gemini-proxy-client 1.0.13 → 1.0.15

package/README.md

@@ -4,160 +4,212 @@
 
 ## 特性
 
-- **反指纹检测**: 使用 Camoufox (基于 Firefox) 防止 Google 检测多账号
-- **自动登录管理**: 首次需要手动登录，之后自动保持登录状态
+- **反指纹检测**: 使用 Camoufox (基于 Firefox) 防止浏览器指纹识别
+- **随机指纹**: 每个账号自动生成独立的浏览器指纹（分辨率、语言、时区）
+- **多账号支持**: 可同时运行多个客户端连接不同 Google 账号
+- **自动登录管理**: 首次需要手动登录，之后自动切换到无头模式
 - **自动连接**: 自动点击 "Continue to the app" 和 "Connect WS" 按钮
-- **连接验证**: 自动检测 WebSocket 连接是否成功（按钮文字变为 "Disconnect WS"）
+- **连接验证**: 自动检测 WebSocket 连接是否成功
 - **自动保活**: 每 2 小时检查登录状态，断线自动重连
-- **无头运行**: 登录后可在后台无头运行，节省资源
 
-## 安装
+## 快速开始
+
+### 1. 安装
 
 ```bash
 npm install -g gemini-proxy-client
 ```
 
-安装时会自动下载 Camoufox 浏览器（约 200MB）。如果下载失败，手动执行：
+### 2. 安装 Camoufox 浏览器
 
 ```bash
-npx camoufox-js fetch
+gemini-client setup
 ```
 
-## 使用方法
-
-### 启动客户端
+这会下载 Camoufox 浏览器（约 200MB）。如果网络有问题，可以设置代理：
 
 ```bash
-# 连接到代理服务器
-gemini-client start --server wss://your-server.com/v1/ws
-
-# 或使用简写
-gemini-client start -s wss://your-server.com/v1/ws
+export https_proxy=http://127.0.0.1:7890
+gemini-client setup
 ```
 
-**首次运行**会打开浏览器窗口，请登录您的 Google 账号。登录成功后，cookies 会自动保存，之后运行将使用无头模式。
+### 3. 启动客户端
 
-**成功启动**后会显示：
-
-```
-✅ 点击了 "Continue to the app" 按钮
-✅ 点击了连接按钮
-  检测按钮文字: "Disconnect WS"
-✅ WebSocket 连接成功！
+```bash
+gemini-client start --server ws://your-server:5345/v1/ws
 ```
 
-### 后台运行
+**首次运行**会：
+1. 打开浏览器窗口
+2. 等待您登录 Google 账号
+3. 登录成功后自动保存 cookies
+4. 关闭浏览器，以无头模式重新启动
+5. 自动连接到代理服务器
+
+**之后运行**会直接以无头模式启动，无需再登录。
 
-#### 方式 1: 使用 nohup（简单）
+### 4. 后台运行
 
 ```bash
-nohup gemini-client start -s wss://your-server.com/v1/ws > gemini-client.log 2>&1 &
+# 使用 nohup 后台运行
+nohup gemini-client start -s ws://your-server:5345/v1/ws > gemini-client.log 2>&1 &
 
 # 查看日志
 tail -f gemini-client.log
 
 # 停止
-kill $(ps aux | grep 'gemini-client start' | grep -v grep | awk '{print $2}')
+pkill -f gemini-client
 ```
 
-#### 方式 2: 使用 screen
+## 多账号配置
+
+可以在同一台机器上同时运行多个客户端，连接不同的 Google 账号：
 
 ```bash
-# 安装 screen
-sudo apt-get install screen  # Ubuntu/Debian
-sudo yum install screen      # CentOS/RHEL
+# 账号 1 - 首次运行会弹出浏览器登录
+nohup gemini-client start \
+  --data-dir ~/.gemini-client/account1 \
+  -s ws://your-server:5345/v1/ws \
+  > account1.log 2>&1 &
+
+# 账号 2 - 使用不同的 data-dir
+nohup gemini-client start \
+  --data-dir ~/.gemini-client/account2 \
+  -s ws://your-server:5345/v1/ws \
+  > account2.log 2>&1 &
+
+# 账号 3
+nohup gemini-client start \
+  --data-dir ~/.gemini-client/account3 \
+  -s ws://your-server:5345/v1/ws \
+  > account3.log 2>&1 &
+```
 
-# 创建会话并运行
-screen -S gemini
-gemini-client start
+每个 `--data-dir` 会独立保存：
+- `cookies.json` - Google 登录状态
+- `fingerprint.json` - 浏览器指纹配置
+- `config.json` - 其他配置
 
-# 按 Ctrl+A 然后按 D 分离会话
-# 重新连接: screen -r gemini
-# 查看所有会话: screen -ls
-```
+### 随机指纹
+
+每个账号首次启动时会自动生成随机的浏览器指纹：
+
+| 项目 | 随机化范围 |
+|------|-----------|
+| 分辨率 | 1920x1080, 1366x768, 1440x900 等 10 种 |
+| 语言 | en-US, zh-CN, ja-JP 等 10 种 |
+| 时区 | America/New_York, Asia/Shanghai 等 10 种 |
 
