# Standalone CLI 配置说明

这个文件用来解释 `/root/standalone_cli/data/sync_config.json` 里常用字段该怎么填。

注意：`sync_config.json` 是 JSON，不能直接写注释，所以说明单独放在这里。

## 最少需要关心的字段

如果你只是先跑起来，优先看这几项：

- `proxy`
- `mail_providers`
- `mail_provider_configs`
- `cpa_base_url`
- `cpa_token`
- `base_url`
- `bearer_token` 或 `email` + `password`

## 字段说明

### 1. `proxy`

作用：注册 OpenAI 时使用的固定代理。

注意：这个代理只用于 OpenAI 注册流程；邮箱服务接口默认直连，不使用代理。

常见填写示例：

```json
"proxy": "http://127.0.0.1:17891"
```

如果你本地跑了 Clash / Mihomo / sing-box，一般就是本机 HTTP 代理端口。

按当前这台机器的实测结果，`17891` 是可用的 US 出口代理。

如果你不想走固定代理，也可以留空：

```json
"proxy": ""
```

## 2. `auto_register`

作用：用于池维护场景下，是否允许在账号不足时自动触发注册。

一般先保持：

```json
"auto_register": false
```

## 3. `mail_providers`

作用：启用哪些邮箱提供商。

当前可选值通常包括：

- `mailtm`
- `duckmail`
- `moemail`
- `cloudflare_temp_email`

示例：只用 `mailtm`

```json
"mail_providers": ["mailtm"]
```

示例：多个提供商轮询

```json
"mail_providers": ["mailtm", "duckmail", "moemail"]
```

## 4. `mail_provider_configs`

作用：为每个邮箱提供商填写自己的连接参数。

### `mailtm`

通常默认即可：

```json
"mailtm": {
  "api_base": "https://api.mail.tm"
}
```

### `duckmail`

如果你要用 DuckMail：

```json
"duckmail": {
  "api_base": "https://api.duckmail.sbs"
}
```

当前建议：DuckMail 直连，不要走 OpenAI 的代理；否则在当前环境下可能出现 `502 Bad Gateway`。

如果你填写了 `domain`，程序会固定使用这个域名创建邮箱，不会再随机选择其他 DuckMail 域名。

例如：

```json
"duckmail": {
  "api_base": "https://api.duckmail.sbs",
  "bearer_token": "your_duckmail_token",
  "domain": "cursors.online"
}
```

实际创建出来的邮箱会像：

```text
ocxxxxxxx@cursors.online
```

也就是说，前缀是程序随机生成的，但域名会固定用你填写的 `cursors.online`。

### `moemail`

如果你有 MoeMail 服务：

```json
"moemail": {
  "api_base": "https://your-moemail.example.com",
  "api_key": "your_moemail_api_key"
}
```

### `cloudflare_temp_email`

如果你自己有 Cloudflare Worker 邮箱接口：

```json
"cloudflare_temp_email": {
  "api_base": "https://your-worker.example.com",
  "admin_password": "your_admin_password",
  "domain": "example.com"
}
```

这里几项的含义：

- `api_base`：你的 Worker 接口地址
- `admin_password`：你的 Worker 后端管理密码
- `domain`：临时邮箱生成时使用的域名后缀

## 5. `mail_strategy`

作用：多个邮箱提供商启用时的调度策略。

可选值：

- `round_robin`：轮询，推荐默认
- `random`：随机
- `failover`：优先一个，失败再切下一个

推荐：

```json
"mail_strategy": "round_robin"
```

## 6. `base_url`

作用：Sub2Api 平台地址。

示例：

```json
"base_url": "https://sub2api.example.com"
```

要求：

- 必须带 `http://` 或 `https://`
- 不能写成纯域名裸字符串

错误示例：

```json
"base_url": "sub2api.example.com"
```

正确示例：

```json
"base_url": "https://sub2api.example.com"
```

## 7. `bearer_token`

作用：Sub2Api 管理员 Bearer Token。

如果你已经知道管理员 Token，可以直接填：

```json
"bearer_token": "your_sub2api_bearer_token"
```

## 8. `email` 和 `password`

作用：如果你不想手动填 `bearer_token`，可以填 Sub2Api 管理员账号密码，让 CLI 去登录并获取 token。

示例：

```json
"email": "admin@example.com",
"password": "your_password"
```

通常两种方式二选一：

- 方式 A：填 `bearer_token`
- 方式 B：填 `email` + `password`

## 9. `account_name`

作用：导入或展示时默认账号名称前缀。

一般默认就行：

```json
"account_name": "AutoReg"
```

## 10. `auto_sync`

作用：注册成功后，是否自动同步到 Sub2Api。

如果你希望注册后自动推送到 Sub2Api：

```json
"auto_sync": true
```

否则：

```json
"auto_sync": false
```

## 11. `cpa_base_url`

作用：CPA 平台地址。

示例：

```json
"cpa_base_url": "https://cpa.example.com"
```

要求同样是：

- 必须带 `http://` 或 `https://`

## 12. `cpa_token`

作用：CPA 平台认证 token。

示例：

```json
"cpa_token": "your_cpa_token"
```

## 13. `min_candidates`

作用：CPA 池健康阈值，低于这个候选数量就认为池子偏少。

例如：

```json
"min_candidates": 1000
```

如果你的使用规模不大，也可以调低，比如：

```json
"min_candidates": 100
```

## 14. `used_percent_threshold`

作用：CPA 池已使用比例的告警阈值。

常见值：

```json
"used_percent_threshold": 95
```

## 15. `auto_maintain`

作用：是否自动执行 CPA 池维护。

