Files
standalone-openai-pool-cli/README.md

4.4 KiB
Raw Blame History

Standalone OpenAI Pool CLI

一个纯 CLI 版的 OpenAI Pool Orchestrator可直接从 /root/standalone_cli 运行,不依赖原仓库路径。

目录结构

/root/standalone_cli/
|- main.py                         # 主 CLI 入口
|- run.py                          # 便捷启动脚本
|- support.py                      # 配置/同步/状态辅助逻辑
|- requirements.txt                # 运行依赖
|- README.md                       # 使用说明
|- config/
|  `- sync_config.example.json     # 配置模板
|- data/
|  |- sync_config.json             # 实际运行配置
|  |- state.json                   # 成功/失败统计
|  `- tokens/                      # 本地 token 文件
`- openai_pool_orchestrator/
   |- register.py                  # 注册核心逻辑
   |- pool_maintainer.py           # CPA/Sub2Api 维护逻辑
   `- mail_providers.py            # 邮箱提供商适配

安装依赖

cd /root/standalone_cli
pip install -r requirements.txt

如果你想用可编辑安装:

cd /root/standalone_cli
pip install -e .
openai-pool-standalone --help

初始化配置

python3 /root/standalone_cli/main.py config init

初始化后请编辑:

  • /root/standalone_cli/data/sync_config.json

至少按需填写:

  • proxy
  • cpa_base_url
  • cpa_token
  • base_url
  • bearer_tokenemail + password
  • 邮箱提供商配置 mail_provider_configs

当前这台机器实测可用的代理是:

  • http://127.0.0.1:17891

模板里的 URL 现在使用了更明确的占位值:

  • https://your-cpa.example.com
  • https://your-sub2api.example.com

留空的字段表示需要你自行填写真实值,例如:

  • cpa_token
  • bearer_token
  • password
  • proxy_pool_api_key

常用命令

查看帮助

python3 /root/standalone_cli/main.py --help
python3 /root/standalone_cli/run.py --help

查看当前配置

python3 /root/standalone_cli/main.py --json config show

单次注册

python3 /root/standalone_cli/main.py register --once

循环注册

python3 /root/standalone_cli/main.py register --sleep-min 5 --sleep-max 30

指定代理注册

python3 /root/standalone_cli/main.py register --proxy http://127.0.0.1:7897 --once

如果你直接使用当前机器的代理,建议改成:

python3 /root/standalone_cli/main.py register --proxy http://127.0.0.1:17891 --once

查看本地 token

python3 /root/standalone_cli/main.py tokens --limit 20

CPA 维护

python3 /root/standalone_cli/main.py cpa status
python3 /root/standalone_cli/main.py cpa check
python3 /root/standalone_cli/main.py cpa maintain
python3 /root/standalone_cli/main.py cpa upload-all

Sub2Api 维护

python3 /root/standalone_cli/main.py sub2api status
python3 /root/standalone_cli/main.py sub2api check
python3 /root/standalone_cli/main.py sub2api sync-all
python3 /root/standalone_cli/main.py sub2api maintain
python3 /root/standalone_cli/main.py sub2api dedupe --apply

统计信息

python3 /root/standalone_cli/main.py stats

运行方式

两种方式等价:

python3 /root/standalone_cli/main.py --help
python3 /root/standalone_cli/run.py --help

其中 python3 /root/standalone_cli/run.py 在不带参数时会自动显示帮助,更适合首次使用。

安装为命令行后也可以这样运行:

openai-pool-standalone --help
openai-pool-standalone register --once

Docker

构建镜像:

cd /root/standalone_cli
docker build -t openai-pool-standalone .

运行容器:

docker run --rm -it \
  -v /root/standalone_cli/data:/app/data \
  openai-pool-standalone config show

或使用 compose

cd /root/standalone_cli
docker compose up --build

当前 compose 默认执行一次性命令 --json config show,用于快速验证镜像和配置挂载是否正常,不会常驻运行。

验证命令

python3 -m compileall /root/standalone_cli
python3 /root/standalone_cli/main.py --json config show
python3 /root/standalone_cli/main.py --json stats
python3 /root/standalone_cli/run.py --help

说明

  • 这个目录现在已经包含独立的核心代码,不再依赖 /root/openai_pool_orchestrator-main
  • 运行配置与 token 只写入 /root/standalone_cli/data/
  • 不要把真实密钥、token、邮箱密码提交到版本库