| name | proxy-fleet |
| description | Manage multiple VPS proxy nodes: deploy 3x-ui + VLESS+Reality, generate Clash/Mihomo subscription URLs, and keep them in sync. Use this skill whenever the user mentions proxy servers, VPS deployment, 3x-ui, VLESS, Reality, Clash subscriptions, proxy fleet management, adding/removing proxy nodes, updating proxy rules, or checking proxy node status. Also trigger when the user says "部署代理", "代理节点", "订阅链接", "分流规则", or references their VPS proxy infrastructure in any way.
|
proxy-fleet
Manage multiple VPS proxy nodes from a single command line. Deploy 3x-ui + VLESS+Reality
and generate Clash/Mihomo subscription URLs that auto-sync when nodes change.
Working Directory
cd /Users/wangzhuc/proxy-fleet
Commands
All commands run from the project root:
python3 scripts/fleet.py init
python3 scripts/fleet.py status
python3 scripts/fleet.py deploy <host> [--name X --emoji 🇯🇵]
python3 scripts/fleet.py deploy <host> --nat 10000-10009
python3 scripts/fleet.py remove <host>
python3 scripts/fleet.py sync
When to Use Each Command
| User says | Command |
|---|
| "加台机器 / deploy / 部署代理" | deploy <ssh-host> |
| "删掉这个节点 / remove" | remove <ssh-host> |
| "节点状态 / 看下代理" | status |
| "更新规则 / 加个 AI 域名" | Edit templates/rules/*.yaml → sync |
| "刷新订阅 / 同步" | sync |
Deploy Flow
SSH → scan ports (avoid conflicts) → pick available port
→ install 3x-ui → reset credentials via CLI
→ generate x25519 keys → create VLESS+Reality inbound via API
→ detect firewall (ufw/iptables) → open ports
→ verify connectivity → save to config.json → sync subscription
Key Files
| File | Purpose |
|---|
config.json | Fleet state — credentials, nodes, subscription hosting (gitignored) |
config.example.json | Template for new users |
scripts/fleet.py | Main CLI — all operations |
templates/rules/ai.yaml | AI service routing rules (OpenAI, Claude, Gemini, etc.) |
templates/rules/proxy.yaml | Common proxy rules (Google, GitHub, Twitter, etc.) |
templates/rules/streaming.yaml | Streaming rules (YouTube, Netflix, etc.) |
templates/rules/direct.yaml | China-direct and LAN rules |
Updating Rules
Edit the relevant file in templates/rules/, then run sync to regenerate and upload
the subscription. Users refresh in Clash Verge Rev to get changes.
Technical Notes
These matter when debugging or extending the skill:
- Xray v26+ key format:
x25519 outputs PrivateKey / Password (= public key) / Hash32.
Older versions use Private key / Public key. The script handles both.
- 3x-ui install is interactive — the script installs with defaults, then resets credentials
via the
/usr/local/x-ui/x-ui setting CLI.
- 3x-ui API:
POST /login → session cookie → /panel/api/inbounds/{add,update,del,list}.
- Reality returns HTTP 400 to non-VLESS clients — the connectivity check treats 400 as alive.
- Port conflicts are the #1 deploy failure cause — the script scans ports before configuring.
- xray binary path is auto-detected via glob (
/usr/local/x-ui/bin/xray-linux-*), works
on both amd64 and arm64.
