v2rayA — Web-Based V2Ray Client with Transparent Proxy

Introduction

v2rayA is a web-based GUI client for V2Ray and Xray proxy cores, designed primarily for Linux servers and desktops. It provides a browser-accessible interface for managing proxy servers, configuring routing rules, and enabling transparent system-wide proxying without desktop GUI dependencies.

What v2rayA Does

• Manages V2Ray/Xray connections through a web dashboard accessible from any browser
• Enables transparent proxy mode using iptables/nftables to route all system traffic
• Imports server configurations from subscription links, QR codes, or manual input
• Supports VMess, VLESS, Trojan, Shadowsocks, and other protocols via the underlying core
• Provides latency testing and automatic server selection across multiple nodes

Architecture Overview

v2rayA is a Go-based web application that wraps V2Ray-core or Xray-core. It runs as a system service, exposing a Vue.js frontend on a local port. When the user activates a connection, v2rayA generates the appropriate V2Ray/Xray JSON configuration and manages the core process lifecycle. Transparent proxy mode sets up iptables/nftables rules to redirect TCP and UDP traffic through the local proxy, with configurable bypass rules for LAN and direct-access domains.

Self-Hosting & Configuration

• Install alongside V2Ray-core or Xray-core on any Linux distribution
• Access the web UI at port 2017 after starting the systemd service
• Import servers via subscription URLs that auto-update on a configurable interval
• Configure routing rules using the built-in rule editor for domain and IP matching
• Deploy on headless servers where desktop GUI clients are not available

Key Features

• Web-based interface that works on headless Linux servers via SSH tunneling or LAN access
• Transparent proxy mode with iptables/nftables integration for system-wide traffic routing
• Supports both V2Ray-core and Xray-core as interchangeable backends
• Subscription management with automatic updates and batch latency testing
• Runs as a systemd service with automatic startup and crash recovery

Comparison with Similar Tools

• Hiddify — Native GUI app for all platforms; v2rayA is web-based and better suited for Linux servers
• Qv2ray — Desktop Qt application (now archived); v2rayA is actively maintained with a web interface
• V2Ray CLI — Raw command-line with JSON configs; v2rayA adds a visual layer for easier management
• NekoRay — Desktop-focused with Qt UI; v2rayA works on headless systems without a display server

FAQ

Q: Does v2rayA work on Windows or macOS? A: v2rayA is primarily designed for Linux. Experimental Windows support exists, but other platforms are better served by native clients like Hiddify or V2Box.

Q: Can I use Xray-core instead of V2Ray-core? A: Yes. v2rayA supports both cores. Install Xray-core and point v2rayA to its binary path in the configuration.

Q: Is the web UI exposed to the network by default? A: By default, v2rayA listens on 127.0.0.1:2017 (localhost only). To access it remotely, bind to 0.0.0.0 or use an SSH tunnel.

Q: How does transparent proxy mode affect all applications? A: It configures iptables/nftables to redirect all outgoing TCP and optionally UDP traffic through the V2Ray core process, so every application on the system is proxied without individual configuration.

Sources

• https://github.com/v2rayA/v2rayA
• https://v2raya.org