vps-proxy-skill

Claude Code skill for deploying and managing a complete proxy infrastructure on a VPS.

What it sets up

• mihomo (Docker) — dual-protocol proxy core
  • VLESS-WebSocket-TLS on TCP 8443
  • Hysteria2 (QUIC) on UDP 443
• Subscription server — Python HTTP server that auto-detects client type
  • Clash/mihomo/Stash → YAML config with proxy groups & rules
  • v2rayNG/NekoBox → base64-encoded share links
• nginx — TLS termination + reverse proxy for subscription endpoint
• Let's Encrypt — automated TLS with certbot + renewal hooks

Architecture

Internet
  ├── TCP :8443 ──► mihomo (VLESS-WS-TLS)
  ├── UDP :443  ──► mihomo (Hysteria2)
  └── TCP :443  ──► nginx
                     ├── /sub ──► subscription server
                     └── /*   ──► your app

Skills included

Skill	Description
setup-proxy	Full setup from scratch on a fresh VPS
manage-proxy	Day-to-day operations, troubleshooting, user management

Installation

Claude Code

# Via plugin marketplace (once published)
/plugin install vps-proxy

# Or manually — clone and symlink
git clone https://github.com/westlakedata/vps-proxy-skill.git ~/.claude/plugins/vps-proxy

Manual (any AI coding assistant)

Copy the skills/ directory contents into your assistant's skill/command directory. The .md files are self-contained.

Usage

In Claude Code:

/setup-proxy    # Deploy from scratch
/manage-proxy   # Manage existing setup

Or just describe what you need — the skills are auto-matched by description.

Prerequisites

• VPS with public IP (Debian/Ubuntu)
• Domain with A record pointing to VPS
• Ports: 80/TCP, 443/TCP+UDP, 8443/TCP
• Root access

Templates

• skills/setup-proxy/sub_server_template.py — subscription server template with placeholder variables

License

MIT