GitHub SSHキーの設定方法とトラブルシューティング

2024-02-14 03:20 GitHub SSHキー

  1. SSHキーの生成と登録

    • ターミナルを開きます。
    • ssh-keygenコマンドを使用して、SSHキーペアを生成します。デフォルトの場所に保存されます。
    • 公開キーをクリップボードにコピーします: cat ~/.ssh/id_rsa.pub | pbcopy
    • GitHubの設定画面に移動し、"SSH and GPG keys"セクションに移動します。
    • "New SSH key"をクリックし、コピーした公開キーを貼り付けます。
    • キーに説明を追加し、"Add SSH key"をクリックします。

  2. SSH接続のテスト

    • ssh -T [email protected]コマンドを実行します。
    • "Hi [ユーザー名]! You've successfully authenticated"というメッセージが表示されれば、SSH接続が正常に動作しています。

トラブルシューティング:

  1. SSH接続エラー: "Permission denied (publickey)"

    • SSHキーが正しく登録されていない可能性があります。上記の手順に従って、キーを再度登録してください。
    • SSHキーのパーミッションが正しく設定されていることを確認します。chmod 400 ~/.ssh/id_rsaコマンドを使用して、パーミッションを設定します。

  2. SSHキーのエラー: "Could not open a connection to your authentication agent."

    • SSHエージェントが実行されていない可能性があります。eval "$(ssh-agent -s)"コマンドを使用して、SSHエージェントを起動します。

  3. パスフレーズの設定

    • SSHキーにパスフレーズを設定している場合、キーを使用するたびにパスフレーズを入力する必要があります。ssh-addコマンドを使用して、キーのパスフレーズをキャッシュに追加することができます。