启动会话时配置浏览器代理

约束与限制

• 每个会话最多可配置5个代理。
• 每个代理最多支持100个域名模式。
• Bypass模式使用操作系统原生代理绕过列表，最多支持配置100条域名、IP地址规则。
• 仅支持HTTP/HTTPS/SOCKS5三种代理协议。
• 代理配置在会话创建后不可变，如需修改代理配置，需重新创建会话。

配置方式

浏览器代理在创建会话时配置，创建后不可修改。如需修改代理配置，需终止当前会话并重新创建。

在 browser_session 中通过 proxies 和 bypass_patterns 参数传入代理配置。

from agentarts.sdk.tools import Browser
# 创建浏览器客户端
client = Browser(region="cn-southwest-2", auth_type="API_KEY", verify_ssl=False)
# 配置单个默认代理，并设置 bypass 直连域名
proxy_configuration = {
    "proxies": [
        {
            "server": "proxy.example.com",  # 代理服务器地址
            "port": 8080,                     # 代理服务器端口
            "type": "http"                    # 代理类型：http / https / socks5
        }
    ],
    "bypass": {
        "domain_patterns": ["localhost", "127.0.0.1"]  # 这些域名直连，不走代理
    }
}
# 启动会话并加载代理配置
client.start_session(
    browser_name="your_browser_name",
    session_name="your_session_name",
    api_key="your_api_key",
    proxy_configuration=proxy_configuration
)

配置示例

场景一：单代理配置

企业内网有一个代理服务器，Agent 需要通过该代理访问所有外部网站，但本地地址不走代理。

proxy_configuration = {
    "proxies": [
        {
            "server": "proxy.example.com",  # 代理服务器地址
            "port": 8080,                     # 代理服务器端口
            "type": "http"                    # 代理类型：http / https / socks5
        }
    ],
    "bypass": {
        "domain_patterns": ["localhost", "127.0.0.1"]  # 这些域名直连，不走代理
    }
}

场景二：多代理配置

为不同域名指定不同代理，未命中域名模式的请求走默认代理，同时配置 bypass 直连域名。

# 配置多代理域名路由 + bypass 直连
proxy_configuration = {
    "proxies": [
        {
            "server": "proxy-a.example.com",  # 代理服务器地址
            "port": 8080,                       # 代理服务器端口
            "type": "http",                     # 代理类型
            "domain_patterns": ["example.com", ".example.com"]  # 匹配 example.com 及其子域名
        },
        {
            "server": "proxy-b.example.com",  # 代理服务器地址
            "port": 1080,                       # 代理服务器端口
            "type": "socks5",                   # 代理类型
            "domain_patterns": ["internal.corp", ".internal.corp"]  # 匹配 internal.corp 及其子域名
        },
        {
            "server": "proxy-default.example.com",  # 默认代理（无 domain_patterns）
            "port": 8080,                             # 代理服务器端口
            "type": "http"                            # 代理类型
        }
    ],
    "bypass": {
        "domain_patterns": ["localhost", "127.0.0.1", ".local"]  # 这些域名直连，不走任何代理
    }
}

场景三：需要认证的代理

代理服务器需要用户名密码认证时，通过credential_id引用平台密钥管理服务中预存的凭据。

proxy_configuration = {
    "proxies": [
        {
            "server": "auth-proxy.example.com",  # 代理服务器地址
            "port": 8443,                          # 代理服务器端口
            "type": "https",                       # 代理类型
            "credential_id": "your_credential_id"  # 凭据 ID，引用平台密钥管理服务中的凭据，不明文传递用户名密码
        }
    ],
    "bypass": {
        "domain_patterns": ["localhost", "127.0.0.1"]  # 这些域名直连，不走代理
    }
}