```json
"auto_maintain": true
```

如果你只想手动维护，也可以关掉：

```json
"auto_maintain": false
```

## 16. `maintain_interval_minutes`

作用：自动维护的时间间隔，单位分钟。

```json
"maintain_interval_minutes": 30
```

## 17. `sub2api_min_candidates`

作用：Sub2Api 池健康阈值。

```json
"sub2api_min_candidates": 200
```

## 18. `sub2api_auto_maintain`

作用：是否自动执行 Sub2Api 池维护。

```json
"sub2api_auto_maintain": false
```

## 19. `sub2api_maintain_actions`

作用：Sub2Api 维护时具体做哪些动作。

默认：

```json
"sub2api_maintain_actions": {
  "refresh_abnormal_accounts": true,
  "delete_abnormal_accounts": true,
  "dedupe_duplicate_accounts": true
}
```

这三项分别表示：

- `refresh_abnormal_accounts`：对异常账号做刷新/测活
- `delete_abnormal_accounts`：对仍异常的账号执行删除
- `dedupe_duplicate_accounts`：清理重复账号

## 20. `upload_mode`

作用：上传/同步策略。

一般保留默认：

```json
"upload_mode": "snapshot"
```

## 21. `proxy_pool_enabled`

作用：是否启用代理池，而不是固定 `proxy`。

如果你没有代理池，建议保持：

```json
"proxy_pool_enabled": false
```

## 22. `proxy_pool_*`

这些字段用于代理池：

- `proxy_pool_api_url`
- `proxy_pool_auth_mode`
- `proxy_pool_api_key`
- `proxy_pool_count`
- `proxy_pool_country`

示例：

```json
"proxy_pool_enabled": true,
"proxy_pool_api_url": "https://your-proxy-pool.example.com/api/fetch",
"proxy_pool_auth_mode": "header",
"proxy_pool_api_key": "your_proxy_pool_api_key",
"proxy_pool_count": 1,
"proxy_pool_country": "US"
```

说明：

- `proxy_pool_auth_mode` 一般是 `header` 或 `query`
- `proxy_pool_country` 常见填 `US`

## 23. PostgreSQL 入库配置

如果你希望注册成功后，把账号资料写入 PostgreSQL 的 `registered_accounts` 表，可以配置以下字段：

```json
"db_enabled": true,
"db_host": "150.158.105.6",
"db_port": 54321,
"db_name": "mail_accounts_db",
"db_user": "postgres",
"db_password": "your_password",
"db_table": "registered_accounts",
"db_source": "standalone_cli"
```

说明：

- `db_enabled`：是否启用入库
- `db_name`：当前你这边实际表所在库是 `mail_accounts_db`
- `db_table`：目标表名
- `db_source`：写入表中 `source` 字段的值

当前实现会尽量写入这些字段：

- `email`
- `chatgpt_password`
- `mail_password`
- `oauth_status`
- `mail_token`
- `name`
- `birthdate`
- `source`

拿到什么就写什么，缺失字段会写空值或 `NULL`。

## 推荐的最小可用配置

如果你要先跑注册，再决定同步哪个平台，可以先这样：

```json
{
  "proxy": "http://127.0.0.1:17891",
  "auto_register": false,
  "auto_register_max_per_loop": 1,
  "db_enabled": false,
  "db_host": "150.158.105.6",
  "db_port": 54321,
  "db_name": "mail_accounts_db",
  "db_user": "postgres",
  "db_password": "",
  "db_table": "registered_accounts",
  "db_source": "standalone_cli",
  "mail_providers": ["mailtm"],
  "mail_provider_configs": {
    "mailtm": {
      "api_base": "https://api.mail.tm"
    }
  },
  "mail_strategy": "round_robin",
  "base_url": "",
  "bearer_token": "",
  "email": "",
  "password": "",
  "account_name": "AutoReg",
  "auto_sync": false,
  "sub2api_min_candidates": 200,
  "sub2api_auto_maintain": false,
  "sub2api_maintain_interval_minutes": 30,
  "sub2api_maintain_actions": {
    "refresh_abnormal_accounts": true,
    "delete_abnormal_accounts": true,
    "dedupe_duplicate_accounts": true
  },
  "cpa_base_url": "",
  "cpa_token": "",
  "min_candidates": 1000,
  "used_percent_threshold": 95,
  "auto_maintain": false,
  "maintain_interval_minutes": 30,
  "upload_mode": "snapshot",
  "proxy_pool_enabled": false,
  "proxy_pool_api_url": "https://zenproxy.top/api/fetch",
  "proxy_pool_auth_mode": "header",
  "proxy_pool_api_key": "",
  "proxy_pool_count": 1,
  "proxy_pool_country": "US"
}
```

## 如果你不知道怎么填

最常见的组合是：

- 只注册，不同步平台：
  - 填 `proxy`
  - 填邮箱提供商配置
  - `auto_sync = false`
  - `cpa_base_url` / `base_url` 可以先留空
- 注册并同步到 Sub2Api：
  - 填 `proxy`
  - 填邮箱提供商配置
  - 填 `base_url`
  - 填 `bearer_token` 或 `email + password`
  - `auto_sync = true`
- 注册并维护 CPA：
  - 填 `proxy`
  - 填邮箱提供商配置
  - 填 `cpa_base_url`
  - 填 `cpa_token`

## 建议命令

配置好之后常用命令是：

```bash
python3 /root/standalone_cli/run.py --json config show
python3 /root/standalone_cli/run.py register --once
python3 /root/standalone_cli/run.py cpa status
python3 /root/standalone_cli/run.py sub2api status
```