A small CLI for managing xray proxy
  • Rust 98.3%
  • Shell 1.7%
Find a file
Tolmachev Igor e59987bdf3
All checks were successful
ci/woodpecker/tag/package Pipeline was successful
ci/woodpecker/tag/release Pipeline was successful
Bump v0.5.2
2026-07-25 21:35:00 +09:00
.woodpecker Revert "Remove systemd unit" 2026-07-25 21:34:13 +09:00
aur Update aur 2026-07-22 22:08:29 +09:00
src Specify path for geoip and geosite 2026-07-22 22:36:24 +09:00
.gitignore Initial commit 2026-06-23 17:46:45 +03:00
.gitmodules Add aur submodules 2026-06-24 00:14:09 +03:00
Cargo.lock Bump v0.5.2 2026-07-25 21:35:00 +09:00
Cargo.toml Bump v0.5.2 2026-07-25 21:35:00 +09:00
codebook.toml Rewrite xray unit manager 2026-07-17 01:46:02 +09:00
install.sh Revert "Remove systemd unit" 2026-07-25 21:34:13 +09:00
LICENSE Create LICENSE 2026-06-23 20:09:53 +03:00
PKGBUILD Revert "Remove systemd unit" 2026-07-25 21:34:13 +09:00
README.md Update README.md 2026-06-30 18:14:18 +03:00
v2rs.service Revert "Remove systemd unit" 2026-07-25 21:34:13 +09:00

v2rs

A small CLI for managing xray proxy.

It fetches subscription links, generates the Xray config, and manages a systemd xray@v2rs service with routing.

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