SSHの接続方法と鍵認証の設定｜ssh-keygenからconfig活用まで

この記事のポイント

・ssh-keygen -t ed25519 でED25519鍵ペアを作成し、ssh-copy-idでサーバーへ公開鍵を登録する
・~/.ssh/configにHost定義を書くと短い名前だけで複数サーバーへ接続を効率化できる
・PasswordAuthentication no・PermitRootLogin noでブルートフォース攻撃を防ぐ
・「Permission denied (publickey)」はssh -vのデバッグログとパーミッション確認で解決できる

# ユーザー名@ホスト名（またはIPアドレス）で接続
ssh user@192.168.1.100

# ポート番号を指定する場合（デフォルトは22）
ssh -p 2222 user@192.168.1.100

The authenticity of host '192.168.1.100' can't be established.
ED25519 key fingerprint is SHA256:xxxxxxxxxxxxx.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes

# リモートサーバーのディスク使用量を確認
ssh user@192.168.1.100 df -h

# リモートサーバーのログを確認
ssh user@192.168.1.100 tail -20 /var/log/messages

# ED25519形式で鍵を作成（現在の推奨）
ssh-keygen -t ed25519 -C "your_email@example.com"

Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/user/.ssh/id_ed25519):  # Enterでデフォルト
Enter passphrase (empty for no passphrase):  # パスフレーズを入力（推奨）
Enter same passphrase again:

Your identification has been saved in /home/user/.ssh/id_ed25519
Your public key has been saved in /home/user/.ssh/id_ed25519.pub
The key fingerprint is:
SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx your_email@example.com

# RSA形式（古い環境向け）
ssh-keygen -t rsa -b 4096

$ cat ~/.ssh/id_ed25519.pub
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGxxxxxxxxxxxxxxxxxxxxxyyyyyyy your_email@example.com

# 公開鍵をサーバーにコピー（最も簡単な方法）
ssh-copy-id user@192.168.1.100

# 鍵ファイルを明示する場合
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@192.168.1.100

# ポート番号を指定する場合
ssh-copy-id -p 2222 user@192.168.1.100

# サーバー上で実行する
$ ssh user@192.168.1.100    # パスワードでログイン
$ mkdir -p ~/.ssh
$ chmod 700 ~/.ssh

# 自分のPCで実行する（別のターミナルで）
$ cat ~/.ssh/id_ed25519.pub
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGxxxxxxxxxxxxxxxxxxxxxyyyyyyy your_email@example.com

# サーバー上で実行する
$ nano ~/.ssh/authorized_keys
# コピーした公開鍵を貼り付けて保存（Ctrl+X → Y → Enter）

# 権限を設定する（重要）
$ chmod 600 ~/.ssh/authorized_keys

# 鍵認証で接続（パスフレーズのみ求められる）
ssh user@192.168.1.100

# 秘密鍵を明示的に指定する場合
ssh -i ~/.ssh/id_ed25519 user@192.168.1.100

# ssh-agentを起動する
eval "$(ssh-agent -s)"
Agent pid 12345

# 秘密鍵をエージェントに登録する
ssh-add ~/.ssh/id_ed25519
Enter passphrase for /home/user/.ssh/id_ed25519: [パスフレーズを1回だけ入力]
Identity added: /home/user/.ssh/id_ed25519 (your_email@example.com)

# 登録済みの鍵を確認する
ssh-add -l
256 SHA256:xxxxxxxxxxxxxxxxxx your_email@example.com (ED25519)

# 鍵ファイルのパーミッションを確認
ls -la ~/.ssh/

# 正常な出力例
drwx------. 2 user user   38 Jun 22 09:00 .
drwx------. 5 user user  128 Jun 22 09:00 ..
-rw-------. 1 user user  419 Jun 22 09:00 id_ed25519
-rw-r--r--. 1 user user   99 Jun 22 09:00 id_ed25519.pub
-rw-------. 1 user user  571 Jun 22 09:00 authorized_keys

# 自分のPC側（接続元）
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519       # 秘密鍵
chmod 644 ~/.ssh/id_ed25519.pub   # 公開鍵

# サーバー側（接続先）
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

# ~/.ssh/config
Host web01
    HostName 192.168.1.100
    User admin
    Port 22
    IdentityFile ~/.ssh/id_ed25519

Host db01
    HostName 192.168.1.200
    User dbadmin
    Port 2222
    IdentityFile ~/.ssh/id_ed25519

# GitHubとの接続（参考）
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519

chmod 600 ~/.ssh/config

# configに定義した名前で接続
ssh web01
ssh db01

# scpやrsyncでも同じ名前が使える
scp backup.tar.gz web01:/tmp/
rsync -av /data/ db01:/backup/

# ~/.ssh/config（先頭に記述）
Host *
    ServerAliveInterval 60
    ServerAliveCountMax 3
    IdentitiesOnly yes

# /etc/ssh/sshd_config を編集
sudo vi /etc/ssh/sshd_config

# 以下の行を変更・確認する
PasswordAuthentication no       # yesをnoに変更
PubkeyAuthentication yes        # yesになっていることを確認

# sshdを再起動して反映
sudo systemctl restart sshd

# /etc/ssh/sshd_config
PermitRootLogin no

# sshdを再起動
sudo systemctl restart sshd

# /etc/ssh/sshd_config
Port 2222

# sshdを再起動
sudo systemctl restart sshd

# firewalldを使っている場合はポートも開放
sudo firewall-cmd --permanent --add-port=2222/tcp
sudo firewall-cmd --reload

# 1. パーミッションを確認（サーバー側）
ls -la ~/.ssh/
# .ssh は 700、authorized_keys は 600 であること

# 2. 公開鍵が正しく登録されているか確認
cat ~/.ssh/authorized_keys

# 3. -vオプションで詳細ログを出して原因を特定
ssh -v user@192.168.1.100

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@         WARNING: UNPROTECTED PRIVATE KEY FILE!          @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/home/user/.ssh/id_ed25519' are too open.

# 自分のPCで実行する
chmod 600 ~/.ssh/id_ed25519

# known_hostsから該当ホストのエントリを削除
ssh-keygen -R 192.168.1.100

# 再度接続すると、新しい鍵のフィンガープリントが登録される
ssh user@192.168.1.100

# Connection timed out: ネットワーク疎通を確認
ping 192.168.1.100

# Connection refused: sshdが起動しているか確認（サーバー側で実行）
sudo systemctl status sshd

# ファイアウォールでポートが開いているか確認
sudo firewall-cmd --list-all

# エラーメッセージの例
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@         WARNING: UNPROTECTED PRIVATE KEY FILE!          @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0777 for '/mnt/c/Users/user/.ssh/id_ed25519' are too open.

# ~/.ssh/ がLinux側のホームディレクトリにあることを確認
echo $HOME
# 表示例: /home/user  ← /mnt/c/ 配下でなければOK

ls -la ~/.ssh/
# drwx------ (700) であること