Mobile Proxy Node.js 配置
移动代理 Node.js 分步设置教程。使用专用的 4G/5G 运营商 IP 地址配置 axios、node-fetch、Puppeteer 和 Playwright，以实现可靠的 JavaScript 自动化。
- https-proxy-agent 集成 — 将 axios 和原生 fetch 请求通过经过身份验证的 HTTP 隧道进行转发。
- socks-proxy-agent 支持 — 在现代 Node.js 运行时环境中全面支持 SOCKS5 协议，并具备远程 DNS 解析功能。
- Puppeteer 页面身份验证 — 使用 page.authenticate() 或 Chrome 运行时标志处理代理凭据提示。
- Playwright 上下文隔离 — 为每个浏览器上下文分配专用的移动代理，实现无信息泄露的多账户管理。
Node.js 代理选项
与浏览器运行时或 Python 不同，Node.js 在默认情况下不会自动读取 HTTP_PROXY 环境变量以处理内置的 HTTP 请求。在现代 JavaScript 和 TypeScript 后端中，若要通过代理路由出站流量，则需要配置 Agent 分发器，或将网络参数传递给高级浏览器自动化框架。
| 工具 / 库 | 代理方法 | 身份验证处理 | 用例 |
|---|---|---|---|
| axios | https-proxy-agent | 内联 URL 凭据 | REST API、后端微服务 |
| fetch (Node 18+) | undici ProxyAgent | ProxyAgent 基本身份验证 | 标准 Web API、Next.js 后端 |
| Puppeteer | args + page.authenticate | CDP 事件拦截 | 无头 Chrome 自动化 |
| Playwright | 上下文代理配置 | 本机服务器对象 | 现代浏览器数据抓取与测试 |
axios 和 node-fetch 的配置
在使用 axios 时，开发人员经常尝试传递一个基本的 { host, port, auth } 代理对象。虽然这种方法在明文 HTTP 请求中可行，但在 HTTPS 目标上却常常会导致连接重置错误。业界标准的解决方案是安装 https-proxy-agent 或 socks-proxy-agent，以建立干净的 HTTP CONNECT 隧道。
import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';
// Define dedicated PXM2 mobile proxy endpoint
const proxyUrl = 'http://user123:secret456@proxy.pxm2.io:8000';
const httpsAgent = new HttpsProxyAgent(proxyUrl);
// Create reusable axios client instance
const client = axios.create({
httpsAgent,
timeout: 15000,
headers: {
'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
},
});
async function checkCarrierIp() {
try {
const response = await client.get('https://ipinfo.io/json');
console.log('Connected through mobile IP:', response.data.ip);
} catch (err) {
console.error('Proxy request failed:', err.message);
}
}
checkCarrierIp();
要在 Node.js 中使用 SOCKS5 代理，请安装 socks-proxy-agent 并初始化 SocksProxyAgent('socks5h://user:pass@proxy.pxm2.io:1080')。socks5h 协议可确保在不泄露客户端信息的情况下进行远程 DNS 解析。
Puppeteer 代理配置
Puppeteer 会启动一个外部 Chromium 二进制文件。由于 Chrome 不接受在命令行参数中内联用户名和密码凭据，因此 Puppeteer 需要分两步操作：先使用 --proxy-server 参数启动浏览器，再调用 page.authenticate() 方法，通过 Chrome DevTools 协议 (CDP) 提供凭据。
import puppeteer from 'puppeteer';
async function runBrowser() {
const browser = await puppeteer.launch({
headless: 'new',
args: [
// 1. Pass host and port to Chrome flags
'--proxy-server=http://proxy.pxm2.io:8000',
'--no-sandbox',
],
});
const page = await browser.newPage();
// 2. Intercept 407 authentication challenges
await page.authenticate({
username: 'user123',
password: 'secret456',
});
await page.goto('https://ipinfo.io', { waitUntil: 'domcontentloaded' });
const ip = await page.$eval('body', el => el.innerText);
console.log('Puppeteer IP verified:', ip);
await browser.close();
}
runBrowser();
Playwright 代理设置
与 Puppeteer 相比，Playwright 提供了更简洁的代理配置机制。Playwright 无需依赖 CDP 身份验证拦截，而是允许您在上下文级别定义代理设置。这使得在单个 Chromium 实例中，可以同时为不同的浏览器上下文分配不同的移动代理。
import { chromium } from 'playwright';
async function main() {
const browser = await chromium.launch({ headless: true });
// Create isolated context with dedicated mobile proxy
const context = await browser.newContext({
proxy: {
server: 'http://proxy.pxm2.io:8000',
username: 'user123',
password: 'secret456',
},
userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36',
});
const page = await context.newPage();
await page.goto('https://api.ipify.org?format=json');
console.log(await page.textContent('body'));
await context.close();
await browser.close();
}
main();
Node.js 代理的最佳实践
在大型规模上运行 Node.js 爬虫和机器人时，合理的连接池管理和内存维护至关重要：
-
1. 在代理代理上启用 Keep-Alive 功能请务必在 HttpsProxyAgent 选项中设置 keepAlive: true。重复使用持久化 TCP 套接字可在每次连续请求中节省 100 毫秒至 250 毫秒的蜂窝网络延迟。
-
2. 关闭空闲上下文在“Playwright and Puppeteer”中，切勿让未使用的浏览器上下文或页面保持打开状态。滞留的上下文会消耗内存，并保持与蜂窝调制解调器的套接字连接。
-
3. 处理按需旋转延迟在 Node.js 中通过 PXM2 Webhook 触发 IP 轮换时，请将轮换调用封装在一个 Promise 中，该 Promise 会在解决请求队列之前暂停 6 秒。
法国
新加坡
印度
常见问题解答
如何在 Node.js 中使用 axios 配合移动代理？
在现代版本的 Axios 中，请使用 https-proxy-agent 或 socks-proxy-agent 创建 httpAgent 或 httpsAgent，并将其传递给您的 Axios 实例。这样可以规避基本代理对象配置中的问题，并确保 HTTPS 完全支持 CONNECT 隧道。
Playwright 是如何处理代理身份验证的？
Playwright 支持直接在浏览器中进行代理身份验证：browser.newContext({ proxy: { server, username, password } })，或在浏览器启动时进行。与 Puppeteer 不同，Playwright 在网络协议层处理身份验证，无需在页面级别弹出窗口。
我可以在原生的 Node.js fetch API 中使用移动代理吗？
是的。在 Node.js 18 及更高版本中，全局 fetch 功能使用 Undici。您可以通过传递来自 Undici 的自定义 Dispatcher 实例（ProxyAgent）来配置代理，或者通过设置标准的 HTTP_PROXY 环境变量并配合 undici-fetch 来实现。
为什么通过 Node.js HTTP 代理建立的 WebSocket 连接会失败？
WebSockets 需要 HTTP 101 “切换协议” 升级。当通过 HTTP 代理路由 WebSockets 时，请确保您的代理服务器支持 HTTP CONNECT 方法，或者切换到 SOCKS5 代理，该代理会在不检查有效载荷头的情况下隧道传输原始 TCP 流。
如何在 Node.js 脚本中管理移动代理 IP 的轮换？
通过 API 进行轮换时，请向您的 PXM2 轮换 URL 发送一个 HTTP GET 请求。请稍作 5 到 10 秒的延迟，以便蜂窝调制解调器建立新的运营商会话，然后在继续操作前，请对 https://api.ipify.org 执行 IP 检查。
相关移动代理指南
探索相关的开发者教程、语言集成以及移动代理基础设施指南。