🧠 终端智能代理检测：自动判断是否需要设置代理访问 GitHub
在开发中，使用 GitHub 是非常常见的需求。但有时候我们会发现某些命令失败、插件无法更新，例如：
fatal: unable to access 'https://github.com/ohmyzsh/ohmyzsh.git/':
Failed to connect to github.com port 443
为了让终端具备自动检测 GitHub 可达性并在必要时自动设置代理，我编写了一个轻量级的 智能代理检测脚本，可以直接集成进 .zshrc 或单独保存为脚本文件使用。
✋ 如果不想自动设置，也可以手动配置代理
当你明确知道当前网络环境需要通过代理访问 GitHub，可以手动在终端中设置以下环境变量：
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890
export all_proxy=socks5h://127.0.0.1:7891
其中，端口号请根据你所使用的代理软件实际情况进行调整，常见配置包括：
7890：Clash 的 HTTP/HTTPS 代理端口7891：Clash 的 SOCKS5 代理端口1087：macOS 系统代理默认端口（如 Surge）
🕐 临时使用代理（推荐用于单条命令）
如果只是临时需要用代理执行一条命令，例如更新 Oh My Zsh，可以这样写：
export https_proxy=http://127.0.0.1:7890
omz update
执行完后关闭终端或 unset 即可恢复默认状态，无需修改 .zshrc。
✅ 可选恢复命令：
如果你想清除已设置的代理变量，可以使用：
unset http_proxy https_proxy all_proxy
🎯 脚本功能
- 自动检测是否能访问
https://github.com - 若不能访问，自动设置本地代理地址（例如：
http://127.0.0.1:7897） - 设置代理后再次验证是否连通
- 命令行输出清晰、颜色友好
🚀 两种使用方式
✅ 方式一：将脚本嵌入 .zshrc 开头（推荐个人使用）
打开 .zshrc 文件：
nano ~/.zshrc
将以下代码粘贴到最上方（优先执行）：
# 智能代理配置函数（使用 ANSI 颜色控制）
function setup_proxy_smart() {
local test_url="https://github.com"
local proxy_addr="http://127.0.0.1:7897"
local timeout=3
echo "🔍 Checking internet access for $test_url..."
if [[ "$(curl --max-time $timeout -s -o /dev/null -w "%{http_code}" "$test_url")" == "200" ]]; then
echo "\033[32m✅ Direct connection available. Proxy not needed.\033[0m"
unset http_proxy https_proxy all_proxy
else
echo "\033[33m🌐 No direct connection. Setting proxy to \033[36m$proxy_addr\033[0m"
export http_proxy=$proxy_addr
export https_proxy=$proxy_addr
export all_proxy=$proxy_addr
echo "🔁 Retesting access via proxy..."
if [[ "$(curl --max-time $timeout -s -o /dev/null -w "%{http_code}" "$test_url")" == "200" ]]; then
echo "\033[32m✅ Proxy connection successful.\033[0m"
else
echo "\033[31m❌ Proxy connection failed. Please check your proxy client.\033[0m"
fi
fi
}
# 每次终端启动时自动执行
setup_proxy_smart
保存后执行：
source ~/.zshrc
🛠️ 方式二：单独存为 proxy_check.sh 脚本文件（适合复用）
① 新建文件：
mkdir -p ~/scripts
nano ~/scripts/proxy_check.sh
② 粘贴同样的脚本代码（见上方）
③ 添加执行权限：
chmod +x ~/scripts/proxy_check.sh
④ 在 .zshrc 中引用：
source ~/scripts/proxy_check.sh
🧠 为什么 all_proxy 两种写法不同？
| 场景 | 类型 | 设置方式 | 原因/说明 |
|---|---|---|---|
| 脚本里 | HTTP 代理 | export all_proxy=$proxy_addr | proxy_addr 是 http://127.0.0.1:7897 类型 |
| 手动设置 SOCKS5 | SOCKS5 代理 | export all_proxy=socks5h://... | 明确使用 socks5 协议（通常端口 7891） |
✅ 最佳实践建议：
-
如果你确定使用的是 HTTP 代理端口（如 Clash 面板显示 7890、7897），就用：
export http_proxy=http://127.0.0.1:7890 export https_proxy=http://127.0.0.1:7890 export all_proxy=http://127.0.0.1:7890 -
如果你想走 SOCKS5 且保证远程解析 DNS，建议用：
export all_proxy=socks5h://127.0.0.1:7891
🧪 实用测试技巧：
你可以切换这两种配置后，用 curl 分别测试：
curl https://ipinfo.io/ip
- 使用 HTTP 代理时：应走 7890
- 使用 SOCKS5 时：应走 7891（并远程解析）
🧩 实际踩坑记录与解决
在配置的过程中，我也遇到了一些问题，以下是过程记录与解决方法，希望对你有帮助。
❗ 问题一：颜色输出不生效
初期使用 %F{color} 的语法输出颜色，但发现终端中无效果，颜色代码直接打印出来了。
✅ 解决办法：
使用更通用的 ANSI 转义序列 来实现颜色：
echo "\033[33mThis is yellow\033[0m"
例如：
\033[32m→ 绿色\033[33m→ 黄色\033[36m→ 青色\033[31m→ 红色\033[0m→ 重置颜色
❗ 问题二：curl 访问明明成功却判断为失败
初始版本使用：
curl --silent --head ...
在某些代理工具（如 Clash）下，HEAD 请求可能被阻断或返回不规范，导致误判失败。
✅ 解决办法：
使用 -o /dev/null -w "%{http_code}" 明确获取状态码：
curl -s -o /dev/null -w "%{http_code}" https://github.com
确保判断依据准确。
❗ 问题三：脚本执行太晚，代理未及时生效
最初放在 .zshrc 末尾调用 source ~/scripts/proxy_check.sh，但有些工具加载在前，造成代理未及时生效。
✅ 解决办法：
将脚本调用（或嵌入）放在 .zshrc 最顶端，确保代理设置先执行。
✅ 输出示例
✔️ 可直连时：
🔍 Checking internet access for https://github.com...
✅ Direct connection available. Proxy not needed.
🌐 需设置代理时：
🔍 Checking internet access for https://github.com...
🌐 No direct connection. Setting proxy to http://127.0.0.1:7897
🔁 Retesting access via proxy...
✅ Proxy connection successful.
❌ 代理设置后仍失败：
🔍 Checking internet access for https://github.com...
🌐 No direct connection. Setting proxy to http://127.0.0.1:7897
🔁 Retesting access via proxy...
❌ Proxy connection failed. Please check your proxy client.
📌 总结
通过这一简单的脚本，你可以实现：
- 在终端环境下自动判断是否需要设置代理
- 避免每次手动设置代理的繁琐步骤
- 保持 GitHub 访问畅通，提升命令行体验
这一方法适用于 Zsh 用户，也可以轻松迁移到 Bash 或其他 shell 中使用。如需支持多端口轮询、日志记录等高级功能，也可以在此基础上进一步扩展。
