freepp README

The project's README from github.com/mio-cc/freepp. As one markdown file: README.md.

min-implant-v2

ChatGPT 订阅支付链路自动化研究项目(仅供学习研究, 请遵守目标平台服务条款与当地法律)。

目录结构

backend/                 FastAPI 后端 (提链引擎 / 直卡 / PayPal BA / hCaptcha)
  core/                  核心链路引擎 (chain / oaics_proto / bind_card / proxy)
  api/                   REST API 路由
  ba_paypal/             PayPal BA 授权四阶段流程 (flow.py) + hCaptcha mint 栈
    ba_fp_helpers/       Node 桥 (happy-dom / hsw PoW) — 需 npm install
    sentinel_assets/     OpenAI Sentinel 签名 SDK — 需 npm install
    paypal/              PayPal 流程模块 (flow / session / smsbower / identity_lib)
  config.yaml            ★ 本地配置 (gitignore, 用 config.example.yaml 复制)
frontend/                React 19 + Vite 8 前端面板 (源码, 需 npm install + build)
web/                     管理台静态资源 (index.html + static/ + dist/ 构建产物)
_archive_dev/            开发期测试脚本与抓包数据 (gitignore, 不随仓库发布)
运维.bat                 Windows 运维菜单 (启动/重启/日志/构建)

环境要求

依赖 版本 用途 必需
Python >=3.10 后端运行时 ✅
Node.js >=18 (建议 20) OpenAI Sentinel mint (Node/V8 sdk bridge)、前端构建 ✅
代理池 见下 链路出口 (账单国/出口国必须对齐) ✅
SMSBower API key 见下 PayPal 授权 2FA 接码 ⚠️ 仅 PayPal BA 线
Clash/mihomo 本地代理 — 711 住宅池 relay 前置 (127.0.0.1:7890/7897) ⚠️ 仅 711 池

Playwright (可选): backend/ba_paypal/paypal/recaptcha_solver.py 需要, 默认走 HTTP 解 可 pip install playwright 启用备用路径。

一、安装

1. Python 依赖

cd backend
pip install -r requirements.txt
pip install -r ba_paypal/requirements.txt

2. Node 依赖 (三处)

cd backend/ba_paypal/ba_fp_helpers     && npm install
cd ../sentinel_assets                  && npm install
cd ../../..                            # 回项目根
cd frontend                            && npm install   # 仅需改前端时

ba_paypal/ 根目录还有一个 package.json (@msgpack/msgpack), 如 Node 桥报缺包 一并 npm install。

3. 配置文件

# 后端配置 (代理池/端口/链路参数)
cd backend
copy config.example.yaml config.yaml     # Windows
cp config.example.yaml config.yaml       # Linux/macOS

# SMSBower 接码平台 key (仅 PayPal BA 线需要)
cd ba_paypal
copy .env.example .env                   # Windows
cp .env.example .env                     # Linux/macOS

编辑 config.yaml, 至少填入代理池凭据 (见下)。

4. 前端构建 (可选, web/dist 已随仓库提供)

cd frontend
npm run build        # 产物输出到 ../web/dist, 后端直接服务

二、启动

Windows

双击运行 运维.bat, 菜单选项:

运维脚本自动探测 python / node (PATH 或 PYTHON / NODE_BIN 环境变量), 日志输出到 %TEMP%\min-implant-v2\。

手动

cd backend
python -m uvicorn app:app --host 0.0.0.0 --port 8770
# 打开 http://127.0.0.1:8770

三、所需外部资源详解

1. 代理池 (必需)

链路每一段都用独立出口 IP, 且账单国必须与出口国一致 (否则 Stripe 400 Billing country must match request country)。项目支持三类代理源:

类型 配置位置 说明
QG 隧道代理 config.yaml → proxy.qg_super_pool / qg_resi_pool 主代理池, 连接串 http://{auth_key}:{auth_pwd}:A{area}@host:port, area 控制出口国家
711 住宅代理 config.yaml → proxy.proxy_711.enabled + 环境变量 走本地 Clash/mihomo relay (7890/7897), sticky session 按国家, 通过 PROXY_711_USER / PROXY_711_PASS 注入 (不再硬编码)
sing-box 节点 core/proxy_pool.py 内置 VLESS/Hysteria2 33 节点 (JP/HK/SG/US/KR/TW), 本地 relay 18077-18117

