X UI Vpn Deploy — DevOps skill for Claude Code

x-ui-deploy

一个 [Claude Code](https://claude.com/claude-code) Skill：在一台全新 VPS 上，从零部署一套 **VLESS + XHTTP + TLS + Cloudflare CDN** 架构的自建代理服务（基于 [3X-UI](https://github.com/MHSanaei/3x-ui) 面板），目标是"把梯子搭起来能用就行"，同时覆盖日常运维、故障排查和进阶双线路优化。

本仓库的内容脱胎于一次真实的端到端部署实战（Azure VPS + 新版 3x-ui + 国内客户端实测），踩过的坑都已经写进对应文档，不是纸上谈兵的操作手册。

架构

客户端 → Cloudflare CDN (443) → Nginx (TLS/反代) → Xray (127.0.0.1:10000) → Internet

组件	技术
VPN 协议	VLESS
传输方式	XHTTP over TLS（替代 WebSocket，抗检测更强、弱网更稳）
管理面板	3X-UI (MHSanaei)
反向代理	Nginx
SSL 证书	acme.sh + Cloudflare DNS 验证
CDN	Cloudflare（隐藏真实 IP）

开始前准备

在让 Claude Code 执行部署之前，先备齐这些东西，能少走很多回头路：

#	需要什么	说明
1	一台全新 VPS	Debian/Ubuntu 为主线；AlmaLinux/Rocky/CentOS Stream 等 RHEL 系也支持（dnf/firewalld/conf.d 的差异已写进 manual-deploy.md，不用重装）。能 SSH 登录（root 或有 sudo 权限的账号均可）。云平台（Azure/AWS/GCP 等）也可以，但要留意它们在系统防火墙之外还有一层独立的安全组/NSG，见下方"已知的坑"
2	已经解析到 Cloudflare 的域名	域名（或至少一个子域名）的 NS 记录已指向 Cloudflare。注意：如果你的"域名"其实是 cc.cd/co.cc 这类免费二级域名分发服务，本身可能在 Public Suffix List 上，不能直接拿来签证书，需要用你实际申请到的完整子域名，详见 troubleshooting.md
3	Cloudflare API 凭据	Global API Key + 账户注册邮箱，或者一个有 Zone DNS/SSL/Settings 编辑权限的 API Token，二选一，用于自动申请 SSL 证书和配置 DNS
4	一个用于证书注册的邮箱	不需要和 Cloudflare 账户邮箱是同一个
5	已安装 Claude Code	本项目是给它用的 Skill，不是独立脚本
6	（可选）这台 VPS 上是否已有其他服务在跑	如果有（比如已经部署了 Outline），提前记下它们用的端口，避免部署过程中被防火墙规则误封

准备齐这些信息后，跟 Claude Code 说"帮我部署一个 VPN"，它会按 `SKILL.md` 里的流程逐项向你确认，再开始执行。

这是什么、怎么用

这不是一个可以直接运行的安装脚本，而是一套写给 [Claude Code](https://claude.com/claude-code) 的 **Skill**——把它放进 `~/.claude/skills/x-ui-deploy/` 之后，跟 Claude Code 说"帮我部署一个 VPN"之类的话，它会读取这套文档、通过 SSH 连接你的服务器、逐步完成部署，并在遇到问题时按文档里记录的踩坑经验自主排查。

安装

git clone https://github.com/flowersmiling/x-ui-vpn-deploy.git ~/.claude/skills/x-ui-deploy

（Windows 上是 `%USERPROFILE%\.claude\skills\x-ui-deploy`）

安装完之后，直接跟 Claude C