v2rs

A small CLI for managing xray proxy.

It fetches subscription links, generates the Xray config, sets up a v2rs TUN interface with policy routing, and runs xray as a transient systemd unit (v2rs-xray).

Installation

1. Add the repository

Import the signing key:

wget -O sign.gpg https://git.igorek.dev/api/packages/igorechek06/arch/repository.key
pacman-key --add sign.gpg
pacman-key --lsign-key 'igorechek06@noreply.git.igorek.dev'

Add the repo to /etc/pacman.conf:

[v2rs]
SigLevel = Required
Server = https://git.igorek.dev/api/packages/igorechek06/arch/v2rs/$arch

2. Install xray

v2rs needs an xray backend, which lives in the AUR. Install either xray or xray-bin first (e.g. with an AUR helper):

paru -S xray   # or: paru -S xray-bin

3. Install v2rs

pacman -Sy v2rs

Usage

v2rs sub add url <name> <link>   # add a subscription and fetch its configs
v2rs cfg list                    # list configs
v2rs cfg sel <number>            # pick the active config
v2rs start                       # route traffic through the proxy
v2rs status                      # show state
v2rs stop                        # restore direct traffic

Run v2rs --help for the full command list.

To start the proxy on boot, enable the bundled unit:

systemctl enable v2rs