update: 2026-02-16 00:43:38
This commit is contained in:
350
GitHub_SSH_故障排查.md
Normal file
350
GitHub_SSH_故障排查.md
Normal file
@@ -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。
|
||||
116
fix_github_ssh.bat
Normal file
116
fix_github_ssh.bat
Normal file
@@ -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
|
||||
Reference in New Issue
Block a user