TopGit
GitHub Repo Review

Shadowsocks for Windows: a Windows SOCKS5 proxy client

shadowsocks/shadowsocks-windows
STopGit review image for shadowsocks/shadowsocks-windows
Review by Topgit.dev for shadowsocks/shadowsocks-windows, with GitHub repository stats and README context.
Quick verdict

Shadowsocks for Windows is the reference GUI client for running a shadowsocks proxy on a Windows desktop, and it does one job well: turning a server address into a working system proxy without touching Windows' network settings by hand. UDP still needs a bolted-on tool like SocksCap, and there's no installer, just a portable download — but the PAC-based routing and switching strategies hold up once you already have a server to point at.

Stars
★ 59.5k
Forks
⑂ 16.1k
Language
C#
License
See repository
Topic
—
Updated
Jan 2025
Homepage
—
GitHub

What is Shadowsocks for Windows?

Shadowsocks for Windows is a C# desktop client for the shadowsocks proxy protocol, packaged as a system tray app rather than a background service. It keeps a list of shadowsocks servers, builds PAC rules from the v2fly/domain-list-community geosite database to decide which domains get proxied, and opens a local SOCKS5/HTTP endpoint at 127.0.0.1:1080 that your browser or other software connects through.

Core features: PAC mode, global mode, and server switching

  • ✓System proxy configuration that flips Windows' system proxy on and off from the tray icon, instead of digging into Windows Settings by hand.
  • ✓PAC mode and global mode: PAC routes only matched domains through the proxy, global mode routes every connection.
  • ✓GeoSite-based PAC rule generation from the v2fly/domain-list-community database, with `geositeDirectGroups` and `geositeProxiedGroups` controlling which domains skip the proxy.
  • ✓Server auto switching with three strategies: random load balancing, latency/packet-loss-based high availability, and a ping-and-choose mode.
  • ✓UDP relay support, though it needs a separate tool like SocksCap or ProxyCap to force specific programs to tunnel UDP through the proxy.
  • ✓Plugin support through a path field in the Edit Servers form, for SIP003-style proxy plugins.
  • ✓Global hotkeys, set independently per running instance so multiple copies don't fight over the same key combination.
How this repository's GitHub stars have grown over time. Source: star-history.com.View the star history ↗

Installing Shadowsocks for Windows

Download the latest release from the shadowsocks-csharp releases page linked in the README — there's no separate installer package described. Before you run it, install .NET Framework 4.8 or higher and the Microsoft Visual C++ 2015 Redistributable (x86); skip the redistributable and the app can fail to start. Treat the download as a portable folder: to run a second instance, copy that folder again and give it a different local port, which is exactly what the README's Multiple Instances section describes.

Strengths

  • ✓PAC rules come from the actively maintained v2fly/domain-list-community geosite database instead of a hand-rolled domain list.
  • ✓Three built-in server-switching strategies mean you're not stuck manually picking a server when one degrades.
  • ✓Fully portable — running another instance is just copying the folder and changing a port, no installer or service registration.
  • ✓Hotkeys are configured per instance, so multiple shadowsocks connections running side by side don't collide on the same key combo.

Limitations and known constraints

  • △UDP relay isn't handled natively; the README says you need a separate tool like SocksCap or ProxyCap to force programs to tunnel UDP over the proxy.
  • △No installer is documented — it's a manual download with a specific .NET Framework and VC++ redistributable prerequisite, and missing either breaks the app silently on launch.
  • △Custom server-switching logic means implementing the IStrategy interface yourself and sending a pull request; there's no config-only way to add a strategy.
  • △Windows Store (UWP) apps need a manual `netsh winhttp import proxy source=ie` command run as Administrator before they'll pick up the proxy.

Alternatives to Shadowsocks for Windows

V2RayN — a similar Windows tray client, but built on the V2Ray/Xray core with a wider protocol list than shadowsocks-windows' single shadowsocks protocol.Clash for Windows — a rule-based proxy client with its own rule-matching engine, an alternative to shadowsocks-windows' PAC/geosite approach.Outline Client — Jigsaw's shadowsocks-based client, built for a simpler one-server setup instead of shadowsocks-windows' multi-server list and switching strategies.

Frequently asked questions

Is Shadowsocks for Windows free and open source?

Shadowsocks for Windows is released under the GPLv3 license and its source is hosted publicly on GitHub, so it's free to download, modify, and redistribute under GPLv3's terms.

How do I enable UDP relay in Shadowsocks for Windows?

Shadowsocks for Windows supports UDP relay, but the README says you need a separate tool like SocksCap or ProxyCap to force the specific programs you want proxied to tunnel their UDP traffic over the connection — it isn't automatic for every app.

What is the difference between PAC mode and global mode in Shadowsocks?

PAC mode in Shadowsocks for Windows generates rules from a geosite database so only matched domains route through the proxy server, while global mode sends every connection through the proxy regardless of destination.

Can I run multiple instances of Shadowsocks on the same Windows PC?

Shadowsocks for Windows supports running multiple instances on one PC — the README says to copy the app into a separate directory and set a different local port for each copy, which avoids configuration conflicts between instances.

Does Shadowsocks for Windows work with Windows Store apps?

Shadowsocks for Windows can work with Windows Store (UWP) apps, but it needs an extra step: the README instructs running `netsh winhttp import proxy source=ie` from an Admin command prompt so those apps pick up the configured proxy.

What .NET version does Shadowsocks for Windows require?

Shadowsocks for Windows requires .NET Framework 4.8 or higher, plus the Microsoft Visual C++ 2015 Redistributable (x86) — both are listed as requirements in the README before you run the downloaded release.

The problem it solves

Windows has no built-in shadowsocks or SOCKS5 client. Someone still has to turn 'connect to this server' into working proxy settings, PAC exception rules, and a toggle you can switch off cleanly when you're done. Shadowsocks for Windows exists to do that translation without you hand-editing Windows' network proxy settings or writing your own PAC file from scratch.

Best use cases

  • •Bypassing geo-restriction on one browser via PAC mode, so only blocked domains route through the shadowsocks server.
  • •Routing all desktop traffic through a shadowsocks server in global mode — for example on a public Wi-Fi network you don't trust.
  • •Running several shadowsocks connections side by side, each in its own copied folder with a different local port and hotkey.
  • •Failing over between multiple shadowsocks servers automatically instead of switching servers by hand when one gets slow.

Who should try it — and who should skip

Try Shadowsocks for Windows if you already have a shadowsocks server and want a Windows tray client with PAC-based selective routing and a few automatic server-switching strategies. Skip it if you need UDP-heavy apps like games or VoIP to work without extra setup — the UDP path requires bolting on SocksCap or ProxyCap — or if you'd rather have Outline Client's one-server, one-click setup than manage PAC groups and switching strategies yourself.

Related repositories

Source & attribution

Based on the shadowsocks/shadowsocks-windows GitHub repository and its README.

GitHub data · last synced Aug 14, 2026Reviewed by Henry
← Back to TopGit

Still deciding about shadowsocks-windows?

One click hands the question to an AI along with this page — see what it says about shadowsocks-windows.

GitHub