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で入ったら、まず読み取りコマンドだけで状況確認(
pwdlswp option getなど → WP-CLIの確認コマンドと変更コマンドの区別(option・post・plugin・theme・eval-file・search-replace))。 - 削除・上書きのコマンドは、対象とバックアップを確認してから1つずつ。
コピペ用の一般形(実際のホスト・ユーザー・鍵名は書き換える)
ssh <ユーザー>@<ホスト> # 標準ポート22
ssh -p <ポート> <ユーザー>@<ホスト> # ポート指定
ssh -i <秘密鍵のパス> -p <ポート> <ユーザー>@<ホスト> # 鍵を指定
ssh <ユーザー>@<ホスト> "pwd; ls" # 1回だけコマンドを実行して戻る(読み取りの確認に)
ssh -v -p <ポート> <ユーザー>@<ホスト> exit # 接続確認(どこで失敗するか詳しく表示)
実際の接続先・鍵の中身は knowledge に書かない(認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない)。