Deprecated

Please use the official images like shadowsocks-libev or shadowsocks-rust instead of this project.

Shadowsocks Server

A secure socks5 proxy, designed to protect your Internet traffic.

Installation

Pull the image from the docker index. This is the recommended method of installation as it is easier to update image. These builds are performed by the Docker Trusted Build service.

docker pull dockage/shadowsocks-server:latest

You can also pull the latest tag which is built from the repository HEAD

docker pull dockage/shadowsocks-server:latest

Alternately you can build the image locally.

git clone https://github.com/dockage/shadowsocks-server.git
cd shadowsocks-server
docker build --tag="$USER/shadowsocks-server" .

Quick Start

The quickest way to get started is using docker-compose.

wget https://raw.githubusercontent.com/dockage/shadowsocks-server/master/docker-compose.yml
docker-compose up

Alternately, you can manually launch the shadowsocks container.

docker run --name='shadowsocks' -d \
  --publish=8388:8388 \
  --env='SS_PASSWORD=ssp@ss' \
dockage/shadowsocks-server:latest

Available Configuration Parameters

Please refer the docker run command options for the --env-file flag where you can specify all required environment variables in a single file. This will save you from writing a potentially long docker run command. Alternately you can use docker compose.

Below is the complete list of available options that can be used to customize your shadowsocks installation.

• SS_PASSWORD: A password used to encrypt transfer. Defaults to ssp@ss.
• SS_TIMEOUT: Connections timeout in seconds. Defaults to 300.
• SS_METHOD: The encryption method, "bf-cfb", "aes-256-cfb", etc. Defaults to aes-256-cfb.

Upgrading

To upgrade to newer shadowsocks releases, simply follow this 3 step upgrade procedure.

• Step 1: Update the docker image.

docker pull dockage/shadowsocks-server:latest

• Step 2: Stop and remove the currently running image

docker stop shadowsocks
docker rm shadowsocks

• Step 3: Start the image

docker run --name=shadowsocks -d [OPTIONS] dockage/shadowsocks-server:latest

For more information refer https://github.com/jpetazzo/nsenter

References

• https://github.com/shadowsocks/shadowsocks
• https://github.com/shadowsocks/shadowsocks/wiki/Encryption
• https://github.com/shadowsocks/shadowsocks/wiki/Configuration-via-Config-File
• https://github.com/shadowsocks/shadowsocks/wiki/TCP-Fast-Open