SSHの基本(接続先・ポート・鍵認証とパスワード認証・秘密鍵/公開鍵・known_hosts・configファイル)

要点

SSHはサーバーに暗号化した通信でコマンド接続する仕組み。接続にはホスト・ポート・ユーザー・認証方法が必要。鍵認証では秘密鍵を手元に、公開鍵をサーバーに置く。秘密鍵・パスワードはknowledgeやAIへの依頼文に書かない。

接続に必要なもの

項目例秘密か
接続先(ホスト)sv000.example-server.jp秘密ではない
ポート標準22。レンタルサーバーは独自番号のことが多い秘密ではない
ユーザー名サーバーのアカウント名秘密ではない
認証秘密鍵ファイル、またはパスワード秘密(認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない)
ssh -i <秘密鍵ファイルのパス> -p <ポート> <ユーザー>@<ホスト>
scp -i <秘密鍵ファイルのパス> -P <ポート> <ローカルファイル> <ユーザー>@<ホスト>:<保存先>   # scp のポートは大文字 -P

認証方式

方式仕組み注意
鍵認証(推奨)手元の秘密鍵と、サーバーに登録した公開鍵の組で認証秘密鍵は絶対に共有しない。パスフレーズを付けると盗まれても使われにくい
パスワード認証ユーザー名+パスワード総当たり攻撃を受けやすい。サーバー会社によっては無効
  • 秘密鍵: 手元だけに置く。メール・チャット・knowledge・Gitに入れない。
  • 公開鍵: サーバーの ~/.ssh/authorized_keys に登録する(レンタルサーバーは管理画面で登録・生成することが多い)。公開してよい。
  • 管理画面で鍵を生成して秘密鍵をダウンロードする方式の場合、ダウンロードは1回きりのことがある。安全な場所に保管。

known_hosts

  • 初回接続時に「このホストを信用するか」と聞かれ、yes でサーバーの指紋が ~/.ssh/known_hosts に記録される。
  • 以後、指紋が変わると Host key verification failed / WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED で止まる。サーバー移転・サーバー側の再構築なら正常、心当たりがなければ接続しない(なりすましの可能性)。
  • 正当な変更と確認できたら、ssh-keygen -R <ホスト> でその行だけ消して再接続。

~/.ssh/config で短くする

Host mysite
  HostName <ホスト>
  Port <ポート>
  User <ユーザー>
  IdentityFile ~/.ssh/<鍵ファイル名>

→ ssh mysite で接続できる。この設定ファイル自体は秘密情報を含まない(鍵の中身は書かない)。

よくあるエラー

エラー原因
Permission denied (publickey)鍵の指定違い、公開鍵が未登録、ユーザー名違い
Connection timed out / refusedポート違い、サーバー側でSSHが無効、接続元IP制限
秘密鍵の権限エラー(UNPROTECTED PRIVATE KEY FILE)鍵ファイルを他人も読める権限にしている。自分だけ読める権限にする
警告 post-quantum key exchange など接続できていれば無視してよい場合が多い(guidepocket.net の例は cc-wp-cli-pipeline)

使い方の原則

コピペ用の一般形(実際のホスト・ユーザー・鍵名は書き換える)

ssh <ユーザー>@<ホスト>                                   # 標準ポート22
ssh -p <ポート> <ユーザー>@<ホスト>                       # ポート指定
ssh -i <秘密鍵のパス> -p <ポート> <ユーザー>@<ホスト>     # 鍵を指定
ssh <ユーザー>@<ホスト> "pwd; ls"                          # 1回だけコマンドを実行して戻る(読み取りの確認に)
ssh -v -p <ポート> <ユーザー>@<ホスト> exit                # 接続確認(どこで失敗するか詳しく表示)

実際の接続先・鍵の中身は knowledge に書かない(認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない)。