termal.in

← ブログ

実際に使う SSH のフラグ(実用的なチートシート)

· 更新 2026年11月12日 · Termalin Team sshcheat-sheetproductivitytutorial

**手短な答え:**最もよく使うフラグはこれです。-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
-tTTY を強制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 クライアントです。ダウンロードするか、鍵を安全に扱う仕組みをお読みください。

まずは 1 台のホストで試してみてください。

Termalin は、あなたとあなたのエージェントのための高速な SSH クライアントです。

無料プラン · Pro を 14 日間お試し · 料金

Google で Termalin を優先する情報源に追加