如果这个项目帮到了你，请点个 Star 支持一下！你的Star是我更新的动力。
4399游戏平台批量自动注册工具，支持验证码自动识别、实名认证、并发注册、注册后自动登录获取Sauth凭证。可通过GitHub Actions云端运行。
如果失效可以直接在issues里反馈。
重要：单个IP最多只能注册15个账号，超过会被封。 工具会自动计数并切换代理IP，务必开启代理使用。
官方QQ群：796507563
- 自动识别验证码（自定义CNN模型 / ddddocr）
- 自动实名认证
- 多线程并发注册
- 注册成功后自动登录，获取Sauth凭证
- 支持代理IP（本地文件 / 在线API自动获取）
- 单IP注册数限制，超限自动换IP，防止封号
- 支持GitHub Actions云端运行，所有参数可视化配置
- 支持按注册数量或运行时长自动停止
| 文件 | 说明 |
|---|---|
| auto_register_4399.py | 主程序 |
| login_4399.py | 登录模块，获取Sauth |
| captcha_pipeline.py | 验证码模型训练流水线（下载/标注/训练/推理） |
| captcha_model.pth | 训练好的验证码识别模型 |
| sfz.txt | 实名认证用身份证（格式：姓名----身份证号） |
| IP.txt | 代理IP列表（格式：ip:port，每行一个） |
| 4399.txt | 输出：注册成功的账号密码 |
| sauth.json | 输出：登录后的Sauth凭证 |
| used_sfz.txt | 已使用的身份证记录 |
| register.log | 运行日志 |
| requirements.txt | Python依赖 |
| .github/workflows/register.yml | GitHub Actions工作流 |
如果不想把身份证数据放在仓库里，可以配置Secret：
# 本地生成base64编码
base64 -w 0 sfz.txt到仓库 Settings → Secrets and variables → Actions，新建Secret：
- 名称：
SFZ_DATA - 值：上面输出的base64字符串
到仓库 Actions 页 → 选择 4399 Auto Register → Run workflow，填写参数后运行。
运行完成后在 Actions 页面下载 Artifacts，包含：
4399.txt— 账号密码sauth.json— Sauth登录凭证register.log— 运行日志
| 参数 | 说明 | 默认值 |
|---|---|---|
| count | 成功注册数量（0=不限） | 0 |
| duration | 最大运行时长(秒) | 3600 |
| workers | 并发线程数 | 3 |
| max_sfz_uses | 每个身份证最大使用次数 | 4 |
| username_prefix | 用户名前缀（留空=纯随机） | |
| username_len | 用户名总长度 | 7 |
| password_len | 密码长度 | 10 |
| use_custom_model | 使用自定义验证码模型 | true |
| auto_login | 注册后自动登录获取Sauth | true |
| use_proxy | 使用代理IP | true |
| proxy_list_urls | 代理列表地址(逗号分隔) | 10源合并 |
| max_per_ip | 单IP最大注册数(超限自动换IP) | 15 |
| proxy_check_threads | 代理验证并发线程数 | 100 |
| proxy_check_timeout | 代理验证超时(秒) | 2 |
| proxy_warmup | 启动前等待就绪代理数 | 20 |
| proxy_check_url | 代理验证地址 | ptlogin.4399.com |
| max_captcha_retry | 验证码最大重试次数 | 3 |
工作流默认每6小时自动运行一次（cron: 0 */6 * * *），可在 .github/workflows/register.yml 中修改。
- Python 3.12+
- 如使用自定义模型：需要PyTorch（CPU即可）
pip install -r requirements.txt
# PyTorch（如需自定义验证码模型）
pip install torch --index-url https://download.pytorch.org/whl/cpu# 按数量运行
python auto_register_4399.py --count 10
# 按时长运行（3600秒）
python auto_register_4399.py --duration 3600
# 无限运行
python auto_register_4399.py
# 也可以通过环境变量覆盖配置
USE_PROXY=true WORKERS=5 python auto_register_4399.py --count 20所有配置项都支持环境变量覆盖，未设置时使用代码中的默认值：
| 环境变量 | 对应配置 |
|---|---|
| USE_PROXY | 是否使用代理 (默认开启) |
| PROXY_FILE | 代理IP文件路径 |
| PROXY_LIST_URLS | 代理列表地址(逗号分隔多个源) |
| MAX_PER_IP | 单IP最大注册数 |
| PROXY_CHECK_THREADS | 代理验证并发线程数 |
| PROXY_CHECK_TIMEOUT | 代理验证超时(秒) |
| PROXY_CHECK_URL | 代理验证地址 |
| USE_CUSTOM_MODEL | 是否使用自定义模型 |
| CUSTOM_MODEL_FILE | 模型文件路径 |
| MAX_CAPTCHA_RETRY | 验证码重试次数 |
| MAX_SFZ_USES | 身份证最大使用次数 |
| CAPTCHA_LENGTH | 验证码长度 |
| USERNAME_PREFIX | 用户名前缀 |
| USERNAME_LEN | 用户名长度 |
| PASSWORD_LEN | 密码长度 |
| AUTO_LOGIN | 注册后自动登录 |
| SFZ_FILE | 身份证文件路径 |
| USED_SFZ_FILE | 已使用身份证文件路径 |
| OUTPUT_FILE | 输出文件路径 |
| SAUTH_FILE | Sauth输出文件路径 |
| LOG_FILE | 日志文件路径 |
| WORKERS | 并发线程数 |
| MIN_INTERVAL | 最小间隔 |
| MAX_INTERVAL | 最大间隔 |
单IP最多注册15个账号，超限会被封。 必须开启代理使用本工具。
开启代理后（use_proxy=true），按以下优先级获取代理：
- 本地文件：优先读取
IP.txt（每行ip:port） - 在线列表：自动从以下源批量拉取（去重合并），默认使用5个源：
| 来源 | 更新频率 | HTTP列表 |
|---|---|---|
| iplocate/free-proxy-list | 30分钟 | protocols/http.txt |
| komutan234/Proxy-List-Free | 1分钟 | proxies/http.txt |
| proxifly/free-proxy-list | 5分钟 | protocols/http/data.txt |
| r00tee/Proxy-List | 5分钟 | Https.txt |
| ABoredCat/Free-Proxy | - | proxies/http.txt |
| mmpx12/proxy-list | 每日 | http.txt |
| ShiftyTR/Proxy-List | 每日 | http.txt |
| monosans/proxy-list | 每日 | proxies/http.txt |
| TheSpeedX/PROXY-List | 每日 | http.txt |
| proxy.scdn.io | 实时 | text.php |
通过 proxy_list_urls 配置，逗号分隔多个地址，支持自定义添加任意源。
代理管理逻辑：
- 拉取代理后多线程并发验证（默认100线程，超时2秒），只保留可用代理
- 验证URL使用
ptlogin.4399.com接口，确保验证通过的代理真正能访问4399 - 启动时预热等待20个代理就绪后再开始注册，避免启动阶段线程空等
- 每个注册线程独占一个代理IP，不会多线程共用同一个IP
- 每个代理IP最多注册
max_per_ip（默认15）个账号 - 达到上限后自动归还并换下一个可用代理
- 遇到封禁/超频错误立即丢弃该代理
- 网络错误软失败：返回池中，连续失败3次才丢弃
- 换代理重试时采用指数退避（1s→2s→4s + 随机抖动），避免打爆目标服务器
- 代理池耗尽后自动从在线列表拉取+验证新代理
- 不开代理时，直连IP同样受15次限制
相关配置：
| 参数 | 说明 | 默认值 |
|---|---|---|
| proxy_check_threads | 代理验证并发线程数 | 100 |
| proxy_check_timeout | 代理验证超时(秒) | 2 |
| proxy_warmup | 启动前等待就绪代理数 | 20 |
| proxy_check_url | 代理验证地址 | ptlogin.4399.com |
姓名----18位身份证号
王春莲----370123196401240541
刘如喜----370123196412110515
ip:port
1.231.81.166:3128
101.251.204.174:8080
username----password
每行一个JSON对象：
{"username": "abc1234", "password": "x9c0ehiys7", "sauth": "{\"sauth_json\": \"...\"}"}如需训练自己的验证码识别模型，使用 captcha_pipeline.py：
# 下载验证码图片
python captcha_pipeline.py collect
# 自动标注
python captcha_pipeline.py label
# 人工检查标注后训练
python captcha_pipeline.py train
# 或一键全流程
python captcha_pipeline.py all- collect（下载）：自动从4399下载验证码图片，保存到
captchas/目录 - label（标注）：使用OCR自动识别并生成标注，保存到
captcha_labels.json - train（训练）：训练CNN模型，输出
captcha_model.pth - all（一键）：按顺序执行以上三个步骤
训练好的模型会自动用于注册和登录时的验证码识别。