Files
gpt/docs/CONFIG.md
T

14 KiB
Raw Blame History

配置说明(可公开)

本文只记录字段名、含义、默认值/占位符。不要把真实密码、API Key、License、JWT/AES、代理账号、邮箱明文、.env 实际值、数据库或用户数据提交到仓库。

本地复制模板:cp .env.example .env,再改密钥。运行时设置保存在加密后的 user_settings(SQLite),API 对密钥只回传 *_configured,不回显明文。


1. 环境变量(.env)

根目录 .env.example 是唯一可提交的模板。.env 已被 gitignore。

必填 / 核心

变量 含义 示例/默认(非真实值)
PORT HTTP 端口 8585
JWT_SECRET JWT 签名密钥 change_me_to_a_long_random_string
AES_KEY AES-256-GCM,64 位 hex(32 字节)。写入数据后不可更换 全 0 占位;生产用 crypto.randomBytes(32)
GPT_PLUS_DB_PATH SQLite 路径 默认 server/data/app.db

可选:库存 / 探测

变量 含义 默认
NVTOKENS_API_KEY nvtokens 库存 API Key;也可在设置页保存 空
NVTOKENS_SESSION 价格查询 session(Cookie scm_session) 空
NVTOKENS_BASE_URL nvtokens 站点 https://nvtokens.com

可选:流水线 / 轮询 / 日志

变量 含义 默认
DISABLE_POLLERS 1/true/yes 时不启动流水线、验活、提链轮询 关闭
OP_LOG_LATEST_LIMIT 操作日志最近条数上限 100(最大 5000)
OP_LOG_VERBOSE 支付/出码更详细日志 关闭

可选:Cloak 浏览器

变量 含义 默认
CLOAK_PROFILE_ROOT 浏览器配置目录 代码内 runtime 目录
CLOAK_RESOURCE_CONCURRENCY 资源并发覆盖 代码默认
CLOAK_LAUNCH_CONCURRENCY 启动并发 5
CLOAK_PROFILE_CLEANUP_CONCURRENCY 配置清理并发 4(最大 32)

可选:提链 HTTP / Python

变量 含义 默认
EXTRACT_PYTHON Python 解释器路径 系统 python
EXTRACT_HTTP_ENGINE impit 时走 impit 引擎 空
EXTRACT_IMPERSONATE TLS 指纹浏览器标识 代码内置

可选:MK_GCASH(开源 GCash 模块)

MK_GCASH=1(或 true/yes)启用独立 GCash 模块;未设置则走原有路径。

变量 含义 默认(上限)
MK_GCASH 开关 关闭
MK_GCASH_PYTHON 模块用 Python,回退 EXTRACT_PYTHON 空
MK_MAX_CONCURRENCY 出码并发 4(上限 20)
MK_MAX_SESSION_CONCURRENCY 会话并发 min(4, 出码并发)(上限 20)
MK_MAX_ACCOUNTS 账号上限 50
MK_MAX_QUEUE 队列 50(上限 200)
MK_EXTRACT_BASE 本地提取服务基址(辅助脚本) http://127.0.0.1:8595
GCASH_MAX_CONCURRENCY 旧路径并发帽 代码常量
GCASH_MAX_ACTIVE_MONITORS 支付墙监视上限 12(上限 24)
GCASH_PAY_DEBUG 支付调试 关闭
GCASH_EXTRACT_DEBUG 出码调试 关闭
GCASH_EXTRACT_DEBUG_TRACE 出码 trace 路径 空
GCASH_QR_SAVE_PATH / GCASH_QR_DUMP_DIR 二维码落盘(调试) 空
SENTINEL_NODE / SENTINEL_CURL / SENTINEL_SDK_PATH Sentinel 相关可执行文件/SDK 空或内置路径

可选:Mailpit / mail.com

变量 含义 默认
MAILPIT_RECIPIENTS_ENV Mailpit 收件人 env 文件 /opt/mailpit/recipients.env
MAILPIT_SKIP_RESTART 1 时不重启 Mailpit(测试用) 关闭
MAILCOM_DEBUG mail.com 轮询调试 关闭
MAILCOM_IMPERSONATE chrome142 / chrome136 / chrome131 空
MAIL_OAUTH_PUBLIC_SECRET mail.com OAuth 公钥覆盖 内置占位

可选:PayPal 地址生成

变量 含义 默认
OPENAI_PAY_ADDRESSGEN_API_URL 地址生成 API 公开默认 URL
OPENAI_PAY_ADDRESSGEN_API_TIMEOUT 超时(秒) 5

