Skip to main content

A useful client of v2ray for linux

Project description


An useful client of v2ray for linux

Simple usage

pip install shadowray
shadowray --autoconfig
shadowray --subscribe-add 'name,url'
shadowray --list
shadowray -s 1

for more detail about command:

shadowray --help

Default config


  • protocol : socks5
  • port: 1082
  • auth: noauth


  • Traffic camouflage : tcp


Basic config

  • subscribe.json : the file used to save subscribes,you can specify it by using shadowray --config-subscribe <path>,but the file must be created by yourself
  • servers.json : the file used to save servers,you can specify it by using shadowray --config-servers <path>,but the file must be created by yourself
  • v2ray : you should specify the folder of v2ray-core,using shadowray --config-v2ray <path>

For simplicity

Using shadowray --autoconfig,then it will complete the basic config automatically,include that downloading the lasted v2ray-core


Add a subscribe

you can use shadowray --subscribe-add '<name>,<url>' to add a subscribe.

Don't forget the ''

Update subscribes

Using shadowray --subscribe-update to update all subscribes.Meanwhile,you can use --port <number> to specify a port of inbound.


List server

To see all available servers(proxies),using shadowray [--list|-l].Then you will see some index,name of proxies,protocol of proxies,the index of proxies used to start a proxy

Start a proxy

For starting a proxy,you can use shadowray [--start|-s] <index>

For running v2ray as a daemon,by using --daemon or -d

Stop daemon

Using shadowray --stop

Specify a config file of v2ray

You can use your config file via [--config-self|-f] <path>.For example, shadowray --config-self ~/config.json or shadowray -f ~/config.json

Export config

Using shadowray --servers-export <index>:<path> to export the specified config to file that specified by <path>

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for shadowray, version 0.1.6
Filename, size File type Python version Upload date Hashes
Filename, size shadowray-0.1.6.linux-x86_64.tar.gz (32.7 kB) File type Source Python version None Upload date Hashes View
Filename, size shadowray-0.1.6-py3-none-any.whl (17.3 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page