git配置多个SSH Key的方法【详解】

酷雪大大_3834

酷雪大大_3834

2026-04-11

268人浏览

原创

必须清空全局 user.name 和 user.email,因为 git 提交时优先使用全局配置,若未为仓库单独配置,易导致身份混淆、跨域提交,甚至触发企业安全审计告警;清空后需为每个仓库手动配置。

git配置多个ssh key的方法【详解】

全局 user.name 和 user.email 必须清空,否则所有仓库默认用它提交,轻则身份混淆,重则触发企业安全审计告警。

为什么必须 unset 全局 user.name 和 user.email

Git 提交时作者信息优先读取全局配置。一旦设了全局值,哪怕你为某个仓库单独执行了 git config user.name "xxx",只要某次 clone 后忘了配、或脚本漏掉这步,就会误推成公司账号到个人仓库(或反过来)。同事看到提交记录里“张三”改了“李四”的私有项目,第一反应是权限出问题;更严重的是,某些企业 CI/CD 或审计系统会直接拦截这类跨域提交。

执行这两条命令彻底清除:

git config --global --unset user.name<br>git config --global --unset user.email

验证是否清空:git config --global --list 输出里不应再出现 user.name 或 user.email。之后每个仓库都得手动运行 git config user.name "xxx" 和 git config user.email "xxx"。

生成密钥时必须用 -f 指定文件名,别碰 id_rsa

Windows 下 Git Bash 默认只认 ~/.ssh/id_rsa 或 ~/.ssh/id_ed25519;macOS/Linux 也倾向默认路径。如果你先为 GitHub 生成一次 ssh-keygen -t ed25519 -C "me@github.com"(没加 -f),再为 Gitee 又跑一遍,第二次会直接覆盖第一次的私钥——结果就是两个平台共用一把钥匙,但服务器只认各自绑定的公钥,必然有一个连不上。

Git Factory
Git Factory

为每个编码任务配置并管理独立的 Git worktree,支持并行分支和清晰的 PR 工作流,避免合并冲突。

下载
  • 正确做法:每次生成都用 -f 显式指定路径,例如 ssh-keygen -t ed25519 -C "me@github.com" -f ~/.ssh/id_ed25519_github
  • 推荐统一用 ed25519 算法(比 rsa 更快更安全),除非你要连老旧 GitLab 实例(部分 12.x 以下版本不支持)
  • 密码(passphrase)可跳过(连续回车),但若在共享电脑上,建议设一个

~/.ssh/config 里的 Host 必须是别名,不能是域名

很多人写 Host github.com,以为这样 git@github.com:me/repo.git 就能自动走对应密钥——错了。SSH 匹配的是 URL 中 @ 后面的部分,而 git@github.com 的主机名确实是 github.com,但问题在于:如果你有两个 GitHub 账号,它们都指向同一个域名,光靠 Host github.com 无法区分路由。

正确写法是定义别名,例如:

# GitHub 个人账号<br>Host github-personal<br>  HostName github.com<br>  User git<br>  IdentityFile ~/.ssh/id_ed25519_github<br><br># GitHub 工作账号<br>Host github-work<br>  HostName github.com<br>  User git<br>  IdentityFile ~/.ssh/id_ed25519_work

克隆时必须用别名:git clone git@github-personal:me/repo.git;已有仓库改 remote:git remote set-url origin git@github-work:org/repo.git。

测试连接失败?先跑 ssh -T,别猜

ssh -T git@github-personal 这类命令不是“走个过场”,它是唯一能快速定位 SSH 层问题的手段。常见错误和对应动作:

  • Permission denied (publickey):私钥没加进 agent(ssh-add ~/.ssh/id_ed25519_github),或 config 里 IdentityFile 路径写错(注意路径是否带空格、是否用了 ~ 符号,某些终端不展开)
  • Could not resolve hostname github-personal:config 文件格式错(比如少了换行、多了不可见字符)、或文件没保存在 ~/.ssh/config(注意权限应为 600)
  • 连接成功但提示 Hi xxx! You've successfully authenticated, but GitHub does not provide shell access.:说明 SSH 层通了,问题一定出在 Git 配置或 remote URL 上

最容易被忽略的是:Windows 用户若用 CMD/PowerShell 而非 Git Bash,ssh-agent 不自动启动,ssh-add 无效;必须用 Git Bash 或 WSL 才能正常加载 config 和密钥。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

git

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

2026.01.21

8485

27

GitHub官网入口版本汇总
GitHub官网入口版本汇总

本专题整合了GitHub入口版本地址汇总,阅读专题下面的文章了解更多详细内容。

2026.04.02

858

19

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

2023.07.05

6079

9

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

2023.07.06

1780

6

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

2023.07.24

1034

5

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

3957

7

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

3681

6

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.26

3199

3

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.27

2758

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 8万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.9万人学习