仅部署脚本(不要写入应用 .env 并提交)

脚本通过环境变量读取,值留在本机或 CI secret。

变量 用途
DEPLOY_SSH_PASSWORD SSH 部署密码
DEPLOY_REMOTE_ROOT 远端目录,默认 /opt/gpt-plus
DEPLOY_ALLOW_ACTIVE_REGISTRATION 1 时允许部署时远端仍在自动注册
BACKUP_DB 部署前数据库备份路径
CFWORKER_MAIL_API_URL / CFWORKER_MAIL_API_KEY / CFWORKER_MAIL_DOMAINS 远端写入 CF 邮箱设置
CLOAK_LICENSE_KEYS 远端写入 Cloak 授权(多行)
APPLY_MAIL_MIX 1 时同时写 mail.com/CF 比例
CLOUDFLARE_ACCOUNT_ID / CLOUDFLARE_API_TOKEN / ADMIN_TOKEN CF Worker 部署
CF_MAIL_DOMAINS Worker 绑定域名列表(逗号分隔)

前端可选:VITE_LOG_ROW_LIMIT(日志行数,构建时注入)。


2. 用户设置(Settings / user_settings)

源:server/src/utils/settings.js 的 DEFAULTS()。密钥类字段在 publicView 中变成 *_configured,不回传原文。

2.1 CloakBrowser(设置页「Cloak / 验活」)

字段 含义 默认
cloak.license_key / license_keys 授权,每行一个;加密存储 空
cloak.headless 无头 true
cloak.max_concurrency 最大并发 3
cloak.humanize 拟人鼠标键盘 true
cloak.human_preset 拟人预设 careful

公开视图:license_configured、license_count,无明文 license。

2.2 注册默认(同页)

字段 含义 默认
registration.set_password 注册时设独立 ChatGPT 密码 true
registration.enable_totp_2fa 启用 TOTP true
registration.asset_optimization 资源优化 true
registration.mail_provider mailcom / cfworker / mix / herosms / imported herosms
registration.mailcom_share / cfworker_share mix 比例份数 0–100 5 / 5
registration.performance_profile safe 或 throughput safe
registration.attempts 默认业务尝试次数 1–3 3

2.3 账号验活

字段 含义 默认
accounts.detect_poll_minutes 验活间隔分钟,0=关 15
accounts.detect_proxy_group 已废弃;验活走 CliProxy 动态池 ""

GB 验活用 region-GB,GC 资格检测用 region-PH。动态池未配置则本轮失败,不回退手工代理组。

2.4 流水线上限(pipeline 数值项)

开关本身在账号页(见第 3 节)。设置页只改上限:

字段 含义 默认
daily_register_limit 每天成功入库上限,0=不限 0
register_concurrency 自动注册并发 1–200 5
extract_attempts 每号最多提链次数 1–50 5
extract_interval_minutes 同号两次提链最短间隔,0=不等 10
pay_attempts 支付最多重试 5
rt_attempts 拿 RT 最多重试 5

2.5 nvtokens 手工上架

字段 含义 默认
nvtokens.auto_list_plus 预留自动上架;当前 UI 为手工推送 false
nvtokens.min_price_yuan 无看板价时的最低价兜底(元) 20.00
nvtokens.api_key 库存 Key 空
nvtokens.session_cookie scm_session 空

公开:api_key_configured、session_configured、session_last4。也可被环境变量覆盖。

2.6 import_dump(无试用普号 / 全部账号导出)

字段 含义 默认
import_dump.url 远程导入 API 地址 空
import_dump.api_key X-API-Key 空

公开仅 configured(url 与 key 都非空才为 true)。不要把真实 url/key 写进文档或仓库。 不会自动导出,需点设置页按钮。

2.7 接码 sms

字段 含义 默认
provider / phone_provider 平台标识 auto
api_url 接口 https://hero-sms.com/stubs/handler_api.php
api_key 密钥 空
country 国家码 usa
product 业务码 openai

PayPal 开通任务会固定英国号码与对应服务码,不受此表其它国家影响。

2.8 注册供应商

HeroSMS(herosms)

字段 默认
api_url https://hero-sms.com
api_key 空
country / service / site / domain usa / openai / openai.com / outlook.com
max_reorders 4
acquire_attempts 3
requests_per_second 12
max_request_concurrency 16
max_active_activations 20
ban_cooldown_ms 1800000
rate_cooldown_ms 12000
max_transient_retries 公开视图默认 2
transient_retry_base_ms 公开视图默认 500