需要的东西:

2. 接码平台 (SMSBower, 仅 PayPal BA 线)

PayPal 注册/2FA 需要手机验证码。项目对接 SMSBower:

# backend/ba_paypal/.env
SMSBOWER_API_KEY=你的key
PAYPAL_SMSBOWER_API_KEY=你的key

3. 中继/本地代理 (仅 711 池)

711 池链路: client → 127.0.0.1:18794 (relay) → Clash 7890/7897 → 711 → 目标。 需要本机运行 Clash 系客户端 (FlClash / Clash Verge), 且开启 mixed-port。

4. OpenAI 账号 token (运行原料)

链路消耗的是 ChatGPT 会话 token (access_token + session_token), 在面板的 "Token 导入" 中批量导入。账号需要有促销资格 (plus-1-month-free) 才能走出 0 元链, 无资格账号压 0 无效。

四、环境变量一览

变量 默认 说明
PYTHON python 运维脚本用的 Python 解释器
NODE_BIN node 运维脚本用的 Node 可执行文件
SENTINEL_NODE node Sentinel mint 调用的 Node
PROXY_711_USER YOUR_711_USER 711 代理用户名
PROXY_711_PASS YOUR_711_PASS 711 代理密码
PROXY_711_RELAY_PORT 18794 711 relay 端口
MIN_TEST_CARD_NUMBER 4000000000000002 内置测试卡号 (占位)
MIN_TEST_CARD_EXP_MONTH 12 测试卡月
MIN_TEST_CARD_EXP_YEAR 30 测试卡年
MIN_TEST_CARD_CVC 123 测试卡 CVC
SMSBOWER_API_KEY / PAYPAL_SMSBOWER_API_KEY — 接码平台 (ba_paypal/.env)
MIN_OAICS_ATTESTATION — 手动注入 OpenAI 前端部署证明 (跳过抓取)
MIN_OAICS_P1 — 手动注入 Stripe hCaptcha P1 token
MIN_OAICS_CUSTOMER — 手动注入 Stripe customer id
MIN_OAICS_SENTINEL 0 时禁用 Sentinel 头开关
PROXY_711_HOST / PROXY_711_PORT 711proxy.com:10000 711 网关覆盖

四·五、GPT 账号注册 (面板 "资源 → 账号注册")

内置 ChatGPT 账号注册功能 (backend/reg/)，协议：next-auth OAuth → OTP → sentinel create_account → access/session token。成功账号自动写入 Token 库 (source=register)，可直接用于提链。

内置邮箱渠道：mailtm (零依赖在线 API，默认)。代理留空时自动启用 711 住宅中继。

接入自定义邮箱渠道：注册引擎提供扩展点，任意邮箱来源（IMAP / outlook 邮箱池 / 自建邮箱 / 临时邮箱 API）都可接入。在 backend/app.py 启动时调用：

from reg import engine as reg_engine

def setup_my_mailbox(proxies, cancel_check):
    # 1) 取一个可用注册邮箱
    email = claim_mailbox()                 # 你的实现
    openai_password = "Aa1!xxxx"            # ≥12 位随机密码
    # 2) 返回取码器：轮询收件箱直到拿到 OpenAI OTP
    def fetch_code(timeout_sec=None, seen_ids=None, not_before=None):
        return wait_otp(email, timeout_sec)  # 你的实现
    return email, openai_password, fetch_code

reg_engine.register_email_channel("my_mailbox", setup_my_mailbox)

注册后渠道名 my_mailbox 自动出现在面板渠道下拉。fetch_code 约定与 chatgpt_core.py 内建渠道一致（timeout_sec / seen_ids / not_before 参数可选实现）。注册协议本身（OAuth/OTP/sentinel/create_account）与邮箱 来源完全解耦。

五、链路概览

