GitHub SSHをテストする方法とトラブルシューティングの手順


  1. SSHキーの生成と設定:

    • SSHキーペアを生成します。以下のコマンドを実行します(コマンドはMacまたはLinuxの場合です):
      ssh-keygen -t rsa -b 4096 -C "[email protected]"
    • キーペアの生成時にパスフレーズの設定を求められます。パスフレーズを設定することで、より安全なアクセスが可能ですが、省略することもできます。
    • 公開鍵(id_rsa.pub)をGitHubアカウントのSSHキー設定に追加します。
  2. SSH接続のテスト:

    • 以下のコマンドを使用して、SSH接続が正しく設定されているかをテストします:
      ssh -T [email protected]
    • 接続が成功した場合、"Hi {your_username}! You've successfully authenticated, but GitHub does not provide shell access." というメッセージが表示されます。
  3. トラブルシューティング:

    • エラーメッセージ: "Permission denied (publickey)" - SSH接続に失敗した場合、SSH鍵が正しく設定されていない可能性があります。以下の手順を確認してください:

      • 正しい公開鍵を使用していることを確認します。
      • SSHエージェントが実行中であることを確認します。以下のコマンドを使用してSSHエージェントを起動します:
        eval "$(ssh-agent -s)"
      • SSHエージェントにSSHキーを追加します:
        ssh-add ~/.ssh/id_rsa
      • ssh -T [email protected] コマンドを再度実行して、接続が成功するか確認します。
    • エラーメッセージ: "Host key verification failed" - ホスト鍵の検証に失敗した場合、接続先のGitHubサーバーの公開鍵が変更されている可能性があります。以下の手順で対処します:

      • ssh-keygen -R github.com コマンドを実行して、既存のホストキーを削除します。
      • 再度接続を試みます。
    • その他のエラーメッセージ: エラーメッセージが表示された場合は、GitHubのドキュメンテーションやコミュニティフォーラムで該当するエラーについて検索し、解決策を探します。