Skip to main content

SSH のトラブルシューティング

GitHub に接続して認証するために SSH を使っている場合、予期しない問題が起きてトラブルシューティングしなければならないことがあります。

HTTPS ポートを介して SSH を使用する

時々、ファイアウォールは SSH 接続を完全に許可することを拒否します。 認証情報キャッシュを使用した HTTPS クローニング を使用することが選べない場合は、HTTPS ポート経由の SSH 接続を使用してクローンの作成を試みることができます。 ほとんどのファイアウォールルールでこれを許可する必要がありますが、プロキシサーバーが干渉する可能性があります。

SSH キーのパスフレーズのリカバリ

SSH キーのパスフレーズをなくした場合、ご使用のオペレーティングシステムによって、リカバリができることもあれば、SSH キーのパスフレーズを新たに生成することが必要なこともあります。

SSH キーの削除または紛失

セキュリティ上の理由から、過去 1 年間使用されていない SSH キーを GitHubは自動的に削除します。

エラー: ホスト キーの検証に失敗しました

セキュリティ上の予防措置として、SSH は以前に確認したホストを追跡します。

Error: Permission denied (publickey)

「Permission denied」エラーは、サーバーが接続を却下したことを示します。 原因はいくつか考えられますが、最も一般的な例を説明します。

エラー: Bad file number

このエラーは通常、サーバーに接続できなかったことを示します。 よくある原因はファイアウォールとプロキシサーバーです。

Error: Key already in use

このエラーは、既に別のアカウントまたはリポジトリに追加されているキーを追加しようとすると発生します。

Error: Permission to user/repo denied to other-user

このエラーは、プッシュしているキーが、リポジトリへのアクセス権を持たないアカウントに添付されていることを示します。

Error: Permission to user/repo denied to user/other-repo

このエラーは、プッシュに使用しているキーが、他のリポジトリにデプロイキーとして添付されており、プッシュ先のリポジトリへのアクセス権がないことを示しています。

Error: Agent admitted failure to sign

まれに、Linux 上の SSH 経由で GitHub に接続すると、エラー "Agent admitted failure to sign using the key" が発生します。 この問題を解決するには以下の手順に従ってください。

エラー: ssh-add: 違法オプション -- apple-use-keychain

このエラーは、ssh-add のバージョンが、パスフレーズをキーチェーンに保存できる、macOS のキーチェーン統合をサポートしていないことを意味しています。

Error: SSL certificate problem, verify that the CA cert is OK

このエラーは、CA ルート証明書の期限が切れていることを示しています。 CA ルート証明書を更新する必要がある場合は、GitHub リポジトリからプッシュまたはプルすることはできません。

エラー: 不明なキーの種類

このエラーは、使用した SSH キーの種類が認識されないか、SSH クライアントでサポートされていないことを意味します。

Error: We're doing an SSH key audit

このエラーは、Git 操作のために使用中の SSH キーが未検証であることを意味します。