> For the complete documentation index, see [llms.txt](https://docs.ipwo.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipwo.net/ji-cheng-jiao-cheng/gong-ju-yu-dai-li-ruan-jian/ru-he-zai-puppeteer-zhong-shi-yong-ipwo-dai-li.md).

# 如何在 Puppeteer 中使用 IPWO 代理

Puppeteer 是基于 Chromium 的浏览器自动化工具，广泛用于跨境电商、社媒运营、自动化测试与数据采集等场景。

通过搭配 IPWO 住宅代理，可以为不同自动化任务分配独立网络环境，实现更稳定的海外业务访问体验。

本文将介绍如何在 Puppeteer 中配置 IPWO 代理，并验证代理是否生效。

***

### 准备工作

开始前，请确保已经准备好以下内容：

* Node.js 环境
* Puppeteer
* IPWO 代理信息

需要提前从 IPWO 后台获取：

* 代理 IP
* 端口
* 用户名
* 密码

👉 请参考：

* 「[如何获取代理](https://docs.ipwo.net/huo-qu-yu-pei-zhi-dai-li/ru-he-huo-qu-dai-li)」→ 获取完整代理信息
* 「[用户名 & 密码认证](https://docs.ipwo.net/huo-qu-yu-pei-zhi-dai-li/ru-he-huo-qu-dai-li/yong-hu-ming-he-mi-ma-ren-zheng)」→ 查看账密使用方式

👉 动态住宅代理支持参数配置（如地区 / session），可参考「[参数说明](https://docs.ipwo.net/huo-qu-yu-pei-zhi-dai-li/can-shu-shuo-ming)」

***

### 安装 Puppeteer

打开终端或命令行工具，运行以下命令安装 Puppeteer：

```
npm init -ynpm install puppeteer
```

***

### 配置 IPWO HTTP 代理

创建一个文件，例如：

```
puppeteer_ipwo_proxy.js
```

将以下代码复制进去：

```
const puppeteer = require('puppeteer');(async () => {  // IPWO 代理信息  const proxyHost = 'gate.ipwo.net';  const proxyPort = '端口';  const proxyUser = '用户名';  const proxyPass = '密码';  // 启动浏览器  const browser = await puppeteer.launch({    headless: false,    args: [      `--proxy-server=http://${proxyHost}:${proxyPort}`    ]  });  const page = await browser.newPage();  // 设置代理认证  await page.authenticate({    username: proxyUser,    password: proxyPass  });  // 打开 IP 检测页面  await page.goto('https://ipinfo.io');  console.log('代理已连接');})();
```

***

### 运行代码

在终端执行：

```
node puppeteer_ipwo_proxy.js
```

运行后，浏览器会自动打开 IP 检测页面。

如果显示的 IP 与 IPWO 提供的代理 IP 一致，则说明代理配置成功。

***

### 配置 SOCKS5 代理（可选）

如果使用的是 SOCKS5 类型代理，可将代理参数修改为：

```
args: [  `--proxy-server=socks5://${proxyHost}:${proxyPort}`]
```

完整示例：

```
const puppeteer = require('puppeteer');(async () => {  const browser = await puppeteer.launch({    headless: false,    args: [      '--proxy-server=socks5://gate.ipwo.net:端口'    ]  });  const page = await browser.newPage();  await page.authenticate({    username: '用户名',    password: '密码'  });  await page.goto('https://ipinfo.io');})();
```

***

### 常见问题

#### Puppeteer 无法启动浏览器

请检查：

* Node.js 是否安装成功
* Puppeteer 是否正确安装
* 本地 Chromium 是否下载完成

***

#### 代理连接失败

请确认：

* 代理 IP 与端口填写正确
* 用户名与密码无误
* 当前代理套餐仍处于有效状态

***

#### 为什么访问速度较慢？

代理速度可能受到以下因素影响：

* 节点地区
* 本地网络环境
* 当前目标网站负载情况

建议：

* 更换国家节点
* 使用 Sticky Session
* 检查本地网络连接

***

### 适用场景

IPWO 与 Puppeteer 的组合适用于：

| 场景     | 说明      |
| ------ | ------- |
| 跨境电商   | 多地区业务访问 |
| 社媒运营   | 多账号环境管理 |
| 自动化测试  | 海外业务测试  |
| 数据采集   | 稳定网络环境  |
| 浏览器自动化 | 自动化访问流程 |

***

### 相关推荐

* [如何在 Selenium 中使用 IPWO 代理](/ji-cheng-jiao-cheng/gong-ju-yu-dai-li-ruan-jian/ru-he-zai-selenium-zhong-shi-yong-ipwo-dai-li.md)
* [如何在 Playwright 中使用 IPWO 代理](/ji-cheng-jiao-cheng/gong-ju-yu-dai-li-ruan-jian/ru-he-zai-playwright-zhong-shi-yong-ipwo-dai-li.md)