Connect From Any Device

Windows

1. Download the software

You need two files:

• Shadowsocks for Windows – Download the latest release from github.com/shadowsocks/shadowsocks-windows/releases. Get the Shadowsocks-x.x.x.zip file.
• v2ray-plugin – Download the Windows version from github.com/shadowsocks/v2ray-plugin/releases. Get the v2ray-plugin-windows-amd64-vx.x.x.tar.gz file.

2. Set up the files

1. Extract the Shadowsocks ZIP to a folder (e.g., C:\Shadowsocks\)
2. Extract v2ray-plugin.exe from the v2ray-plugin archive
3. Place v2ray-plugin.exe in the same folder as Shadowsocks.exe

3. Configure the client

1. Run Shadowsocks.exe – a new icon will appear in your system tray (bottom-right corner)
2. Right-click the Shadowsocks tray icon and select Edit Servers
3. Fill in the fields:
   • Server Addr: YOUR_DOMAIN
   • Server Port: 443
   • Password: your password
   • Encryption: aes-256-gcm
   • Plugin Program: v2ray-plugin
   • Plugin Options: tls;host=YOUR_DOMAIN;path=/shadowsocks;mux=0
4. Click Apply then OK

4. Enable the proxy

Right-click the Shadowsocks tray icon and select System Proxy → Global to route all traffic through Shadowsocks.

Alternatively, choose PAC mode to only route traffic for blocked sites (uses a built-in list of commonly blocked domains).

macOS

1. Download the software

• ShadowsocksX-NG – Download from github.com/shadowsocks/ShadowsocksX-NG/releases. Get the .dmg file.
• v2ray-plugin – Download the macOS version from github.com/shadowsocks/v2ray-plugin/releases. Get the v2ray-plugin-darwin-amd64-vx.x.x.tar.gz file (or arm64 if you have an M-series Mac).

2. Install v2ray-plugin

Extract the plugin and move it to a system path:

tar xzf v2ray-plugin-darwin-*.tar.gz
sudo cp v2ray-plugin /usr/local/bin/
sudo chmod +x /usr/local/bin/v2ray-plugin

3. Configure the client

1. Open ShadowsocksX-NG.dmg and drag the app to your Applications folder
2. Launch ShadowsocksX-NG – it will appear in your menu bar
3. Click the paper plane icon in the menu bar and select Server Preferences
4. Click the + button to add a new server
5. Fill in the fields:
   • Address: YOUR_DOMAIN
   • Port: 443
   • Password: your password
   • Encryption: aes-256-gcm
   • Plugin: v2ray-plugin
   • Plugin Options: tls;host=YOUR_DOMAIN;path=/shadowsocks;mux=0
6. Click OK

4. Enable the proxy

Click the ShadowsocksX-NG menu bar icon and select Turn Shadowsocks On. Choose Global Mode to route all traffic, or PAC Mode for selective routing.

Linux

1. Install shadowsocks-libev and v2ray-plugin

On Ubuntu or Debian:

sudo apt update
sudo apt install -y shadowsocks-libev

Download v2ray-plugin:

wget https://github.com/shadowsocks/v2ray-plugin/releases/latest/download/v2ray-plugin-linux-amd64-v1.3.2.tar.gz
tar xzf v2ray-plugin-linux-amd64-*.tar.gz
sudo mv v2ray-plugin /usr/local/bin/
sudo chmod +x /usr/local/bin/v2ray-plugin

2. Create the client configuration

Create the config file:

sudo nano /etc/shadowsocks-libev/client.json

Paste the following (replace the placeholder values):

{
    "server": "YOUR_DOMAIN",
    "server_port": 443,
    "local_address": "127.0.0.1",
    "local_port": 1080,
    "password": "YOUR_PASSWORD",
    "method": "aes-256-gcm",
    "plugin": "v2ray-plugin",
    "plugin_opts": "tls;host=YOUR_DOMAIN;path=/shadowsocks;mux=0"
}

3. Start the client

Run the Shadowsocks local proxy:

ss-local -c /etc/shadowsocks-libev/client.json

To run it in the background as a service:

sudo systemctl start shadowsocks-libev-local@client
sudo systemctl enable shadowsocks-libev-local@client

4. Configure your applications

The local SOCKS5 proxy is now available at 127.0.0.1:1080. Configure your browser or system to use it:

• Firefox: Settings → Network Settings → Manual proxy → SOCKS Host: 127.0.0.1, Port: 1080, SOCKS v5
• System-wide: Set the environment variables ALL_PROXY=socks5://127.0.0.1:1080 or use proxychains

Android

1. Install the apps

Install both apps from the Google Play Store:

• Shadowsocks – The official Shadowsocks client
• v2ray Plugin – The v2ray-plugin for Android

If the Play Store is not available in your country, you can download the APK files from github.com/shadowsocks/shadowsocks-android/releases.

2. Configure the client

1. Open the Shadowsocks app
2. Tap the + button to add a new profile
3. Select Manual Settings and fill in:
   • Profile Name: any name you like (e.g., “My Proxy”)
   • Server: YOUR_DOMAIN
   • Remote Port: 443
   • Password: your password
   • Encrypt Method: aes-256-gcm
   • Plugin: select v2ray
   • Configure: tls;host=YOUR_DOMAIN;path=/shadowsocks;mux=0
4. Tap the check mark to save

3. Connect

Tap the profile you just created, then tap the paper plane icon to connect. Android will ask you to allow a VPN connection – this is normal; Shadowsocks uses Android’s VPN API to route traffic.

iOS

Due to Apple’s App Store restrictions, there are no free Shadowsocks clients with v2ray-plugin support for iOS. The recommended options are:

Option 1: Shadowrocket ($2.99)

Shadowrocket is the most popular and reliable option.

1. Purchase and install Shadowrocket from the App Store
2. Open the app and tap + to add a server
3. Select Type: Shadowsocks
4. Fill in the fields:
   • Address: YOUR_DOMAIN
   • Port: 443
   • Password: your password
   • Algorithm: aes-256-gcm
   • Obfs: select websocket
   • Obfs Host: YOUR_DOMAIN
   • Obfs Path: /shadowsocks
   • Enable TLS: ON
5. Tap Done and then tap the toggle to connect

Option 2: Potatso Lite (Free)

Potatso Lite is a free alternative, though it may not support all v2ray-plugin features.

1. Install Potatso Lite from the App Store
2. Tap Add → Manual Input
3. Select Shadowsocks and fill in your server details
4. For plugin settings, enter: v2ray-plugin;tls;host=YOUR_DOMAIN;path=/shadowsocks;mux=0
5. Save and connect