> 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/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-browser-use-zhong-pei-zhi-ipwo-dai-li.md).

# 如何在 Browser Use 中配置 IPWO 代理

Browser Use 是一个开源 AI Agent 框架，可让大语言模型直接操作浏览器完成网页浏览、数据采集和自动化任务。

在访问目标网站时，为 Browser Use 配置住宅代理可以帮助管理网络出口 IP，提高连接稳定性，并根据业务需求选择不同国家或地区的网络环境。

本文将介绍如何在 Browser Use 中配置 IPWO 住宅代理。

***

### 什么是 Browser Use？

Browser Use 是一个基于 Playwright 的 AI Agent 框架，通过连接 OpenAI、Claude、Gemini 等模型，让 AI 能够像真人一样操作浏览器。

常见应用场景包括：

* AI 网页浏览
* 自动化表单填写
* 数据采集
* 网站监控
* AI Agent 工作流
* 自动化测试

***

### 环境准备

开始之前，请确保已经准备：

* 拥有 [IPWO 住宅代理账号](/readme/zhu-ce-deng-lu.md)
* [获取代理用户名和密码](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi.md)
* 获取代理服务器地址和端口
* OpenAI、Claude 或 Gemini API Key

示例代理信息：

```
Host: us.ipwo.net
Port: 7878

Username: username
Password: password
```

***

### 安装 Browser Use

安装 Browser Use：

```bash
pip install browser-use
```

安装 Playwright 浏览器：

```bash
playwright install
```

***

### 在 Browser Use 中配置代理

Browser Use 底层使用 Playwright，因此可以直接使用 Playwright 的代理配置功能。

示例：

```python
from browser_use import Agent
from browser_use.browser.browser import Browser

browser = Browser(
    proxy={
        "server": "http://us.ipwo.net:7878",
        "username": "username",
        "password": "password"
    }
)

agent = Agent(
    task="Search for the latest AI news",
    browser=browser
)

agent.run()
```

启动后，所有浏览器流量都会通过代理节点访问目标网站。

***

### 指定国家节点

如果您使用国家定向代理，可以在用户名中指定目标国家。

示例：

```python
browser = Browser(
    proxy={
        "server": "http://us.ipwo.net:7878",
        "username": "username_country_us",
        "password": "password"
    }
)
```

此时 Browser Use 将通过美国出口 IP 访问网站。

***

### 与 OpenAI 配合使用

```python
from browser_use import Agent
from browser_use.browser.browser import Browser
from langchain_openai import ChatOpenAI

browser = Browser(
    proxy={
        "server": "http://us.ipwo.net:7878",
        "username": "username",
        "password": "password"
    }
)

agent = Agent(
    task="Find the latest proxy industry news",
    llm=ChatOpenAI(
        model="gpt-4o"
    ),
    browser=browser
)

agent.run()
```

***

### 与 Claude 配合使用

```python
from browser_use import Agent
from browser_use.browser.browser import Browser

browser = Browser(
    proxy={
        "server": "http://us.ipwo.net:7878",
        "username": "username",
        "password": "password"
    }
)

agent = Agent(
    task="Summarize the homepage content",
    browser=browser
)

agent.run()
```

代理配置方式保持一致。

***

### [验证代理](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/kuai-su-yan-zheng.md)是否生效

启动 Browser Use 后，可以访问以下网站验证出口 IP：

```
https://ipinfo.io
```

或者：

```
https://whatismyipaddress.com
```

也可以使用命令行测试：

```bash
curl -x "us.ipwo.net:7878" \
-U "username:password" \
ipinfo.io
```

如果返回代理 IP 信息，则说明代理配置正常。

***

### 常见问题

### Browser 无法启动

请检查：

```bash
playwright install
```

是否已成功执行。

***

#### Connection Timeout

可能原因：

* 网络无法访问代理节点
* 防火墙限制连接
* 代理账号失效

建议先使用 curl 测试代理连接。

***

#### Proxy Authentication Failed

通常表示：

* 用户名错误
* 密码错误
* 代理认证格式错误

请检查代理配置中的：

```
server
username
password
```

是否填写正确。

***

#### 网站仍然显示本地 IP

请确认：

* Browser 实例已正确配置 proxy 参数
* 没有其他浏览器实例绕过代理
* Browser Use 已重新启动

***

### 最佳实践

* 长时间运行的 Browser Use Agent 建议使用 Sticky Session。
* 针对数据采集任务，可结合 IP 轮换功能降低封禁风险。
* 不同 Agent 建议使用独立 Session。
* 对于 Google、Amazon、TikTok 等高风控网站，建议使用住宅代理而非数据中心代理。
* 在 Docker 或云服务器环境中部署时，建议统一管理代理配置。

***

### 相关阅读

完成 Browser Use 代理配置后，您可能还需要：

* [OpenAI SDK 使用代理](/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-openai-sdk-zhong-shi-yong-ipwo-dai-li.md)
* [Claude API 使用代理](/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-claude-api-zhong-shi-yong-ipwo-dai-li.md)
* [Gemini API 使用代理](/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-gemini-api-zhong-shi-yong-ipwo-dai-li.md)
* [LangChain 使用住宅代理](/kai-fa-zhe-wen-dang/ai-agent-kai-fa/ru-he-zai-langchain-xiang-mu-zhong-pei-zhi-ipwo-dai-li.md)
* [获取和配置住宅代理](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi.md)
* [如何检测代理是否生效](/dai-li-jian-ce-yu-yin-si-an-quan/ru-he-jian-ce-dai-li-shi-fou-sheng-xiao.md)
* [407 Proxy Authentication Required](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/407-proxy-authentication-required.md)
* [超时 Timeout](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/chao-shi-timeout.md)