1. 生成新 SSH 金鑰
ssh-keygen -t ed25519 -C "[email protected]"
執行後會出現提示：
Enter file in which to save the key: 直接回車使用預設名稱 id_ed25519Enter passphrase: 建議設置密碼以增加安全性(也可以直接回車跳過)Enter same passphrase again: 再次輸入密碼確認
提示: 如果你使用的是舊系統不支援 ed25519,可以使用 ssh-keygen -t rsa -b 4096 -C "[email protected]" 替代。
2. 設置正確的檔案權限(重要!)
SSH 對檔案權限要求嚴格,否則金鑰可能被忽略:
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pub
3. 將 SSH 金鑰新增到 ssh-agent
macOS 用戶
# 啟動 ssh-agent
eval "$(ssh-agent -s)"
# 編輯或創建 config 檔案,實現自動載入
vi ~/.ssh/config
按 i 進入編輯模式,加入以下內容:
Host *
AddKeysToAgent yes
UseKeychain yes
IdentityFile ~/.ssh/id_ed25519
按 esc 然後輸入 :wq 儲存退出。
# 新增金鑰到 ssh-agent
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
Linux 用戶
# 啟動 ssh-agent
eval "$(ssh-agent -s)"
# 新增金鑰
ssh-add ~/.ssh/id_ed25519
Windows 用戶(Git Bash)
# 啟動 ssh-agent
eval "$(ssh-agent -s)"
# 新增金鑰
ssh-add ~/.ssh/id_ed25519
4. 複製公鑰到剪貼簿
macOS
pbcopy < ~/.ssh/id_ed25519.pub
Linux
# 使用 xclip(需先安裝: sudo apt install xclip)
xclip -selection clipboard < ~/.ssh/id_ed25519.pub
# 或直接顯示並手動複製
cat ~/.ssh/id_ed25519.pub
Windows(Git Bash)
clip < ~/.ssh/id_ed25519.pub
5. 將公鑰新增到 GitHub
- 登入 GitHub
- 點擊右上角頭像 → Settings
- 左側選單選擇 SSH and GPG keys
- 點擊 New SSH key
- Title: 輸入這個金鑰的描述(例如: "My Laptop")
- Key: 貼上剛才複製的公鑰
- 點擊 Add SSH key
6. 配置多個 Git 服務(選用)
如果你使用多個 Git 託管服務或多個帳號,可以編輯 ~/.ssh/config:
vi ~/.ssh/config
按 i 進入編輯模式,加入配置:
# GitHub 個人帳號
Host github.com
HostName github.com
User git
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_ed25519
# GitHub 工作帳號
Host github-work
HostName github.com
User git
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_ed25519_work
# Bitbucket
Host bitbucket.org
HostName bitbucket.org
User git
PreferredAuthentications publickey
IdentityFile ~/.ssh/bitbucket_id_ed25519
# GitLab
Host gitlab.com
HostName gitlab.com
User git
PreferredAuthentications publickey
IdentityFile ~/.ssh/gitlab_id_ed25519
按 esc 然後輸入 :wq 儲存。
使用工作帳號時:
git clone git@github-work:company/repo.git
7. 測試連接
GitHub
ssh -T [email protected]
成功的回應:
Hi <username>! You've successfully authenticated, but GitHub does not provide shell access.
Bitbucket
ssh -T [email protected]
GitLab
ssh -T [email protected]
常見問題排解
❌ Permission denied (publickey)
可能原因:
- 公鑰沒有正確新增到 GitHub
- 檔案權限不正確
- ssh-agent 沒有載入金鑰
解決方法:
# 檢查權限
ls -la ~/.ssh
# 確認金鑰已載入
ssh-add -l
# 如果沒有,重新新增
ssh-add ~/.ssh/id_ed25519
# 詳細除錯模式
ssh -vT [email protected]
❌ 首次連接提示無法確認主機真實性
The authenticity of host 'github.com' can't be established.
ED25519 key fingerprint is SHA256:xxx...
Are you sure you want to continue connecting (yes/no/[fingerprint])?
輸入 yes 並按回車(注意要完整輸入 yes,不能只按回車)。
❌ ssh-add 後重啟電腦金鑰消失
參考步驟 3 的 config 配置,確保已加入 AddKeysToAgent yes。
❌ 設定正確的檔案權限
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pub
chmod 600 ~/.ssh/config
安全提示
- 永遠不要分享你的私鑰 (
id_ed25519)
- 建議為私鑰設置 passphrase 增加安全性
- 定期輪換金鑰 每年或離職時更新
- 刪除不用的金鑰 在 GitHub Settings 中移除舊裝置的金鑰
- 備份私鑰 但要加密存放在安全的地方
將現有專案改用 SSH
如果你的專案目前使用 HTTPS,可以切換到 SSH:
# 查看當前遠端 URL
git remote -v
# 更改為 SSH URL
git remote set-url origin [email protected]:username/repo.git
# 確認更改
git remote -v
祝程式設計愉悅! 🚀
如果遇到問題,可以使用 ssh -vvv [email protected] 查看詳細除錯資訊。
Select Language