gitwtfhub

wtf is v2ray-agent?

mack-a/v2ray-agent — explained in plain English

Analysis updated 2026-06-21

★ 20,506ShellAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

TL;DR

One-click Linux shell script that installs and configures Xray or sing-box proxy server software on a VPS, supporting multiple protocols for bypassing internet restrictions with automatic SSL and a menu interface.

Mindmap

mindmap
  root((v2ray-agent))
    Protocols
      VLESS
      Trojan
      Hysteria2
      NaiveProxy
    Features
      Auto SSL renewal
      User management
      Subscription links
    Traffic routing
      WireGuard
      IPv6
      SNI reverse proxy
    Setup
      Linux VPS
      One-click install
      vasma command

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

Set up a self-hosted proxy server on a Linux VPS with automatic SSL certificate generation in under 30 minutes.

REASON 2

Manage proxy users, subscription links, and traffic routing through a simple menu by running vasma.

REASON 3

Unblock streaming services by routing traffic through WireGuard or SNI reverse proxy configurations.

What's in the stack?

ShellXray-coresing-boxLinuxWireGuard

How it stacks up

mack-a/v2ray-agentnyr/openvpn-installspaceship-prompt/spaceship-prompt
Stars20,50620,52520,487
LanguageShellShellShell
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audienceops devopsops devopsdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a Linux VPS with a domain name pointed at it for automatic SSL certificate generation.

Free to use and modify under AGPL-3.0, but any deployed version must also share its source code under the same license.

Wtf does this do

This repository provides a Chinese-language one-click shell script for quickly installing and configuring proxy server software on a Linux VPS. It supports multiple cores, Xray-core and sing-box, and multiple protocols including VLESS, VMess, Trojan, Hysteria2, Tuic, and NaiveProxy. Key features listed in the README include automatic SSL certificate application and renewal, a simple menu-based interface for managing users, ports, and configuration, subscription link generation and management, traffic routing management (including WireGuard, IPv6, Socks5, DNS, and SNI reverse proxy for unblocking streaming media), domain blacklist management to block access to specific websites, and BT download controls. After installation, the management menu can be reopened at any time by running the command vasma. The project is licensed under AGPL-3.0 and has an associated Telegram channel and group for community support.

Yoink these prompts

Prompt 1
I just ran the v2ray-agent installer on my VPS. How do I add a new user and generate a subscription link using the vasma menu?
Prompt 2
My Xray-core proxy set up by v2ray-agent is slow on high-latency connections, how do I switch the protocol to Hysteria2?
Prompt 3
How do I migrate an existing v2ray-agent VLESS setup to sing-box for better mobile client compatibility?
Prompt 4
Walk me through setting up BT download blocking in v2ray-agent using the built-in traffic routing management.

Frequently asked questions

wtf is v2ray-agent?

One-click Linux shell script that installs and configures Xray or sing-box proxy server software on a VPS, supporting multiple protocols for bypassing internet restrictions with automatic SSL and a menu interface.

What language is v2ray-agent written in?

Mainly Shell. The stack also includes Shell, Xray-core, sing-box.

What license does v2ray-agent use?

Free to use and modify under AGPL-3.0, but any deployed version must also share its source code under the same license.

How hard is v2ray-agent to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is v2ray-agent for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

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

Other repos in this lane