Singbox Proxy Skill — AI skill for Claude Code

**中文** · [English](README.en.md)

singbox-proxy-skill —— 给 Claude Code / AI 工具自建稳定 IP 代理

给开发者的「**稳定 IP 搭建**」skill:一条命令级地在自己的 VPS 上起一套 **sing-box Shadowsocks 中转 + 网页管理面板 + 安全加固**，可选链一个**静态住宅出口**， 让你从任何网络都能**稳定、可信地**访问 Claude Code / Claude API / Codex / Cursor 等 AI 开发工具。 手动可跑,也能被任何 AI 编码 agent 驱动。

**singbox-proxy-skill** 是一个开源的 [Claude Code](https://claude.com/claude-code) agent skill（也可移植到 Cursor / Cline / Aider / Codex 等）。你把一台干净的 Ubuntu VPS 交给它，它就：

• 装好 sing-box（经典 Shadowsocks aes-256-gcm，一账号一端口一密码）；
• 起一个单文件网页面板：服务器实时监控（CPU/内存/磁盘/网络/服务健康）+ 账号增删/禁用/轮换 + 一键导出配置；
• 做好 SSH 加固 + UFW + fail2ban + 自动安全更新；
• 可选链上游 SOCKS5/HTTP 代理（住宅出口 IP），可选绑域名（换机器只改 DNS，客户端零改动）；
• 抗封传输可选：经典 SS（默认）/ VLESS+REALITY / VLESS+WS+TLS 套 Cloudflare CDN——干净 IP 被封或被限速时，换协议或让源站藏到 CF 后面（见下方链路架构）；
• 一键出 Clash / ss:// 配置发给你的电脑和手机。

管理面板（网页）

登录后即是**服务器实时监控**（CPU / 内存 / 磁盘 / 网络 / 服务健康 / 出口 IP），走 SSH 隧道访问、不公网暴露：


**账号管理** —— 一账号一端口一密码，可创建 / 禁用 / 启用 / 轮换密码 / 删除：


**每个账号一键导出配置**（手机 `ss://` + 电脑完整 Clash YAML，含国内外分流规则）：


图中均为脱敏示例数据（`vpn.example.com` / `203.0.113.7`）。

为什么要「稳定 IP」——Claude Code 的痛点

Claude Code / Claude API、OpenAI、Cursor 这些 AI 工具**对你的出口 IP 很敏感**：

• 机房 / 云 IP 经常被限流、弹验证码，甚至直接 403（看着像机器人）；
• 共享 VPN IP 会轮换、被拉黑，动不动掉线重登；
• 静态住宅 / ISP IP 像正常家庭用户：固定、可信、不轮换 —— Claude Code 稳定在线、不被卡。

所以最稳的组合是:**离你近的干净 IP VPS 做入口**（握手快、线路好）+ **静态住宅上游做出口**（AI 服务看到的那个可信身份）。 只想翻过网络封锁、不在乎 IP 信誉，就跳过上游，直接从 VPS 出。选型见 [`references/providers.md`](references/providers.md)。

链路架构：两种方案，看你有没有 Cloudflare

同一套服务器，两种客户端接入链路。**没有 Cloudflare 域名 → 走方案一（经典直连，老搭建）；有域名并托管到 Cloudflare → 走方案二（CDN 抗封，新链路）。** 出口那一段（可选的静态住宅上游）两种方案完全一样。

方案一 · 经典直连（无需 Cloudflare · 最简单）

客户端直接连你 VPS 的公网 IP。传输用经典 Shadowsocks（或 VLESS+REALITY）。

 ┌──────────┐   经典SS / REALITY    ┌───────────────┐  （可选）SOCKS5上游  ┌────────────────┐
 │  你的设备  │ ───────────────────▶ │   你的 VP