> 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-langchain-xiang-mu-zhong-pei-zhi-ipwo-dai-li.md).

# 如何在 LangChain 项目中配置 IPWO 代理

LangChain 是目前最流行的大语言模型应用开发框架之一，广泛用于构建 AI Agent、RAG（检索增强生成）、自动化工作流和多模型应用。

在某些网络环境下，开发者可能需要通过代理访问 OpenAI、Claude、Gemini 等模型服务，或者访问外部 API、搜索引擎和数据源。通过配置 IPWO 住宅代理，您可以为 LangChain 应用提供稳定的网络连接，并根据业务需求选择不同国家或地区的出口 IP。

本文将介绍如何在 LangChain 项目中配置 IPWO 住宅代理。

***

### 为什么在 LangChain 中使用代理？

LangChain 本身不会直接访问互联网，但其集成的模型、工具和数据源通常需要网络连接。

常见场景包括：

* 调用 OpenAI API
* 调用 Claude API
* 调用 Gemini API
* 使用 Web 搜索工具
* 访问第三方 API
* AI Agent 浏览网页
* 数据采集与分析

通过代理，可以统一管理这些请求的网络出口。

***

### 环境准备

开始之前，请确保已经获取：

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

Username: username
Password: password
```

安装 LangChain：

```bash
pip install langchain
```

根据所使用的模型安装对应 SDK：

```bash
pip install langchain-openai
```

```bash
pip install langchain-anthropic
```

```bash
pip install langchain-google-genai
```

***

### 通过环境变量配置代理

这是最简单且推荐的方式。

Linux/macOS：

```bash
export HTTP_PROXY=http://username:password@us.ipwo.net:7878
export HTTPS_PROXY=http://username:password@us.ipwo.net:7878
```

Windows：

```cmd
set HTTP_PROXY=http://username:password@us.ipwo.net:7878
set HTTPS_PROXY=http://username:password@us.ipwo.net:7878
```

配置后，大多数 LangChain 集成组件会自动通过代理访问网络。

***

### OpenAI + LangChain 使用代理

```python
import os

os.environ["HTTP_PROXY"] = "http://username:password@us.ipwo.net:7878"
os.environ["HTTPS_PROXY"] = "http://username:password@us.ipwo.net:7878"

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="gpt-4o-mini",
    api_key="YOUR_OPENAI_API_KEY"
)

response = llm.invoke("What is a residential proxy?")

print(response.content)
```

***

### Claude + LangChain 使用代理

```python
import os

os.environ["HTTP_PROXY"] = "http://username:password@us.ipwo.net:7878"
os.environ["HTTPS_PROXY"] = "http://username:password@us.ipwo.net:7878"

from langchain_anthropic import ChatAnthropic

llm = ChatAnthropic(
    model="claude-sonnet-4-0",
    api_key="YOUR_CLAUDE_API_KEY"
)

response = llm.invoke("Explain residential proxies.")

print(response.content)
```

***

### Gemini + LangChain 使用代理

```python
import os

os.environ["HTTP_PROXY"] = "http://username:password@us.ipwo.net:7878"
os.environ["HTTPS_PROXY"] = "http://username:password@us.ipwo.net:7878"

from langchain_google_genai import ChatGoogleGenerativeAI

llm = ChatGoogleGenerativeAI(
    model="gemini-2.5-flash",
    google_api_key="YOUR_GEMINI_API_KEY"
)

response = llm.invoke("Explain residential proxies.")

print(response.content)
```

***

### LangChain Agent 使用代理

当 Agent 调用搜索工具、API 或浏览器工具时，同样可以继承系统代理配置。

```python
import os

os.environ["HTTP_PROXY"] = "http://username:password@us.ipwo.net:7878"
os.environ["HTTPS_PROXY"] = "http://username:password@us.ipwo.net:7878"
```

之后启动 Agent：

```python
from langchain.agents import initialize_agent

# 初始化 Agent
agent = initialize_agent(
    tools=[],
    llm=llm
)
```

所有支持系统代理的工具都将自动通过代理访问网络。

***

### Browser Use + LangChain 使用代理

如果您的 Agent 集成 Browser Use，可以直接为浏览器配置代理。

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

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

这样浏览器自动化流量也会通过代理访问目标网站。

***

### Docker 部署 LangChain 应用

如果 LangChain 项目运行在 Docker 容器中，可以在启动时配置代理。

```bash
docker run \
-e HTTP_PROXY=http://username:password@us.ipwo.net:7878 \
-e HTTPS_PROXY=http://username:password@us.ipwo.net:7878 \
your-langchain-app
```

容器中的所有网络请求都会通过代理转发。

***

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

在启动 LangChain 应用前，建议先验证代理连接。

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

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

***

### 常见问题

#### 模型调用超时

可能原因：

* 网络无法访问代理节点
* 代理账号已过期
* 目标服务响应较慢

建议：

* 测试代理连通性
* 更换代理节点
* 增加请求超时时间

***

#### Proxy Authentication Failed

通常表示：

* 用户名错误
* 密码错误
* 代理格式配置错误

请检查：

```
http://username:password@host:port
```

格式是否正确。

***

#### OpenAI、Claude 或 Gemini 返回 401

此类错误通常与 API Key 有关，而不是代理配置问题。

请检查：

* API Key 是否有效
* API Key 是否正确加载
* API 配额是否充足

***

#### Agent 无法访问外部网站

请确认：

* 系统代理已正确配置
* Browser Use 或 Playwright 已正确设置代理
* Docker 容器已继承代理环境变量

***

### 最佳实践

* 推荐通过环境变量统一管理代理配置。
* 长时间运行的 Agent 建议使用 Sticky Session。
* 多 Agent 应用建议为不同任务分配独立 Session。
* 在 Docker、Kubernetes 和云服务器环境中统一管理代理配置。
* 对于网页浏览和数据采集场景，建议结合 Browser Use 或 Playwright 使用住宅代理。

***

### 相关阅读

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

* [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)
* [获取和配置住宅代理](/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)