**手短な答え:**最もよく使うフラグはこれです。-p <port>(標準以外のポート)、-i <key>(特定の鍵を強制)、-L / -R / -D(ローカル・リモート・ダイナミック転送)、-J <bastion>(踏み台を経由)、-N -f(シェルなしでトンネルをバックグラウンド化)、-t(sudo のために TTY を強制)、-o Option=value(任意の ssh_config ディレクティブをインラインで設定)、そして -vvv(失敗する接続をデバッグ)。2 回渡すものは ~/.ssh/config に書くべきで、そうすれば ssh web1 がフラグを一切付けずにそれらを引き連れてきます。
ssh --help は 40 個のフラグをアルファベット順にぶちまけますが、これは覚え方として最も役に立たない並べ方です。フラグは、やろうとしていること——別のユーザーで接続する、ポートを転送する、踏み台を経由する、接続拒否をデバッグする——に応じて手を伸ばすものです。そこで、同じ一式をタスク別に整理し、どれをもう打つのをやめて代わりに ssh_config(英語) に入れるべきかの注記も添えます。
すべての底にある原則はこうです。フラグは 1 回限りのため、config は恒久化のため。 2 回渡すものは、ファイルに書くべきものです。
接続の基本
「誰が、どこへ、どの鍵で」に答えるフラグです。
-p <port>——標準以外のポートに接続します。ssh -p 2222 user@host。(小文字の-pです。大文字の-Pは scp のポートフラグで、誰もが一度は引っかかります。)-l <user>——ログインユーザーで、user@という接頭辞の代わりになります。ssh -l deploy hostはssh deploy@hostと同じです。-lはスクリプトや古めのドキュメントで見かけます。-i <identity>——特定の秘密鍵を指定します。ssh -i ~/.ssh/work_ed25519 user@host。認証が失敗したときに最も役立つフラグです。エージェントに推測させる代わりに、まさにその鍵を強制します。-F <configfile>——別の設定ファイルを使います。ssh -F ./project.sshconfig web1、あるいは-F /dev/nullで個人の config を無視し、カスタマイズ一切なしでテストします。-v/-vv/-vvv——冗長度で、たいていの謎を終わらせるフラグです。-vを 1 つで、試された認証方式と提示された鍵が見え、-vvvでハンドシェイク全体が見えます。何かが失敗したら、推測を立てる前に-vvvを付けてもう一度実行してください——そのトレースを読むこと自体が 1 つのスキルです。
-o という抜け道
これは深く理解しておく価値のあるフラグです。何十個もの他のフラグを包含してしまうからです。-o は、任意の ssh_config オプションをインラインで設定します。 ~/.ssh/config の Host ブロックに書けるものは何でも、-o Option=value として渡せます——選ばれた少数のオプションだけでなく、config の語彙すべてが、1 回の接続のために使えるのです。
しょっちゅう登場するものをいくつか。
ssh -o IdentitiesOnly=yes -i ~/.ssh/right_key user@host # この鍵だけを提示する
ssh -o StrictHostKeyChecking=accept-new user@host # 新しいホストは信頼、変更は依然として検知
ssh -o ServerAliveInterval=30 user@host # 不安定な回線向けのキープアライブ
ssh -o ProxyJump=bastion.example.com db.internal # 踏み台をインラインで経由
-o IdentitiesOnly=yes は、エージェントが 6 個の鍵を提示し、厳格なサーバーが 5 個で打ち切ってくるときの Too many authentication failures への対処です。-o StrictHostKeyChecking=accept-new は、ほどよい中間地点です——見たことのないホストは自動で信頼しつつ、既知のホストの鍵が変わったときには、やはり大声で知らせます。
要点はこうです。挙動ごとに専用のフラグは要りません。config のディレクティブを知っていれば、フラグも知っていることになります——-o Directive=value だからです。毎回 3 つも 4 つも渡すようになったら、それらを config に移して固定しましょう。
転送とトンネル
ポートの配管を担うフラグです。その考え方——どちら側がポートを開くか——は SSH ポート転送の解説で個別に扱っています。ここではフラグの要約を。
-L <local>:<host>:<port>——ローカル転送。あなたのマシン上にポートを開き、サーバーから到達できる宛先へトンネルします。ssh -L 5432:localhost:5432 db.example.comは、リモートのデータベースをあなたの127.0.0.1:5432に持ってきます。-R <remote>:<host>:<port>——リモート転送。サーバー上にポートを開き、あなたの側へトンネルで戻します——NAT の内側にあるマシンに到達するための、リバーストンネルの技です。-D <port>——ダイナミック転送。あなたのマシン上の SOCKS プロキシで、宛先は接続ごとに選ばれます。ssh -D 1080 jump.example.comとしてから、ブラウザーを127.0.0.1:1080に向けます。-N——リモートコマンドを実行しません。シェルは要らず、トンネルだけが欲しいときに、どの転送とも組み合わせます。-f——接続後にsshをバックグラウンドへ回します。-Nと組み合わせれば、放っておけるトンネルになります:ssh -fN -L 5432:localhost:5432 db.example.com。-g——ローカル転送(-L/-D)を127.0.0.1だけでなく、LAN 上の他のマシンにも使わせます。ささやかな露出です——ネットワーク全体にトンネルを開くことになるので、意図して使ってください。
踏み台ホストとエージェント
次のホップに到達する手段と、慎重に扱うべきフラグです。
-J <jumphost>——ProxyJump。踏み台を通り抜けてトンネルし、あなたのノート PC からターゲットまでエンドツーエンドで認証します。ssh -J bastion.example.com db.internal。踏み台は暗号化されたバイト列を運ぶだけで、あなたの鍵がそこに着地することはありません——ゲートウェイを抜ける正しいやり方です。詳しくは: ProxyJump: 踏み台の背後のサーバーに到達する。-A——エージェント転送。リモートホスト上にソケットを露出させ、署名要求をあなたのローカルエージェントへ中継します。これにより、そこのプロセスが次のサーバーへあなたとして認証できます。便利ですが見た目より危険です。そのホストで root 権限を持つ者は、セッションが開いている間、あなたの身元を借りられます。「次のホップに到達する」には-Jを使い、-Aは完全に信頼できるホストのためにとっておきましょう——理由はエージェント転送は便利だが危険(英語)にあります。
2 つの違いはこうです。-J は、誰にも鍵を貸さずに、あなたのシェルを踏み台の背後のホストへ届けます。-A は、接続した箱に、あなたの鍵のライブでの利用を貸します。同じ取引ではありません。
セッション制御
特定の不便を直す、小さなフラグです。
-t——擬似端末を強制します。対話的な TTY を前提とするリモートコマンドに必要です:ssh -t host 'sudo systemctl status nginx'は、sudoのプロンプトと色付き出力のための本物の端末を与えます。ローカルに TTY がないときは、二重にして(-tt)強制します。-q——静かなモード。警告とバナーを抑えます。コマンド自身の出力だけが欲しいスクリプトで役立ちます。-C——圧縮を要求します。遅く、遅延の大きい回線では確かな効果があります。高速な LAN では、ほとんど無意味か、わずかに逆効果です。-o BatchMode=yes——プロンプトを一切出しません。認証にパスワードやパスフレーズが必要になるなら、ハングする代わりに即座に失敗します。これが、cron や CI の中で SSH を安全にするものです——無人のスクリプトで止まったプロンプトは、永遠にハングします。
SSH はどのポートを使うのか?
SSH は既定で TCP ポート 22 を使います——ssh・scp・sftp、そして SSH 越しの git は、あなたが別途指定しない限り、すべてこれを前提とします。別の場所で待ち受けているサーバーに到達するには、-p でポートを渡します。
ssh -p 2222 user@host
サーバーが待ち受けるポートを変えるには、/etc/ssh/sshd_config に Port を設定して sshd を再起動します——そして、ログアウトする前に、ホストのファイアウォールとクラウドのセキュリティグループの両方で新しいポートを開けてください。新しいポートを許可せずに SSH を移すのは、自分を締め出す最速の方法だからです。(22 番から離れると、通りすがりのスキャナーは静かになります。それ自体が本当のセキュリティではありません。)ssh_config(英語) にホストごとに一度 Port 2222 と設定すれば、二度と -p を打つことはありません。
シェルを開かずに SSH でコマンドを実行する方法
ホストのあとにコマンドをクォートで囲んで置けば、SSH はそれを実行し、出力を表示して終了します——対話的なシェルは開きません。
ssh user@host 'df -h /'
ssh user@host 'systemctl is-active nginx'
これはスクリプトと cron の背骨です。接続 1 つ、コマンド 1 つ、そしてテストできる終了コード。ローカルのシェルが先に展開してしまわないよう、コマンドはクォートで囲みます。ここで重要なフラグが 2 つあります。
-tは、TTY を必要とするコマンドのために TTY を強制します——ssh -t user@host 'sudo systemctl restart nginx'は、sudoに本物の対話的プロンプトを与えます。-o BatchMode=yes(または-n)は、入力待ちを止めるので、無人のジョブはプロンプトでハングする代わりに、素早く失敗します。
SSH セッションを終了する方法
exit と入力するか、Ctrl-D を押せば、シェルを閉じて接続を切ります。 どちらもリモートのシェルにファイル終端(EOF)を送り、ログアウトして、ローカルのプロンプトに戻します。
exit # または Ctrl-D を押す
セッションが固まったとき——回線が死に、端末が Ctrl-C すら含めて何もかも無視するとき——exit は役に立ちません。あなたが打つものが、向こう側に届いていないからです。代わりに SSH 自身のエスケープシーケンスを使います。Enter を押してから、~.(チルダ、続いてピリオド)と入力します。これは、リモート側がどれほど動かなくなっていても、ローカルの ssh に接続を即座に断ち切るよう指示します。~ のエスケープは改行の直後でしか読まれないので、先に Enter を押すわけです。
コンパクトな早見表
| フラグ | 何をするか | ssh_config での同等指定 |
|---|---|---|
-p 2222 | 標準以外のポート | Port 2222 |
-l user / user@ | ログインユーザー | User user |
-i ~/.ssh/key | 特定の鍵 | IdentityFile ~/.ssh/key |
-F file | 別の設定ファイル | — (これ自体が設定) |
-v … -vvv | 冗長/デバッグ | LogLevel DEBUG3 |
-o Opt=val | 任意の設定オプションをインラインで | (オプションそのもの) |
-L a:host:b | ローカル転送 | LocalForward a host:b |
-R a:host:b | リモート転送 | RemoteForward a host:b |
-D 1080 | ダイナミック(SOCKS)転送 | DynamicForward 1080 |
-N | リモートコマンドなし | RequestTTY no(+コマンドなし) |
-f | 接続後にバックグラウンド | — (1 回限りのみ) |
-g | 転送を LAN に開く | GatewayPorts yes |
-J host | 踏み台を経由 | ProxyJump host |
-A | エージェントを転送 | ForwardAgent yes |
-t | TTY を強制 | RequestTTY force |
-q | 静かに | LogLevel QUIET |
-C | 圧縮 | Compression yes |
-o BatchMode=yes | プロンプトを出さない | BatchMode yes |
右の列が手がかりです。ほぼすべてのフラグに config での同等指定があり、それがワークフローになります。フラグを一度使って接続が動くことを確かめ、繰り返すものは ~/.ssh/config に移します。そうすれば ssh web1 が、フラグを一切付けずにそれらすべてを引き連れてきます。config に同等指定がないフラグ——-f、-F、デバッグの冗長度——が、本当に 1 回限りのものです。
クライアントが状態を代わりに保持する場所
フラグも config も、どちらもマシンごとのドットファイルの中に住んでいます。そして、それは規模が大きくなると痛手になります。設定をノート PC 間で手作業でコピーし、スリープのたびにトンネルを張り直し、40 台のホストのどれが動いているかを知る術もありません。Termalin は、フラグが運ぶのと同じ事実——ポート、ユーザー、鍵、踏み台ホスト、キープアライブ、保存したローカル/リモート/ダイナミック転送——を、構造化されたデータとしてホストに紐づけて保持し、フォルダーとタグで整理し、マシン間でエンドツーエンド暗号化して同期します。各サーバーを初回接続時に検証し、ホストごとのライブ状態を表示し、打ち直したコマンドではなく接続と一緒にトンネルを張ります。フラグは何が起きているかを教えてくれます。クライアントは、毎朝それらを打ち直す手間からあなたを解放します。
Termalin は、ホストごとの設定・鍵・トンネルをあなたの代わりに保存する、無料・クロスプラットフォームの SSH クライアントです。ダウンロードするか、鍵を安全に扱う仕組みをお読みください。