yaojin3616 / shadowsocks-manager

A shadowsocks manager tool for multi user and traffic control.

shadowsocks-manager

A shadowsocks manager tool for multi user and traffic control.
Base on Node.js and SQLite.

This version is not a stable version now. If you want to use the old version, please switch to this branch.

Dependencies

Node.js 6.*

Install

From source:

git clone https://github.com/shadowsocks/shadowsocks-manager.git
cd shadowsocks-manager
npm i

use node server.js to run this program.

From npm:

npm i -g shadowsocks-manager

use ssmgr to run this program.

Usage

1. Start shadowsocks with manager API, it supports shadowsocks-python and shadowsocks-libev. For example, you can run this command:
   ss-manager -m aes-256-cfb -u --manager-address 127.0.0.1:6001
2. run ssmgr with type s:
   ssmgr -t s -s 127.0.0.1:6001 -m 0.0.0.0:6002
3. If you have several servers, you have to run step 1 and step 2 in every server.
   The listening address in --manager-address of step 1 and in -s of step 2 must be same. For security reseon, we recommend you to use 127.0.0.1 instead of 0.0.0.0.
4. Now you can use the plugins to manager them. You can read the details in plugins readme page.

+-------------+    +-------------+       +------+
| Shadowsocks |    | Shadowsocks |  ...  |      |
| manager API |    | manager API |       |      |
+-------------+    +-------------+       +------+
       |                 |                  |
       |                 |                  |
+-------------+    +-------------+       +------+
| ssmgr       |    | ssmgr       |  ...  |      |
| with type s |    | with type s |       |      |
+-------------+    +-------------+       +------+
       |                 |                  |
       +------------+----+--------  ...  ---+
                    |
                    |
             +---------------+
             | ssmgr plugins |
             |  with type m  |
             +---------------+

Plugins

[================100%] cli
[================100%] telegram
[================100%] flowSaver
[================100%] email
[==10%---------------] user
[================100%] freeAccount
[0%------------------] account
[1%------------------] webgui

Donate

If you find this project helpful, please consider making a donation:

• Alipay

• Wechat