gitwtfhub

wtf is vless-ultimate-installer?

inferno1978/vless-ultimate-installer — explained in plain English

Analysis updated 2026-05-18

14PythonAudience · ops devopsComplexity · 4/5Setup · hard

TL;DR

Russian-language Python installer that sets up a VLESS proxy server (Xray-core, REALITY or xHTTP) on a Linux VPS, with optional cascaded entry-exit tunneling through AmneziaWG.

Mindmap

mindmap
  root((VLESS-Ultimate-Installer))
    Inputs
      Ubuntu or Debian VPS
      Root access
      Public IP
    Outputs
      Configured Xray proxy
      VLESS share links and QR codes
      Clash and Sing-box configs
    Use Cases
      Personal anti-censorship tunnel
      Cascaded entry-exit setup
      Multi-node exit balancing
    Tech Stack
      Python
      Xray-core
      nginx
      AmneziaWG

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Deploy a personal VLESS REALITY proxy on a single Linux VPS

REASON 2

Run a cascaded entry-exit tunnel from a Russian VPS to a foreign exit over AmneziaWG

REASON 3

Manage proxy users with QR codes, share links, TTL, and traffic limits

REASON 4

Export proxy configs for Clash Meta and Sing-box clients

What's in the stack?

PythonXray-corenginxAmneziaWGCertbotiptables

How it stacks up

inferno1978/vless-ultimate-installer0c33/agentic-aiadennng/stock_strategy_lab
Stars141414
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity4/54/54/5
Audienceops devopsdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Needs a root-accessible Ubuntu 20.04+ or Debian 11+ VPS with a public IP and Python 3.10+, and Mode B requires two VPS hosts.

Wtf does this do

VLESS Ultimate Installer is a Russian-language Python project that automates setting up a VLESS proxy server on a Linux VPS, intended as a personal anti-censorship tunnel. VLESS is the protocol used by the Xray-core proxy, and the installer covers both the REALITY variant over TCP and an xHTTP over TLS variant. The README targets Ubuntu 20.04, 22.04, or 24.04 and Debian 11, 12, or 13, requires Python 3.10 or newer, root access, and a public IP. A one-line bootstrap script downloads and runs an installer from the repository, or the user can clone the repo to /opt/vless-ultimate and run main.py manually. The single entry point opens an interactive menu, and CLI flags such as --status, --scheduled-backup, and --switch-mode-a or --switch-mode-b are also available. The installer supports three deployment modes. Mode A is a single VPS that the client connects to directly. Mode B is a cascade where the client first reaches an entry VPS inside Russia, which then forwards to a foreign exit VPS over an AmneziaWG (AWG 2.0) tunnel. Mode B Multi extends this to several exit nodes with built-in balancing, up to ten. Around this it bundles a long list of features: encrypted DNS through DNSCrypt-proxy with leak tests, split tunneling using RIPE NCC data for Russian subnets, optional Cloudflare WARP in full, selective, or runet-only modes, Telegram notifications, configuration exports for Clash Meta and Sing-box clients, user management with QR codes, share links, TTL, and traffic limits, and security pieces such as AutoBan, a DPI detector, a honeypot, and SSH hardening. The repository centers on main.py, bootstrap.sh, a verify.py integrity check, and a vless_installer package whose _core.py the README estimates at around 37,000 lines, plus modules for MTProto proxying, an nginx watchdog, ipset persistence across reboot, smoke tests after each config apply, atomic Xray config apply, RIPE file age checks, and cluster operations on exit nodes. The running stack uses Xray-core for VLESS handling, nginx for TLS termination and a masking decoy site, AmneziaWG for the encrypted entry-to-exit tunnel, Certbot for Let's Encrypt certificates in the xHTTP mode, and ipset plus iptables for optional Russian-subnet ingress blocking.

Yoink these prompts

Prompt 1
Walk me through running the bootstrap.sh one-liner on a fresh Ubuntu 22.04 VPS for Mode A
Prompt 2
Show me how to switch an existing install from Mode A to Mode B using the --switch-mode-b flag
Prompt 3
Explain how the AmneziaWG tunnel is set up between the entry and exit VPS in Mode B
Prompt 4
Help me add a new user with a QR code and a 50GB monthly traffic limit
Prompt 5
Set up Telegram notifications and the nginx watchdog after install

Frequently asked questions

wtf is vless-ultimate-installer?

Russian-language Python installer that sets up a VLESS proxy server (Xray-core, REALITY or xHTTP) on a Linux VPS, with optional cascaded entry-exit tunneling through AmneziaWG.

What language is vless-ultimate-installer written in?

Mainly Python. The stack also includes Python, Xray-core, nginx.

How hard is vless-ultimate-installer to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is vless-ultimate-installer for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.