> ## 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.

# 浏览器配置

> 管理多个隔离的浏览器配置，实现独立的浏览环境

Zeus Desktop 支持**多分身浏览器管理**，允许你创建和管理多个完全隔离的浏览器实例——每个分身都拥有独立的 Cookie、存储、登录状态、代理和指纹配置。

## 概述

浏览器分身是 Zeus Desktop 的核心功能，提供类似花漾浏览器、Multilogin、AdsPower 等产品的环境隔离能力。每个分身运行在完全独立的 Chrome 实例中，使用独立的 `user-data-dir`，确保分身之间的数据完全隔离。

### 核心能力

| 功能       | 描述                                    |
| -------- | ------------------------------------- |
| **完全隔离** | 每个分身拥有独立的 Cookie、localStorage、缓存和登录会话 |
| **代理支持** | 为每个分身配置独立的 HTTP/HTTPS/SOCKS5 代理       |
| **指纹伪装** | 自定义浏览器指纹，防止追踪和检测                      |
| **视觉标识** | 为每个分身分配独特的颜色和图标，便于快速识别                |
| **并发运行** | 同时运行多个分身，互不干扰                         |

## 架构

```mermaid theme={null}
flowchart TB
    subgraph ProfileManager["分身管理器"]
        PM["ProfileManager\n(单例)"]
        PM --> P1["分身 A\nuser-data-dir-a"]
        PM --> P2["分身 B\nuser-data-dir-b"]
        PM --> P3["分身 C\nuser-data-dir-c"]
    end

    subgraph BrowserInstances["Chrome 实例"]
        P1 --> C1["Chrome (端口 9222)\n+ 代理 A\n+ 指纹 A"]
        P2 --> C2["Chrome (端口 9223)\n+ 代理 B\n+ 指纹 B"]
        P3 --> C3["Chrome (端口 9224)\n+ 代理 C\n+ 指纹 C"]
    end

    subgraph CDP["CDP 注入"]
        C1 --> I1["指纹注入器"]
        C2 --> I2["指纹注入器"]
        C3 --> I3["指纹注入器"]
    end
```

## 分身数据模型

每个浏览器分身存储以下配置信息：

```typescript theme={null}
interface BrowserProfile {
  id: string;               // 唯一标识符
  name: string;             // 显示名称
  color: string;            // 颜色标签
  iconPath?: string;        // 自定义图标路径
  browserDataPath: string;  // Chrome user-data-dir 路径
  createdAt: string;        // 创建时间
  lastUsedAt?: string;      // 最后使用时间
  homepageUrl?: string;     // 首页网址
  userAgent?: string;       // 自定义 User-Agent
  proxy?: ProxyConfig;      // 代理设置（详见代理 IP 文档）
  fingerprint?: FingerprintConfig; // 指纹设置（详见指纹文档）
}
```

## 创建分身

分身创建对话框分为三个标签页：

### 1. 基本信息

* **分身名称**（必填）— 用于识别分身的描述性名称
* **首页网址**（可选）— 启动分身时打开的页面

### 2. 代理设置

为分身配置独立代理。详见 [代理 IP](/zh/desktop/proxy-ip)。

### 3. 指纹配置

自定义浏览器指纹。详见 [浏览器指纹](/zh/desktop/browser-fingerprint)。

## 分身生命周期

```mermaid theme={null}
flowchart LR
    A["创建分身"] --> B["配置\n(代理 + 指纹)"]
    B --> C["启动浏览器"]
    C --> D["CDP 连接\n(自动分配端口)"]
    D --> E["注入指纹"]
    E --> F["就绪"]
    F --> G["关闭浏览器"]
    G --> H["数据持久化\n保存在 user-data-dir"]
```

### 启动流程

当你启动一个分身时，Zeus Desktop 会执行以下步骤：

1. **分配调试端口** — 查找可用端口用于 Chrome DevTools Protocol (CDP)
2. **构建启动参数** — 组装 Chrome 启动标志，包括 `--user-data-dir`、`--proxy-server`、`--user-agent`、`--lang`
3. **启动 Chrome 进程** — 使用配置的参数启动一个 Chrome 实例
4. **等待 CDP 就绪** — 轮询调试端口直到 Chrome 准备就绪
5. **注入指纹** — 通过 CDP WebSocket 连接注入高级指纹覆盖和反检测脚本
6. **就绪** — 浏览器准备就绪，可以使用

### macOS 应用封装

在 macOS 上，每个分身会被封装为独立的 `.app` 应用程序包，在 Dock 中显示为独立应用，拥有自己的图标和名称。这提供了原生的 macOS 体验，每个分身看起来就像一个独立的应用程序。

## 数据隔离

每个分身的数据存储在独立的目录中：

```
~/.zeus-profiles/
├── profile-abc123/
│   ├── Default/           # Chrome 用户数据
│   ├── Cookies
│   ├── Local Storage/
│   └── ...
├── profile-def456/
│   ├── Default/
│   └── ...
└── profiles.json          # 分身元数据
```

这确保了：

* **Cookie 不会泄漏**到其他分身
* **登录会话完全独立**
* **缓存和历史记录独立**
* **localStorage 完全隔离**

## 管理分身

### 查看配置

点击分身卡片上的设置图标，可以查看完整配置信息：

* 基本信息（名称、首页）
* 代理状态（类型、地址、认证状态）
* 指纹摘要（UA、语言、时区、分辨率、保护状态）

### 更新分身

你可以随时修改分身的配置。代理和指纹设置的更改将在下次启动浏览器时生效。

### 删除分身

删除分身会同时移除元数据和关联的 `user-data-dir`，永久清除该分身的所有浏览数据。