Coding (騰訊雲開發平台) SSH Key 配置與倉庫連接新手全攻略

Coding (騰訊雲開發平台) SSH Key 配置與倉庫連接新手全攻略

Coding (現騰訊雲 CodeCC/COER) 是國內主流 Git 代碼託管平台。本文面向零基礎新手，從 Git 安裝、SSH Key 生成、公鑰配置、連接驗證、常見報錯全流程圖文級指引。

前置準備

• 註冊 Coding 賬號，創建項目 (獲取 SSH 地址：git@e.coding.net:team/project.git)
• 安裝 Git for Windows (含 Git Bash)

步驟 1：配置 Git 全局用戶信息

git config --global user.name "你的姓名/暱稱"
git config --global user.email "你的郵箱@domain.com"

# 驗證
cat ~/.gitconfig
# 輸出應包含 [user] name/email

步驟 2：生成 SSH Key 對

# Git Bash 中執行
ssh-keygen -t ed25519 -C "你的郵箱@domain.com"
# 或兼容性更好：ssh-keygen -t rsa -b 4096 -C "你的郵箱@domain.com"

# 交互提示：
# Enter file in which to save the key (~/.ssh/id_ed25519):  # 直接回車用默認路徑
# Enter passphrase (empty for no passphrase):  # 可設置密碼短語，建議設置
# Enter same passphrase again:  # 確認

# 生成結果：
# ~/.ssh/id_ed25519 (私鑰，絕不可外洩)
# ~/.ssh/id_ed25519.pub (公鑰，需上傳到 Coding)

步驟 3：將公鑰添加到 Coding

1. 打開 ~/.ssh/id_ed25519.pub，複製全部內容 (以 ssh-ed25519 開頭，郵箱結尾)
2. 登錄 Coding Web 控制台 → 右上角頭像 → 個人設置 → SSH 公鑰 → 新增公鑰
3. 粘貼公鑰內容，備註名稱 (如 "公司筆記本")，確定

步驟 4：驗證 SSH 連接

ssh -T git@e.coding.net

# 首次連接提示：
# The authenticity of host 'e.coding.net' can't be established.
# ECDSA key fingerprint is SHA256:xxx.
# Are you sure you want to continue connecting (yes/no)?  # 輸入 yes

# 成功標誌：
# Hi 用戶名! You've successfully authenticated, but Coding does not provide shell access.

步驟 5：克隆/推送驗證完整流程

# 克隆項目
git clone git@e.coding.net:team/project.git
cd project

# 創建提交推送
echo "# README" > README.md
git add .
git commit -m "init"
git push origin master

常見報錯速查表

進階配置：多賬號/多平台 SSH 管理

# ~/.ssh/config
Host coding-work
    HostName e.coding.net
    User git
    IdentityFile ~/.ssh/id_ed25519_work
    IdentitiesOnly yes

Host coding-personal
    HostName e.coding.net
    User git
    IdentityFile ~/.ssh/id_ed25519_personal
    IdentitiesOnly yes

# 使用：git clone git@coding-work:team/project.git

安全最佳實踐

• 私鑰設置強 Passphrase，配合 ssh-agent 緩存解密
• 定期輪換 Key (建議 90 天)，舊 Key 及時撤銷
• 不同環境 (公司/個人/服務器) 使用獨立 Key 對
• 啟用 Coding 部署公鑰 (只讀) 替代個人公鑰用於 CI/CD

完成以上步驟，你已掌握 Coding SSH 協議全鏈路配置，可高效進行代碼託管、Code Review、CI/CD 集成等日常研發協作。