{"id":13434635,"url":"https://github.com/shadowsocks/shadowsocks-windows","last_synced_at":"2025-12-16T15:45:29.305Z","repository":{"id":6363228,"uuid":"7600409","full_name":"shadowsocks/shadowsocks-windows","owner":"shadowsocks","description":"A C# port of shadowsocks","archived":false,"fork":false,"pushed_at":"2025-01-01T08:09:55.000Z","size":13489,"stargazers_count":58798,"open_issues_count":193,"forks_count":16363,"subscribers_count":2436,"default_branch":"v4","last_synced_at":"2025-05-05T15:59:39.167Z","etag":null,"topics":["c-sharp","proxy","shadowsocks"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shadowsocks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-01-14T07:54:16.000Z","updated_at":"2025-05-05T15:33:37.000Z","dependencies_parsed_at":"2022-07-14T04:50:28.524Z","dependency_job_id":"bf81be4b-c63e-4e60-87eb-c13a1197e3c8","html_url":"https://github.com/shadowsocks/shadowsocks-windows","commit_stats":{"total_commits":1458,"total_committers":88,"mean_commits":"16.568181818181817","dds":0.7510288065843621,"last_synced_commit":"8fafef7c5751809751d8eef361e3c39caef75261"},"previous_names":["shadowsocks/shadowsocks-csharp"],"tags_count":67,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadowsocks%2Fshadowsocks-windows","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadowsocks%2Fshadowsocks-windows/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadowsocks%2Fshadowsocks-windows/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadowsocks%2Fshadowsocks-windows/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shadowsocks","download_url":"https://codeload.github.com/shadowsocks/shadowsocks-windows/tar.gz/refs/heads/v4","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253799124,"owners_count":21966219,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c-sharp","proxy","shadowsocks"],"created_at":"2024-07-31T03:00:19.451Z","updated_at":"2025-12-16T15:45:29.246Z","avatar_url":"https://github.com/shadowsocks.png","language":"C#","readme":"\u003cimg src=\"shadowsocks-csharp/Resources/ssw128.png\" alt=\"[logo]\" width=\"48\"/\u003e Shadowsocks for Windows\r\n=======================\r\n\r\n[![Build Status]][Appveyor]\r\n\r\n[中文说明]\r\n\r\n## Features\r\n\r\n1. System proxy configuration\r\n2. PAC mode and global mode\r\n3. [GeoSite] and user rules\r\n4. Supports HTTP proxy\r\n5. Supports server auto switching\r\n6. Supports UDP relay (see Usage)\r\n7. Supports plugins\r\n\r\n## Downloads\r\n\r\nDownload the latest release from [release page].\r\n\r\n## Requirements\r\n\r\n.NET Framework 4.8 or higher, Microsoft [Visual C++ 2015 Redistributable] (x86) .\r\n\r\n## Basics\r\n\r\n1. Find Shadowsocks icon in the notification tray\r\n2. You can add multiple servers in servers menu\r\n3. Select `Enable System Proxy` menu to enable system proxy. Please disable other\r\nproxy addons in your browser, or set them to use system proxy\r\n4. You can also configure your browser proxy manually if you don't want to enable\r\nsystem proxy. Set Socks5 or HTTP proxy to 127.0.0.1:1080. You can change this\r\nport in `Servers -\u003e Edit Servers`\r\n\r\n## PAC\r\n\r\n- The PAC rules are generated from the geosite database in [v2fly/domain-list-community](https://github.com/v2fly/domain-list-community).\r\n- Generation modes: whitelist mode and blacklist mode.\r\n- Domain groups: `geositeDirectGroups` and `geositeProxiedGroups`.\r\n    - `geositeDirectGroups` is initialized with `cn` and `geolocation-!cn@cn`.\r\n    - `geositeProxiedGroups` is initialized with `geolocation-!cn`.\r\n- To switch between different modes, modify the `geositePreferDirect` property in `gui-config.json`\r\n    - When `geositePreferDirect` is false (default), PAC works in whitelist mode. Exception rules are generated from `geositeDirectGroups`. Unmatched domains goes through the proxy.\r\n    - 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.\r\n- Starting from 4.3.0.0, shadowsocks-windows defaults to whitelist mode with Chinese domains excluded from connecting via the proxy.\r\n- The new default values make sure that:\r\n    - When in whitelist mode, Chinese domains, including non-Chinese companies' Chinese CDNs, are connected to directly.\r\n    - 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.\r\n\r\n### User-defined rules\r\n\r\n- To define your own PAC rules, it's recommended to use the `user-rule.txt` file.\r\n- You can also modify `pac.txt` directly. But your modifications won't persist after updating geosite from the upstream.\r\n\r\nFor Windows10 Store and related applications, please execute the following command under Admin privilege:\r\n```\r\nnetsh winhttp import proxy source=ie\r\n```\r\n\r\n## Server Auto Switching\r\n\r\n1. Load balance: choosing server randomly\r\n2. High availability: choosing the best server (low latency and packet loss)\r\n3. Choose By Total Package Loss: ping and choose. Please also enable\r\n   `Availability Statistics` in the menu if you want to use this\r\n4. Write your own strategy by implement IStrategy interface and send us a pull request!\r\n\r\n## UDP\r\n\r\nFor UDP, you need to use SocksCap or ProxyCap to force programs you want\r\nto be proxied to tunnel over Shadowsocks\r\n\r\n## Multiple Instances\r\n\r\nIf you want to manage multiple servers using other tools like SwitchyOmega,\r\nyou can start multiple Shadowsocks instances. To avoid configuration conflicts,\r\ncopy Shadowsocks to a new directory and choose a different local port.\r\n\r\n## Plugins\r\n\r\nIf you would like to connect to server via a plugin, please set the plugin's\r\npath (relative or absolute) on Edit Servers form.\r\n_Note_: Forward Proxy will not be used while a plugin is enabled.\r\n\r\nDetails:\r\n[Working with non SIP003 standard Plugin].\r\n\r\n## Global hotkeys\r\n\r\nHotkeys could be registered automatically on startup.\r\nIf you are using multiple instances of Shadowsocks,\r\nyou must set different key combination for each instance.\r\n\r\n### How to input?\r\n\r\n1. Put focus in the corresponding textbox.\r\n2. Press the key combination that you want to use.\r\n3. Release all keys when you think it is ready.\r\n4. Your input appears in the textbox.\r\n\r\n### How to change?\r\n\r\n1. Put focus in the corresponding textbox.\r\n2. Press BackSpace key to clear content.\r\n3. Re-input new key combination.\r\n\r\n### How to deactivate?\r\n\r\n1. Clear content in the textbox that you want to deactivate,\r\nif you want to deactivate all, please clear all textboxes.\r\n2. Press OK button to confirm.\r\n\r\n### Meaning of label color\r\n\r\n- Green: This key combination is not occupied by other programs and register successfully.\r\n- Yellow: This key combination is occupied by other programs and you have to change to another one.\r\n- Transparent without color: The initial status.\r\n\r\n## Server Configuration\r\n\r\nPlease visit [Servers] for more information.\r\n\r\n## Experimental\r\n\r\n[Experimental Features]\r\n\r\n## Development\r\n\r\n1. Visual Studio 2019 \u0026 .NET Framework 4.8 SDK are required.\r\n2. It is recommended to share your idea on the Issue Board before you start to work,\r\nespecially for feature development.\r\n\r\n## License\r\n\r\n[GPLv3]\r\n\r\n## Open Source Components / Libraries\r\n\r\n```\r\nCaseless.Fody (MIT)              https://github.com/Fody/Caseless\r\nCostura.Fody (MIT)               https://github.com/Fody/Costura\r\nFody (MIT)                       https://github.com/Fody/Fody\r\nGlobalHotKey (GPLv3)             https://github.com/kirmir/GlobalHotKey\r\nMdXaml (MIT)                     https://github.com/whistyun/MdXaml\r\nNewtonsoft.Json (MIT)            https://www.newtonsoft.com/json\r\nReactiveUI.WPF (MIT)             https://github.com/reactiveui/ReactiveUI\r\nReactiveUI.Events.WPF (MIT)      https://github.com/reactiveui/ReactiveUI\r\nReactiveUI.Fody (MIT)            https://github.com/reactiveui/ReactiveUI\r\nReactiveUI.Validation (MIT)      https://github.com/reactiveui/ReactiveUI.Validation\r\nWPFLocalizationExtension (MS-PL) https://github.com/XAMLMarkupExtensions/WPFLocalizationExtension/\r\nZXing.Net (Apache 2.0)           https://github.com/micjahn/ZXing.Net\r\n\r\nlibsscrypto (GPLv2)    https://github.com/shadowsocks/libsscrypto\r\nPrivoxy (GPLv2)        https://www.privoxy.org\r\nSysproxy ()            https://github.com/Noisyfox/sysproxy\r\n```\r\n\r\n\r\n\r\n[Appveyor]:     https://ci.appveyor.com/project/celeron533/shadowsocks-windows\r\n[Build Status]: https://ci.appveyor.com/api/projects/status/tfw57q6eecippsl5/branch/master?svg=true\r\n[release page]: https://github.com/shadowsocks/shadowsocks-csharp/releases\r\n[GeoSite]:      https://github.com/v2fly/domain-list-community\r\n[Servers]:      https://github.com/shadowsocks/shadowsocks/wiki/Ports-and-Clients#linux--server-side\r\n[中文说明]:     https://github.com/shadowsocks/shadowsocks-windows/wiki/Shadowsocks-Windows-%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E\r\n[Visual C++ 2015 Redistributable]:     https://www.microsoft.com/en-us/download/details.aspx?id=53840\r\n[GPLv3]:        https://github.com/shadowsocks/shadowsocks-windows/blob/master/LICENSE.txt\r\n[Working with non SIP003 standard Plugin]: https://github.com/shadowsocks/shadowsocks-windows/wiki/Working-with-non-SIP003-standard-Plugin\r\n[Experimental Features]: https://github.com/shadowsocks/shadowsocks-windows/wiki/Experimental","funding_links":[],"categories":["WeChat","Uncategorized","C# #","C#","优质软件","Tool","Software","\u003ca id=\"d03d494700077f6a65092985c06bf8e8\"\u003e\u003c/a\u003e工具","網路自由","C\\#","开源项目"],"sub_categories":["Mini Program","Uncategorized","\u003ca id=\"cb16466a31a167bb61f39e2a4a85f449\"\u003e\u003c/a\u003eShadowsocks"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshadowsocks%2Fshadowsocks-windows","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshadowsocks%2Fshadowsocks-windows","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshadowsocks%2Fshadowsocks-windows/lists"}