MacでのSSH経由のGit接続の設定とトラブルシューティング方法

2024-02-08 01:11 Mac SSH Git
  1. SSHキーペアの生成: SSH経由でGitに接続するには、最初にSSHキーペアを生成する必要があります。ターミナルを開き、以下のコマンドを実行します。
ssh-keygen -t rsa -b 4096 -C "[email protected]"

コマンドを実行すると、キーペア（公開鍵と秘密鍵）が生成されます。デフォルトの場所に保存され、パスフレーズを要求されることがあります。

  1. 公開鍵の追加: 次に、生成された公開鍵をGitアカウントに追加する必要があります。Gitホスティングサービスにログインし、アカウント設定またはSSHキーの管理セクションを見つけます。公開鍵をコピーし、Gitアカウントに追加します。

  2. SSH構成の設定: SSH構成ファイルを使用して、Gitホスティングサービスとの接続設定を行うこともできます。ターミナルで以下のコマンドを実行し、SSH構成ファイルを開きます。

nano ~/.ssh/config

ファイルが存在しない場合は新規作成されます。以下のような設定を追加します。

Host git-host
  HostName git.example.com
  User git
  IdentityFile ~/.ssh/id_rsa

Host: 自分が指定するGitホストの名前 HostName: Gitホストのアドレス User: ユーザー名 IdentityFile: 秘密鍵のパス

  1. Gitリポジトリへの接続: 接続が正しく設定されていれば、ターミナルで次のようにコマンドを実行してGitリポジトリに接続できます。
git clone git-host:repository.git

これでSSH経由でのGit接続が完了しました。

  1. 接続エラー: 接続エラーが発生した場合は、以下を確認してください。

    • SSHキーが正しく設定されているか確認します。
    • インターネット接続が正常であることを確認します。

  2. パーミッションの問題: 秘密鍵やSSH構成ファイルのパーミッションが正しく設定されていない場合、接続に問題が発生することがあります。以下のコマンドを使用してパーミッションを設定します。

chmod 600 ~/.ssh/id_rsa
chmod 600 ~/.ssh/config
  1. パスフレーズの入力: 秘密鍵にパスフレーズが設定されている場合、接続時にパスフレーズを入力する必要があります。ターミナルで以下のコマンドを実行し、パスフレーズを入力します。
ssh-add -K ~/.ssh/id_rsa

これでパスフレーズを入力せずにSSH接続ができるようになります。