Node fetch、axios 使用代理：5 个坑

为什么 fetch 还是显示你自己的 IP

只设 HTTP_PROXY 不够：Node 文档写明，代理支持默认关闭，要设 NODE_USE_ENV_PROXY=1 或加 --use-env-proxy，而且变量是进程启动时读的。我们测试时，Node 24.14.0 下只设 HTTP_PROXY、不加开关，请求直接到了测试页。

还有三个坑。文件开头导入 undici 包，可能会换掉全局 dispatcher：导入 undici 8.12.4 后，即使开了 NODE_USE_ENV_PROXY=1，fetch 也直连，而 undici 7.30.2 没有这个现象。用已安装 undici 创建的 dispatcher，在两边版本不同时可能被内置 fetch 拒绝（我们遇到 UND_ERR_INVALID_ARG）。axios 完全不用 Node 的开关：它自己读同样的变量，一旦传了 proxy 选项或 agent，就以后者为准。

第二个坑的办法是：fetch 和 dispatcher 用同一个包里的，或者用 setGlobalDispatcher() 全局注册。

• Node.js 代理设置总览

• 来源：
• Node.js 文档：NODE_USE_ENV_PROXY 与 --use-env-proxy
• Node.js 文档：内置代理支持（http）
• Node.js 文档：fetch 与自定义 dispatcher（globals）
• 本地测试，2026-11-14

给 fetch 和 axios 配代理的四种方式

来源：Node.js、undici、axios 文档，以及我们 2026 年 11 月 14 日的本地测试（Node.js 24.14.0、axios 1.21.1）。版本号即测试时所用版本。

• 来源：
• Node.js 文档：NODE_USE_ENV_PROXY 与 --use-env-proxy
• undici 文档：EnvHttpProxyAgent
• undici 文档：ProxyAgent
• axios README：请求配置（proxy）
• 本地测试，2026-11-14

本地代理上的实测结果

我们在一个要登录、并记录每个请求的本地代理上跑了每种写法。不加开关时，内置 fetch 无视 HTTP_PROXY；设 NODE_USE_ENV_PROXY=1 后，请求带着登录到了代理；EnvHttpProxyAgent 用 setGlobalDispatcher 注册后可用，undici 的 ProxyAgent 配 undici 自己的 fetch 也可用。axios 通过 proxy 选项和环境变量都可用，配上 SocksProxyAgent 连本地 SOCKS5 代理也可用。

测试页是纯 HTTP；至于 https:// 页面，文档说 undici 和 axios 都会开 CONNECT 隧道。这些结论会随版本变化，请在自己的版本上做同样的检查。

• 来源：
• 本地测试，2026-11-14

内置支持：启动 Node 时带上变量

# Node.js 24 (or 22.21 and newer): switch the built-in support on at start-up
NODE_USE_ENV_PROXY=1 \
HTTPS_PROXY="http://LOGIN:PASSWORD@HOST:2222" \
NO_PROXY="localhost,127.0.0.1" \
node app.js

# the same thing as a flag
HTTPS_PROXY="http://LOGIN:PASSWORD@HOST:2222" node --use-env-proxy app.js

仅为示例：把 LOGIN、PASSWORD、HOST 换成「我的资产」里的值；账号密码里的特殊字符要做百分号编码。

用 undici 的 fetch：单次调用或整个进程

// npm i undici
import { fetch, ProxyAgent, EnvHttpProxyAgent, setGlobalDispatcher } from 'undici'

// A) one dispatcher for one call. Use fetch from the same undici package.
const login = encodeURIComponent('LOGIN')
const pass = encodeURIComponent('PASSWORD')
const agent = new ProxyAgent(`http://${login}:${pass}@HOST:2222`)
const res = await fetch('https://ipinfo.io/json', { dispatcher: agent })
console.log(await res.json())

// B) every fetch() in the process, driven by HTTPS_PROXY / NO_PROXY
// (the agent does nothing until it is registered)
setGlobalDispatcher(new EnvHttpProxyAgent())

