mack-a/v2ray-agent

Analysis updated 2026-06-21

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

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

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

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

What is it built with?

ShellXray-coresing-boxLinuxWireGuard

How does it compare?

	mack-a/v2ray-agent	nyr/openvpn-install	spaceship-prompt/spaceship-prompt
Stars	20,506	20,525	20,487
Language	Shell	Shell	Shell
Setup difficulty	moderate	moderate	easy
Complexity	3/5	2/5	2/5
Audience	ops devops	ops devops	developer

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

How do you get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub mack-a on gitmyhub

Verify against the repo before relying on details.