neverbehave/shadowsocks-libev-docker repository overview

⁠Shadowsocks-libev Docker Image

基于 Based on: https://github.com/teddysun/shadowsocks_install/tree/master/docker/shadowsocks-libev⁠

⁠Changes 修改

• 适合于集群使用，通过环境变量生成配置，无需映射文件

  Suitable for cluster/k8s, generating config from environment variables, no volumn mapping required.

• 原Dockerfile包含从私人镜像站下载的二进制文件dl.lamp.sh，改为从github获取

  The origin dockerfile download binary file from private mirror center dl.lamp.sh, changed to download from github

⁠Intro

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.

Based on alpine with latest version shadowsocks-libev⁠ and simple-obfs⁠ and v2ray-plugin⁠.

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 teddysun/shadowsocks-libev

This pulls the latest release of shadowsocks-libev.

It can be found at Docker Hub⁠.

⁠Start a container

Set Environment Variables, check the table below.

Only required values are enforced or container won't work.

⁠Environment Variables

If you want to enable simple-obfs, a sample is:

-e PLUGIN="obfs-server" -e PLUGIN_OPTS="obfs=tls"

If you want to enable v2ray-plugin, a sample is:

-e PLUGIN="v2ray-plugin" -e PLUGIN_OPTS="server"

For more v2ray-plugin configrations please visit v2ray-plugin usage⁠.

This container will generate config based on the env provided.

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 --restart=always -e PASSWORD=YOUR_PASSWORD neverbehave/shadowsocks-libev

Warning: The port number must be same as configuration and opened in firewall.