-#### 方式 3: 使用 pm2（推荐）
+指纹保存后会保持一致，避免同一账号频繁变化被检测。
+
+## 命令参考
+
+### start - 启动客户端
 
 ```bash
-# 安装 pm2
-npm install -g pm2
+gemini-client start [options]
+```
 
-# 启动
-pm2 start "gemini-client start" --name gemini-client
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-s, --server <url>` | 代理服务器 WebSocket 地址 | `ws://localhost:5345/v1/ws` |
+| `-t, --token <token>` | 客户端认证令牌 | 自动生成 |
+| `-d, --daemon` | 后台运行模式 | false |
+| `--headless` | 强制无头模式 | 自动判断 |
+| `--data-dir <path>` | 数据目录路径 | `~/.gemini-client` |
 
-# 查看日志
-pm2 logs gemini-client
+### setup - 安装 Camoufox 浏览器
 
-# 停止
-pm2 stop gemini-client
+```bash
+gemini-client setup
+```
 
-# 重启
-pm2 restart gemini-client
+下载并安装 Camoufox 浏览器，首次使用前必须执行。
 
-# 开机自启
-pm2 startup
-pm2 save
+### login - 登录 Google 账号
+
+```bash
+gemini-client login [--data-dir <path>]
 ```
 
-#### 方式 4: 使用 Xvfb（无图形界面服务器）
+单独执行登录操作，会打开浏览器让您登录 Google 账号。
 
-如果是纯命令行服务器，需要安装虚拟显示：
+### logout - 清除登录状态
 
 ```bash
-# Ubuntu/Debian
-sudo apt-get install xvfb
+gemini-client logout [--data-dir <path>]
+```
+
+删除保存的 cookies，下次启动需要重新登录。
+
+### status - 查看状态
 
-# 使用 xvfb-run 运行
-nohup xvfb-run gemini-client start -s wss://your-server.com/v1/ws > gemini-client.log 2>&1 &
+```bash
+gemini-client status [--data-dir <path>]
 ```
 
-### 其他命令
+查看当前登录状态和配置信息。
+
+## 使用 PM2 管理（推荐）
+
+使用 PM2 可以更方便地管理多个客户端：
 
 ```bash
-# 单独登录 Google 账号
-gemini-client login
+# 安装 PM2
+npm install -g pm2
+
+# 启动多个账号
+pm2 start "gemini-client start --data-dir ~/.gemini-client/account1 -s ws://server:5345/v1/ws" --name account1
+pm2 start "gemini-client start --data-dir ~/.gemini-client/account2 -s ws://server:5345/v1/ws" --name account2
+pm2 start "gemini-client start --data-dir ~/.gemini-client/account3 -s ws://server:5345/v1/ws" --name account3
 
 # 查看状态
-gemini-client status
+pm2 status
 
-# 清除登录状态
-gemini-client logout
+# 查看日志
+pm2 logs
 
-# 查看帮助
-gemini-client --help
-```
+# 停止所有
+pm2 stop all
 
-## 命令参考
+# 开机自启
+pm2 startup
+pm2 save
+```
 
-### start - 启动客户端
+## 无图形界面服务器
 
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `-s, --server <url>` | 代理服务器 WebSocket 地址 | `ws://localhost:5345/v1/ws` |
-| `-t, --token <token>` | 客户端认证令牌 | 自动生成 `gp_client_YYYY_MM_DD_HH_mm_ss` |
-| `-d, --daemon` | 后台运行模式 | false |
-| `--headless` | 强制无头模式 | 自动判断 |
-| `--data-dir <path>` | 数据目录路径 | `~/.gemini-client` |
+如果是纯命令行服务器（无桌面环境），需要安装虚拟显示：
 
-## 数据存储
+```bash
+# Ubuntu/Debian
+sudo apt-get install xvfb
 
-默认数据目录: `~/.gemini-client/`
+# 使用 xvfb-run 运行（首次登录时需要）
+xvfb-run gemini-client start --data-dir ~/.gemini-client/account1 -s ws://server:5345/v1/ws
+```
 
