ClashVerge-MultiScript - 🎓 Override script for CN campus network, academic databases, AI services & game accelerator coexistence

• 🖥️ 100% Local Execution — Credentials and keys stay on your computer
• 🧙 Interactive Wizard — No manual YAML editing required
• 🔐 SSH Hardening — Auto ed25519 key generation, port change, optional password-login disable
• 🚄 Network Tuning — One-click BBR congestion control + sysctl tweaks
• 🎯 Hysteria 2 Out-of-the-Box — Server install + client config auto-generated
• 📦 Zero Dependencies — Single .exe, no Python/Node needed
• 🛡️ Dry-Run Mode — Preview before touching your VPS
• 🔄 Idempotent — Safe to re-run

PS> .\\VPS-Builder.exe deploy -c config.yaml --ask-password

Enter current VPS SSH/root password: \*\*\*\*\*\*\*\*
Ready to deploy 1.2.3.4: SSH TCP 2222, Hysteria UDP 8443. Type yes to continue: yes

\[1/8] Connecting to VPS...               ✓
\[2/8] Generating SSH keys...             ✓
\[3/8] Uploading public key...            ✓
\[4/8] Hardening SSH (port 2222)...       ✓
\[5/8] Updating system packages...        ✓
\[6/8] Enabling BBR...                    ✓
\[7/8] Installing Hysteria 2...           ✓
\[8/8] Generating client config...        ✓

Deployment completed!
SSH private key: C:\\Users\\you\\AppData\\Roaming\\VPS-Builder\\keys\\1.2.3.4\_VPS-Builder-Key
Hysteria client: C:\\Users\\you\\AppData\\Roaming\\VPS-Builder\\clients\\1.2.3.4\_hysteria.yaml

• Windows 10 or Windows 11
• PowerShell
• Go 1.21+ (only if building from source)

• ✅ Supported: KVM / Xen / VMware (full virtualization)
• ❌ NOT supported: OpenVZ (cannot enable BBR, poor UDP performance)
• 💡 Not sure? Check the provider's product page, or run on the VPS:

  systemd-detect-virt
  # Output `kvm` or `xen` → supported; `openvz` or `lxc` → not supported

• ✅ Supported: Debian 10+ / Ubuntu 20.04+
• ❌ NOT supported: CentOS / AlmaLinux / Rocky Linux / Arch / Windows Server
• 💡 Not sure about your OS? Run on the VPS:

  cat /etc/os-release

• 💡 If it's another OS, go to your VPS console and "Reinstall OS" → pick Debian 12 or Ubuntu 22.04 LTS

• Root SSH password login enabled (only for the first deployment)

• Firewall/Security Group open:

  • TCP 22 (current SSH port)
  • TCP 2222 (new SSH port, customizable)
  • UDP 8443 (Hysteria 2 port, customizable)

🤔 **Is "KVM VPS" the same as "Debian/Ubuntu VPS"?**

No! They are two different layers:

• **KVM** is a virtualization technology (the VPS "hardware architecture")
• **Debian/Ubuntu** is an operating system (what runs inside)

A KVM VPS can run Debian, Ubuntu, CentOS, or any Linux distro. This tool requires the combo of **"KVM virtualization + Debian/Ubuntu OS"**.

Go to the Releases page and download the latest VPS-Builder-windows-amd64.exe.

git clone https://github.com/SehAie/VPS-Builder.git
cd VPS-Builder
go mod tidy
go build -o VPS-Builder.exe ./cmd/VPS-Builder

.\\VPS-Builder.exe init -o config.yaml

Answer a few wizard questions: VPS IP, new SSH port, Hysteria port, domain, etc.

By default: TCP 2222 and UDP 8443 (or whatever you set in config.yaml).

.\\VPS-Builder.exe deploy -c config.yaml --dry-run --ask-password

.\\VPS-Builder.exe deploy -c config.yaml --ask-password

Enter your current root password, type yes to confirm.

explorer $env:APPDATA\\VPS-Builder

Structure:

%APPDATA%\\VPS-Builder\\
├── keys\\
│   ├── <IP>\_VPS-Builder-Key          # SSH private key
│   └── <IP>\_VPS-Builder-Key.pub      # SSH public key
├── clients\\
│   └── <IP>\_hysteria.yaml            # Hysteria client config
└── last-deploy-summary.txt

ssh -i "$env:APPDATA\\VPS-Builder\\keys\\1.2.3.4\_VPS-Builder-Key" -p 2222 root@1.2.3.4

• VPS\_BUILDER\_ROOT\_PASSWORD — Preset SSH password (use --ask-password for better security)

Key factors: virtualization type (must be KVM), region, bandwidth cap, UDP support, streaming unblock.

⚠️ **Avoid OpenVZ providers**: Some ultra-cheap VPSes use OpenVZ virtualization, which **can't enable BBR and has poor UDP performance**, making them unsuitable for Hysteria 2. Always confirm "KVM" on the product page before buying.

In the control panel's "Reinstall OS":

• ✅ Debian 12 (Bookworm) — recommended, lean & stable
• ✅ Ubuntu 22.04 LTS — more packages
• ❌ Don't pick CentOS / AlmaLinux / Rocky / Windows

• Note the IP from your console
• Root password is usually in the welcome email, or reset it in the console

  iptables -I INPUT -p tcp --dport 2222 -j ACCEPT
  iptables -I INPUT -p udp --dport 8443 -j ACCEPT
  netfilter-persistent save

After deployment you'll get a Hysteria 2 client config at %APPDATA%\\VPS-Builder\\clients\\.

• ✅ Test on a fresh VPS first — never on production
• ✅ Disable SSH password login after verifying key login works
• ❌ Never commit config.yaml, private keys, or client configs to public repos
• ❌ Avoid default ports (defaults already moved to 2222 / 8443)
• ✅ Back up your %APPDATA%\\VPS-Builder\\ folder

PRs, issues, and suggestions welcome!

git clone https://github.com/SehAie/VPS-Builder.git
cd VPS-Builder
go mod tidy
go test ./...

MIT License — see LICENSE.

If this project helps you, please give it a star ⭐!

This tool is for educational and lawful use only. Users are responsible for complying with local laws. The author is not liable for misuse.