从请求入口开始:桌面网页可以访问时,终端里的 git clone、brew install、curl 或 pip install 等操作仍可能停在等待阶段,或者报告 Connection timed out 。这时需要检查命令自身读取了什么网络设置。
把临时变量、快捷开关与工具独立配置分开处理,才能看清哪一步改变了请求路径。不要因为浏览器正常就跳过终端设置检查。
同一电脑可以采用不同代理入口
💡 先检查已有连接:确认客户端本身能够连接,再处理终端配置。涉及服务范围的信息可查看 服务说明入口。
系统设置与命令行环境可能是不同入口,需要分别核对。
图形程序和终端各自读取设置
- 桌面浏览器:可能通过系统的
CFNetwork等网络接口读取代理选项。客户端开启系统代理后,还应确认目标应用是否采用了该设置。 - 命令行中的网络工具:可能使用环境变量或自身配置,不能推断它们都与桌面应用一致;是否读取系统代理需要单独确认。排查时可查看
http_proxy、https_proxy和all_proxy等变量是否指向正确的本地监听。
不要用不同协议替代访问验证
在终端输入 ping example.com 后没有响应,不能直接说明代理设置失败。
- 协议区别:该命令使用 ICMP,与网页的请求路径不同。
ping是否响应不能代替应用请求验证,可使用curl查看目标页面的响应,并结合客户端记录判断。
先找到正在使用的监听地址
在应用中核对 HTTP、SOCKS 或混合监听的地址和端口,然后再填写终端变量。不要把示例参数当作所有工具的默认值。
不同监听设置的核对入口:
| 需要确认的项目 | HTTP 或混合监听 | SOCKS 监听 | 查找位置 |
|---|---|---|---|
| 混合监听工具 | 查看当前设置 并 确认是否开启 | 查看当前设置 并 确认协议类型 | 客户端设置中的监听选项 |
| 分开监听的工具 | 查看当前设置 | 查看当前设置 | 偏好设置中的协议监听项 |
| 本地监听配置 | 查看当前设置 | 查看当前设置 | 偏好设置中的本地地址 |
| 文件配置方式 | 查看当前配置 ,以生效配置为准 | 查看当前配置 | 本地配置文件中的入站部分 |
| 其他桌面工具 | 查看当前设置 | 查看当前设置 | 当前应用的设置或偏好页面 |
💡 下文地址用于展示格式;示例端口
7890仅展示写法,使用前需要替换为当前监听值,并核对 HTTP 与 SOCKS 是否共用端口。
临时变量先在当前窗口验证
短时间使用时,可以先只对当前终端设置变量。确认请求路径后,再考虑是否保存成长期配置。
写入本次会话的变量
下面示例分别给出 HTTP 和 SOCKS 地址写法,不能直接据此认定本地已开启对应监听:
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export all_proxy=socks5://127.0.0.1:7890
在同一窗口检查结果
请求出口查询页面时,先看是否返回响应,再与当前选择的节点对照:
curl -i https://ip.sb
也可以查看目标站点的响应头:
curl -I https://example.com
出现 HTTP 响应只能说明该请求获得了返回;是否经过节点,还需结合出口与客户端日志确认。
- 作用范围:当前窗口中的变量由该会话使用,新开窗口需要重新确认;工具独立保存的代理配置也要另行核对。
常用操作可以保存为快捷开关
重复设置时,可把相关操作保存在当前 Shell 对应的配置文件中,通过 setproxy 和 unsetproxy 切换当前会话的变量,保存前应确认已经了解这些命令的作用。
先查询所用的 Shell
不要按系统版本猜测配置文件,先在终端查看当前环境:
echo $SHELL
- 结果为
/bin/zsh时,核对~/.zshrc文件。 - 结果为
/bin/bash时,核对~/.bash_profile文件。
只编辑对应的配置文件
例如使用文本编辑器打开 ~/.zshrc:
nano ~/.zshrc
保存下方快捷操作前,先把其中的 7890 改为当前监听端口,并核对变量对应的协议。
alias setproxy="export http_proxy=http://127.0.0.1:7890; export https_proxy=http://127.0.0.1:7890; export all_proxy=socks5://127.0.0.1:7890; echo '已设置代理变量'; curl -s https://ip.sb"
alias unsetproxy="unset http_proxy; unset https_proxy; unset all_proxy; echo '已清除代理变量'; curl -s https://ip.sb"
保存后载入变更
- 按
Control + O写入文件,再用 回车键 确认保存位置。 - 按
Control + X关闭编辑器。 - 在当前会话重新载入配置:
source ~/.zshrc
分别检查开启和关闭状态
- 写入变量:执行
setproxy后查看请求出口及日志,确认目标程序读取了这些变量。 - 清除变量:执行
unsetproxy后再次查看出口;若仍走代理,还需检查工具自身设置或 TUN。
工具保存的选项要独立核对
环境变量没有覆盖目标程序时,应查看该工具自己的网络设置。采用 HTTPS 和 SSH 的请求也可能读取不同选项。
版本管理请求的两种入口
远端地址可能采用 HTTPS,例如https://example.com/...,也可能采用 SSH,例如t.me/jichangyyds:...。核对访问方式后,再选择对应的代理设置。
HTTPS 请求的工具设置: 下面展示工具独立保存代理选项的方式,地址仍需对应当前监听:
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890
git config --global http.https://example.com.proxy http://127.0.0.1:7890
git config --global https.https://example.com.proxy http://127.0.0.1:7890
不用时,检查并清除对应配置项:
git config --global --unset http.proxy
git config --global --unset https.proxy
SSH 请求需要核对独立转发,相关报错示例: ssh: connect to host example.com: Operation timed out。
采用 SSH 地址时,实际连接由 ssh 处理,HTTP 环境变量未必适用。需要时查看 SSH 配置中的转发设置,并先确认本地 SOCKS 监听。 ~/.ssh/config 是这类连接的配置入口。
nano ~/.ssh/config
下方示例使用 nc 转发连接,主机名与监听参数应按当前目标核对:
Host example.com
User git
ProxyCommand nc -X 5 -x 127.0.0.1:7890 %h %p
保存后重新执行 git clone t.me/jichangyyds:... ,查看是否仍有连接错误,不把建立连接等同于下载性能保证。
包管理器的下载设置
更新索引和下载包可能采用不同设置。镜像地址与代理地址作用不同,示例中的来源需要先核对再使用:
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles
export ALL_PROXY=socks5://127.0.0.1:7890
brew update
项目依赖管理器的代理选项
npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890
npm config delete proxy
npm config delete https-proxy
语言包下载工具的代理选项
单次命令可以带代理参数:
pip install package_name --proxy http://127.0.0.1:7890
也可以查看工具保存的代理设置:
pip config set global.proxy http://127.0.0.1:7890
需要更广接管范围时再查看 TUN
逐个程序配置并不方便时,可了解客户端的 虚拟网卡模式。它的覆盖范围由实际路由与配置决定,启用后仍需核对请求去向。
- 接管入口:系统中可能出现
utun等虚拟网卡,由相应路由决定哪些请求进入客户端。 - 核对对象:终端里的
curl、git、brew等请求以及后台程序,都应分别查看日志,不能假定开启后全部正确转发。
到当前客户端核对选项:
- 带后台服务的客户端:查看服务安装和授权状态,再核对 TUN 开关。
- 提供增强接管的客户端:查看高级网络设置中的 增强模式 及所需系统授权。
协议检查与常见问答
ICMP 响应不能替代网页请求验证
- 核对请求类型:检查代理时,应使用目标应用对应的访问方式。例如可以查看网页响应,或查询当前出口:
curl -I https://example.com或curl https://ip.sb。
问:终端提示拒绝连接,先查什么?
- 核对运行状态:确认客户端已经启动,本地监听地址和协议与变量中的设置相符。
- 核对端口:在应用中查看实际监听值,修改终端变量后重新发起请求。
问:HTTPS 证书相关错误怎样定位?
- 保留错误信息:先核对所用网络和证书处理设置,再查看客户端日志,不能仅从错误名称确定原因。
- 核对信任设置:检查所用网络与证书处理设置。不要把关闭校验当作恢复连接的常规方法;可先核对
证书信任与 HTTPS 解密设置再重新发起请求。
问:内网地址,例如 本机开发服务 或 局域网设备无法访问时,检查哪里?
- 检查例外范围:本地请求若也进入代理,可能改变原有访问路径。
- 核对直连设置:查看
no_proxy中是否包含需要直连的本地目标,下面地址段仅作写法示例,应按自己的网络核对:export no_proxy="localhost,127.0.0.1,localaddress,.localdomain.com,192.168.0.0/16,10.0.0.0/8"
把能够恢复的设置记录下来
先核对监听,再验证当前窗口的变量,最后检查工具独立配置与 TUN。清除一种设置后仍走代理时,应沿其他入口继续排查。
服务条件另行查看:下载报错需要结合当前请求分析,线路名称不能保证传输表现。相关说明可查看 服务选项 ,收费及范围以商家页面为准。
继续排查:连接仍未恢复时,可转到《节点连接失败的基础核对》。
保留本地配置备份,修改后分别检查外部请求和内网访问。
文档入口与界面对照

查找设置时,可将配图与当前软件界面对照。遇到菜单名称或选项位置变化,应回到项目文档核对操作。
服务条款: 涉及收费与服务范围的事项,以商家页面为准。