相关技巧

关注公众号 jb51net

关闭
首页 > 网络编程 > 相关技巧 > GitHub SSH 全局配置

Windows 系统下 GitHub SSH 全局配置完全指南(最新推荐)

作者：YahirQ

本文提供了Windows系统下GitHub SSH全局配置的完整指南及常见问题排查,本文介绍的非常详细,感兴趣的朋友跟随小编一起看看吧

在日常开发中，通过 SSH 协议连接 GitHub 不仅能避免频繁输入密码，还能提高传输安全性。然而，很多 Windows 用户在配置 SSH 时容易遇到各种问题：密钥生成、端口被屏蔽、多账号管理混乱……本文将手把手带你完成一份“全局级”的 SSH 配置，让你在 Windows 终端下畅享无密推送。

为什么需要“全局”配置？

所谓“全局”，并不是指某个单一命令，而是指通过一系列设置，让所有 Git 操作（克隆、推送、拉取）默认使用 SSH 协议，而无需每次指定协议或密钥。实现这一目标主要依赖三部分：

完成配置后，无论是 git clone 还是 git push，系统都会自动选择正确的密钥和端口，真正做到一劳永逸。

环境与工具准备

若尚未安装 Git，可前往 Git for Windows 下载安装。

第一步：生成 SSH 密钥对

打开 PowerShell（以普通用户身份即可），执行以下命令：

ssh-keygen -t ed25519 -C "your_email@example.com"

注意：请将 your_email@example.com 替换为你的 GitHub 注册邮箱，这仅是注释标记，不影响认证。

如果系统提示 ed25519 算法不可用（多见于旧版 Windows），可改用 RSA 4096 位：

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

随后终端会提示：

生成后，~/.ssh 目录下会生成两个文件：

第二步：将公钥添加到 GitHub

复制公钥内容

在 PowerShell 中执行：

clip < ~/.ssh/id_ed25519.pub

如果 clip 命令无效，可使用：

cat ~/.ssh/id_ed25519.pub

然后手动复制屏幕输出的全部内容。

登录 GitHub 添加公钥

  1. 点击右上角头像 → Settings
  2. 左侧菜单选择 SSH and GPG keys
  3. 点击 New SSH key
  4. 添加一个描述性标题（例如 “Windows Laptop”）
  5. 将公钥内容粘贴到 Key 字段
  6. 点击 Add SSH key 保存

第三步：配置 SSH 客户端（核心）

方式一：创建 SSH 配置文件（最推荐）

创建或编辑 SSH 配置文件 C:\Users\你的用户名\.ssh\config（无任何扩展名）：

# GitHub 主账号
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
    PreferredAuthentications publickey

如果你有多个 GitHub 账号（例如个人账号和工作账号），可以为每个账号配置不同的 Host 别名：

# 个人账号
Host github-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_personal
# 工作账号
Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_work

配置项说明：

配置项作用
Host定义连接别名，后续 Git 操作使用此别名替代 git@github.com
HostName指定真实的 Git 服务器地址
User连接用户名，对于 Git 服务固定为 git
IdentityFile指向该账号对应的私钥文件路径
IdentitiesOnly yes确保 SSH 仅尝试使用此处指定的密钥

设置文件权限（在 Git Bash 中执行）：

chmod 600 ~/.ssh/config

方式二：修改 Git 全局配置（最简单）

如果你只有一个 GitHub 账号，可以使用更简单的方式：

# 设置 Git 全局使用 SSH 代替 HTTPS
git config --global url."git@github.com:".insteadOf "https://github.com/"
# 设置 SSH 命令使用你的密钥
git config --global core.sshCommand "ssh -i %USERPROFILE%\.ssh\id_ed25519"
# 验证配置
git config --global --list | findstr "insteadof|sshCommand"

优点：配置简单，一键完成
缺点：所有仓库使用同一密钥，不适合多账号场景

方式三：Windows OpenSSH 服务（最稳定）

启用 Windows 系统级的 OpenSSH 身份验证代理服务，让密钥在系统重启后自动加载：

以管理员身份打开 PowerShell，执行：

# 1. 启用 SSH-Agent 服务
Set-Service ssh-agent -StartupType Automatic
# 2. 启动服务
Start-Service ssh-agent
# 3. 添加密钥到代理
ssh-add $HOME\.ssh\id_ed25519
# 4. 检查已加载的密钥
ssh-add -l

优点：系统级服务，重启后自动加载密钥

第四步：解决 GitHub 22 端口被阻断问题

很多网络环境会屏蔽 github.com:22 端口，导致 SSH 连接失败。GitHub 提供了备用 SSH 地址：ssh.github.com，端口 443。

修改 ~/.ssh/config 文件：

# 使用 443 端口连接
Host github.com
    HostName ssh.github.com
    Port 443
    User git
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

多账号场景下同样适配：

