终端网络代理配置手册

Thu, 07 May 2026 00:00:00 +0000

问题背景

macOS 的终端（Terminal / iTerm2）默认不走系统代理设置，导致 brew install、git clone、curl 等命令行工具无法连接 GitHub 或速度极慢。

解决方案很简单：在 Zsh 配置中注入几个别名，手动控制终端的代理开关。

配置代码

将以下代码块添加到 ~/.zshrc 的最底部：

# =================================================
# 终端代理控制 (Proxy Control)
# Target: Clash Verge (Localhost: 7897)
# =================================================

# 开启代理
alias proxy='export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897; echo "\n✅ 终端代理已开启 (Port: 7897)"'

# 关闭代理
alias unproxy='unset https_proxy http_proxy all_proxy; echo "\n🚫 终端代理已关闭"'

# 检查当前 IP
alias myip='curl -s ipinfo.io/json | grep -E "ip|country"'

生效步骤

打开配置文件：nano ~/.zshrc
将上述代码粘贴到文件末尾
保存退出（Ctrl+O → Enter → Ctrl+X）
立即生效：source ~/.zshrc

命令速查

命令	说明	预期反馈
`proxy`	开启代理，在 `brew install` 或 `git clone` 前使用	`✅ 终端代理已开启...`
`unproxy`	关闭代理，恢复国内直连	`🚫 终端代理已关闭...`
`myip`	验证当前出口 IP 及国家	`{ "ip": "x.x.x.x", "country": "US" }`

常见问题

端口变更

不同代理软件默认端口不同：

ClashX Pro：7890
Surge：6152
Clash Verge：7897

修改方法：打开 ~/.zshrc，将 alias proxy='...' 行中所有端口号替换为你的代理端口，然后 source ~/.zshrc 生效。

代理开启后依然超时

确认代理软件正在运行，且"系统代理"开关已打开
检查代理软件设置中的"混合端口 (Mixed Port)“是否与配置一致
执行 myip 确认出口 IP 是否已变化

网络 on Xiang's Blog