How do I install the Proxy Fleet skill?

Run npx skillmds@latest add imraywang/proxy-fleet in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Proxy Fleet safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Proxy Fleet?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Proxy Fleet free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Proxy Fleet?

imraywang (@imraywang) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Proxy Fleet by imraywang — Agent Skill

Name: Proxy Fleet
Author: imraywang

Proxy Fleet

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.

imraywang 8995934 6 files · 14.4 KB Updated Sep 17, 2026

File contents

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                              # First-time setup
python3 scripts/fleet.py status                            # Parallel health check
python3 scripts/fleet.py deploy <host> [--name X --emoji 🇯🇵]  # One-click deploy
python3 scripts/fleet.py deploy <host> --nat 10000-10009   # NAT machine
python3 scripts/fleet.py remove <host>                     # Remove from subscription
python3 scripts/fleet.py sync                              # Regenerate subscription YAML

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.

---name: proxy-fleetdescription: 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-fleetManage multiple VPS proxy nodes from a single command line. Deploy 3x-ui + VLESS+Realityand generate Clash/Mihomo subscription URLs that auto-sync when nodes change.## Working Directory```bashcd /Users/wangzhuc/proxy-fleet```## CommandsAll commands run from the project root:```bashpython3 scripts/fleet.py init # First-time setuppython3 scripts/fleet.py status # Parallel health checkpython3 scripts/fleet.py deploy <host> [--name X --emoji 🇯🇵] # One-click deploypython3 scripts/fleet.py deploy <host> --nat 10000-10009 # NAT machinepython3 scripts/fleet.py remove <host> # Remove from subscriptionpython3 scripts/fleet.py sync # Regenerate subscription YAML```## 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 RulesEdit the relevant file in `templates/rules/`, then run `sync` to regenerate and uploadthe subscription. Users refresh in Clash Verge Rev to get changes.## Technical NotesThese 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.

Frequently asked questions