README

Shadowsocks for Windows
=======================

[![Build Status]][Appveyor]

[中文说明]

 Features

1. System proxy configuration
2. PAC mode and global mode
3. [GeoSite] and user rules
4. Supports HTTP proxy
5. Supports server auto switching
6. Supports UDP relay (see Usage)
7. Supports plugins

 Downloads

Download the latest release from [release page].

 Requirements

.NET Framework 4.8 or higher, Microsoft [Visual C++ 2015 Redistributable] (x86) .

 Basics

1. Find Shadowsocks icon in the notification tray
2. You can add multiple servers in servers menu
3. Select Enable System Proxy menu to enable system proxy. Please disable other
proxy addons in your browser, or set them to use system proxy
4. You can also configure your browser proxy manually if you don't want to enable
system proxy. Set Socks5 or HTTP proxy to 127.0.0.1:1080. You can change this
port in Servers - Edit Servers

 PAC

- The PAC rules are generated from the geosite database in v2fly/domain-list-community.
- Generation modes: whitelist mode and blacklist mode.
- Domain groups: geositeDirectGroups and geositeProxiedGroups.
    - geositeDirectGroups is initialized with cn and geolocation-!cn@cn.
    - geositeProxiedGroups is initialized with geolocation-!cn.
- To switch between different modes, modify the geositePreferDirect property in gui-config.json
    - When geositePreferDirect is false (default), PAC works in whitelist mode. Exception rules are generated from geositeDirectGroups. Unmatched domains goes through the proxy.
    - When geositePreferDirect is true, PAC works in blacklist mode. Blocking rules are generated from geositeProxiedGroups. Exception rules are generated from geositeDirectGroups. Unmatched domains are connected to directly.
- Starting from 4.3.0.0, shadowsocks-windows defaults to whitelist mode with Chinese domains excluded from connecting via the proxy.
- The new default values make sure that:
    - When in whitelist mode, Chinese domains, including non-Chinese companies' Chinese CDNs, are connected to directly.
    - When in blacklist mode, only non-Chinese domains goes through the proxy. Chinese domains, as well as non-Chinese companies' Chinese CDNs, are connected to directly.

 User-defined rules

- To define your own PAC rules, it's recommended to use the user-rule.txt file.
- You can also modify pac.txt directly. But your modifications won't persist after updating geosite from the upstream.

For Windows10 Store and related applications, please execute the following command under Admin privilege:

netsh winhttp import proxy source=ie


 Server Auto Switching

1. Load balance: choosing server randomly
2. High availability: choosing the best server (low latency and packet loss)
3. Choose By Total Package Loss: ping and choose. Please also enable
   Availability Statistics in the menu if you want to use this
4. Write your own strategy by implement IStrategy interface and send us a pull r

Top issues

Discussions

Latest release

📝 Release Notes
 Add the support of plain/none cipher.

 📦 File Info
Shadowsocks-4.4.1.0.zip
 MD5: bb8fabe90e342c166aa227ad9978e36b
 SHA1: 1aab2b5f41c1c90ba8024c5a8bb8f902e7600727
 SHA256: 62b74a688d22bfdf20f673a351580029d7b9de67c6facc9a5613b22b3f798968