Host github-personal
    HostName ssh.github.com
    Port 443
    User git
    IdentityFile ~/.ssh/id_ed25519_personal
    IdentitiesOnly yes
Host github-work
    HostName ssh.github.com
    Port 443
    User git
    IdentityFile ~/.ssh/id_ed25519_work
    IdentitiesOnly yes

第五步：验证配置是否成功

基础测试

测试 SSH 连接：

ssh -T git@github.com

预期输出：

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

多账号场景下，分别测试各个别名：

ssh -T git@github-personal
ssh -T git@github-work

成功输出示例：

Hi username! You've successfully authenticated

详细诊断脚本

创建诊断脚本 check_ssh.bat：

@echo off
echo ===== SSH 配置诊断工具 =====
echo.
echo [1] 检查密钥文件...
if exist "%USERPROFILE%\.ssh\id_ed25519" (
    echo ✓ 找到私钥文件
) else (
    echo ✗ 未找到私钥文件，请先生成 SSH 密钥
)
echo.
echo [2] 检查 SSH 配置文件...
if exist "%USERPROFILE%\.ssh\config" (
    type "%USERPROFILE%\.ssh\config"
    echo.
) else (
    echo ℹ 未找到 config 文件，将使用默认配置
)
echo [3] 测试 GitHub 连接...
ssh -T git@github.com 2>&1 | findstr "successfully" >nul
if %errorlevel%==0 (
    echo ✓ SSH 连接测试成功
) else (
    echo ✗ SSH 连接测试失败
    echo 请检查：1.公钥是否添加到 GitHub 2.网络连接
)
echo.
echo ===== 诊断完成 =====
pause

第六步：修改现有仓库的远程地址

如果你的仓库之前使用 HTTPS 协议，需要修改为 SSH 地址。

查看当前远程地址：

git remote -v

修改为 SSH 地址（单账号）：

git remote set-url origin git@github.com:用户名/仓库名.git

多账号场景下，使用配置的别名：

git remote set-url origin git@github-personal:用户名/仓库名.git

高级配置：多 Git 账号完整方案

1. 为每个账号生成独立的 SSH 密钥

# 个人账号
ssh-keygen -t ed25519 -C "personal@example.com" -f ~/.ssh/id_ed25519_personal
# 工作账号
ssh-keygen -t ed25519 -C "work@company.com" -f ~/.ssh/id_ed25519_work

2. 将公钥分别添加到对应的 GitHub 账号

3. 配置~/.ssh/config文件

如上文多账号配置所示。

4. 在每个项目仓库中设置独立的 Git 用户信息

进入项目目录后执行：

# 个人项目
git config user.name "Your Personal Name"
git config user.email "personal@example.com"
# 工作项目
git config user.name "Your Work Name"
git config user.email "work@company.com"

5. 克隆仓库时使用别名

# 个人仓库
git clone git@github-personal:username/personal-repo.git
# 工作仓库
git clone git@github-work:company/work-repo.git

日常使用命令速查

基本克隆命令

# 单账号
git clone git@github.com:用户名/仓库名.git
# 多账号（使用别名）
git clone git@github-personal:用户名/仓库名.git
# 带分支和重命名
git clone -b 分支名 git@github.com:用户名/仓库名.git 新目录名

密钥管理命令

# 查看已加载的密钥
ssh-add -l
# 手动添加密钥到代理
ssh-add ~/.ssh/id_ed25519
# 从代理中移除所有密钥
ssh-add -D

常见问题排查

问题 1：Permission denied (publickey)

原因：公钥未正确添加到 GitHub，或 config 文件中 IdentityFile 路径错误。

解决：

  1. 确认公钥已添加到 GitHub Settings → SSH and GPG keys
  2. 检查 ~/.ssh/config 中的 IdentityFile 路径是否正确
  3. 确认私钥文件权限正确（不应对外可读）

问题 2：Connection refused或Connection timed out

原因：22 端口被网络屏蔽。

解决：按照第四步配置使用 443 端口连接 ssh.github.com。

问题 3：每次都要输入密码

原因：SSH 代理未启用或密钥未添加到代理。

解决：按照第三步的"方式三"启用 Windows OpenSSH 服务并添加密钥。

问题 4：多账号下使用了错误的密钥

原因：config 文件中未设置 IdentitiesOnly yes，SSH 客户端尝试了其他默认密钥。

解决：在 config 文件的每个 Host 配置中添加 IdentitiesOnly yes。

总结

通过以上配置，你的 Windows 系统将实现：

这套配置方案覆盖了从单账号到多账号、从标准端口到备用端口的各种场景，真正做到了"全局配置，一劳永逸"。

到此这篇关于Windows 系统下 GitHub SSH 全局配置完全指南(最新推荐)的文章就介绍到这了,更多相关GitHub SSH 全局配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:
阅读全文