shadowsocks_install/docker/shadowsocks-r/README.md
Teddysun c00c849326
Update README.md
Signed-off-by: Teddysun <i@teddysun.com>
2018-08-11 17:24:17 +09:00

75 lines
2.0 KiB
Markdown

## ShadowsocksR Docker Image by Teddysun
[shadowsocksr][1] is a lightweight secured socks5 proxy for embedded devices and low end boxes.
It is a port of [shadowsocks][2] created by @clowwindy maintained by @breakwa11 and @Akkariiin.
Docker images are built for quick deployment in various computing cloud providers.
For more information on docker and containerization technologies, refer to [official document][3].
## Prepare the host
If you need to install docker by yourself, follow the [official installation guide][4].
## Pull the image
```bash
$ docker pull teddysun/shadowsocks-r
```
or pull image based **alpine**
```bash
$ docker pull teddysun/shadowsocks-r:alpine
```
This pulls the latest release of shadowsocks-r.
It can be found at [Docker Hub][5].
## Start a container
You **must create a configuration file** `/etc/shadowsocks-r/config.json` in host at first, and sample:
```
{
"server":"0.0.0.0",
"server_ipv6":"::",
"server_port":9000,
"local_address":"127.0.0.1",
"local_port":1080,
"password":"password0",
"timeout":120,
"method":"aes-256-cfb",
"protocol":"origin",
"protocol_param":"",
"obfs":"plain",
"obfs_param":"",
"redirect":"",
"dns_ipv6":false,
"fast_open":true,
"workers":1
}
```
This container with sample configuration `/etc/shadowsocks-r/config.json`
There is an example to start a container that listens on `9000` (both TCP and UDP):
```bash
$ docker run -d -p 9000:9000 -p 9000:9000/udp --name ssr -v /etc/shadowsocks-r:/etc/shadowsocks-r teddysun/shadowsocks-r
```
There is an example to start a container based **alpine** that listens on `9000` (both TCP and UDP):
```bash
$ docker run -d -p 9000:9000 -p 9000:9000/udp --name ssr -v /etc/shadowsocks-r:/etc/shadowsocks-r teddysun/shadowsocks-r:alpine
```
**Note**: The port number must be same as configuration.
[1]: https://github.com/shadowsocksrr/shadowsocksr
[2]: https://shadowsocks.org/en/index.html
[3]: https://docs.docker.com/
[4]: https://docs.docker.com/install/
[5]: https://hub.docker.com/r/teddysun/shadowsocks-r/