A v2ray subscriber written by python3
Project description
v2sub
A v2ray subscriber written by python3
Simple Usage
If you only have one subscribe, just do as following steps (root or sudo is needed).
-
install
v2ray
first if you don't have installed -
install
v2sub
pip install git+https://github.com/airborne007/v2sub.git@master
-
add a subscribe
v2sub add [url]
-
update subscribe
v2sub update
-
run and enjoin it
v2sub run [index]
Features
-
multiple subscribes support
-
run system
v2ray
which you can be controlled bysystemctl
command -
node delay test is support by
ping
More details
-
help message
# v2sub --help Usage: v2sub [OPTIONS] COMMAND [ARGS]... A v2ray subscriber written by python3 Options: --help Show this message and exit. Commands: add add a subscribe. list list subscribe nodes. ping test node delay by ping. remove remove subscribe. run start v2ray with an specify node. update update subscribe nodes. version show version
-
add or update subscribe
# v2sub add --help Usage: v2sub add [OPTIONS] URL add a subscribe. URL: url of the subscribe Options: --name TEXT name of the subscribe, if not provided, a default name will be given. --help Show this message and exit.
-
update subscribe nodes
# v2sub update --help Usage: v2sub update [OPTIONS] update subscribe nodes. Options: --name TEXT the name of the subscribe you want to update, if not provided, default subscribe will be updated. --all-subs, --all whether to update all subscribe, default is False. --help Show this message and exit.
-
list subscribe nodes
# v2sub list --help Usage: v2sub list [OPTIONS] list subscribe nodes. Options: --name TEXT the name of the subscribe you want list, if not provided, default subscribe will be listed. --all-subs, --all whether list all subscribe, default is False. --help Show this message and exit.
-
remove subscribe and it's nodes
# v2sub remove --help Usage: v2sub remove [OPTIONS] remove subscribe and it\'s nodes. Options: --name TEXT name of subscribe will be removed, if not provided, default subscribe will be removed. --all-subs, --all whether remove all subscribe, default is False. --help Show this message and exit.
-
run or switch
v2ray
service# v2sub run --help Usage: v2sub run [OPTIONS] INDEX start v2ray with an specify node. INDEX: the index node id list before. Options: --name TEXT the name of the subscribe you want run with. if not provided, the default subscribe will be run. --port INTEGER the local port v2ray client listen on, default is 1080 --help Show this message and exit.
-
test node delay
Usage: v2sub ping [OPTIONS] Options: --name TEXT the name of the subscribe you want ping with. if not provided, default subscribe will be pinged. --index INTEGER the node of subscribe you want to ping with. if not provided, will test all node delay. --help Show this message and exit.
TODO
support more features.
More
This program can run on all Linux platforms in theory, but I only tested it on
Arch Linux
. If you have any problems with other linux distributions, issue or
pull request is welcome.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.