Skip to content

Shadowsocks server Docker image, A secure socks5 proxy, designed to protect your Internet traffic.

License

Notifications You must be signed in to change notification settings

dockage/shadowsocks-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Shadowsocks Server Docker Pulls Docker Stars MicroBadger Docker Automated build

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

Quick reference

About

Shadowsocks server Docker image, A secure socks5 proxy, designed to protect your Internet traffic.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published