GitHub SSH キー登録ガイド
GitHub アカウントに SSH キーを登録して、リポジトリをクローン하거나認証するたびにパスワードを入力する手間を省く方法を説明します。
📋 概要
SSH (Secure Shell) は、ネットワーク上にパスワードを送信せずに安全な認証を提供するプロトコルです。SSH キーのペアを GitHub に登録すると、認証情報を入力せずにリポジトリのクローン、プル、プッシュができるようになります。
GitHub は2種類の SSH キーをサポートしています:
- Ed25519 (推奨) — モダンで安全이며、鍵のサイズも小さいです
- RSA (4096ビット) — レガシー互換性用、Ed25519 がサポートされていない環境でのみ使用してください
🛠️ 設定ステップ
1. 既存の SSH キーを確認
新しいキーを生成する前に、既にキーがあるかどうか確認します。
Linux / macOS / WSL:
ls -la ~/.ssh/Windows (PowerShell):
Get-ChildItem $env:USERPROFILE\.sshid_ed25519、id_ed25519.pub、id_rsa、id_rsa.pub というファイルがあるかどうか確認します。 사용할 키 쌍이 이미 있으면 3단계로 건너뛰세요.
2. 新しい SSH キーを生成
Ed25519 アルゴリズムを使用して新しい SSH キーを生成します (推奨).
Linux / macOS / WSL:
ssh-keygen -t ed25519 -C "<your-email@example.com>"Windows (PowerShell):
ssh-keygen -t ed25519 -C "<your-email@example.com>"キーファイルの場所を聞かれたら、Enter を押してデフォルト (~/.ssh/id_ed25519) を使用します。
パスフレーズを聞かれたら、安全なパスフレーズを入力するか、Enter を押して空にできます。パスフレーズを使用すると、秘密鍵が漏えいしても追加のセキュリティ層が適用されます。
3. 公開鍵の確認とコピー
公開鍵を表示してクリップボードにコピーします。
Linux / macOS / WSL:
cat ~/.ssh/id_ed25519.pubWindows (PowerShell):
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub公開鍵は ssh-ed25519 または ssh-rsa で始まり、あなたのメールアドレスで終わります。出力全体を選択してコピーしてください。
⚠️ セキュリティ注意: 秘密鍵 (
id_ed25519またはid_rsa、.pubなし) を絶対に共有したり公開したりしないでください。公開鍵 (id_ed25519.pub) のみ共有しても安全です。
4. GitHub にキーを登録
- GitHub にログインします
- プロフィール写真をクリック → Settings をクリック
- 左サイドバーで SSH and GPG keys をクリック
- New SSH key をクリック
- Title フィールドに説明的なラベルを入力します (例:
マイノートパソコン、<minimax:tool_call> PC) - Key フィールドに公開鍵を貼り付けます
- Add SSH key をクリック
5. 接続テスト
SSH キーが正しく登録されていることを確認します。
ssh -T git@github.com初めて接続的时候会显示以下警告:
The authenticity of host 'github.com (IP アドレス)' can't be established.
RSA key fingerprint is SHA256:xxxxx.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
yes を入力して Enter を押してください。成功すると 다음 메시지가 표시됩니다:
Hi <username>! You've successfully authenticated, but GitHub does not provide shell access.
6. SSH でリポジトリをクローン
接続を確認したら、SSH アドレスを使用してリポジトリをクローンします。
git clone git@github.com:<owner>/<repository>.git<owner> をリポジトリの所有者置き換え、<repository> をリポジトリ名で置き換えてください。
🔍 SSH キー登録の確認
GitHub アカウントに登録されているすべての SSH キーを一覧表示するには:
- Settings → SSH and GPG keys に移動します
- タイトルと作成日付在内的注册済みキー一覧を確認します
🩺 トラブルシューティング
| 症状 | 原因 | 解決方法 |
|---|---|---|
Permission denied (publickey) | SSH キーが登録されていない、または間違ったキーを使用 | 公開鍵が GitHub に登録されていることを確認します。正しい秘密鍵を使用していることを確認します。 |
ssh -T は "successfully authenticated" と言うが git 操作は失敗 | キーが特定のリポジトリに追加されていない | SSH キーが該当リポジトリの読み取り/書き込みアクセス権を持っていることを確認します。 |
| 接続タイムアウト | ポート 22 をブロックするファイアウォールまたはネットワーク問題 | ネットワーク設定を確認するか、代わりに HTTPS を使用してください。 |
git@github.com: Permission denied | 잘못けたリモート URL 形式 | リモートの URL で git@github.com: (コロン) を使用し、https://github.com/ ではないことを確認します。 |
| "Too many authentication failures" | キーの試行回数が多すぎてサーバーが拒否 | ssh -vT git@github.com でデバッグするか、-i ~/.ssh/id_ed25519 でキーを指定します。 |
🔒 セキュリティベストプラクティス
- 秘密鍵 (
id_ed25519またはid_rsa) を絶対に共有しないでください。イシュー、メールへの添付、リポジトリへのコミットに含めないでください。 - SSH キーを生成的时候 パスフレーズを使用して、秘密鍵が漏えいしても保護してください。
- デバイスごとに固有の SSH キーを使用 — ノートパソコン、デスクトップ、サーバーに異なるキーを登録してください。
- 登録済みキーの定期監査 — 古かったり使用されていない SSH キーは GitHub アカウントから削除してください。
- 組織で集中型キー管理が必要な場合は SSH 証明書の使用を検討してください。
📚 参照
バージョン: 1.0
最終更新: 2026-09-24
ソースファイル: giipv3/public/help/github-ssh-key.ja.md