2026 年 11 月 14 日在需要登录的本地 HTTP 代理上验证，测试页为纯 HTTP，undici 为 8.12.4 与 7.30.2。请把占位符换成自己的值。

axios：HTTP 用 proxy 选项，SOCKS5 用 agent

// npm i axios socks-proxy-agent
import axios from 'axios'
import { SocksProxyAgent } from 'socks-proxy-agent'

// HTTP proxy: axios' own proxy option
const viaHttp = await axios.get('https://ipinfo.io/json', {
  proxy: { protocol: 'http', host: 'HOST', port: 2222, auth: { username: 'LOGIN', password: 'PASSWORD' } },
})
console.log(viaHttp.data)

// SOCKS5 proxy: hand axios an agent and turn its own proxy handling off
const agent = new SocksProxyAgent(
  `socks5h://${encodeURIComponent('LOGIN')}:${encodeURIComponent('PASSWORD')}@HOST:3333`
)
const viaSocks = await axios.get('https://ipinfo.io/json', { proxy: false, httpAgent: agent, httpsAgent: agent })
console.log(viaSocks.data)

两种写法都在 2026 年 11 月 14 日用带登录的本地代理验证过（HTTP 页面）。请换上自己的值，端口要和所买协议一致。

带账号密码的 SOCKS5：两个细节

socks-proxy-agent 会先把百分号编码的账号密码解码再发送：测试里代理收到的是原始用户名和密码，用 socks5h 时收到的是域名而不是 IP。undici 的 ProxyAgent 配 socks5: 地址时没有解码：代理收到的 %40、%3A 是原样字符。密码含特殊字符时，请用 socks-proxy-agent，或者换一个不含特殊字符的密码。

两个库都要求代理在 SOCKS5 端口上说 SOCKS5。Proxy302 的 SOCKS5 端口是 3333，且凭据要是按 SOCKS5 生成的；HTTP 用 2222。

• 来源：
• 本地测试，2026-11-14
• socks-proxy-agent README
• undici 文档：ProxyAgent
• Proxy302 产品信息与价格表

症状与处理

Node.js 脚本该选哪种 Proxy302 产品

服务器、测试和不登录账号的脚本，可以按 IP 租机房 IP：1 天 US$0.25，30 天 US$3.99，购买时选 HTTP（端口 2222）或 SOCKS5（端口 3333），一次最多买 100 个。机房 IP 能被识别为机房地址，所以涉及账号、店铺、广告账户的工作，请选静态 ISP IP，每天 US$0.50 起。

没有免费试用，最小的购买是 1 个 IP 用 1 天。

• 按 IP 租机房 IP
• 静态 ISP 代理

• 来源：
• Proxy302 产品信息与价格表

用 Proxy302 怎么做：步骤

1. 第 1 步

   打开机房页面，选国家、租期和协议（fetch 与 axios 的 proxy 选项选 HTTP，agent 方案选 SOCKS5），确认费用后用钱包支付。

2. 第 2 步

   打开「我的资产」，复制 host、port、username、password。

3. 第 3 步

   填进你选的写法里，或者填进内置开关用的 HTTPS_PROXY。

4. 第 4 步

   请求 https://ipinfo.io/json，对比打印出的 IP 和你自己的 IP。

   预期结果 显示代理的 IP，而不是你自己的。

常见问题

延伸阅读

Node.js 代理设置

在 Node.js 里使用 HTTP 或 SOCKS5 代理的几种方式，附短示例和出口检查。

Puppeteer 代理设置

用 --proxy-server、page.authenticate 和浏览器上下文在 Puppeteer 里设置 HTTP 代理，并检查出口 IP。

npm 怎么设置代理

用 npm config、.npmrc 或环境变量给 npm 设置代理，说明 pnpm 和 Yarn，并用 npm ping 验证、关闭。

407 代理需要认证怎么办

HTTP 407 来自代理服务器，而不是你要访问的网站。

数据中心代理如何计费

按 IP 购买数据中心代理：高速固定 IP，单地址价格最低，按 IP 和租期计费。支持 HTTP / SOCKS5，可选国家。

查看配置与价格