ドキュメント

Termiyo のすべて

短いページを、必要になる順に並べています。

はじめに

Termiyo をインストールする

ダウンロードページから、お使いのマシン用のファイルを選びます。Mac では Universal の .dmg、Windows ではインストーラー、Linux ではディストリビューションのパッケージです。各システムでの確認方法とインストール方法もそのページにあります。

保管庫を作る

Termiyo を初めて開くと、マスターパスワードを尋ねます。アプリが保存するすべてを守るのはこれだけで、どこにも送られず、復旧の手段はありません。互いに関係のない単語をいくつか並べたパスフレーズにしてください。

識別情報を追加する

識別情報とは、ユーザー名と認証方法の組み合わせです。パスワード、秘密鍵、またはエージェント。ホストとは別に管理されるので、同じログインを打ち直さずに多数のホストへ使えます。

ホストを追加する

アドレスを入れ、識別情報を選びます。ダブルクリックで接続します。最初の接続ではサーバー鍵のフィンガープリントが表示され、受け入れるとその鍵が以後の再接続すべてに対して固定されます。

踏み台ホスト

非公開のホストへ届く

ホストを開き、Advanced を展開して踏み台ホストを選びます。Termiyo はまず踏み台に接続し、そこを通して目的のホストへチャネルを開きます。目的のホストがあなたのマシンから到達できる必要は一切ありません。

連鎖

踏み台ホストは、それ自身の踏み台ホストを持てます。Termiyo は接続前に経路全体を平坦化し、輪になった連鎖は拒否し、失敗したときはどのホップで失敗したかを示します。

ポート転送

ローカル

待ち受けるのは自分のマシン、届けるのはサーバー側です。よくあるのは、ホスト上で localhost にしかバインドしていないデータベースへ届くという用途です。

リモート

逆向きです。サーバーが待ち受け、接続はあなたのマシンのポートへ戻ってきます。サーバーにしか到達できない相手へローカルのビルドを見せるときに便利です。

動的 (SOCKS5)

Termiyo はローカルで SOCKS5 プロキシを動かし、すべての接続をセッション経由で送り出します。宛先の解決は向こう側で行われます。ブラウザーをそこへ向ければ、サーバーから閲覧していることになります。

同期

サインイン

Settings、Sync。すでに保管庫を開けているパスワードを使います。Termiyo はそこから 2 つの別々の鍵を導きます。1 つは手元に残り、もう 1 つはサーバーがパスワードを知らないまま検証できるものです。

2 台目のマシン

Termiyo を入れ、同じパスワードで保管庫を作り、サインインします。ホスト、鍵、スニペットは最初の同期で届きます。復号はあなた自身のマシン以外のどこでも行われません。

サインアウト

消えるのはトークンで、データではありません。マシンにあるものはそのまま残り、保管庫のパスワードの下で暗号化されたままです。

コマンドを尋ねる

設定

Settings、AI、そして Anthropic の API キー。キーは保管庫に入り、ほかの資格情報と同じように暗号化されます。

尋ねる

したいことを書いてください。提案はあなたが読めるようコマンドラインに置かれます。Termiyo が代わりに実行することはありません。削除、上書き、サービスの停止にあたるものには印が付きます。

送られるもの

あなたの質問と、ログインバナーが示していれば OS の種類です。直近のコマンドは、あなたが有効にした場合にかぎり送られます。ホスト名、ユーザー名、パスワード、鍵が送られることはありません。

Telnet とシリアル

シリアルコンソール

ホスト追加時に Serial を選ぶと、Termiyo は見えているポートを一覧します。たいていのコンソールポートは 9600 の 8-N-1 です。速度が違ってもエラーにはならず、文字化けが出ます。出力がおかしいときは、まずそこを確かめてください。

break を送る

break 信号は、固まったブートローダーを中断したり、機器をリカバリーモニターへ落としたりするための手段です。ターミナルからこれを出す方法は他にありません。

Telnet

ネットワーク機器が他を話さないことが多いため対応しています。暗号化されません。パスワードを含めてすべてが平文で流れます。管理用ネットワークで使ってください。インターネットを越えて使うものではありません。

ほかの SSH クライアントから取り込む

今お使いのクライアントから取り込む

このコンピューターを調べる

取り込みメニューはホスト一覧の上にある雲のボタンで、その最初の項目が「このコンピューターを調べる」です。Termiyo は、すでにお使いの道具がサーバーを保存している場所——ssh_config、known_hosts、PuTTY、FileZilla、WinSCP、MobaXterm、JetBrains の IDE、Remmina、Tabby、SecureCRT、Cyberduck、そして実体が ssh コマンドである iTerm2 のプロファイル——を自分で見に行き、見つけたものを件数とともに並べます。ファイルを探してくるよう求めたりはしません。

何が一緒に来るか

名前、アドレス、ポート、ユーザー名、踏み台、ポート転送。保存済みのパスワードも、FileZilla、WinSCP、JuiceSSH、Remmina から、暗号化して保管される保管庫へ入ります。JetBrains と Cyberduck は OS のキーチェーン、MobaXterm は DPAPI、SecureCRT は自前のパスフレーズでパスワードを守っているため、それらのホストもそのまま取り込まれ、最初の接続時に一度だけ尋ねます。対応づけられなかったものは、黙って捨てずに理由とともに一覧に出ます。

Termius・JuiceSSH・PuTTY はファイルが要ります

