代理设置中勾选“请勿用于本地地址”后，内网服务（如 http://localhost:8080）无法访问？

Question

【常见问题】 启用系统或浏览器代理后，若勾选“请勿用于本地地址”（即 bypass proxy for local addresses），会导致 `http://localhost:8080`、`http://127.0.0.1:3000` 或内网 IP（如 `http://192.168.1.100:8080`）等地址被自动绕过代理——本意是提升本地访问效率，但**当开发服务实际运行在远程容器、WSL2、Docker Desktop 或虚拟机中时，`localhost` 对宿主机而言已非“本地”，而该选项却错误地将其归类为需跳过的本地地址**，造成连接被拒绝或超时。典型现象：前端能正常启动，但 API 调用 504/ERR_CONNECTION_REFUSED；Chrome 控制台显示“Failed to load resource”，而 `curl http://localhost:8080` 在终端却可通。根本原因在于操作系统对“local address”的判定逻辑（如 Windows/macOS 的 `localhost`/`127.*`/`::1`/无域名纯IP默认绕过），与现代开发环境的网络拓扑不匹配。解决方案需按场景调整代理排除列表，而非简单依赖默认勾选。

Answer 1

```html

一、现象层：典型故障表征与环境错配

• 前端应用（如 React/Vue）在浏览器中正常渲染，但所有跨域或同源 API 请求均失败，Chrome DevTools Network 面板显示 ERR_CONNECTION_REFUSED 或 504 Gateway Timeout；
• curl http://localhost:8080/api/health 在宿主机终端返回 200 OK，证明服务可达；
• 使用 telnet localhost 8080 或 nc -zv localhost 8080 成功建立 TCP 连接；
• 但浏览器发起的相同请求却未抵达后端——流量被代理客户端（如 Charles、Fiddler、系统 PAC、浏览器内置代理）静默丢弃；
• 该现象在 WSL2（localhost 映射至 172.x.x.x）、Docker Desktop（host.docker.internal 解析为网关 IP）、VMware Fusion（NAT 模式下宿主需访问 192.168.x.1）等场景高频复现。

二、机制层：操作系统与代理栈的“本地地址”判定逻辑

现代代理系统（含 Windows 网络设置、macOS 网络偏好设置、Chrome --proxy-bypass-list、Firefox network.proxy.no_proxies_on）默认启用 RFC 3330 / RFC 4291 定义的“非路由地址”绕过策略：

地址类型	IPv4 范围	IPv6 范围	是否默认 bypass
环回地址	127.0.0.0/8	::1/128	✅ 强制绕过
私有网络地址	10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16	fc00::/7	✅ 大多数代理默认绕过
链路本地地址	169.254.0.0/16	fe80::/10	✅ 绕过

关键矛盾点：WSL2 的 localhost 实际绑定在 172.28.0.1（动态分配），Docker Desktop 的 host.docker.internal 解析为 192.168.65.2 ——二者均落入私有地址段，触发默认 bypass，而代理根本未尝试转发。

三、诊断层：精准定位绕过行为的四步法

1. 抓包验证：用 Wireshark 过滤 tcp.port == 8080 && ip.addr == 127.0.0.1，确认浏览器请求是否发出；
2. 代理日志审计：开启 Charles/Fiddler 的 “Log All Requests” 并搜索 localhost:8080，观察是否缺失日志条目；
3. 绕过列表显式检查：执行 netsh winhttp show proxy（Windows）或 scutil --proxy（macOS）查看系统级 bypass 列表；
4. 浏览器级覆盖验证：Chrome 启动时添加参数 --proxy-bypass-list=""（清空绕过列表），若问题消失，则 100% 确认为 bypass 误判。

四、解法层：按开发拓扑分类的精准绕过配置

graph LR A[开发环境拓扑] --> B{WSL2} A --> C{Docker Desktop} A --> D{VMware/VirtualBox} A --> E{远程容器/K8s Port-Forward} B --> F["将 172.16.0.0/12 加入 bypass
或禁用 'bypass local addresses'"] C --> G["在 proxy-bypass-list 中显式排除
host.docker.internal, 192.168.65.2"] D --> H["将 VM 网关 IP 如 192.168.122.1 加入 bypass
或使用域名代替 IP"] E --> I["禁用自动 bypass，仅保留
127.0.0.1, ::1"]

五、工程实践：跨平台可复用的代理配置模板

# Chrome 启动脚本（Linux/macOS）
google-chrome \
  --proxy-server="http://127.0.0.1:8888" \
  --proxy-bypass-list="127.0.0.1:8080,localhost:3000,host.docker.internal:8000,192.168.65.2:8080"

# Windows PowerShell 设置系统代理（绕过 WSL2 动态网段）
netsh winhttp set proxy "127.0.0.1:8888" "127.0.0.1,localhost,,172.28.0.0/16,172.29.0.0/16"

# .pac 文件片段（企业级统一策略）
function FindProxyForURL(url, host) {
  if (shExpMatch(host, "localhost") || 
      shExpMatch(host, "127.*") || 
      isInNet(host, "172.28.0.0", "255.255.0.0") || // WSL2
      isInNet(host, "192.168.65.0", "255.255.255.0")) // Docker Desktop
    return "DIRECT";
  return "PROXY 127.0.0.1:8888";
}

```