Quick Guide

Config File

Shadowsocks accepts JSON format configs like this:

{
    "server":"my_server_ip",
    "server_port":8388,
    "local_port":1080,
    "password":"barfoo!",
    "timeout":600,
    "method":"rc4-md5"
}

Explanation of each field:

  • server: your hostname or server IP (IPv4/IPv6).
  • server_port: server port number.
  • local_port: local port number.
  • password: a password used to encrypt transfer.
  • timeout: connections timeout in seconds.
  • method: encryption method, "bf-cfb", "aes-256-cfb", "des-cfb", "rc4", etc. Default is table, which is not secure. "aes-256-gcm" is recommended.

URI and QR code

Shadowsocks for Android / iOS also accepts BASE64 encoded URI format configs:

    ss://BASE64-ENCODED-STRING-WITHOUT-PADDING#TAG

Where the plain URI should be:

    ss://method:[email protected]:port

For example, we have a server at 192.168.100.1:8888 using bf-cfb encryption method and password test. Then, with the plain URI ss://bf-cfb:[email protected]:8888, we can generate the BASE64 encoded URI:

    ss://YmYtY2ZiOnRlc3RAMTkyLjE2OC4xMDAuMTo4ODg4Cg

To help organize and identify these URIs, you can append a tag after the BASE64 encoded string:

    ss://YmYtY2ZiOnRlc3RAMTkyLjE2OC4xMDAuMTo4ODg4Cg#example-server

This URI can also be encoded to QR code. Then, just scan it with your Android / iOS devices:


Try it yourself