把本地 Git 生成的 SSH 公钥追加到服务器目标用户的 ~/.ssh/authorized_keys,权限设成 .ssh 为 700、authorized_keys 为 600,再用 ssh 验证,就能完成免密登录和代码拉取。 公钥可以公开,私钥必须留在本地,别把两者弄反。
git怎么把公钥添加到服务器:先分清三种场景
很多人一上来就复制公钥,结果贴错位置,公钥登录的核心不是“复制粘贴”,而是“哪个用户、哪个目录、哪个文件”,据 OpenSSH 官方文档,公钥认证默认读取目标用户家目录下的 ~/.ssh/authorized_keys,所以你先要确认:是让本地电脑登录服务器,还是让服务器去拉 GitHub 代码,还是用云控制台导入密钥对。
本地Git公钥与服务器登录公钥是一回事吗
是同一套 SSH 密钥机制,但用途不同。
- 本地生成一对密钥:
id_ed25519是私钥,id_ed25519.pub是公钥。 - 把公钥追加到服务器用户目录:用于本地免密登录服务器。
- 把公钥添加到 GitHub 账户:用于本地向 GitHub 推代码。
- 把服务器公钥添加到 GitHub Deploy keys:用于服务器拉取私有仓库。
常见误操作是把本地公钥贴到 GitHub,却想登录服务器;或者把服务器公钥贴到本地 authorized_keys,方向错了,命令再对也不会生效。
三种场景对照表
| 场景 | 公钥放哪里 | 私钥放哪里 | 验证方式 |
|---|---|---|---|
| 本地登录 Linux 服务器 | 服务器目标用户的 ~/.ssh/authorized_keys |
本地 ~/.ssh/ |
ssh user@服务器IP |
| 本地向 GitHub 推代码 | GitHub 账户 Settings 里的 SSH keys | 本地 ~/.ssh/ |
ssh -T git@github.com |
| 服务器拉私有仓库 | GitHub 仓库 Settings 里的 Deploy keys | 服务器 ~/.ssh/ |
在服务器执行 ssh -T git@github.com |
| 云控制台密钥对 | 云平台密钥对绑定实例 | 本地保存下载的私钥 | 用控制台指定用户名登录 |
从生成到生效:git公钥添加到服务器完整命令
先别急着改 SSH 配置,多数情况下,公钥登录不生效,问题集中在用户路径和文件权限,业内专家指出,公钥排错应先看“是不是目标用户”,再看“目录权限对不对”,最后才看 sshd_config。
Windows下git公钥添加到Linux服务器步骤
Windows 用户建议用 Git Bash 操作,路径和 Linux 更接近。
- 打开 Git Bash,生成密钥:
ssh-keygen -t ed25519 -C "you@example.com"- 一路回车可生成默认文件;已有密钥就别覆盖。
- 查看公钥内容:
cat ~/.ssh/id_ed25519.pub- 文件实际位置通常在
C:\Users\你的用户名\.ssh\id_ed25519.pub。
- 复制整行公钥,它以
ssh-ed25519开头,以邮箱注释结尾。 - 登录服务器,创建目录并设置权限:
mkdir -p ~/.sshchmod 700 ~/.ssh
- 把公钥追加进文件:
nano ~/.ssh/authorized_keys- 粘贴公钥,保存退出;已有内容不要删,另起一行追加。
- 设置文件权限:
chmod 600 ~/.ssh/authorized_keys
- 回到本地测试:
ssh user@服务器IP- 自定义端口用
ssh -p 2222 user@服务器IP。
Git Bash 支持 ssh-copy-id,可以少走手动步骤:
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@服务器IP- 非 22 端口:
ssh-copy-id -i ~/.ssh/id_ed25519.pub -p 2222 user@服务器IP
Linux和macOS用一条命令追加公钥
本机是 Linux 或 macOS 时,ssh-copy-id 最省事,它会把公钥追加到远端用户的 authorized_keys,并尽量修正权限。
- 普通用户:
ssh-copy-id -i ~/.ssh/id_ed25519.pub user@服务器IP - root 用户:
ssh-copy-id -i ~/.ssh/id_ed25519.pub root@服务器IP - 指定端口:
ssh-copy-id -i ~/.ssh/id_ed25519.pub -p 2222 user@服务器IP
不想用 ssh-copy-id,可以手动管道追加:
cat ~/.ssh/id_ed25519.pub | ssh user@服务器IP "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"
这条命令的关键是 >>,它代表追加,用 > 会覆盖原有公钥,多人共用一个账号时容易出事。
简米云服务器git公钥配置要收费吗
围绕云服务器操作时,地域和计费问题经常被一起问,以简米云 ECS 为例,常见路径是控制台进入“密钥对”,创建或导入密钥对,再绑定实例,按提示重启生效,酷番云、华为云也有类似入口,菜单名称可能随控制台版本变化。
- SSH 公钥本身不收费,它是 OpenSSH 的标准能力。
- 云厂商的密钥对管理功能通常不单独收费,收费的是云服务器实例、带宽、云盘等资源。
- 控制台导入公钥时,注意选择登录用户名,Linux 常见为
root或创建实例时设置的用户。 - 已有实例绑定密钥对后,是否需要重启以控制台提示为准。
git公钥添加到服务器失败怎么办
先看报错。Permission denied (publickey) 最常见,但原因不止一个,别急着重装 SSH,按下面顺序查更快。
权限与路径排错清单
- 确认登录用户:
whoami,公钥要放进这个用户的家目录,不是别的用户。 - 确认文件存在:
ls -la ~/.ssh。 - 目录权限:
chmod 700 ~/.ssh。 - 文件权限:
chmod 600 ~/.ssh/authorized_keys。 - 家目录权限别放开过头,常见要求是用户家目录不能被其他用户随意写。
- 公钥要完整一行,不能断行,不能只复制一半。
- 多个公钥时每行一个,注释只是给人看的。
- 服务器启用了 SELinux 时,可检查安全上下文,必要时执行
restorecon -R -v ~/.ssh。 - 查看 SSH 服务配置:
PubkeyAuthentication yes,AuthorizedKeysFile .ssh/authorized_keys。 - 改完配置后重启服务:
systemctl restart sshd或systemctl restart ssh,以系统实际服务名为准。 - 看日志:
/var/log/secure、/var/log/auth.log或journalctl -u sshd。
本地多密钥时怎么指定
本地既有 GitHub 密钥,又有服务器密钥,SSH 可能拿错私钥,可以临时指定:
ssh -i ~/.ssh/id_ed25519_server user@服务器IP- 调试加
-v:ssh -v -i ~/.ssh/id_ed25519_server user@服务器IP
推 GitHub 报错时,用 ssh -T git@github.com 验证,行业共识认为,把公钥认证用于自动化拉取代码,比在脚本里写密码更稳妥,也更适合持续集成环境。
GitHub公钥和服务器公钥区别:别把入口贴反
两个“公钥位置”各管什么
| 对比项 | GitHub 账户公钥 | 服务器 authorized_keys |
|---|---|---|
| 作用 | 本地电脑向 GitHub 认证 | 本地电脑登录服务器 |
| 配置入口 | GitHub Settings → SSH and GPG keys | 服务器 ~/.ssh/authorized_keys |
| 私钥位置 | 本地电脑 | 本地电脑 |
| 常见误用 | 把服务器公钥贴到个人账户 | 把 GitHub 公钥贴到错误用户目录 |
如果服务器要从私有仓库拉代码,正确做法是在服务器上生成密钥,把服务器公钥添加到 GitHub 仓库的 Deploy keys,这样服务器持有私钥,GitHub 只保存公钥。
到这里,主线操作已经闭环:生成密钥、把公钥追加到正确用户的 authorized_keys、修好 700 和 600 权限、用 ssh 验证,换一台机器时,重复“生成、追加、验证”三步即可,不需要改 Git 仓库地址。
git公钥添加到服务器Q&A
SSH公钥登录要收费吗
不收费,公钥认证是 OpenSSH 自带能力,GitHub 添加公钥也不收费,云服务器场景中,可能产生费用的是实例、带宽和存储,密钥对管理通常不单独计费。
添加公钥后仍提示Permission denied (publickey)怎么办
先确认登录用户是否与公钥存放用户一致,再查 ~/.ssh 是否为 700、authorized_keys 是否为 600,随后用 ssh -v user@服务器IP 看客户端到底提交了哪把私钥,服务端再看 sshd_config 是否开启公钥认证,以及日志里拒绝的原因。
一台服务器可以放多个Git公钥吗
可以。authorized_keys 支持每行一个公钥,多个开发者或同一人的多台设备都能追加,追加时用 >>,不要覆盖原文件,OpenSSH 会按文件中的公钥逐条匹配,公钥末尾的注释不参与认证。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/798764.html