SMSBower(smsbower)

字段 默认
api_url https://smsbower.app/stubs/handler_api.php
api_key 空
country / service / domain / max_price gb / dr / "" / ""

CF Worker 邮箱(cfworker_mail)

字段 默认
api_url / api_key / domain 空
disabled_suffixes / domains []

公开:api_key_configured、ready、域名目录与启用数量。

导入邮箱(imported_mail)

字段 默认
mailboxes 空(明文列表,不回传)
allow_unsafe_url false

公开仅 configured。

2.9 动态代理池

dynamic_proxy.active_pool 默认 1024proxy。供应商 id:

id UI 名 sticky_minutes 默认
1024proxy 1024proxy 30
b2proxy b2proxy 30
cliproxy CliProxy 30
iprocket IPRocket 5

每家:username、password(公开为 password_configured)。业务流量(注册/提链/支付/验活/换绑/拿 RT)走当前池;GB→region-GB,GC→region-PH,按任务 sticky SID。

2.10 手工代理表(设置页「代理管理」)

库表字段:group_name、proxy_type(http / https / socks5)、host、port、username、password、remark、status。

用途:兼容旧数据或 mail.com 指定分组。未配置动态池时业务任务失败,不回退到本表。导入文本不要提交到 git。

2.11 邮箱域名策略

字段 含义 默认
email_domains.mode all / whitelist / blacklist all
email_domains.allow / deny 后缀列表 []

suffix_quota.hourly / daily:每后缀每小时/每天额度,0=不限。

2.12 Mailpit

字段 含义 代码默认(部署请改成本地值)
url Mailpit HTTP http://127.0.0.1:8025
username / password / webhook_secret 鉴权 空
smtp_host / mx_host / ui_url SMTP / MX / UI 代码内示例主机名,勿当生产密钥
domains 收信域列表 []

2.13 mail.com 轮询

字段 含义 默认
oauth_secret 一般不填(公钥内置) 空
proxy_group 空=直连,不回退动态池 ""
poll_minutes 0=关闭轮询 0
auto_delete_used / auto_repull 删已用子号 / 再拉满 false
cap 每母号地址上限(含母号) 10
enabled_suffixes / disabled_suffixes 拉子号后缀 内置默认目录 / []
unavailable_suffixes 平台拒绝记录 {}

3. CB / GB / GC 流水线

不是三套独立 env,而是通道 + 开关:

通道 UI 设置对象 代理 region
GB(英国 PayPal) 账号管理(非 GC) pipeline __auto__:GB(换绑等同)
GC(菲律宾 GCash) 账号管理(GC) pipeline_gc __auto__:PH
Cloak(CB) 设置授权 + 注册任务 cloak + 注册任务 动态池 / 任务指定

每套开关默认全 false:

开关 GB(pipeline) GC(pipeline_gc)
register 持续注册 GB 持续注册 GC,不启动 PayPal
rebind 有试用后换绑 有试用后换绑 PH
extract 提 PayPal 支付链 出 GCash 码(gcash_*)
pay PayPal 支付 GCash 支付墙轮询
acquire_rt 支付成功拿 RT 支付成功拿 RT(PH)

global_extract(全局提链监视,另页):

字段 默认
enabled false
interval_minutes 60(5–1440)
concurrency 1(最大 20,引擎 PROCESS_CAP=20)
enabled_channels [](公开只给 enabled_count)

4. 前端设置页标签

web/src/views/Settings.vue:

  1. 账户 / 密码
  2. Cloak / 验活(含流水线上限、nvtokens、import_dump)
  3. 接码平台
  4. 注册供应商 / 动态代理
  5. 代理管理
  6. 邮箱域名(策略、mail.com/CF 比例、后缀额度、CF 域)
  7. 邮箱轮询 / 后缀

账号页流水线开关见第 3 节。个人密码修改走 /api/profile,不写入 user_settings。


5. 默认管理员(安装后立刻改密)

README:首次可登录 admin / admin123。生产用户(含任意业务账号)的真实密码禁止写入仓库或本文。


6. 明确不入库

  • .env 及任何真实密钥、token、license、TOTP 种子
  • server/data/(app.db、会话、卡哈希等)
  • Cloak runtime 配置目录 server/src/automation/runtime/
  • 代理账号密码、import_dump 真实 URL/Key、cloak license 明文
  • DEPLOY_SSH_PASSWORD、Cloudflare token、Worker ADMIN_TOKEN
  • web/dist/、node_modules/、日志、debug/

密钥生成示例(只生成随机串,不要提交结果):

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"