连接设置操作前请核对当前界面

Mac开启翻墙代理后终端无法访问网络?按环境变量和工具设置查找原因

浏览器采用系统设置,并不代表终端采用相同路径。先核对本地监听,再分别查看环境变量、工具配置和虚拟网卡接管。

从请求入口开始:桌面网页可以访问时,终端里的 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"

保存后载入变更

  1. 按 Control + O 写入文件,再用 回车键 确认保存位置。
  2. 按 Control + X 关闭编辑器。
  3. 在当前会话重新载入配置:
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。清除一种设置后仍走代理时,应沿其他入口继续排查。

服务条件另行查看:下载报错需要结合当前请求分析,线路名称不能保证传输表现。相关说明可查看 服务选项 ,收费及范围以商家页面为准。


继续排查:连接仍未恢复时,可转到《节点连接失败的基础核对》。

保留本地配置备份,修改后分别检查外部请求和内网访问。

文档入口与界面对照

官方项目或文档页面截图

查找设置时,可将配图与当前软件界面对照。遇到菜单名称或选项位置变化,应回到项目文档核对操作。

服务条款: 涉及收费与服务范围的事项,以商家页面为准。

需要了解服务范围,可进入 服务选项;需要浏览不同方案,可进入 服务列表。

接着了解其他设置

从当前问题继续查找,分别了解应用接管、路由去向与连接恢复。