为 Git 设置网络代理完整指南：解决 GitHub 访问慢问题

作者：[小庄-Python办公]
日期：2025年11月25日

前言

在使用 Git 进行开发时，很多开发者都会遇到一个共同的问题：从 GitHub 克隆或拉取代码时速度极慢，甚至频繁失败。特别是在国内网络环境下，这个问题尤为突出。

本文将详细介绍如何通过设置网络代理来解决这个问题，重点讲解端口号 10808 的配置方法，涵盖 HTTP 和 SOCKS5 两种代理协议。

为什么需要为 Git 设置代理？

加速访问：GitHub 服务器在国外，直连速度较慢
提高稳定性：避免因网络波动导致的克隆失败
特殊环境需求：公司内网或某些地区网络限制

准备工作

在开始配置之前，请确保：

已在本地运行代理软件（Clash、V2Ray、Shadowsocks 等）
清楚代理软件的端口号（本文以 10808 为例，实际端口以你的软件为准）
了解代理协议类型（HTTP 或 SOCKS5）

方法一：设置 HTTP/HTTPS 代理

1. 全局代理配置（不推荐）

对所有 Git 仓库生效：

# 设置 HTTP 代理
git config --global http.proxy http://127.0.0.1:10808

# 设置 HTTPS 代理（通常也使用 http:// 代理）
git config --global https.proxy http://127.0.0.1:10808

# 如果需要用户名密码认证（示例）：
git config --global http.proxy http://username:password@127.0.0.1:10808

2. 针对特定网站配置（推荐）

只对 GitHub 生效，不影响其他 Git 仓库：

# 为 GitHub 设置 HTTP 代理（按 URL 精确匹配）
git config --global http.https://github.com.proxy http://127.0.0.1:10808

方法二：设置 SOCKS5 代理

1. 全局 SOCKS5 代理

git config --global http.proxy socks5://127.0.0.1:10808
git config --global https.proxy socks5://127.0.0.1:10808

2. 针对 GitHub 的 SOCKS5 代理（最推荐）

git config --global http.https://github.com.proxy socks5://127.0.0.1:10808

3. 让 DNS 也走代理（可选）

某些环境下需要让域名解析也通过 SOCKS5 代理，使用 socks5h：

git config --global http.https://github.com.proxy socks5h://127.0.0.1:10808

验证配置

设置完成后，检查配置是否生效：

git config --global --list

你应该看到类似输出：

http.https://github.com.proxy=socks5h://127.0.0.1:10808

也可以临时测试一次拉取：

git -c http.proxy=socks5h://127.0.0.1:10808 ls-remote https://github.com/username/repo.git

临时使用代理

如果不想永久设置代理，可以在单次命令中临时使用：

# 临时使用代理克隆仓库
git -c http.proxy=socks5://127.0.0.1:10808 clone https://github.com/username/repo.git

# 临时使用代理推送代码
git -c http.proxy=socks5://127.0.0.1:10808 push

取消代理设置

当不再需要代理时，可以轻松取消：

# 取消全局代理
git config --global --unset http.proxy
git config --global --unset https.proxy

# 取消针对 GitHub 的代理
git config --global --unset http.https://github.com.proxy

故障排查

常见问题及解决方案：

代理不生效：检查代理软件是否正常运行；确认端口号是否正确；验证代理协议是否匹配（HTTP vs SOCKS5）
连接被拒绝：

fatal: unable to access 'https://github.com/.../': Failed to connect to 127.0.0.1 port 10808: Connection refused

可能原因：代理服务未启动或端口被占用
认证失败：检查用户名和密码是否正确；尝试不使用认证信息

检查代理端口的方法

在 Windows 上：

netstat -ano | findstr :10808

在 Linux/Mac 上：

lsof -i :10808

最佳实践建议

优先使用针对特定网站的配置，避免影响内网 Git 仓库
SOCKS5/socks5h 协议通常比 HTTP 协议更稳定
定期检查代理配置，特别是在更换网络环境后
重要操作前先测试代理是否正常工作

总结

通过为 Git 设置网络代理，可以显著提升访问 GitHub 等国外代码托管平台的速度和稳定性。本文提供了完整的配置方案：

支持 HTTP 和 SOCKS5 协议
提供全局和针对性的配置方法
包含验证和故障排查步骤
推荐最佳实践方案

最推荐的配置命令：

git config --global http.https://github.com.proxy socks5h://127.0.0.1:10808

希望本指南能帮助你解决 Git 网络问题，提升开发效率！

标签：Git, 代理, GitHub, 网络优化, 开发工具

分类：开发技巧, 工具配置