Français  English 

Shadowsocks

Windows

  1. Download Shadowsocks for Windows.
  2. Extract the archive, and double-click on the Shadowsocks.exe file.

  3. Make sure the QR code below is centered and completely visible, right-click on the Shadowsocks system tray icon, and go to Servers > Scan QRCode from Screen...

    Shadowsocks QR code

  4. You may also go to Servers > New server and manually complete the following steps:
    1. Enter 52.15.254.140 as the Server IP.
    2. Enter 8530 as the Server Port.
    3. Enter kIHCO+d+WwlYhQGPRC2AVsvxP+qaJJxVYQ/6nVv1ecfcAa3UlZwftnswTFqwx2Pz as the Password.
    4. The SOCKS 5 Proxy Port should be 1080 and the Encryption Method should be chacha20-ietf-poly1305.
    5. Click Save.
  5. Click on the Shadowsocks menu tray icon and select Enable.
  6. That's it! You can verify that your traffic is being routed properly by looking up your IP address on DuckDuckGo. It should say Your public IP address is 52.15.254.140.

macOS

  1. Download ShadowsocksX-NG.
  2. Double-click the ZIP, and extract the application into your Applications folder.
  3. Launch ShadowsocksX-NG. You will be prompted to enter your password so that your system proxy settings can be modified.
  4. Look for the Shadowsocks paper plane icon in your menu bar and click on it.

  5. Make sure the QR code below is centered and completely visible, and choose Scan QR Code from Screen...

    Shadowsocks QR code

  6. You may also configure the connection by going to Servers, selecting Open Server Preferences..., and clicking the + button on the sidebar:
    1. Enter 52.15.254.140 and 8530 in the Address fields.
    2. Make sure chacha20-ietf-poly1305 is selected for the Encryption value.
    3. Enter kIHCO+d+WwlYhQGPRC2AVsvxP+qaJJxVYQ/6nVv1ecfcAa3UlZwftnswTFqwx2Pz as the Password.
    4. Click OK.
  7. Click on the Shadowsocks icon in the menu bar again, and choose Global Mode.
  8. You can use the Shadowsocks icon to enable/disable the VPN. The color of the icon will change based on whether or not it is active.
  9. That's it! You can verify that your traffic is being routed properly by looking up your IP address on DuckDuckGo. It should say Your public IP address is 52.15.254.140.

Linux

Download shadowsocks2-linux-x64.gz and extract it:

`gunzip shadowsocks2-linux-x64.gz`

Make the binary executable:

`chmod +x shadowsocks2-linux-x64`

Start the shadowsocks SOCKS proxy:

`./shadowsocks2-linux-x64 -c 52.15.254.140:8530 -password "kIHCO+d+WwlYhQGPRC2AVsvxP+qaJJxVYQ/6nVv1ecfcAa3UlZwftnswTFqwx2Pz" -socks localhost:1080 -verbose -cipher chacha20-ietf-poly1305`

For reference, this is the configuration specified:

    Server: 52.15.254.140
    Port: 8530
    Password: kIHCO+d+WwlYhQGPRC2AVsvxP+qaJJxVYQ/6nVv1ecfcAa3UlZwftnswTFqwx2Pz
    Encryption Method: chacha20-ietf-poly1305

Once you have Shadowsocks running locally, you'll need to forward your browser traffic through the SOCKS proxy it provides

Testing with Curl

You can quickly test using curl:

 `curl -I --socks5 localhost:1080 google.com`

This should return a 301 Found response not a connection refused error.

Configuring Firefox to connect through a SOCKS proxy

  1. Click the Menu button next to the Home icon to the right of the address bar.
  2. Click Options.
  3. Click the Advanced icon.
  4. Go to the Network tab.
  5. Click the Settings button to Configure how Firefox connects to the Internet.
  6. Choose Manual proxy configuration.
  7. Enter 127.0.0.1 and Port 1080 on the SOCKS Host line.
  8. Select Remote DNS. This configures Firefox to send all DNS requests through the SOCKS proxy. This will protect you against DNS poisoning and ensure that false DNS entries cannot be used to censor your access.
  9. Click OK.
  10. Click OK again to close the Firefox preferences window.
  11. You should be good to go! You can verify that your traffic is being routed properly by looking up your IP address on DuckDuckGo. It should say Your public IP address is 52.15.254.140.

Android

  1. Download Shadowsocks for Android from Google Play. If Google Play is blocked in your country, you can download a mirrored copy from this server!
  2. Launch the application.
  3. Tap the Add Profile + icon, second from the top-right of the screen.
  4. Select Scan QR code.

  5. Use your phone to scan this image, or if you are using your phone right now you can choose the Manual Settings option and copy and paste the information from the Linux section above:

    Shadowsocks QR code

  6. Tap the round paper plane icon along the bottom-left bar.
  7. Accept the Android VPN connection warning.
  8. You can verify that your traffic is being routed properly by looking up your IP address on DuckDuckGo. It should say Your public IP address is 52.15.254.140.

iOS

  1. Download Shadowrocket and launch it.

    Note: Shadowrocket is not available in the China App Store.

  2. Tap the QR code import icon in the top-left of the screen.

  3. Use your phone to scan this image, or if you are using your phone right now you can manually add a new proxy by tapping Add Server and using the information from the Linux section above:

    Shadowsocks QR code

  4. Toggle the connection switch located to the right of the Not Connected text on the Home tab.
  5. You can verify that your traffic is being routed properly by looking up your IP address on DuckDuckGo. It should say Your public IP address is 52.15.254.140.

simple-obfs for unreliable/hostile networks

For users on unreliable or hostile networks (esp. experiencing quality-of-service (QOS) throttling) using the simple-obfs plugin may help alleviate these issues. Further configuration of the Shadowsocks client to use the simple-obfs plugin can be carried out via the following configuration:

    Server: 52.15.254.140
    Port: 8530
    Password: kIHCO+d+WwlYhQGPRC2AVsvxP+qaJJxVYQ/6nVv1ecfcAa3UlZwftnswTFqwx2Pz
    Encryption Method: chacha20-ietf-poly1305
    Plugin: obfs-local
    Plugin_Options: obfs=http;obfs-host=www.github.com

Android users will first need to download the Simple Obfuscation plugin app, and then modify the existing Streisand profile on your client to use this plugin. You can do this by hitting the edit button next to the profile, tapping the Plugin option at the bottom of the profile and selecting the "Simple obsfucation" plugin from the menu. Your Shadowsocks traffic will now be obfuscated as http traffic to www.github.com.