段落导航
先选择原来报错的命令进行排查。记录它由哪个进程执行、读取哪里的参数,再比较本地端口与远端请求;配置只保存到确实需要的位置,便于以后更换端口或恢复直连。
沿发起请求的进程查找代理来源
浏览器与开发工具可能使用不同设置。Git、npm 和镜像引擎要分别看待,先确定失败请求由前台命令还是后台服务发出。
使用能重现原问题的命令保存完整错误,再比较配置与连接日志。错误文字中若含私人地址或凭据,对外提供前先遮盖。
把请求发起者与配置入口对应
| 请求类型 | 需要查看的位置 | 可用的检查入口 |
|---|---|---|
| Git 的 HTTPS 请求 | 用户配置及代理环境变量 | 配置来源和详细连接输出 |
| npm 的仓库请求 | 项目配置、用户配置和环境变量 | 当前参数查询与仓库连通检查 |
| 桌面镜像程序的拉取操作 | 桌面程序自身的代理选项 | 后台日志与原拉取错误 |
| 系统镜像引擎的拉取操作 | 引擎配置文件及服务环境 | 服务运行记录与当前参数 |
确认当前进程确实监听代理端口
从客户端当前设置读取 HTTP 或混合端口,再用系统监听工具核对。地址没有对应监听时,先处理客户端状态。
显式指定代理进行请求,可以把端口可达性与工具设置分开。该请求也失败时先检查本地监听、网络和防火墙。
# 先从客户端读取实际端口,替换下方占位内容
curl -I -x http://localhost:<实际端口> https://github.com
# Linux 读取监听列表
ss -lntp
# Windows 读取监听列表
netstat -ano解析失败、连接被拒绝与证书错误指向不同阶段。先保存完整错误,再检查对应环节,避免只延长等待时间。
用临时终端变量进行范围有限的比较
在新终端设定代理后,只验证从该会话启动且会读取变量的程序。确认结果再决定是否持久保存,并记录保存位置。
需要直达的本机与内网地址应单独核对。代理例外应符合开发服务和仓库的实际访问要求。
# POSIX shell:填写本机实际 HTTP 代理地址
export HTTP_PROXY='http://localhost:<实际端口>'
export HTTPS_PROXY="$HTTP_PROXY"
export NO_PROXY=localhost,.local
# PowerShell
$env:HTTP_PROXY='http://localhost:<实际端口>'
$env:HTTPS_PROXY=$env:HTTP_PROXY从文件来源定位 Git 的旧代理值
查看代理参数及其文件来源,可以找到遗留用户配置。没有对应输出时,再检查环境变量与仓库自己的设置。
持久参数只在需要时写入,并记录撤销方式。SSH 与 HTTPS 属于不同访问路径,检查时先分清远端地址类型。
git config --show-origin --get-regexp '(^http\..*proxy$|^remote\..*\.proxy$)'
# 确需固定代理时才执行;将占位内容换成本机值
git config --global http.proxy 'http://localhost:<实际端口>'
git ls-remote https://github.com/git/git.git HEAD
# 撤销这项用户级设置
git config --global --unset-all http.proxy检查 npm 的配置层级与仓库目标
项目目录与用户目录可能各有 npmrc。先查看当前读取的代理和 registry,再核对目标是否仍是预期仓库。
分别查询 proxy、https-proxy 和 registry,并在原项目下运行连通检查。换目录后表现不同,要继续比较项目配置。
临时变量已经满足需求时,先保留这条可用路径。确实需要固定配置,再写入并记录回退操作。
npm config get proxy
npm config get https-proxy
npm config get registry
npm ping
# 需要固定代理时才填写实际端口
npm config set proxy 'http://localhost:<实际端口>'
npm config set https-proxy 'http://localhost:<实际端口>'
# 撤销本次固定代理
npm config delete proxy
npm config delete https-proxy镜像拉取要检查后台引擎的代理
桌面程序先在自己的设置里寻找代理选项,比较使用系统参数与手动参数时的实际效果。
手动填写前核对当前监听地址和端口,再用原拉取操作检查。
桌面程序与原生引擎的配置入口需要区分。查看对应说明后再修改,避免在不同入口重复写入。
原生引擎的配置文件需要先备份。把必要字段合并到现有内容,保留其他字段,通过校验后再重启受影响服务。
容器内应用的变量与引擎拉取配置分别检查,前者不能直接说明后台拉取已经使用代理。
# 修改前另存原配置,只合并需要的字段
# 配置中的代理地址应采用本机核对后的值
sudo dockerd --validate --config-file=/etc/docker/daemon.json
# 校验通过并确认能够中断服务后再重启
sudo systemctl restart docker
docker info
docker pull hello-world- 桌面程序的后台代理
- 应用设置后检查后台参数,再用原镜像拉取操作对照。
- 容器内应用的访问
- 按容器实际需要设置变量,并单独核对宿主及内网例外。
先辨认子系统与容器中的本地地址
在子系统或容器中,本地回环可能指向该环境自身。先确认宿主可达地址与网络模式,再检查监听及防火墙允许范围。
从发生错误的环境内请求代理端口。端口可以连接后,再决定使用变量、工具配置还是虚拟网卡接管。
临时设置清理的常见疑问与复查
代理参数应该保留在哪里?选择日常确实使用的配置方式,记录工具依赖,删除测试期间额外写入的固定值。
清理后怎样核对?打开新终端,重做原来失败的命令,比较结果及对应连接记录。
所有工具都要重新配置吗?只检查这次受影响的工具,确认它的请求路径符合使用需求即可。
关闭客户端后仍连接被拒绝时,继续查遗留固定地址与变量,确认是否仍指向已经停止的监听。