Termius はこのマシンに置く内容をフィールドごとに暗号化するため、そこに読めるものはなく、しかも自前のエクスポートは廃止されています。ファイルはご自身で実行したコミュニティ製エクスポーターから用意してください。Termiyo はその JSON と CSV をキーごと読み取ります。JuiceSSH は携帯のアプリなので、バックアップをこちらへコピーしてください。PuTTY は Windows ではセッションをレジストリに持つため、先に regedit で書き出してください。macOS と Linux では ~/.putty/sessions をそのまま読みます。どれもダウンロードフォルダーに置いておけば、戻ってきたときに Termiyo が名前を挙げて差し出します。

目を通すまで何も書き込みません

プレビューが、何が作られ、何がすでにあり、何を持ち込めなかったかを、保管庫に触れる前に示します。同じファイルをもう一度取り込んでも、すでにあるホストを更新するだけで、2 つ目の複製は作りません。

SSH 証明書

証明書を貼り付ける

設定 → SSH キーを開いてキーを選び、認証局が署名した -cert.pub の行を「証明書」に貼り付けます。Termiyo は、誰がログインできるか、いつまで有効か、強制するコマンドを表示し、キー一覧には期限が表示されます。ホスト証明書は保存前に拒否されます。別のキーに署名された証明書も、どのキーか判別できる限り拒否されます。Termiyo が保管するキーなら常に、エージェント内のキーなら公開鍵を入力した時点で判別できます。

エージェント内の証明書

SSH エージェントが持つ証明書は自動的に提示されるので、貼り付けは不要です。Termiyo は接続前に、エージェントが何を持っているかを確認します。

取り込みで一緒に移る

ssh_config を取り込むと、各キーの CertificateFile と隣にある -cert.pub も一緒に取り込まれます。キーファイルを選んだ場合も同じです。別のキーに署名された証明書、ホスト証明書、期限切れの証明書は関連付けられず、プレビューに理由が表示されます。すでにあるキーへの証明書は、そのためのチェックボックスをオンにしたときだけ追加されます。

Mosh でも

Mosh のホストも、SSH のホストと同じように証明書でログインします。証明書がコマンドを強制している場合、ホストは mosh-server の代わりにそのコマンドを実行するため Mosh は起動できません。Termiyo はそれを考えられる原因として示します。セキュリティキーの証明書は、タッチを待てないため Mosh のログインでは使われません。その場合は SSH を使ってください。

AWS から取り込む

必要なもの

ec2:DescribeInstances を持つアクセスキー。それだけです。資格情報はその 1 回の呼び出しに使われ、保存されません。

得られるもの

選んだリージョンで動いているすべてのインスタンス。公開アドレスがないものも含みます。それらこそ踏み台を通して届く相手です。必要なものにチェックを入れてください。

もう一度実行する

再取り込みは、すでにあるホストを更新します。2 つ目の複製は作らず、あなたが割り当てた識別情報にも手を付けません。

スニペット

コマンドを保存する

スニペットは取っておくコマンドで、フォルダーにまとめられます。実行すると、目の前のターミナルに入力されます。

スニペットの中の値

値を入れる場所に ${name} と書き、エディターでそれぞれの入れ方を選びます。「毎回たずねる」（既定の答えや、許可する答えの一覧を付けられます）、「ホストから入れる」（ホストのアドレス、ポート、ログイン名）、または「シェルに任せる」（${PATH} のように、シェルがすでに持っている値に）。値が欠けたままスニペットが実行されることはありません。すべての値に答えがそろうまで「スニペットを実行」は押せません。デスクトップ版では次回、前回の答えが候補として出ます。秘密の値は保存されません。

サーバーへのリンク

リンクをコピーする

「サーバー」ページでサーバーのメニューを開き、「リンクをコピー」を選びます。サーバー自身のページとホストエディターにも同じ操作があり、コマンドパレットで「リンクをコピー」と入力しても見つかります。リンクは termiyo://connect/prod-db のような形です。サーバーの名前だけを含み、アドレスもログイン名もパスワードも含みません。

クリックすると起きること

デスクトップアプリが前面に出て、接続する前に確認します。そのとき、その名前がそのコンピューター上で指しているアドレスを表示します。リンクが開けるのは、その名前ですでに保存されているサーバーだけです。なければ Termiyo はそう伝え、何も開きません。ボールトがロックされている場合、リンクはロック解除を最長 5 分待ちます。

同じ名前のサーバーが 2 台あるとき

デスクトップアプリは、ログイン名、アドレス、ボールトを添えて一覧にし、どれを指しているかを尋ねます。「キャンセル」では何も開きません。見分ける手がかりがない場合は、そう伝えて何も開きません。スマートフォンアプリは尋ねません。2 台のサーバーが共有する名前では、何も開きません。

Linux の AppImage

AppImage はシステムに登録されないため、一度セットアップするまでリンクは何もしません。設定、ヘルプ、コマンドライン、「termiyo:// リンク」、「セットアップ」の順に進みます。.deb と .rpm のパッケージ、および macOS ではセットアップは不要です。Windows では、Termiyo を一度開いたあとでリンクが使えるようになります。

クリックできるリンクにならないとき

termiyo:// をリンクにしないアプリもあります。その場合はターミナルで termiyo ssh prod-db を実行します。このコマンドは、macOS と Linux のパッケージでは、設定のヘルプからインストールできます。