Night mode
This article shows you how to install ShadowsocksR (SSR) on Windows, Android, and Linux clients, and how to create a private ShadowsocksR server. On July 27, 2017, the breakwa11 ShadowsocksR repositories were deleted from Github. This page links to copies of the software from the ShadowsocksRR (SSRR) repositories. — ShadowsocksR (SSR)

This article comprises these sections:

thanks

thanks

Windows Client

Download

To extract the Windows C# client, you will need to use 7-Zip. Therefore first download and install 7-zip.

Now download the Windows C# client software from Github. For your convenience, the download is also mirrored in Europe and Asia.

At the time of writing, the latest release has file name ShadowsocksR-win-4.9.0.zip. The file size is 1,638,863 bytes bytes. The file size on disk on Windows systems is 1,642,496 bytes. The SHA256 sum is 6f3a6cfd 099d3749 2b1ac6ea 3d504acc 6d4c2948 c9cc99de 59d7488e f18bf6b1. You can check this on Windows using 7-Zip by right-clicking on the file, and doing CRC SHA and then SHA 256.

Guide: Complete ShadowsocksR Clients and Server Tutorial 16

To unzip the download, right-click on the downloaded file, choose the 7-Zip set of options, and extract the downloaded file into its own folder. The new folder will have a name ShadowsocksR-win-4.9.0.

Guide: Complete ShadowsocksR Clients and Server Tutorial 17

In Windows Explorer, change into the folder for ShadowsocksR.

Guide: Complete ShadowsocksR Clients and Server Tutorial 18

Choose your executable depending on how modern your Windows PC is:

  • For >= Windows 8 or with .NET 4.0, use ShadowsocksR-dotnet4.0.exe
  • For <= Windows 7 or with .NET 2.0, use ShadowsocksR-dotnet2.0.exe

Double-click on the appropriate application file to launch the program.

Add Server

To add a server, open the system tray notification area, and find the ShadowsocksR icon. It looks like a paper airplane. Right-click on the ShadowsocksR icon to bring up the control options. Choose Servers then Edit servers….

Guide: Complete ShadowsocksR Clients and Server Tutorial 19

Fill in your server details, and click OK. (You may need to quit and restart ShadowsocksR when you change the first entry.)

Guide: Complete ShadowsocksR Clients and Server Tutorial 20

Scan QR Code

If someone has shared a quick-response (QR) code with you, you can use the option Scan QR code from screen… to add a server.

 

Guide: Complete ShadowsocksR Clients and Server Tutorial 21

Mode

In global mode, any Windows application that is set up to use the Windows system proxy server settings will send its traffic through ShadowsocksR.

  • For example, Microsoft Edge will automatically send its traffic through ShadowsocksR if this option is set.
  • In Windows 10, you can see what your current setting is in Settings > Network & Internet > Proxy.

Guide: Complete ShadowsocksR Clients and Server Tutorial 22

The opposite of global mode is to disable the system proxy feature. Then you will have to manually configure each application to send its traffic through ShadowsocksR.

  • You can do this in Firefox under Options > Advanced > Network > Settings. If you are going to do this, make sure you also proxy your DNS traffic.

Guide: Complete ShadowsocksR Clients and Server Tutorial 23

  • If you are using Chrome instead of Firefox, you can do something similar with the extension Proxy SwitchyOmega by FelisCatus. Configure SwitchyOmega for a SOCKS5 proxy server at address 127.0.0.1 port 1080.

Options

To control ShadowocksR, again open the system tray notification area, and find the ShadowsocksR icon. It looks like a paper airplane. It will be color-coded depending on your current Mode setting. Right-click on the ShadowsocksR icon to bring up the control options.

Guide: Complete ShadowsocksR Clients and Server Tutorial 24

  • Mode controls whether SSR will disable Windows system-wide proxying, use proxy automatic configuration (PAC), act as a global system-wide proxy, or leave the Windows system-wide proxy settings unchanged
  • PAC populates the proxy automatic configuration (PAC) list
  • Proxy rule controls whether SSR will bypass the proxy server for local area network (LAN) and/or mainland IP addresses
  • Servers allows you to add, edit, or delete SSR servers and their configuration details
  • Servers Subscribe allows you to get an up-to-date list of free public servers from Github (may no longer work due to Github deletion)
  • Load balance causes SSR to try to find the most responsive server from among your list (uncheck this option to use one definite server only)
  • Global settings controls things like whether to start on boot, and whether port 1080 or some other port is used for the local proxy
  • Port settings is for port forwarding
  • Scan QR Code from screen scans a server configuration from a quick-response (QR) code you have displayed in your browser or elsewhere
  • Import SSR links can import links in the format of the SSR QRcode scheme
  • Help gives options such as viewing the log
  • Quit to exit from the ShadowsocksR program

Android Client

Download the Android apk file from Github. For your convenience, the download is also mirrored in Europe and Asia.

At the time of writing, the latest release has file name shadowsocksr-android-3.5.4.apk. The file size is 3,857,528 bytes. The SHA256 sum is d2b443e1 1b3dbffe bf52b76f 27598bc3 b830bb53 39f26b91 1baa75c1 ce53aee7. If you wish, you can check this in Android with the Hash Droid application.

Guide: Complete ShadowsocksR Clients and Server Tutorial 25

Tap on the downloaded apk file to install it. It will likely be blocked by your default security settings.

Guide: Complete ShadowsocksR Clients and Server Tutorial 26

Follow the prompt to go to Settings. You will need to check the box to allow installs from Unknown sources to permit the install.

Guide: Complete ShadowsocksR Clients and Server Tutorial 27

Make sure the box is checked to allow this installation, and tap OK.

Guide: Complete ShadowsocksR Clients and Server Tutorial 28

Once the install is complete, open the app.

  1. Tap the logotype ShadowsocksR at the top left to bring up the server configuration options.
  2. Click the plus sign button + at the bottom right to add a new server.

You can add a new server by typing in its details, or by scanning a displayed QR code with your Android device camera.

Guide: Complete ShadowsocksR Clients and Server Tutorial 29

To use the feature to scan QR codes, you may need to first install the app Barcode Scanner by ZXing Team.

Once you have added your server, tap the connect button at the top right. It looks like a paper airplane in a circle.

You will need to check the box to say I trust this application. Tap OK.

You are now connected.

Guide: Complete ShadowsocksR Clients and Server Tutorial 30

Download SSR For Android and Windows

Download SSR Now