diff --git a/GitHub_SSH_故障排查.md b/GitHub_SSH_故障排查.md new file mode 100644 index 0000000..88ef8d0 --- /dev/null +++ b/GitHub_SSH_故障排查.md @@ -0,0 +1,350 @@ +# GitHub SSH 连接问题诊断与解决方案 + +## 问题现象 + +``` +Connection closed by 198.18.0.66 port 22 +fatal: Could not read from remote repository. +``` + +这个错误表明 SSH 连接被关闭，可能的原因包括： +1. SSH 密钥未正确配置 +2. SSH 密钥未添加到 GitHub +3. 网络问题或代理设置 +4. SSH 配置文件问题 + +--- + +## 诊断步骤 + +### 第 1 步：检查 SSH 密钥是否存在 + +**Windows:** +```bash +dir %USERPROFILE%\.ssh +``` + +**Linux/macOS:** +```bash +ls -la ~/.ssh +``` + +**应该看到:** +- `id_rsa` 和 `id_rsa.pub` (RSA 密钥) +- 或 `id_ed25519` 和 `id_ed25519.pub` (Ed25519 密钥，推荐) + +--- + +### 第 2 步：如果没有 SSH 密钥，生成新密钥 + +**推荐方式 (Ed25519):** +```bash +ssh-keygen -t ed25519 -C "your_email@example.com" +``` + +**传统方式 (RSA):** +```bash +ssh-keygen -t rsa -b 4096 -C "your_email@example.com" +``` + +**执行过程:** +``` +Generating public/private ed25519 key pair. +Enter file in which to save the key (/home/user/.ssh/id_ed25519): [直接回车] +Enter passphrase (empty for no passphrase): [可以直接回车或输入密码] +Enter same passphrase again: [重复密码] +``` + +--- + +### 第 3 步：查看公钥内容 + +**Windows:** +```bash +type %USERPROFILE%\.ssh\id_ed25519.pub +# 或 +type %USERPROFILE%\.ssh\id_rsa.pub +``` + +**Linux/macOS:** +```bash +cat ~/.ssh/id_ed25519.pub +# 或 +cat ~/.ssh/id_rsa.pub +``` + +**复制输出的完整内容**，类似： +``` +ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIM... your_email@example.com +``` + +--- + +### 第 4 步：添加公钥到 GitHub + +1. **登录 GitHub**: https://github.com +2. **打开设置**: 点击右上角头像 → Settings +3. **SSH 和 GPG 密钥**: 左侧菜单 → SSH and GPG keys +4. **添加新密钥**: 点击 "New SSH key" 按钮 +5. **填写信息:** + - Title: 给密钥起个名字（如：My Windows PC） + - Key: 粘贴第3步复制的公钥内容 +6. **保存**: 点击 "Add SSH key" + +--- + +### 第 5 步：测试 SSH 连接 + +```bash +ssh -T git@github.com +``` + +**成功的输出:** +``` +Hi username! You've successfully authenticated, but GitHub does not provide shell access. +``` + +**如果仍然失败，继续下一步...** + +--- + +## 常见问题与解决方案 + +### 问题 1: Connection closed by 198.18.0.66 + +这个 IP 地址 `198.18.0.66` 不是 GitHub 的官方 IP，可能是： +- 代理服务器 +- VPN +- 公司网络的网关 + +**解决方案：检查代理设置** + +#### 方案 A: 配置 Git 使用代理 + +如果您在使用代理，需要配置： + +```bash +# HTTP 代理 +git config --global http.proxy http://proxy_server:port +git config --global https.proxy https://proxy_server:port + +# SOCKS5 代理 +git config --global http.proxy socks5://proxy_server:port +``` + +#### 方案 B: 取消代理设置 + +```bash +git config --global --unset http.proxy +git config --global --unset https.proxy +``` + +#### 方案 C: 为 SSH 配置代理 + +创建或编辑 `~/.ssh/config` 文件： + +**Windows:** `C:\Users\YourName\.ssh\config` +**Linux/macOS:** `~/.ssh/config` + +``` +Host github.com + HostName github.com + User git + # 如果使用 HTTP 代理 + ProxyCommand connect -H proxy_server:port %h %p + # 如果使用 SOCKS5 代理 + # ProxyCommand connect -S proxy_server:port %h %p +``` + +--- + +### 问题 2: Permission denied (publickey) + +**原因:** SSH 密钥未被识别 + +**解决方案:** + +1. **启动 SSH Agent:** + ```bash + # Windows (Git Bash) + eval "$(ssh-agent -s)" + + # Linux/macOS + eval "$(ssh-agent -s)" + ``` + +2. **添加私钥到 SSH Agent:** + ```bash + ssh-add ~/.ssh/id_ed25519 + # 或 + ssh-add ~/.ssh/id_rsa + ``` + +3. **再次测试连接:** + ```bash + ssh -T git@github.com + ``` + +--- + +### 问题 3: 防火墙阻止 SSH 端口 22 + +**解决方案 A: 使用 HTTPS 代替 SSH** + +修改远程仓库 URL： +```bash +# 查看当前 URL +git remote -v + +# 修改为 HTTPS +git remote set-url origin https://github.com/shumengya/QuickGit.git +``` + +**缺点:** 每次推送需要输入用户名和密码（或 Token） + +**解决方案 B: 使用 SSH over HTTPS (端口 443)** + +编辑 `~/.ssh/config`: +``` +Host github.com + HostName ssh.github.com + Port 443 + User git +``` + +测试： +```bash +ssh -T -p 443 git@ssh.github.com +``` + +--- + +### 问题 4: SSH 密钥格式错误 + +**原因:** Windows 换行符问题或复制时引入了额外字符 + +**解决方案:** + +1. **重新生成密钥**（推荐） +2. **或确保公钥完整且格式正确** + +--- + +## QuickGit 用户的完整解决流程 + +### 步骤 1: 生成 SSH 密钥 + +```bash +# Windows (Git Bash 或 PowerShell) +ssh-keygen -t ed25519 -C "shumengya@example.com" + +# 一路回车即可 +``` + +### 步骤 2: 复制公钥 + +```bash +# Windows +type %USERPROFILE%\.ssh\id_ed25519.pub + +# Linux/macOS +cat ~/.ssh/id_ed25519.pub +``` + +### 步骤 3: 添加到 GitHub + +1. 访问 https://github.com/settings/keys +2. 点击 "New SSH key" +3. 粘贴公钥，保存 + +### 步骤 4: 测试连接 + +```bash +ssh -T git@github.com +``` + +**期望输出:** +``` +Hi shumengya! You've successfully authenticated... +``` + +### 步骤 5: 在 QuickGit 中重新配置远程仓库 + +如果之前的远程仓库配置有问题： + +```bash +# 删除旧的 github 远程仓库 +git remote remove github + +# 重新添加 +git remote add github git@github.com:shumengya/QuickGit.git + +# 验证 +git remote -v +``` + +### 步骤 6: 使用 QuickGit 推送 + +1. 启动 QuickGit +2. 选择 `[2] 提交并推送更改` +3. 选择推送到 `github` + +--- + +## 调试命令 + +如果问题仍然存在，使用以下命令获取详细信息： + +```bash +# 详细模式测试 SSH 连接 +ssh -vT git@github.com + +# 查看 Git 配置 +git config --list + +# 查看远程仓库配置 +git remote -v + +# 手动推送（查看详细错误） +git push -v github main +``` + +--- + +## 快速修复：改用 HTTPS + +如果 SSH 问题难以解决，可以临时使用 HTTPS： + +```bash +# 修改远程仓库 URL +git remote set-url github https://github.com/shumengya/QuickGit.git + +# 推送（需要输入用户名和密码/Token） +git push github main +``` + +**注意:** HTTPS 方式需要： +- GitHub 用户名 +- Personal Access Token（不能使用密码） + +**生成 Token:** +1. GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) +2. Generate new token +3. 勾选 `repo` 权限 +4. 复制 Token（只显示一次） + +--- + +## 总结 + +**推荐解决方案顺序:** + +1. ✅ 生成 SSH 密钥 +2. ✅ 添加公钥到 GitHub +3. ✅ 测试 SSH 连接 +4. ✅ 配置 SSH Agent（如果需要） +5. ⚠️ 检查代理设置（如果在公司网络） +6. 🔄 最后选择：使用 HTTPS 作为备用方案 + +**最快的解决方法:** +如果急需推送代码，先改用 HTTPS，之后再慢慢配置 SSH。 diff --git a/fix_github_ssh.bat b/fix_github_ssh.bat new file mode 100644 index 0000000..6fe0357 --- /dev/null +++ b/fix_github_ssh.bat @@ -0,0 +1,116 @@ +@echo off +chcp 65001 >nul +echo ======================================== +echo GitHub SSH 连接快速修复脚本 +echo ======================================== +echo. + +echo [1] 方案一：修改 hosts 文件（需要管理员权限） +echo [2] 方案二：配置 SSH 使用 HTTPS 端口 443 +echo [3] 方案三：改用 HTTPS 方式（临时方案） +echo [4] 测试当前 SSH 连接 +echo [5] 查看详细诊断信息 +echo [0] 退出 +echo. + +set /p choice="请选择 [0-5]: " + +if "%choice%"=="1" goto solution1 +if "%choice%"=="2" goto solution2 +if "%choice%"=="3" goto solution3 +if "%choice%"=="4" goto test +if "%choice%"=="5" goto diagnose +if "%choice%"=="0" goto end + +:solution1 +echo. +echo ======================================== +echo 方案一：修改 hosts 文件 +echo ======================================== +echo. +echo 请按照以下步骤操作： +echo. +echo 1. 以管理员身份打开记事本 +echo 2. 打开文件：C:\Windows\System32\drivers\etc\hosts +echo 3. 找到被注释的 GitHub 行（以 # 开头） +echo 4. 删除行首的 # 和空格，保存文件 +echo. +echo 或者在文件末尾添加： +echo 140.82.112.3 github.com +echo. +echo 修改后执行：ipconfig /flushdns +echo. +notepad C:\Windows\System32\drivers\etc\hosts +goto end + +:solution2 +echo. +echo ======================================== +echo 方案二：配置 SSH 使用端口 443 +echo ======================================== +echo. +echo 正在修改 SSH 配置文件... +echo. + +( +echo. +echo # GitHub SSH over HTTPS +echo Host github.com +echo HostName ssh.github.com +echo Port 443 +echo User git +echo IdentityFile ~/.ssh/id_ed25519 +) >> %USERPROFILE%\.ssh\config + +echo [OK] SSH 配置已更新！ +echo. +echo 测试连接： +ssh -T git@github.com +goto end + +:solution3 +echo. +echo ======================================== +echo 方案三：改用 HTTPS 方式 +echo ======================================== +echo. +echo 请在您的 Git 仓库目录执行： +echo. +echo git remote set-url github https://github.com/shumengya/QuickGit.git +echo git push github main +echo. +echo 注意：需要使用 GitHub Personal Access Token 作为密码 +goto end + +:test +echo. +echo ======================================== +echo 测试 SSH 连接 +echo ======================================== +echo. +ssh -T git@github.com +echo. +goto end + +:diagnose +echo. +echo ======================================== +echo 详细诊断信息 +echo ======================================== +echo. +echo [1] DNS 解析结果： +nslookup github.com +echo. +echo [2] SSH 密钥状态： +dir %USERPROFILE%\.ssh\id_* +echo. +echo [3] Git 远程仓库配置： +git remote -v +echo. +echo [4] 详细 SSH 测试： +ssh -vT git@github.com +goto end + +:end +echo. +pause