适用范围与准备

适用于自己的 Node.js 程序通过内置 fetch、node:http 或 node:https 请求网络:npm 已能下载包,但脚本仍无法使用已有 HTTP 代理。这里只核对支持内置环境代理的 Node 版本,不把 npm 配置当成所有库的网络配置。

先区分原因

npm 的代理选项和 Node 程序的请求路径不同。Node 的内置代理支持需要明确启用,读取进程的 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY;自定义 agent 或 dispatcher 仍可能改写行为。TUN 接管也需要另行记录。

按顺序操作

  1. 在发生问题的同一终端或服务环境运行 node --version,确认实际可执行文件。官方文档给出的 --use-env-proxy 起点为 v22.21.0、v24.5.0;本文按这些版本及后续兼容版本写,旧版不要直接照搬参数。
  2. 记录既有代理变量及应用是否设置了自定义 agent/dispatcher,只在本机查看,避免输出含密码的 URL。同时检查小写 http_proxy、https_proxy 和 no_proxy;存在同名大小写时小写值优先,先核对其用途,不能只改大写后就认定已换出口。确认填的是自己客户端真实 HTTP/mixed 端口,不是 SOCKS 或控制 API 端口。
  3. macOS/Linux 的 POSIX shell 可在子 shell 中运行下面的最小内置 fetch 对照。7890 是端口占位,example.com 是公开 GET 示例;有组织网络策略时使用获准端点和代理。先确认原来的 NO_PROXY 不包含测试目标,不为排障清空组织绕过规则。
  4. 用代理客户端连接记录核对测试域名,再看状态码和完整正文是否收到。测试成功后回原程序核对同一请求;若原程序单独失败,继续检查它使用的库和自定义网络对象。
  5. 后台服务需按其启动方式设置环境并在获准维护时重启;终端变量不会自动进入已运行进程。证书错误另查受信任 CA,不能用 NODE_TLS_REJECT_UNAUTHORIZED=0 当代理修复。
macOS/Linux,子 shell 内临时设置;不会持久修改当前终端。先将端口换成自己的 HTTP/mixed 端口。
(
  export HTTP_PROXY=http://127.0.0.1:7890
  export HTTPS_PROXY=http://127.0.0.1:7890
  node --use-env-proxy -e 'fetch("https://example.com/", {signal: AbortSignal.timeout(15000)}).then(async r => { const body = await r.text(); console.log(r.status, body.length); if (!r.ok) process.exitCode = 1; }).catch(e => { console.error(e.message); process.exitCode = 1; });'
)

怎样确认有效

代理记录确认这次请求经过预期入口,响应内容完整,原程序也在自己的运行环境完成请求。最小脚本成功只说明内置请求链路可用,不能代表第三方 HTTP 库、npm 安装脚本或后台服务都已恢复。

无效时恢复与下一步

上述子 shell 退出后临时变量自行结束;若另改过服务配置,按原值恢复并验证原业务。提供版本、请求库、是否有自定义 agent 和脱敏错误,保留现有依赖锁文件。