GitHub 私有仓库服务器 SSH 密钥部署指南

git clone https://username:[email protected]/XXXX/XXX.git

🚀 三、完整操作指南（以当前服务器为例）

假设你要在一台名为 star-server 的机器上部署 XXXXXX 项目

步骤 1：生成服务器专属 SSH 密钥

# 登录到目标服务器后执行（建议用普通用户，非 root）
ssh-keygen -t ed25519 -C "star-server-deploy" -f ~/.ssh/id_ed25519_github_XXXXXX
# 一路回车（不设置密码，便于自动化）

💡 使用 -f 指定文件名，避免覆盖默认密钥；-C 添加注释便于识别。

步骤 2：将公钥添加到 GitHub

cat ~/.ssh/id_ed25519_github_XXXXXX.pub

复制输出内容，然后：

1. 打开 GitHub 仓库：https://github.com/XXXXX/XXXXXX
2. 进入 Settings → Deploy keys → Add deploy key
3. Title: star-server（自定义，用于区分）
4. Key: 粘贴刚才复制的公钥内容

✅ Allow write access（如果你后续需要 git pull 或 git push）

⚠️ 注意：Deploy Key 默认只有读权限，勾选 'Allow write access' 才能推送。

步骤 3：配置 SSH 客户端

nano ~/.ssh/config

添加以下内容：

Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_github_rankground
    IdentitiesOnly yes
    PreferredAuthentications publickey

保存退出（Ctrl+O → Enter → Ctrl+X）

✨ IdentitiesOnly yes 确保 SSH 只使用指定密钥，避免其他密钥干扰。

步骤 4：设置严格文件权限（关键！）

SSH 对权限非常敏感，错误的权限会导致认证失败：

chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519_github_rankground # 私钥必须仅 owner 可读写
chmod 644 ~/.ssh/id_ed25519_github_rankground.pub # 公钥可读
chmod 600 ~/.ssh/config

步骤 5：测试 SSH 连接

ssh -T [email protected]

成功时会显示：

Hi XXXXXXX! You've successfully authenticated, but GitHub does not provide shell access.

✅ 认证通过！

步骤 6：克隆项目（终于成功！）

git clone [email protected]:XXXXXX/XXXXX.git

从此，这台服务器可以自由拉取（甚至推送）代码，无需密码、token 或交互。

💡 四、多服务器管理技巧

假设你有 5 台服务器：web-01, web-02, worker-a, worker-b, staging

✅ GitHub 支持一个仓库绑定大量 Deploy Key（实测 >50 个无压力）

优势一览：

• 独立认证：每台服务器拥有唯一身份
• 快速吊销：某台机器泄露？只需在 GitHub 删除对应 key，其他服务器不受影响
• 无 token 管理负担：无需轮换、无需担心过期
• 权限精细：每个 key 可单独控制读/写权限

🧠 总结：安全部署的核心原则

'每台服务器，一把钥匙；一个仓库，多个入口。'

通过为每台服务器生成独立 SSH 密钥并绑定为 GitHub Deploy Key，你不仅解决了 Git 认证问题，更构建了一个安全、可审计、易维护的部署体系。

这不仅是技术选择，更是工程素养的体现。

🔗 延伸阅读

• GitHub 官方文档：Deploy Keys
• SSH 密钥最佳实践（OpenSSH）