# v2rayA — Web-Based V2Ray Client with Transparent Proxy

> Browser-accessible V2Ray/Xray client for Linux servers with transparent proxy, routing rules, and multi-node management.

## Install

Save as a script file and run:

# v2rayA — Web-Based V2Ray Client with Transparent Proxy

## Quick Use
```bash
# Install v2ray-core first:
bash <(curl -sL https://raw.githubusercontent.com/v2fly/fhs-install-v2ray/master/install-release.sh)
# Install v2rayA:
wget -qO - https://apt.v2raya.org/key/public-key.asc | sudo tee /etc/apt/keyrings/v2raya.asc
echo "deb [signed-by=/etc/apt/keyrings/v2raya.asc] https://apt.v2raya.org/ v2raya main" 
  | sudo tee /etc/apt/sources.list.d/v2raya.list
sudo apt update && sudo apt install v2raya
sudo systemctl enable --now v2raya
# Open http://localhost:2017 in your browser
```

## 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

---
Source: https://tokrepo.com/en/workflows/v2raya-web-based-v2ray-client-transparent-proxy-8e7e7e32
Author: Script Depot