AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版让管理员通过网页安装 Mihomo、导入和更换机场订阅，并完善 Codex ticket 的采集校验、主备切换及故障诊断。打票代理与账号日常业务代理继续独立配置。
社区交流群
欢迎加入 QQ 群「中转技术交流」（群号 1004036018），交流部署实践、协议兼容、出口代理和功能改进。也欢迎参与问题复现、测试、文档补充和 Pull Request，一起维护这个独立分支。
二维码长期有效。需要长期留档、报告问题或讨论具体改动时，请使用 Issues。
本 fork 更新
- 网页管理机场代理：异步安装固定版本 Mihomo 并校验官方摘要，支持多订阅/TXT 导入、追加或替换。静态住宅代理凭据单独保留，切换出口时可恢复原配置。订阅目前支持 Clash/Mihomo YAML 格式。
- 节点用后移出：可选串行固定打票出口，发送前持久化已用状态；失败、已用和停用节点需手动恢复，重启不会自动重置。节点操作保留尚未保存的订阅输入。
- 更完整的票据生命周期：按个人与 Team/Business 账号区分票据形态，检查编码、签发时间、有效期及 SSE 成功完成事件；主备票据按账号和模型隔离，提供固定主用与提前备票策略。默认保留提前刷新行为。
- 有限探测与诊断：默认探测周期及失败冷却为 180 秒，每轮最多 6 次，按账号/模型轮询；账号额度限流期间跳过采集。管理端展示最近结果、HTTP 状态、下次允许探测时间和备用有效期。
- 可选严格响应处理：默认关闭。开启后，已注入票据的 HTTP 响应头明确不匹配时关闭正文并返回终止错误，不自动重放或切换账号重试；关闭时仅影响后续票据调度。
使用与升级
在「系统设置 → 网关 → Codex 设置」选择 Mihomo，点击「检测并安装」，导入订阅并保存应用；内核就绪后选择「设为打票代理」，再保存系统设置。打票总开关及模型开关仍需按需开启。内核以应用用户运行，当前支持 Linux amd64/arm64，需要可写且允许执行文件的数据目录。
从旧 systemd 机场内核升级时，root 安装/部署入口会暂存并验证旧配置，然后切换服务；失败恢复旧代理，原配置保留。仅网页二进制自更新无法取得 root 权限，旧内核需先通过 root 升级入口迁移一次。迁移支持旧安装器的单 airport provider，自定义目录需正确传入 DATA_DIR；跨文件系统迁移会安全失败。
严格拦截时上游可能已经计费，且无法取得完整 usage。该开关针对 HTTP 响应头，不覆盖原生 WebSocket state 事件。292/332 是票据形态长度，不是 HTTP 状态码，也不能证明回答质量或解除限流。手动恢复节点不重置账号冷却。
本地测试与相关竞态检查、前端检查和构建已通过。运行验证覆盖原生 Linux amd64、非 root Docker、ARM64 QEMU/PRoot 模拟，以及 systemd 用户级隔离服务迁移和回退；不等同原生 ARM64 硬件、真实机场/模型或生产 root 迁移实测。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.7.3One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.7.3/deploy/install.sh | sudo bash -s -- install -v v2.7.3Manual download:
Download the appropriate archive for your platform from the assets below.
📚 Documentation
2.7.3 热修复：地区过滤（785df27af）
新增 Mihomo 国家／地区过滤面板，支持排除香港、多选允许/排除及未知地区策略。此热修复已部署至 Tosky.ai，版本号仍为 2.7.3，源码提交为 785df27af924d2da4b4fb83b6ba69ff1ceb5bfd9。
Linux amd64 手动更新请下载 热修复包 和 SHA-256 校验文件，按包内 HOTFIX.md 操作。原 tag、标准安装包和容器镜像未替换；同版本号不会触发常规升级提示。不要用上方原版一键安装命令获取此热修复。
地区检测需在面板主动执行，通过节点访问 country.is，不调用模型。规则默认关闭；动态出口变化后需重新检测。