Skip to content

v2node as backend

v2node is a backend written to replace the discontinued v2bx, and is a supported alternative to XrayR. It natively handles VMess, VLESS, Shadowsocks, Trojan, Hysteria2, and AnyTLS in a single binary — unlike XrayR, it doesn't need a separate process for Hysteria2/AnyTLS.

Two forks are supported. They share the same protocols and the same API, but differ in how deep the integration goes:

HungSoKie/v2nodewyx2685/v2node
Repogithub.com/HungSoKie/v2nodegithub.com/wyx2685/v2node
Minimum versionv0.3.5v0.3.5
IP limit✓ (API + Redis)✓ (API + Redis)
Route / Outbound / DNS / Inbound / domain / protocol cases
Node status reporting
One-click install from the node edit page
NotesAlso supports the Unified API format

If you don't specifically need the wyx2685 fork, use HungSoKie/v2node — it's a superset.

Install

HungSoKie/v2node (one-click)

  1. Open the node's edit page and fill in SSH Info (see Other settings for the format), then save.
  2. Click Install v2node. The current node form is saved first, then the install runs over SSH on the node itself — you can close the page right after clicking.
  3. If no result comes back within 5 minutes, the install may still be running; check the node manually.

The same SSH Info also powers the Install XrayR, Install BBR, and Restart Node buttons next to it.

wyx2685/v2node (manual)

bash
wget -N https://raw.githubusercontent.com/wyx2685/v2node/master/script/install.sh && bash install.sh

API configuration

Point v2node at the same API endpoint used by every backend:

https://yourdomain.com/modules/addons/v2raysocks_nodes/api/api.php

V2RaySocks tells backends apart by the client's User-Agent — as long as it contains v2node, requests are routed to the v2node handler automatically. No separate endpoint or config flag is needed. If the User-Agent also contains unified, the Unified API format is used instead of v2node's native format (only meaningful for HungSoKie/v2node, which supports it).

Port forwarding

If the node is behind a relay, or you're setting up random port nodes, use the same ipt.sh / iptables-pf.sh scripts described in XrayR as backend.