Node.js 中的身份验证代理:Axios、原生 fetch 与 Got

· 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。

Node.js (Axios / Undici) · HTTP
new HttpsProxyAgent('http://user:pass@ip:port')
独享 IPv4(数据中心)
🇺🇸 美国
有货
起
US$1.10 / IP / 月
批量阶梯折扣
  • 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
购买 美国
独享 IPv4(数据中心)
🇸🇬 新加坡
有货
起
US$1.10 / IP / 月
批量阶梯折扣
  • 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 隧道。

客户端安装命令代理配置
Axiosnpm i https-proxy-agentaxios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false })
原生 fetch (Node 18+)npm i undicifetch(url, { dispatcher: new ProxyAgent('http://user:pass@ip:port') })
Gotnpm i hpagentgot(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. 1

    安装客户端与 Agent

    在项目中运行 npm install axios https-proxy-agent(如果使用原生 fetch,则运行 npm install undici)。

  2. 2

    初始化 Agent

    使用 ProxyV4 订单中的参数创建 const agent = new HttpsProxyAgent('http://user:pass@ip:port');。

  3. 3

    通过代理发送请求

    调用 const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });。

  4. 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。支持单购或批量购买。

查看美国实时价格

Related articles

按平台选择代理
网页抓取专属代理:不限流量的固定 IP 池
适用于 Python、Scrapy、Playwright 和 Selenium 的网页抓取代理:独享 IPv4 与静态 ISP 地址池,无限流量,按 IP 统一定价。
代理配置
带认证代理的 Puppeteer 配置:启动参数加登录验证
Puppeteer 代理认证实践示例:使用 --proxy-server 设置地址,通过 page.authenticate() 验证登录,并介绍 SOCKS5、多上下文配置与错误修复。
代理配置
Playwright 代理身份认证:每个上下文独享独立静态 IP
在 Node.js 或 Python 中为每个 Playwright 浏览器上下文配置独立的 HTTP(S) 认证代理,使时区与语言环境匹配对应 IP,并验证实际出口地址。
免费工具
将代理列表转换为工具所需的格式
在浏览器中批量转换代理列表,支持 ip:port:user:pass、user:pass@ip:port、http:// URL、SOCKS5 URI、JSON 数组与 FoxyProxy 导入格式。
按平台选择代理
用于SEO排名监控的代理:还原当地搜索者的真实结果页
提供美国、英国、越南、日本等7个市场的独享IPv4 SEO排名监控代理,确保自然排名、本地搜索包(Local Pack)和广告投放与当地搜索结果完全一致。
按平台选择代理
用于多账号稳定运行且防连带触发手机验证的Discord代理
Discord专用代理,让每个账号与Token独享独立静态IP,避免单次进群导致整组账号批量触发手机验证。支持美国、新加坡及越南节点。
IPV4 · united states
美国独享 IPv4 代理池:适用于数据抓取、排名追踪与广告核查
购买美国独享 IPv4 代理:静态美国数据中心 IP,单人专享,无限流量。专为数据采集、SERP 排名追踪与美国广告投放检查打造。
IPV4 · singapore
新加坡独享 IPv4 代理:每个店铺与广告账户专享一个固定 IP
新加坡独享 IPv4 代理:由您独享的静态新加坡数据中心 IP,适用于 Lazada 和 Shopee 新加坡店铺、新加坡广告账户及区域自动化业务。