How To Deploy a Shadowsocks Container


Shadowsocks is an open source socks5 proxy which, according to their official site, is designed to protect your internet traffic. In plain English, it allows you to browse the Internet with more privacy:

  • Encypt the traffic between you and the servers;
  • Prevent cookies, or malicious applications;
  • Mask your computer’s IP;
  • Prevent your ISP from logging DNS history;

In this tutorial we will explain in detail how to deploy a private shadowsocks container in 3 steps.


Please make sure you complete the following prerequisites:

Step 1. Pull the shadowsocks image to your account

Open the terminal on your local computer:

$ hyper pull oddrationale/docker-shadowsocks
Using default tag: latest
latest: Pulling from oddrationale/docker-shadowsocks
012a7829fd3f: Pull complete
41158247dd50: Pull complete
916b974d99af: Pull complete
a3ed95caeb02: Pull complete
95b198eff4ae: Pull complete
001c5b5b7517: Pull complete
Digest: sha256:221070b8688f049fa791528e1e9c5fc0c027f12a858d22b540170c2cca1dec69
Status: Image is up to date for oddrationale/docker-shadowsocks:latest

Step 2. Launch the container

$ hyper run -d --name shadowsocks -p 1989 oddrationale/docker-shadowsocks -s -p 1989 -k MyPassWord -m aes-256-cfb

The container should be running:

$ hyper ps
CONTAINER ID        IMAGE                             COMMAND                  CREATED             STATUS              PORTS               NAMES               PUBLIC IP
b6cae93b056d        oddrationale/docker-shadowsocks   "/usr/local/bin/ssser"   23 seconds ago      Up 18 seconds                           shadowsocks         

Step 3. Attach Floating IP

$ hyper fip allocate 1
$ hyper fip attach shadowsocks


Now, setup your browser and you are ready to go!

Shadowsocks Cient


Try it: