# mack-a/v2ray-agent

Xray、Tuic、hysteria2、sing-box 八合一一键脚本

Repository: https://github.com/mack-a/v2ray-agent
Canonical: https://ross.abutalabs.com/products/v2ray-agent
Homepage: https://www.v2ray-agent.com
Language: Shell
License: AGPL-3.0
License Family: copyleft
Topics: cloudflare, nginx, v2ray, trojan, shell, websockettlscdn-cloudflare-ip, vless, vmess, xray-core, grpc-cloudflare, trojan-grpc, xtls-rprx-vision, reality, reality-grpc, xray, xray-install, sing-box, hysteria2, tuic-v5, httpupgrade
Last push: 2026-08-03T14:56:07+00:00

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 95, release rhythm 87, longevity 100
- inputs: {"age_days": 2492, "days_push": 30, "days_rel": 87, "gap_med": 11.0, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 21741, forks 5533 (observed 2026-08-28T04:11:32.020813+00:00)

## What it is
An all-in-one shell script that installs and manages proxy servers (Xray-core and sing-box) on a VPS, supporting protocols like VLESS, VMess, Trojan, Hysteria2, Tuic, and NaiveProxy. It provides an interactive menu for user management, automatic TLS certificate issuance and renewal, subscription link generation, and traffic routing rules.

## Use cases
- set up a proxy server on a VPS with one command
- install xray with reality and vless vision
- deploy hysteria2 on a cheap VPS
- automatically renew TLS certificates for a proxy server
- manage proxy users and ports via a menu
- generate subscription links for proxy clients
- route traffic through cloudflare CDN with websocket
- block torrent and P2P traffic on my server

## When to choose
- you want a quick, menu-driven setup of multiple proxy protocols on a Linux VPS
- you need automatic TLS certificate management and renewal
- you want to combine Xray-core and sing-box with subscription support in one tool
- you need CDN-friendly transports like websocket or gRPC through Cloudflare

## When to avoid
- you need a GUI or graphical dashboard for proxy management
- you run a non-Linux platform such as Windows or macOS as the server
- you want a minimal, hand-crafted configuration instead of an opinionated all-in-one script
- you require corporate-grade auditing of the generated server configuration

## Facets
- artifact type: cli-tool
- maturity: active
- function: security, networking, proxy, deployment, cli, self-hosted, configuration-management
- domain: privacy, censorship-circumvention, networking, self-hosted
- platform: cli, self-hosted
- tags: v2ray, xray, proxy-server, vpn, trojan, vless, vmess, reality, hysteria2, tuic, sing-box, cloudflare-cdn, tls-certificate, one-click-script, shell-script, subscription-management, nginx, devops, command-line, linux, docker

## Member repositories
- mack-a/v2ray-agent (main) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:32.020813+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:57:49.096565+00:00, confidence not recorded.
  - readme: https://github.com/mack-a/v2ray-agent (fetched 2026-08-28T04:11:32.020813+00:00, sha c5653843cda6)
  - homepage: https://www.v2ray-agent.com (fetched 2026-08-29T07:56:22.051822+00:00, sha e6ab8973468b)
  - site_page: https://www.v2ray-agent.com/about (fetched 2026-08-29T07:56:22.057981+00:00, sha 45460b738a3d)
  - site_page: https://www.v2ray-agent.com/archives/1680104902581 (fetched 2026-08-29T07:56:22.055121+00:00, sha 94e8733a519a)
- Data as of 2026-08-30T08:39:29.467469+00:00.