本文介绍 Git SSH 密钥的配置方法。首先阐述使用 SSH 密钥替代密码认证的优势，包括免密登录、安全验证及多平台兼容。接着提供全系统适配的详细步骤，涵盖检查现有密钥、生成新密钥（推荐 ED25519）、启动 SSH 代理、添加密钥到代理以及绑定公钥到 GitHub 的具体命令操作。此外，还包含多账号管理技巧、开机自动启动代理设置、常见问题排查表及最佳实践建议，帮助用户高效安全地管理 Git 远程仓库连接。
在使用 Git 与 GitHub 交互时，SSH 密钥是替代账号密码认证的更优方案，核心优势如下：
前置条件：已安装 Git（可通过终端执行 验证），并拥有 GitHub 账号。
git --version首先检查本地是否已存在 SSH 密钥，避免重复生成。
# macOS/Linux 系统（终端执行）
ls -al ~/.ssh
# Windows 系统（PowerShell/CMD 执行）
dir %USERPROFILE%\.ssh
执行后若出现以下文件，说明已存在对应算法的密钥，可直接跳过生成步骤，进入启动代理环节；若无则需生成新密钥。
id_rsa.pub：RSA 算法公钥（兼容性强，适用于旧系统）。id_ed25519.pub：ED25519 算法公钥（推荐，加密强度更高、性能更优）。authorized_keys：已授权的公钥列表，用于本地认证管理。优先选择 ED25519 算法，若需兼容老旧服务器或设备，可改用 RSA 算法（4096 位及以上，安全性达标）。
# 推荐：ED25519 算法（替换为你的 GitHub 绑定邮箱）
ssh-keygen -t ed25519 -C "[email protected]"
# 兼容旧系统：RSA 算法（4096 位，加密强度足够）
ssh-keygen -t rsa -b 4096 -C "[email protected]"
执行命令后将进入交互流程，按以下提示操作：
~/.ssh/id_ed25519 或 ~/.ssh/id_rsa），无需自定义，避免后续配置路径混乱。SSH 代理用于管理本地私钥，避免每次操作都需重新验证私钥，需手动启动（部分系统默认不自动启动）。
# macOS/Linux 系统（终端执行，启动并绑定环境变量）
eval "$(ssh-agent -s)"
# Windows 系统（PowerShell 以普通权限执行）
Start-Service ssh-agent
启动成功提示：macOS/Linux 会显示代理进程 ID；Windows 无明显提示，可通过 Get-Service ssh-agent 查看服务状态，确保 Status 为'Running'。
将生成的私钥添加到 SSH 代理，完成后代理会自动管理私钥认证流程。
# ED25519 算法（默认路径）
ssh-add ~/.ssh/id_ed25519
# RSA 算法（默认路径）
ssh-add ~/.ssh/id_rsa
# 若自定义了密钥保存路径，需指定完整路径
ssh-add /path/to/your/private_key
关键权限设置：为避免私钥被非法访问，需限制文件权限（仅所有者可读写），执行以下命令： chmod 600 ~/.ssh/id_ed25519（ED25519 算法）或 chmod 600 ~/.ssh/id_rsa（RSA 算法），Windows 系统无需额外设置。
需先复制本地公钥内容，再在 GitHub 平台添加配置，完成双向认证绑定。
# macOS 系统（直接复制到剪贴板）
pbcopy < ~/.ssh/id_ed25519.pub
# Linux 系统（需先安装 xclip，若未安装执行：sudo apt install xclip）
xclip -sel clip < ~/.ssh/id_ed25519.pub
# Windows 系统（PowerShell 执行，复制到剪贴板）
Get-Content ~/.ssh/id_ed25519.pub | Set-Clipboard
备用方案：若上述命令失效，可手动打开公钥文件复制内容。macOS/Linux 执行 cat ~/.ssh/id_ed25519.pub，Windows 直接打开 C:\Users\你的用户名\.ssh\id_ed25519.pub，复制完整内容（从 ssh-ed25519 开头到邮箱结尾，不可遗漏或多复制空格）。
配置完成后，通过命令验证是否能成功与 GitHub 建立 SSH 连接。
# GitHub 验证命令（通用，无需修改）
ssh -T [email protected]
# 若需验证 GitLab，执行以下命令
ssh -T [email protected]
首次连接会提示'是否确认连接'，输入「yes」并回车即可。
成功提示：Hi username! You've successfully authenticated, but GitHub does not provide shell access.（username 为你的 GitHub 用户名），说明配置生效。
若同时使用 GitHub、GitLab，或拥有多个 GitHub 账号（个人 + 工作），需生成独立密钥对并配置，避免认证冲突。
# 个人 GitHub 账号（默认密钥）
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519
PreferredAuthentications publickey
# 工作 GitHub 账号（独立密钥）
Host work.github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519_work
PreferredAuthentications publickey
# GitLab 账号（独立密钥）
Host gitlab.com
HostName gitlab.com
User git
IdentityFile ~/.ssh/id_ed25519_gitlab
PreferredAuthentications publickey
使用方法：克隆工作账号仓库时，将地址中的 github.com 替换为 work.github.com，如 git clone [email protected]:company/repo.git。
sudo systemctl enable ssh-agent，重启后生效；若为 macOS，也可通过「系统设置 - 用户与群组 - 登录项」添加终端脚本实现。Set-Service -Name ssh-agent -StartupType 'Automatic'，后续开机将自动启动代理服务。| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| Permission denied（权限拒绝） | 私钥文件权限过高，被 SSH 协议拦截；或密钥路径错误 | 执行 chmod 600 ~/.ssh/id_ed25519 重置权限；确认密钥路径与配置一致 |
| Agent admitted failure（代理认证失败） | SSH 代理未启动，或密钥未添加到代理 | 重新执行 eval "$(ssh-agent -s)"（macOS/Linux）或 Start-Service ssh-agent（Windows），再重新添加密钥 |
| Could not resolve hostname（无法解析主机） | 网络故障、DNS 配置错误，或 config 文件 HostName 写错 | 检查网络连接；切换 DNS 为 8.8.8.8；验证 config 文件中 HostName 是否正确；执行 ssh -vT [email protected] 查看详细日志排查 |
| Host key verification failed（主机密钥验证失败） | 本地缓存的 GitHub 主机密钥失效或被篡改 | 删除缓存文件：macOS/Linux 执行 rm ~/.ssh/known_hosts，Windows 删除 C:\Users\你的用户名\.ssh\known_hosts，重新执行验证命令并确认连接 |
~/.ssh/sshd_config 配置禁用密码认证，仅允许 SSH 密钥登录，修改后重启 SSH 服务（sudo systemctl restart sshd）生效。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online