[![NPM version][npm-image]][npm-url]
[![npm license][license-image]][download-url]

[npm-image]: https://img.shields.io/npm/v/shadowsocks-manager.svg?style=flat-square
[npm-url]: https://npmjs.org/package/shadowsocks-manager
[download-url]: https://npmjs.org/package/shadowsocks-manager
[license-image]: https://img.shields.io/npm/l/shadowsocks-manager.svg

shadowsocks-manager

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

For more details, you can see the wiki page.

If you want to use the old version, please switch to this branch.

WebGUI Demo:

https://wall.gyteng.com

FreeAccount Demo:

https://free.ssmgr.top

FreeAccountMiner Demo:

https://coin.ssmgr.top

Dependencies

Node.js 6.*

Install

$3

``
git clone https://github.com/yujincheng08/shadowsocks-manager-ipv6.git
cd shadowsocks-manager-ipv6
npm i
`
use node server.js to run this program.

$3


`
npm i -g shadowsocks-manager-ipv6
`
use ssmgr to run this program.

$3

`
docker run --name ssmgr -idt -v ~/.ssmgr:/root/.ssmgr --net=host gyteng/ssmgr [ssmgr params...]
`

$3

here is the Dockerfile

`
FROM ubuntu:16.04
MAINTAINER gyteng
RUN apt-get update && \
apt-get install tzdata net-tools curl git sudo software-properties-common python-pip -y && \
pip install git+https://github.com/shadowsocks/shadowsocks.git@master && \
add-apt-repository ppa:max-c-lv/shadowsocks-libev -y && \
curl -sL https://deb.nodesource.com/setup_6.x | bash - && \
apt-get install -y nodejs shadowsocks-libev && \
npm i -g shadowsocks-manager && \
echo "Asia/Shanghai" > /etc/timezone && \
rm /etc/localtime && \
dpkg-reconfigure -f noninteractive tzdata
ENTRYPOINT ["/usr/bin/ssmgr"]
`

$3


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
or
ssserver -m aes-256-cfb -p 12345 -k abcedf --manager-address 127.0.0.1:6001
`
2. run ssmgr with type s:

config file:
`
type: s

shadowsocks:
address: 127.0.0.1:6001
manager:
address: 0.0.0.0:4001
password: '123456'
db: 'ss.sqlite'
`

If you want to use MySQL, the db must like this:

`
db:
host: '1.1.1.1'
user: 'root'
password: 'abcdefg'
database: 'ssmgr'
`

And you have to close only_full_group_by when the version of MySQL is greater than 5.7

command:
ssmgr -c /your/config/file/path.yml

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 shadowsocks -> address of step 2's config file 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 manage 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 |
+---------------+
`

$3

telegram
freeAccount
freeAccountMiner
webgui

$3

ssmgr --help will show startup parameters info.

`
Usage: ssmgr [options]

Options:

-h, --help output usage information
-V, --version output the version number
-c, --config [file] config file, default: ~/.ssmgr/default.yml
-d, --db [file] sqlite3 file, sample: ~/.ssmgr/db.sqlite
-t, --type [type] type, s for server side, m for manager side
-s, --shadowsocks [address] ss-manager address, sample: 127.0.0.1:6001
-m, --manager [address] manager address, sample: 0.0.0.0:6002
-p, --password [password] manager password, both server side and manager side must be equals
-r, --run [type] run shadowsocks from child_process, sample: libev / libev:aes-256-cfb / python / python:aes-256-cfb
--debug show debug message
`

First, ssmgr will read the config file in --config, and other parameters(-detsmp`) will replace the config file values.

$3

If your want to help to translate it to other languages, please edit files here and give me a pull request.

$3

Join the group if you have some problem: https://t.me/ssmgr

$3

* Linode

* DigitalOcean

* Vultr

* AlibabaCloud

* BandwagonHost

* dediserve

$3

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

* Alipay

* WeChat Pay