SSH Config
接続設定の基準となるデータは~/.ssh/configです。sshcはIncludeの階層をたどり、ワイルドカードを含まない個別のHostエイリアスを接続先として表示しています。
設定ファイルを編集する
SSH Configでは、読み込まれたファイルとIncludeの関係を確認しながら、UTF-8テキストを編集できます。保存中に処理が中断しても、元の設定ファイルが途中まで書き換わった状態にならないよう保存します。
ファイルの欄と、接続先の[テキストで編集]の欄は、SFTPの編集と同じエディタ(Monaco)です。
- ディレクティブ、値、コメントを色分けします。
- 行の頭で
Ctrl+Spaceを押すと、ディレクティブの名前の候補を出します。 - OpenSSHが知らないディレクティブなど、設定を読んだときに見つかった問題の行に印を付けます。印にマウスを乗せると、問題の文が出ます。
Tabは字下げです。エディタの外へフォーカスを移すときは、Ctrl+M(macOSはCtrl+Shift+M)でTabの動きを切り替えます。
sshcが管理するグループ領域を除き、コメント、空行、ディレクティブの順序はできるだけ維持されます。生成範囲は、# >>> sshc groupsで始まる行と# <<< sshc groupsの間です。この範囲は次回の保存時に置き換えられるため、直接編集しないでください。
ファイルとフォルダの操作
見出しの[ファイルを作成]で、~/.sshの中に新しい設定ファイルを作れます。OpenSSHに読み込ませるには、~/.ssh/configのIncludeから参照してください。開いているファイルの見出しの「…」には、次の操作があります。
- [ファイル名を変更]: このファイルを直接参照する
Includeの行も同時に書き換えます。ワイルドカードのパターンは書き換えず、新しいパスが一致しないときは警告します。 - [フォルダを作成]:
~/.sshの中にフォルダを作ります。グループのフォルダは、Connectionsのグループの一覧で管理してください。 - [ファイルを削除]: このファイルを直接参照する
Includeの行も削除します。バックアップを保存するので、履歴から復元できます。 - [フォルダを削除]: 空のフォルダだけを削除できます。
未保存の編集があるあいだは、名前の変更と削除はできません。~/.sshの外のパスは使えません。
接続詳細の4つのタブ
- 基本: ホスト、ユーザー、ポート、認証
- 踏み台・転送・その他: 経由する接続先(ProxyJump)、ポート転送、その他のディレクティブ
- 表示とターミナル: 色、OSアイコン、タグ、表示順、ターミナルの配色・文字コード、VPNなど、sshcだけが使う設定
- 最終的な値: 最終的に適用される値、参照元、警告
値を空にして保存すると、OpenSSHから継承した値に戻ります。名前の変更、グループへの移動、複製、コメント、保存ファイルの変更、削除と、Hostブロックをテキストのまま編集する[テキストで編集]は、接続詳細の見出しの「…」にあります。
接続せずに設定を確認する
sshc info <alias>
sshc info <alias> --json実際の接続時と同じ規則でInclude、Match、ProxyJumpを読み、最終的に使われる設定を表示します。パスワード、パスフレーズ、SetEnvの値、ProxyCommandの本文は表示されません。