Sub2api Relay Setup — DevOps skill for Claude Code

sub2api-relay-setup

从零搭建一个**自己可控的 AI API 中转站**并部署 [Sub2API](https://github.com/Wei-Shaw/sub2api) 的完整实战指南 —— 打包成一个 Claude Code / Claude 可直接调用的 **Skill**。

不再依赖别人代搭的中转站:买一台服务器,部署 Sub2API 网关,绑自己的域名,发 API Key 给自己 / 团队 / 客户用。这个仓库把整个流程 + 每一步的踩坑和验证方法沉淀成一份**照着做就能跑通**的 skill。

这份 skill 覆盖什么

• 去哪买服务器、买什么规格(厂商对照 + 下单核对项 + 付款踩坑)
• 域名合规怎么选(为什么必须未备案 .com)
• 系统初始化(Docker / Caddy / fail2ban / UFW / swap)
• docker compose 部署 Sub2API 三容器
• Caddy 反代 + 域名 + Let's Encrypt 自动 HTTPS
• 后台 settings 表 / 数据库配置、账号与 API Key 治理
• 上游渠道 + 分组接入(让 key 真能调模型)
• 把旧 CRS 服务器迁移成 Sub2API(可回滚)
• 烟测 + 长期运维(升级 / 备份 / 1C2G 防 OOM / 欠费恢复)

**所有真实 IP、域名、密码一律是占位符。** 照抄前替换 `` / `` / `` 等即可。

目录结构

sub2api-relay-setup/
├─ SKILL.md                 主流程(0~9 阶段)+ 验证心智 + 排障思路
└─ references/
   ├─ buy-server.md         去哪买 / 买什么 / 域名怎么选 / 付款踩坑
   ├─ templates.md          Caddy / Nginx / settings SQL / 运维 / 烟测 可复制模板
   └─ pitfalls.md           全阶段踩坑速查(现象 → 原因 → 规则)

怎么用

作为 Claude Code / Claude Skill(推荐)

把整个目录放进 Claude Code 的 skills 目录即可:

git clone https://github.com/jessepwj/sub2api-relay-setup.git
# 放到你的 skills 目录(路径按你的环境):
cp -r sub2api-relay-setup ~/.claude/skills/

然后对 Claude 说「帮我搭一个中转站部署 sub2api」「怎么买服务器搭中转」等,skill 会自动触发,一步步带你做。

直接当文档看

不用 Claude 也行 —— `SKILL.md` + `references/` 本身就是一份完整的中文实战手册,直接阅读照做即可。

免责声明

• 本项目是独立的部署实战指南,与上游 `Wei-Shaw/sub2api` 无隶属关系,请以其官方 README 为准。
• 搭建中转 API 服务涉及上游服务商条款、数据合规、域名备案等责任,请自行评估并遵守当地法规与各服务商政策。
• 指南按作者实践整理,不同厂商 / 版本可能有差异,遇到不一致以官方文档和你实测为准。

License

[MIT](LICENSE) © jessepwj