teddysun/shadowsocks-python repository overview

⁠Shadowsocks-python Docker Image by Teddysun

Shadowsocks⁠ is a lightweight secured socks5 proxy for embedded devices and low end boxes.

It is a port of Shadowsocks⁠ created by @clowwindy.

Docker images are built for quick deployment in various computing cloud providers.

For more information on docker and containerization technologies, refer to official document⁠.

⁠Supported tags and respective Dockerfile links

• latest (Dockerfile)⁠

⁠Reference

• Supported architectures (more info⁠): amd64, arm32v6, arm32v7, arm64v8, i386, ppc64le, s390x

⁠Prepare the host

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

⁠Pull the image

$ docker pull teddysun/shadowsocks-python

This pulls the latest release of shadowsocks-python.

It can be found at Docker Hub⁠.

⁠Start a container

You must create a configuration file /etc/shadowsocks-python/config.json in host at first:

$ mkdir -p /etc/shadowsocks-python

A sample in JSON like below:

$ cat > /etc/shadowsocks-python/config.json <<EOF
{
    "server":"0.0.0.0",
    "server_port":9000,
    "local_address":"127.0.0.1",
    "local_port":1080,
    "password":"password0",
    "timeout":120,
    "method":"aes-256-cfb",
    "fast_open":true
}
EOF

This container with sample configuration /etc/shadowsocks-python/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 --restart=always -v /etc/shadowsocks-python:/etc/shadowsocks-python teddysun/shadowsocks-python

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