建立 2024-01-01 更新 2026-09-15

SSH 連線

SSH 用一對金鑰證明「這台電腦是我的」，之後 git clone／git push 不必每次貼密碼或 PAT。一台電腦一個 GitHub 帳號時，照這頁做即可；多帳號見 單電腦使用多個帳戶。

官方步驟：Connecting to GitHub with SSH。

產生金鑰

現在建議 ed25519：

ssh-keygen -t ed25519 -C "你的Email"

舊環境沒有 ed25519 再用：

ssh-keygen -t rsa -b 4096 -C "你的Email"

一路 Enter 可用預設路徑。會得到私鑰（不要分享）與 .pub 公鑰。

加入 ssh-agent

若金鑰有 passphrase，啟動 agent 並加入私鑰：

eval $(ssh-agent -s)
ssh-add ~/.ssh/id_ed25519

（RSA 則是 id_rsa。）

把公鑰加到 GitHub

1. 複製公鑰：cat ~/.ssh/id_ed25519.pub（macOS 可用 pbcopy < ~/.ssh/id_ed25519.pub）。
2. 打開 GitHub SSH keys → New SSH Key → 貼上 → 儲存。

GitLab 則在 User Settings → SSH Keys。

測試

ssh -T git@github.com

成功會看到 Hi <your-username>! You've successfully authenticated.

之後 clone 請用 SSH 網址：

git clone git@github.com:username/repo.git

已存在的 HTTPS 遠端可改：

git remote set-url origin git@github.com:username/repo.git