Troubleshoot
GitHub Actions の SSH デプロイが失敗する
最終更新: 2026-04-25
症状
Actions から VPS への SSH 接続で Permission denied (publickey)
- 鍵を Secrets に入れたが authorized_keys に反映していない
- deploy 用ユーザー が作成されていない
想定される原因
- 1
鍵のフォーマット不一致
ed25519 と rsa の混在や改行混入。
- 2
authorized_keys 未登録
Secrets に入れただけではダメ。
- 3
deploy ユーザーが sudo を持たない
deploy 後の reload で失敗。
対処手順
- ed25519 鍵を新規発行、公開鍵を deploy@vps の authorized_keys に追加
- Secrets に秘密鍵を厳密に貼る(改行 / 先頭スペース注意)
- sudoers に systemctl reload nginx / docker compose 限定で許可