如何在 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：

pip install langchain

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

pip install langchain-openai

pip install langchain-anthropic

pip install langchain-google-genai

通过环境变量配置代理

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

Linux/macOS：

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

Windows：

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

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

OpenAI + LangChain 使用代理

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 使用代理

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 使用代理

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 或浏览器工具时，同样可以继承系统代理配置。

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：

from langchain.agents import initialize_agent

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

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

Browser Use + LangChain 使用代理

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

from browser_use.browser.browser import Browser

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

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

Docker 部署 LangChain 应用

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

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

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

验证代理是否生效

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

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 有关，而不是代理配置问题。