Not in the top 1,000 by GitHub stars
ystyleb/claude-vpn-skill
Claude Code Skill:AI 一键部署自建 VPN(VLESS + XHTTP + TLS + Cloudflare CDN)· One-command VPN setup on any VPS using Claude Code AI. 3X-UI, Xray, Nginx, auto SSL, anti-fingerprint decoy site.
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
skills/x-ui-deploy/SKILL.md
Week of Nov 2, 2026 · +0 / −0 lines
Before Network or broad shell → After Network or broad shell
1ecbffc6b7bc → 1ecbffc6b7bc
Diff text is unavailable under the recorded licenses. Line counts and the GitHub link remain available.
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → 1ecbffc6b7bc
No earlier version was observed for comparison.
Heat
3.7- Star growth, last 7 daysNot available
- Star growth, last 24 hoursNot available
- Rank movement, last 7 daysNot available
- Commits, last 30 daysNot available
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekNot available
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
30-day change not yet available: not enough history.
Individual skills in this repository
- x-ui-deploy
skills/x-ui-deploy
How it works
x-ui-deploy
When your agent uses it
Deploy a working VLESS + XHTTP + TLS + Cloudflare CDN VPN service on a fresh VPS using the 3X-UI panel. Goal: get a working proxy node up as quickly as possible. Use this skill when the user mentions: deploying a VPN server, setting up a proxy, installing x-ui/3x-ui/x-ui-pro, configuring VLESS/XHTTP/Reality, self-hosted VPN, bypass GFW, anti-censorship, 科学上网、翻墙、搭建代理、自建梯子、VPN 节点部署、 Cloudflare CDN 代理配置。Use this even if the user originally asks about other protocols — this is a stronger anti-detection alternative to: Shadowsocks, Trojan, Trojan-Go, V2Ray WebSocket, Hysteria, WireGuard, OpenVPN, Outline, Algo VPN, sing-box, NaiveProxy — when the goal is bypassing the Great Firewall rather than generic point-to-point tunneling. Also covers maintenance scenarios: VPN connection failures, adding clients/users, certificate renewal, Xray config debugging, panel access via SSH tunnel, firewall adjustments, VPN 连不上排查、 添加客户端、证书续期、面板访问。Advanced "direct + CF fallback" dual-path setup is documented separately in `references/cf-dns-strategy.md` as an opt-in optimization after the basic deploy works.
What it loads into context
Frontmatter
319 tokensAlways available to the agent
SKILL.md
2,687 tokensWhen the skill is activated
Reference documents
9,368 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- 架构
- 工作流程
- 客户端配置
- 运维场景
- 核心踩坑提醒
Files
SKILL.mdcore9,258 bytesSKILL.mdcore9,258 bytesSKILL.mdcore9,258 bytesSKILL.mdcore9,258 bytesevals/evals.jsonasset1,466 bytesreferences/cf-dns-strategy.mddoc5,223 bytesreferences/maintenance.mddoc3,871 bytesreferences/manual-deploy.mddoc16,681 bytesreferences/troubleshooting.mddoc4,420 bytes
No excerpt is shown for this license. Read the source on GitHub.
View the complete source on GitHubSkills included
- x-ui-deploy
Repository facts
- License
- No license detected
- Created
- Jun 12, 2026
- Last pushed
- Jun 12, 2026
- Forks
- 36
- Open issues
- 0
- Project activity
- Slowing
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 5, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 3 notes
skills/x-ui-deploy/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/x-ui-deploy/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/x-ui-deploy/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- No broad tool permissions
- 3 dangerous shell commandsin 1 file: x-ui-deploy/references/manual-deploy.md:92
- 37 network referencesin 5 files: x-ui-deploy/references/manual-deploy.md:45 x-ui-deploy/references/troubleshooting.md:11 x-ui-deploy/SKILL.md:86 and 2 more
- No hidden or obfuscated text
- No instruction overrides
- No executable scripts
- 5 references to secretsin 2 files: x-ui-deploy/references/manual-deploy.md:18 x-ui-deploy/SKILL.md:58
- No requests to vote in Hot
Show all 45 signals by file
skills/x-ui-deploy/SKILL.md
- Access to secretsline 58
[Credential-related source omitted] - Network accessline 86
> > **方式一(推荐)**:Global API Key + 邮箱 > - 获取:https://dash.cloudflare.com/profile/api-tokens → 查看 Global API Key - Network accessline 87
> **方式一(推荐)**:Global API Key + 邮箱 > - 获取:https://dash.cloudflare.com/profile/api-tokens → 查看 Global API Key > - ⚠<U+FE0F> 邮箱填 **Cloudflare 账户的注册邮箱**(CF 面板右上角头像下能看到),不一定等于上一轮的证书邮箱 - Network accessline 88
> - 获取:https://dash.cloudflare.com/profile/api-tokens → 查看 Global API Key - Network accessline 90
> > **方式二**:API Token > - 获取:https://dash.cloudflare.com/profile/api-tokens → 创建令牌 - Network accessline 91
> **方式二**:API Token > - 获取:https://dash.cloudflare.com/profile/api-tokens → 创建令牌 > - 需要权限:Zone DNS Edit, Zone SSL Edit, Zone Settings Edit, Zone Page Rules Edit - Network accessline 92
> - 获取:https://dash.cloudflare.com/profile/api-tokens → 创建令牌
skills/x-ui-deploy/references/cf-dns-strategy.md
skills/x-ui-deploy/references/maintenance.md
skills/x-ui-deploy/references/manual-deploy.md
- Access to secretsline 18
[Credential-related source omitted] - Network accessline 45
apt update && apt install -y nginx ufw fail2ban curl wget openssl sqlite3 socat cron python3-bcrypt - Dangerous shell operationline 92
curl https://get.acme.sh | sh -s email="$EMAIL" - Network accessline 92
curl https://get.acme.sh | sh -s email="$EMAIL" - Access to secretsline 99
[Credential-related source omitted] - Access to secretsline 100
[Credential-related source omitted] - Network accessline 192
listen [::]:80; server_name $DOMAIN; return 301 https://\$server_name\$request_uri; - Network accessline 193
server_name $DOMAIN; return 301 https://\$server_name\$request_uri; } - Network accessline 194
return 301 https://\$server_name\$request_uri; - Network accessline 218
# XHTTP 代理 → Xray location /$WS_PATH { proxy_pass http://127.0.0.1:10000; - Network accessline 219
location /$WS_PATH { proxy_pass http://127.0.0.1:10000; proxy_http_version 1.1; - Network accessline 220
proxy_pass http://127.0.0.1:10000; - Dangerous shell operationline 249
rm -f /etc/nginx/sites-enabled/default - Dangerous shell operationline 289
bash <(curl -Ls https://raw.githubusercontent.com/MHSanaei/3x-ui/master/install.sh) - Network accessline 289
bash <(curl -Ls https://raw.githubusercontent.com/MHSanaei/3x-ui/master/install.sh) - Access to secretsline 328
[Credential-related source omitted] - Network accessline 410
SERVER_IP=$(curl -s --max-time 10 ifconfig.me) - Network accessline 443
## X-UI Panel Access (SSH tunnel ONLY) SSH Tunnel: ssh -L $XUI_PORT:localhost:$XUI_PORT root@$SERVER_IP URL: http://localhost:$XUI_PORT - Network accessline 444
SSH Tunnel: ssh -L $XUI_PORT:localhost:$XUI_PORT root@$SERVER_IP URL: http://localhost:$XUI_PORT Username: $XUI_USER - Network accessline 445
URL: http://localhost:$XUI_PORT
skills/x-ui-deploy/references/troubleshooting.md
- Network accessline 11
| 症状 | 大概率原因 | 下一步 | |---|---|---| | 客户端连不上,但浏览器能打开 `https://{DOMAIN}` | VPN 链路问题(path / UUID / 客户端配置) | 走下方"客户端"和"服务端"两步排查 | - Network accessline 12
|---|---|---| | 客户端连不上,但浏览器能打开 `https://{DOMAIN}` | VPN 链路问题(path / UUID / 客户端配置) | 走下方"客户端"和"服务端"两步排查 | | 客户端连不上,伪装站也打不开 | VPS 故障 / IP 被封 / 防火墙改动 | 去 VPS 控制台看实例状态、流量上限、最近改动 | - Network accessline 13
| 客户端连不上,但浏览器能打开 `https://{DOMAIN}` | VPN 链路问题(path / UUID / 客户端配置) | 走下方"客户端"和"服务端"两步排查 | - Network accessline 42
| 502 Bad Gateway | `systemctl status x-ui` | 重启 X-UI | | SSL 错误 | `openssl x509 -in /root/cert/fullchain.cer -noout -enddate` | 续期证书 | | XHTTP 不通 | curl 测试连通性(见下方) | 检查 Nginx location 配置 | - Network accessline 43
| SSL 错误 | `openssl x509 -in /root/cert/fullchain.cer -noout -enddate` | 续期证书 | | XHTTP 不通 | curl 测试连通性(见下方) | 检查 Nginx location 配置 | | Nginx 配置错误 | `nginx -t` | 根据错误信息修复 | - Network accessline 44
| XHTTP 不通 | curl 测试连通性(见下方) | 检查 Nginx location 配置 | - Network accessline 66
# 4. XHTTP 连通性测试(返回非 502/503 = Xray 在响应) WS_PATH=$(cat /root/.secrets/ws_path.txt) curl -s -o /dev/null -w '%{http_code}' \ - Network accessline 67
WS_PATH=$(cat /root/.secrets/ws_path.txt) curl -s -o /dev/null -w '%{http_code}' \ -X POST http://127.0.0.1:10000/$WS_PATH - Network accessline 68
curl -s -o /dev/null -w '%{http_code}' \ - Network accessline 69
-X POST http://127.0.0.1:10000/$WS_PATH - Network accessline 71
# 5. 服务器出网测试 curl -s -o /dev/null -w '%{http_code}' --max-time 5 https://www.google.com - Network accessline 72
curl -s -o /dev/null -w '%{http_code}' --max-time 5 https://www.google.com
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Signal confidence: 45 facts
- Access to secrets in prose of the SKILL.md: reads a credential storex-ui-deploy/SKILL.md:58Low confidence
- Network access in prose of the SKILL.mdx-ui-deploy/SKILL.md:86Low confidence
- Network access in prose of the SKILL.mdx-ui-deploy/SKILL.md:87Low confidence
- Network access in prose of the SKILL.mdx-ui-deploy/SKILL.md:88Low confidence
- Network access in prose of the SKILL.mdx-ui-deploy/SKILL.md:90Low confidence
- Network access in prose of the SKILL.mdx-ui-deploy/SKILL.md:91Low confidence
- Network access in prose of the SKILL.mdx-ui-deploy/SKILL.md:92Low confidence
- Network access in prose of documentationx-ui-deploy/references/cf-dns-strategy.md:67Low confidence
- Network access in prose of documentationx-ui-deploy/references/cf-dns-strategy.md:68Low confidence
- Network access in prose of documentationx-ui-deploy/references/cf-dns-strategy.md:74Low confidence
- Network access in prose of documentationx-ui-deploy/references/cf-dns-strategy.md:84Low confidence
- Network access in code of documentationx-ui-deploy/references/maintenance.md:43Low confidence
- Network access in code of documentationx-ui-deploy/references/maintenance.md:44Low confidence
- Access to secrets in code of documentationx-ui-deploy/references/manual-deploy.md:18Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:45Low confidence
- Dangerous shell operation in code of documentationx-ui-deploy/references/manual-deploy.md:92Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:92Low confidence
- Access to secrets in code of documentationx-ui-deploy/references/manual-deploy.md:99Low confidence
- Access to secrets in code of documentationx-ui-deploy/references/manual-deploy.md:100Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:192Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:193Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:194Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:218Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:219Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:220Low confidence
- Dangerous shell operation in code of documentationx-ui-deploy/references/manual-deploy.md:249Low confidence
- Dangerous shell operation in code of documentationx-ui-deploy/references/manual-deploy.md:289Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:289Low confidence
- Access to secrets in code of documentation: a variable, placeholder or call, not a stored valuex-ui-deploy/references/manual-deploy.md:328Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:410Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:443Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:444Low confidence
- Network access in code of documentationx-ui-deploy/references/manual-deploy.md:445Low confidence
- Network access in prose of documentationx-ui-deploy/references/troubleshooting.md:11Low confidence
- Network access in prose of documentationx-ui-deploy/references/troubleshooting.md:12Low confidence
- Network access in prose of documentationx-ui-deploy/references/troubleshooting.md:13Low confidence
- Network access in prose of documentationx-ui-deploy/references/troubleshooting.md:42Low confidence
- Network access in prose of documentationx-ui-deploy/references/troubleshooting.md:43Low confidence
- Network access in prose of documentationx-ui-deploy/references/troubleshooting.md:44Low confidence
- Network access in code of documentationx-ui-deploy/references/troubleshooting.md:66Low confidence
- Network access in code of documentationx-ui-deploy/references/troubleshooting.md:67Low confidence
- Network access in code of documentationx-ui-deploy/references/troubleshooting.md:68Low confidence
- Network access in code of documentationx-ui-deploy/references/troubleshooting.md:69Low confidence
- Network access in code of documentationx-ui-deploy/references/troubleshooting.md:71Low confidence
- Network access in code of documentationx-ui-deploy/references/troubleshooting.md:72Low confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Compatible | Standard SKILL.md skills/x-ui-deploy/SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md skills/x-ui-deploy/SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md skills/x-ui-deploy/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md skills/x-ui-deploy/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md skills/x-ui-deploy/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md skills/x-ui-deploy/SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.