Node.js 中的身份验证代理:Axios、原生 fetch 与 Got
由 ProxyV4 工程团队撰写 · Updated:
在 Axios 中使用 Node.js 代理的可靠方式是将 HttpsProxyAgent 作为 httpsAgent 传入,并设置 proxy: false。Axios 自带的 proxy: { host, port } 配置不会建立 HTTP CONNECT 隧道,因此访问 https:// URL 时会报错;而原生 fetch() 则需要使用 undici 的 ProxyAgent。本页面展示了各客户端如何配合 ProxyV4 的 http://user:pass@ip:port URL 使用,以及如何验证出口 IP。
new HttpsProxyAgent('http://user:pass@ip:port')- 1 个 IPUS$1.85
- 3+ 个 IPUS$1.70
- 10+ 个 IPUS$1.60
- 25+ 个 IPUS$1.50
- 50+ 个 IPUS$1.40
- 100+ 个 IPUS$1.30
- 200+ 个 IPUS$1.20
- 500+ 个 IPUS$1.10
- 1 个 IPUS$1.85
- 3+ 个 IPUS$1.70
- 10+ 个 IPUS$1.60
- 25+ 个 IPUS$1.50
- 50+ 个 IPUS$1.40
- 100+ 个 IPUS$1.30
- 200+ 个 IPUS$1.20
- 500+ 个 IPUS$1.10
选择适合你 HTTP 客户端的代码片段
这三种客户端均使用相同的代理 URL。你可以根据订单中的 ip:port:user:pass 信息进行拼接;协议头保持为 http://,因为客户端与代理之间通过 HTTP 通信,并通过代理建立 TLS 隧道。
| 客户端 | 安装命令 | 代理配置 |
|---|---|---|
| Axios | npm i https-proxy-agent | axios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false }) |
原生 fetch (Node 18+) | npm i undici | fetch(url, { dispatcher: new ProxyAgent('http://user:pass@ip:port') }) |
| Got | npm i hpagent | got(url, { agent: { https: new HttpsProxyAgent({ proxy: 'http://user:pass@ip:port' }) } }) |
为什么在 Axios 中设置 `proxy: false` 至关重要
Axios 会自动检测 HTTP_PROXY 和 HTTPS_PROXY 环境变量。如果机器上设置了其中任何一个(在 CI 运行器和容器中很常见),同时你又传入了 agent,这两种配置就会发生冲突。proxy: false 会让 Axios 忽略环境变量及其内置代理逻辑,从而确保完全由 agent 决定请求的路由走向。
在多个请求间复用 Agent
- 在请求循环外为每个代理 IP 创建一个 agent;agent 会持有 keep-alive 连接池,而每次调用都创建新 agent 会丢弃这些连接
- 使用多个代理时,维护一个从 IP 映射到 agent 的
Map并从中取用,而不是实时动态创建 agent - 为每次调用设置
timeout(例如 Axios 中的timeout: 10000),避免某个卡死的目标站点一直占用工作进程 - 需要将代理列表作为数据导入?代理格式转换工具可将
ip:port:user:pass行转换为可直接require或import的 JSON 数组
静态 IP 能为 Node.js 任务带来什么
ProxyV4 独享 IPv4 在整个租期内仅供单一客户使用,且续费时保持 IP 地址不变。因此,绑定到该 IP 的 API 白名单、登录会话或速率限制配额在多次部署之间均能持续有效。流量不设限制,让长时间运行的工作任务表现稳定可预测。有关抓取模式和频次控制,请参阅网页抓取应用场景。
操作步骤
- 1
安装客户端与 Agent
在项目中运行
npm install axios https-proxy-agent(如果使用原生fetch,则运行npm install undici)。 - 2
初始化 Agent
使用 ProxyV4 订单中的参数创建
const agent = new HttpsProxyAgent('http://user:pass@ip:port');。 - 3
通过代理发送请求
调用
const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });。 - 4
验证出口 IP
console.log(res.data)应输出代理 IP。如果输出的是你服务器的真实地址,则说明 agent 未生效。
常见问题
为什么 Axios 的 proxy: { host, port, auth } 在 HTTPS 站点上会失败?
该选项会直接向代理发送普通 HTTP 请求,而不是先请求建立 HTTP CONNECT 隧道,导致与目标服务器的 TLS 连接无法正常建立。请改用 httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port') 并设置 proxy: false。
如何在 Node 18、20 或 22 中为原生 fetch() 配置代理?
Node 的 fetch 基于 undici 构建,因此只需从 undici 中导入 ProxyAgent,并在 fetch() 选项中传入 { dispatcher: new ProxyAgent('http://user:pass@ip:port') } 即可。
我的密码包含 @ 或 :,会导致 URL 解析失败吗?
可能会,因为这些字符在 URL 中具有特殊含义。在拼接 http://user:pass@ip:port 之前,请先使用 encodeURIComponent(password) 对密码进行百分比编码。
请求返回 407 错误,是什么原因?
代理已响应但拒绝了登录凭据。请重新核对订单中的用户名和密码;407 错误排查页面列出了常见原因。
来源
适用于 Node.js 工作进程的静态 IPv4
涵盖 7 个国家/地区的独享 IPv4 以及美越静态 ISP 代理,不限流量,单人独享单 IP。支持单购或批量购买。
查看美国实时价格