-| 文件 | 说明 |
-|------|------|
-| `cookies.json` | Google 登录 cookies |
-| `config.json` | 配置信息 |
+注意：首次登录需要在有图形界面的环境中完成（或使用 VNC/远程桌面）。
 
 ## 工作流程
 
-1. 启动 Camoufox 浏览器
-2. 打开 Build App 页面
-3. 检查 Google 登录状态，未登录则等待用户手动登录
-4. 点击 "Continue to the app" 按钮（如果存在）
-5. 关闭可能遮挡的模态框
-6. 在 Build App iframe 中点击 "Connect WS" 按钮
-7. 验证连接成功（按钮文字变为 "Disconnect WS"）
-8. 启动保活机制（每 2 小时检查登录状态）
+```
+首次启动
+    ↓
+打开浏览器 UI → 用户登录 Google
+    ↓
+保存 cookies 和 fingerprint
+    ↓
+关闭浏览器 → 以无头模式重新启动
+    ↓
+自动点击 "Continue to the app"
+    ↓
+自动点击 "Connect WS" 按钮
+    ↓
+验证连接成功 → 后台运行
+    ↓
+定期检查登录状态（每 2 小时）
+```
 
 ## 保活机制
 
@@ -170,14 +222,14 @@ gemini-client --help
 
 - Node.js >= 18.0.0
 - 能够访问 GitHub（下载 Camoufox 浏览器）
-- 能够访问 Google AI Studio（非中国大陆 IP）
-- 图形界面或 Xvfb（虚拟显示）
+- 能够访问 Google AI Studio
+- 图形界面或 Xvfb（首次登录需要）
 
 ## 常见问题
 
 ### Q: Camoufox 下载失败怎么办？
 
-设置代理或手动下载：
+设置代理后重试：
 
 ```bash
 export https_proxy=http://127.0.0.1:7890
@@ -188,18 +240,23 @@ npx camoufox-js fetch
 
 通常 1-2 周，但可能因 IP 变化、长时间无活动或 Google 安全检测而提前失效。
 
-### Q: 可以同时运行多个客户端吗？
+### Q: 多账号会被检测到吗？
 
-可以，使用不同的 `--data-dir` 参数：
+Camoufox + 随机指纹可以降低检测风险，但同一 IP 运行过多账号仍有风险。建议：
+- 同一 IP 不超过 2-3 个账号
+- 使用代理让不同账号走不同 IP（效果更好）
 
-```bash
-gemini-client start -s wss://server.com/v1/ws --data-dir ~/.gemini-client-1
-gemini-client start -s wss://server.com/v1/ws --data-dir ~/.gemini-client-2
-```
+### Q: 如何确认连接成功？
 
-### Q: 如何查看客户端是否连接成功？
+查看日志，成功连接会显示：
 
-启动后查看日志，如果看到 `✅ WebSocket 连接成功！` 和 `检测按钮文字: "Disconnect WS"`，说明连接成功。
+```
+✅ 点击了 "Continue to the app" 按钮
+✅ 点击了连接按钮
+  检测按钮文字: "Disconnect WS"
+✅ WebSocket 连接成功！
+✅ 客户端已启动 (无头模式)
+```
 
 ## License
 

package/dist/cli.js

@@ -12,7 +12,7 @@ const program = new Command();
 program
     .name('gemini-client')
     .description('Gemini Proxy Build App 客户端 - 使用 Camoufox 自动保持连接')
-    .version('1.0.13');
+    .version('1.0.15');
 program
     .command('start')
     .description('启动客户端，连接到代理服务器')
@@ -70,4 +70,19 @@ program
         console.log(chalk.yellow('⚠️ 没有保存的登录状态'));
     }
 });
+program
+    .command('setup')
+    .description('安装 Camoufox 浏览器')
+    .action(async () => {
+    console.log(chalk.cyan('📦 安装 Camoufox 浏览器...'));
+    const { execSync } = await import('child_process');
+    try {
+        execSync('npx camoufox-js fetch', { stdio: 'inherit' });
+        console.log(chalk.green('✅ Camoufox 安装成功！'));
+    }
+    catch (error) {
+        console.error(chalk.red('❌ 安装失败，请检查网络连接'));
+        process.exit(1);
+    }
+});
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gemini-proxy-client",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "Gemini Proxy Build App 客户端 - 使用 Camoufox 自动保持连接",
   "main": "dist/index.js",
   "bin": {