Axios 代理设置：Node.js 账号密码认证

步骤

1. 安装 axios 和 agent

   npm ls 会显示 node_modules 里实际装上的版本。记下 axios 的版本号：第 4 步的内置选项能否安全用于 https，取决于它。

   npm i axios https-proxy-agent
   npm ls axios https-proxy-agent

2. 把 agent 作为 httpsAgent 传入，并设 proxy: false

   HttpsProxyAgent 带着你的登录信息向代理发送 CONNECT，再在这条隧道里与网站建立 TLS，代理只负责转发，读不到页面内容。proxy: false 让 axios 把路由完全交给 agent。去掉这一项时，shell 里的 HTTPS_PROXY 变量会盖过你的 agent，测试的两个 axios 版本都是如此。

   import axios from 'axios';
   import { HttpsProxyAgent } from 'https-proxy-agent';
   
   const client = axios.create({
     httpsAgent: new HttpsProxyAgent('http://USERNAME:PASSWORD@HOST:PORT'),
     proxy: false,
     timeout: 30000,
   });
   
   const { data } = await client.get('https://api.ipify.org?format=json');
   console.log(data.ip);

3. 运行脚本，查看地址

   node check-ip.mjs 会打印 api.ipify.org 返回的 ip 字段。它应该是代理的出口地址，与你自己网络的地址不同。

4. 在 axios 1.16.1 及以上使用内置 proxy 选项

   从 1.16.1 起，axios 会自己为 https 网址建立 CONNECT 隧道，登录信息写在 auth 里。1.16.0 及更早的版本会把 https 请求当作带完整网址的普通 GET 发给代理，代理能读到请求内容，能否成功也要看代理愿不愿意代为获取。axios 版本较旧时，请继续用第 2 步的 agent。

   import axios from 'axios';
   
   const { data } = await axios.get('https://api.ipify.org?format=json', {
     proxy: {
       protocol: 'http',
       host: 'HOST',
       port: PORT,
       auth: { username: 'USERNAME', password: 'PASSWORD' },
     },
     timeout: 30000,
   });
   console.log(data.ip);

5. 在静态 IP 之间轮换，并设置可靠的超时

   在 proxies.txt 里每行写一个代理 URL，格式为 http://USERNAME:PASSWORD@HOST:PORT，每行对应你的一个 IP，请求会依次交给下一个客户端。axios 的 timeout 从隧道建立之后才开始计时。测试中，代理接受了连接却一直不回应 CONNECT 时，timeout 没有触发，所以再用 AbortSignal.timeout 给整个请求设一个上限。

   import { readFileSync } from 'node:fs';
   import axios from 'axios';
   import { HttpsProxyAgent } from 'https-proxy-agent';
   
   const clients = readFileSync('proxies.txt', 'utf8')
     .split('\n')
     .map((line) => line.trim())
     .filter(Boolean)
     .map((proxy) =>
       axios.create({ httpsAgent: new HttpsProxyAgent(proxy), proxy: false, timeout: 30000 }),
     );
   
   const urls = Array(6).fill('https://api.ipify.org');
   
   for (const [i, url] of urls.entries()) {
     const client = clients[i % clients.length];
     try {
       const { data } = await client.get(url, { signal: AbortSignal.timeout(45000) });
       console.log(i, data);
     } catch (err) {
       console.log(i, err.code ?? err.message);
     }
   }

常见错误与解决办法

选择哪条产品线

用 axios 调用 API、或读取接受服务器流量的网站时，数据中心 IP 最省钱，轮换循环会把负载分摊到你租的每个 IP 上。网站开始拒绝数据中心 IP 段时，把这个任务换到住宅代理。脚本每天都要登录同一个账号时，给它一个 ISP IP。

其他接入指南

有不明白的词？ 术语表用大白话解释。