> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeus.agentspro.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 代理 IP

> 为浏览器分身配置代理服务器，实现不同 IP 地址的流量路由

Zeus Desktop 允许为每个浏览器分身分配独立的代理服务器，实现每个浏览会话使用不同的 IP 地址和地理位置。

## 概述

代理支持是创建真正隔离浏览环境的关键组件。通过为不同分身分配不同的代理，每个分身看起来来自不同的位置、IP 地址和网络——这对于多账号管理、区域测试和隐私保护至关重要。

### 支持的代理类型

| 类型         | 协议          | 适用场景               |
| ---------- | ----------- | ------------------ |
| **HTTP**   | `http://`   | 常规网页浏览，最常见的代理类型    |
| **HTTPS**  | `https://`  | 加密代理通道，用于安全浏览      |
| **SOCKS5** | `socks5://` | 底层代理，支持所有协议，适合高级使用 |

## 配置方法

### 设置代理

在分身创建（或编辑）对话框中，切换到**代理设置**标签页：

1. **启用代理** — 打开开关以激活代理设置
2. **代理类型** — 选择 HTTP、HTTPS 或 SOCKS5
3. **主机** — 输入代理服务器的主机名或 IP（如 `192.168.1.100`）
4. **端口** — 输入代理服务器端口（如 `1080`）
5. **用户名**（可选）— 需要认证的代理填写
6. **密码**（可选）— 需要认证的代理填写

### 配置示例

```
类型:     SOCKS5
主机:     proxy.example.com
端口:     1080
用户名:   user123
密码:     ********
```

## 工作原理

### 命令行代理

当启动配置了代理的分身时，Zeus 会将 `--proxy-server` 参数传递给 Chrome：

```
chrome --proxy-server=socks5://proxy.example.com:1080
```

这会将**所有浏览器流量**路由到指定的代理服务器。

### 代理认证（CDP）

如果代理需要用户名/密码认证，Zeus 会通过 Chrome DevTools Protocol 自动处理：

```mermaid theme={null}
sequenceDiagram
    participant Chrome
    participant Proxy as 代理服务器
    participant CDP as Zeus CDP 处理器

    Chrome->>Proxy: 请求（通过 --proxy-server）
    Proxy-->>Chrome: 407 需要代理认证
    Chrome->>CDP: Fetch.authRequired 事件
    CDP->>Chrome: Fetch.continueWithAuth（凭据）
    Chrome->>Proxy: 带凭据的请求
    Proxy-->>Chrome: 200 OK（代理后的响应）
```

实现机制：

* `Fetch.enable({ handleAuthRequests: true })` — 启用认证拦截
* `Fetch.authRequired` 事件监听 — 自动使用存储的凭据响应

用户不会看到任何代理认证弹窗——一切都在后台自动完成。

## 代理测试

保存代理配置前，你可以直接在 UI 中测试连接。

### 测试流程

1. 点击\*\*"测试代理"\*\*按钮
2. Zeus 通过配置的代理向 `httpbin.org/ip` 发送测试请求
3. 显示结果：
   * **成功/失败**状态
   * **出口 IP** — 目标服务器看到的公网 IP 地址
   * **延迟** — 往返时间（毫秒）

### 测试内容

| 检查项       | 描述             |
| --------- | -------------- |
| **连通性**   | 能否连接到代理服务器？    |
| **认证**    | 凭据（如有）是否被接受？   |
| **出口 IP** | 外部世界看到的是什么 IP？ |
| **延迟**    | 代理连接有多快？       |

## 最佳实践

### 代理选择

* **住宅代理** — 反检测效果最好，表现为普通家庭用户
* **数据中心代理** — 速度更快但更容易被检测，适合测试使用
* **手机代理** — 信任度最高，适合敏感账号

### 性能建议

* 选择**地理位置靠近**目标网站的代理服务器，以降低延迟
* 使用 **SOCKS5** 获得最佳兼容性——支持 UDP 和所有协议
* 让代理的**地理位置**与分身的时区和语言设置保持一致

### 安全注意事项

* 代理凭据存储在本地分身配置文件中
* 务必使用可信的代理服务商——代理可以看到未加密的 HTTP 流量
* 为了最大安全性，建议配合仅 HTTPS 浏览使用

## 故障排除

### 代理连接失败

1. 确认代理主机和端口正确
2. 检查代理服务器是否在线并接受连接
3. 确保本地防火墙没有阻止到代理端口的出站连接
4. 尝试切换代理类型（HTTP 与 SOCKS5）

### 认证错误

1. 仔细检查用户名和密码
2. 部分代理可能有 IP 白名单——确保你当前的 IP 被允许
3. 检查代理服务商是否有使用限制或已过期

### 使用代理时浏览缓慢

1. 使用内置测试功能测试代理延迟
2. 尝试地理位置更近的代理服务器
3. 考虑升级到更快的代理套餐
4. 检查代理服务商是否限制了带宽