Gitを使用したSSH接続のテスト方法とトラブルシューティング

2024-02-14 02:15 gitSSHテスト

  1. SSHキーの生成と登録:

    • ssh-keygenコマンドを使用してSSHキーペアを生成します。キーペアは公開鍵と秘密鍵からなります。
    • 公開鍵をリモートサーバーに登録します。これには、リモートサーバーにログインし、~/.ssh/authorized_keysファイルに公開鍵を追加することが含まれます。

  2. SSH接続のテスト:

    • ssh -T [email protected]コマンドを使用して、GitリモートサーバーへのSSH接続が機能するかどうかを確認できます。正常に接続できれば、"Hi {username}! You've successfully authenticated, but GitHub does not provide shell access."というメッセージが表示されます。

  3. リモートリポジトリへのSSH接続の設定:

    • リモートリポジトリのURLをSSH形式に変更する必要があります。これには、リモートリポジトリのURLをgit remote set-url origin [email protected]:{username}/{repository}.gitコマンドで変更します。

  4. プロキシ設定:

    • プロキシを使用している場合、Gitが正しく機能するようにプロキシ設定を行う必要があります。これには、git config --global http.proxyとgit config --global https.proxyコマンドを使用します。

  5. SSH接続のトラブルシューティング:

    • エラーメッセージを確認します。一般的なエラーメッセージとその解決策を以下に示します。
      • "Permission denied (publickey)": SSH鍵が正しく設定されていない可能性があります。鍵の生成と登録手順を再確認してください。
      • "Host key verification failed": 接続先のホストの公開鍵が変更された可能性があります。ssh-keygen -R {hostname}コマンドを使用して、既存のホストキーを削除し、新しいキーを受け入れる必要があります。