appso/shadowsocks-libev repository overview

⁠Shadowsocks-libev Docker Image

shadowsocks-libev⁠ is a lightweight secured socks5 proxy for embedded devices and low end boxes. It is a port of shadowsocks⁠ created by @clowwindy maintained by @madeye and @linusyang.

Docker images are built for quick deployment in various computing cloud providers. For more information on docker and containerization technologies, refer to official document⁠.

⁠Prepare the host

If you need to install docker by yourself, follow the official installation guide⁠.

⁠Pull the image

$ docker pull appso/shadowsocks-libev

or pull image based alpine

$ docker pull appso/shadowsocks-libev:alpine

This pulls the latest release of shadowsocks-libev.

It can be found at Docker Hub⁠.

⁠Start a container

You must create a configuration file /etc/shadowsocks-libev/config.json in host at first, and sample:

{
    "server":"0.0.0.0",
    "server_port":9000,
    "password":"password",
    "timeout":300,
    "method":"aes-256-gcm",
    "fast_open":false,
    "nameserver":"8.8.8.8",
    "mode":"tcp_and_udp"
}

and if you want to enable simple-obfs, configuration file /etc/shadowsocks-libev/config.json sample:

{
    "server":"0.0.0.0",
    "server_port":9000,
    "password":"password",
    "timeout":300,
    "method":"aes-256-gcm",
    "fast_open":false,
    "nameserver":"8.8.8.8",
    "mode":"tcp_and_udp",
    "plugin":"obfs-server",
    "plugin_opts":"obfs=http"
}

This container with sample configuration /etc/shadowsocks-libev/config.json

There is an example to start a container that listens on 9000 (both TCP and UDP):

$ docker run -d -p 9000:9000 -p 9000:9000/udp --name ss-libev -v /etc/shadowsocks-libev:/etc/shadowsocks-libev appso/shadowsocks-libev

There is an example to start a container based alpine that listens on 9000 (both TCP and UDP):

$ docker run -d -p 9000:9000 -p 9000:9000/udp --name ss-libev -v /etc/shadowsocks-libev:/etc/shadowsocks-libev appso/shadowsocks-libev:alpine

Note: The port number must be same as configuration.