Linux怎么配置Git多用户密钥 Linux下不同平台SSH Key管理详解-LINUX-PHP中文网

git本身不管理ssh密钥，多账号本质靠~/.ssh/config按host路由不同私钥：为各平台（如github.com、gitlab.com）或同一域名下不同账号（如github-personal/github-work）分别配置唯一host块、绝对路径identityfile，并确保remote url与host名完全匹配。

linux怎么配置git多用户密钥 linux下不同平台ssh key管理详解

ssh-keygen 生成的密钥默认只绑定一个用户身份，但 Git 本身不管理 SSH 密钥——它完全依赖底层 SSH 客户端行为。所以“多用户”本质是让不同 Git 域名（如 github.com、gitlab.com、gitee.com）或同一域名下不同账号（如公司和个人 GitHub 账号）走不同的私钥，这靠的是 ~/.ssh/config 文件路由控制，不是 Git 配置。

为什么直接用默认密钥会冲突

当你执行 git clone git@github.com:user1/repo.git，SSH 默认尝试用 ~/.ssh/id_rsa 登录；如果同时还要访问 git@gitlab.com:user2/project，而两个账户不能共用同一把私钥（比如企业 GitLab 强制要求独立密钥），就会认证失败或误登错账号。
根本原因：SSH 不看 Git URL 用户名，只看 Host 名和配置的 IdentityFile。

`~/.ssh/config` 是核心路由开关

这个文件决定了「连哪个 Host 时用哪把私钥」，必须手动创建并严格设置权限：
chmod 600 ~/.ssh/config

常见写法示例：

Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_rsa_github
<p>Host gitlab.com
HostName gitlab.com
User git
IdentityFile ~/.ssh/id_rsa_gitlab</p><p>Host gitee.com
HostName gitee.com
User git
IdentityFile ~/.ssh/id_rsa_gitee</p>

注意：Host 行写的是你在 git remote 里用的主机别名（如 git@github.com 中的 github.com），不是 IP 或完整 URL。

关键点：

每个 Host 块必须唯一，不能重复；
IdentityFile 路径必须绝对，不能用 ~，推荐写成 /home/username/.ssh/xxx；
如果某台服务器用了非标端口（如 2222），加一行 Port 2222；
不要在 config 里写 StrictHostKeyChecking no 这类弱安全配置。

生成多个密钥要带 -f 指定路径

别反复覆盖 id_rsa。每次生成新密钥都用 -f 显式指定文件名：

ssh-keygen -t ed25519 -C "personal@github.com" -f ~/.ssh/id_ed25519_github_personal
ssh-keygen -t ed25519 -C "work@gitlab.com" -f ~/.ssh/id_ed25519_gitlab_work

生成后立刻用 ssh-add 加载（尤其 macOS/Linux 桌面环境）：

GitCode API Usage

简单易用的 GitCode API SKILL，提供 CLI 和轻量级 Python SDK 两种调用方式，用于与 GitCode 的 REST API 进行交互。支持加密访问令牌、异步调用以及完善的类型提示。 - 文档：https://gitcode-api.readthedocs.io/ - PyPI 页面：https://pypi.org/project/gitcode-api - GitHub 仓库：https://github.com/Trenza1ore/GitCode-API

下载

ssh-add ~/.ssh/id_ed25519_github_personal
ssh-add ~/.ssh/id_ed25519_gitlab_work

验证是否加载成功：
ssh-add -l 列出所有已加载密钥指纹；
ssh-add -D 清空（调试时常用）。

容易踩的坑：

Windows WSL 下 ssh-agent 默认不自动启动，需手动运行 eval $(ssh-agent)；
终端新开 tab 后 ssh-add 加载的密钥不会自动继承，得重新 ssh-add 或配 shell 启动脚本；
用 ed25519 算法比 rsa 更快更安全，但老系统（如 CentOS 7 默认 OpenSSH 6.6）不支持，得降级用 -t rsa -b 4096。

Git remote URL 必须匹配 config 的 Host 名

这是最容易忽略的一环。你写了 Host github.com，但 remote 地址却是 git@github.com:org/repo.git —— 没问题；可如果写成 git@github.com:org/repo.git 却在 config 里配了 Host github（少了个 .com），SSH 就找不到对应块，回落到默认密钥，导致认证失败。

检查当前 remote 是否匹配：

git remote get-url origin
# 输出应为 git@github.com:user/repo.git，不是 https://...

修正方式：

用 git remote set-url origin git@github.com:user/repo.git 强制切回 SSH 协议；
确保 git remote -v 显示的 host 名与 ~/.ssh/config 中的 Host 完全一致（包括大小写、点、连字符）；
测试路由是否生效：ssh -T git@github.com 应输出 “Hi user! You've successfully authenticated...”，且用的是你预期的密钥。

复杂点在于：有些平台（如 Gitee）允许同一域名下多个账号，此时仅靠 Host 匹配不够，得用别名机制，例如：

Host github-personal
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_github_personal
<p>Host github-work
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519_github_work</p>

然后 remote 改成 git@github-personal:user/repo.git 和 git@github-work:org/repo.git —— 这才是真正可控的多账号方案。