项目内置 16 个提链分支, 均可在面板 "链路配置" 或 config.yaml → chain.branches.<name>.stages 调整七段出口 (checkout/init/update/provider/approve/poll/resolve) 与 OAICS 五段 (checkout/taxes/provider/confirm/resolve) 映射。

分支 渠道 账单国 (默认) 产出
paypal PayPal auto paypal.com/agreements/approve?ba_token=...
direct 直卡 PH 卡绑定 + 订阅验证 (SetupIntent 内联)
momo MoMo auto payment.momo.vn/pay/app 跳转
pix PIX 二维码 auto PIX 支付二维码
ideal iDEAL auto iDEAL 银行跳转
upi UPI auto UPI 支付跳转
kakao Kakao Pay auto Kakao 支付跳转
blik BLIK auto BLIK 支付跳转
twint TWINT auto TWINT 支付跳转
bizum Bizum auto Bizum 支付跳转
gopay GoPay auto GoPay 支付跳转
qris QRIS ID QRIS 二维码
gcash GCash PH GCash 支付跳转
grabpay GrabPay PH GrabPay 支付跳转
naver_pay Naver Pay auto Naver Pay 支付跳转
grok Grok 链路 auto card 渠道提链

核心链路形态:

freepp (mio-cc/freepp)

Searching Database…

189 ·GitHub
Freepp
这是什么？这是 min-implant-v2，一个 Python/Node 研究项目，在多种地区性支付渠道（PayPal、直接银行卡、PIX、iDEAL、UPI、Kakao Pay 等）之间自动化 ChatGPT 订阅支付链路，用于研究优惠码零成本订阅流程。
这是 CLI 工具还是完整的服务？它是一个自托管后端（Python + Node），搭配网页前端面板（web/dist 已预构建）；在 Windows 上通过基于菜单的批处理启动器操作，在其他平台则手动启动后端。
怎么让它跑起来？在列出的三个位置安装 Python（>=3.10）和 Node.js（>=18）依赖，把代理池凭据填入 config.yaml，然后通过 Windows 批处理菜单启动，或手动启动后端。
运行它需要代理池和短信服务吗？需要——每一段链路都需要代理池（QG 隧道、经本地 Clash/mihomo 中转的 711 住宅代理，或内置的 sing-box 节点），而 PayPal BA 线路的 2FA 短信验证码则专门需要 SMSBower API 密钥。
零成本链路总是有效吗？不是——账单国家必须与代理出口国家完全一致，否则 Stripe 会拒绝请求；导入的 OpenAI 账号令牌必须已具备“加赠 1 个月免费”的促销资格，否则零成本链路会失败。
它只能在 Windows 上运行吗？一键启动器（运维.bat）仅限 Windows，但由于技术栈就是纯 Python 和 Node，你也可以在其他平台上手动启动后端。
除 PayPal 外它还支持哪些支付渠道？它内置 16 条链路分支，覆盖直接银行卡、MoMo、PIX、iDEAL、UPI、Kakao Pay、BLIK、TWINT、Bizum、GoPay、QRIS、GCash、GrabPay、Naver Pay 以及一个 Grok 卡渠道，每个都可通过 config.yaml 配置。
内置的 GPT 账号注册功能是做什么的？backend/reg/ 下的一个模块通过 next-auth OAuth、OTP 和 Sentinel createaccount 自动化 ChatGPT 账号注册，把成功的账号直接写入令牌库以便复用，默认使用零依赖的 mailtm 邮箱通道。
为什么每一段链路都需要专用代理？支付链路的每个阶段都必须通过与账单国家匹配的专属 IP 出口，因为如果账单国家与请求国家不一致，Stripe 会返回 400 错误。
What are similar projects?GuJumpgate, FlowPilot, grok-register, outlook-auto-register, LibreChat, opencodex, cloudflare-turnstile-bypass, any-auto-register
Which topics is it in?sms-api, captcha-solving, cracking, sms, stripe, exploit, oauth2, oauth, chatgpt, security-tools, proxy, openai
Creator
mio-cc
Size
5.3 MB
Stars
189
Updated
CommitAug 20
Age
2mo
Commits · 90 Days