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.

Source Distribution

shadowray-0.1.6.linux-x86_64.tar.gz (32.7 kB view hashes)

Uploaded source

Built Distribution

shadowray-0.1.6-py3-none-any.whl (17.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page