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.

Filename, size & hash SHA256 hash help File type Python version Upload date
shadowray-0.1.6.linux-x86_64.tar.gz (32.7 kB) Copy SHA256 hash SHA256 Source None
shadowray-0.1.6-py3-none-any.whl (17.3 kB) Copy SHA256 hash SHA256 Wheel py3

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page