Quick Guide

Config File

Shadowsocks accepts JSON format configs like this:


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:


Where the plain URI should be:

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

For example, we have a server at 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:


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


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

Try it yourself