shadowsocks-electron

Shadowsocks Electron

> Test on Ubuntu20.4/21.04/22.04 (amd64) ● MacOS catalina (x64) ● Windows 10/11 (x64)

Shadowsocks GUI client with cross-platform desktop support powered by Electron⚛️, made specially for Linux / Windows users.

Features

➣ Supported

• SS / SSR Protocol
• PAC Mode (GFWList)
• Global Mode (socks proxy)
• Manual Mode (no system-wide proxy set)
• HTTP(S) Proxy
• ACL (access control list)
• Nodes Load-Balancing Mode
• Clipboard / QR-code Import
• Subscription Import
• Language Detecting And Switching (zh-CN / en-US)
• Configuration Backup / Recovery
• Dark / Light Mode
• Auto Start
• Server Share
• Activity Logs

➣ In Testing

• AEAD ciphers
• SIP003 plugins (v2ray & kcptun)

➣ Comming Soon

• v2ray-plugin

Supported Platforms & Arch

> More architecture will be supported if necessary, just give me an issue.

• Ubuntu
  • deb x64/x86/arm64
  • AppImage x64/x86/arm64
  • snap x64
• MacOS
  • dmg x64
• Windows
  • exe x64
  • zip x64/x86

Downloads

• GitHub Releases

  • [↪ releases page ](https://github.com/nojsja/shadowsocks-electron/releases/latest)

• ElectronJs Website

  • [↪ main page ](https://www.electronjs.org/apps/shadowsocks-electron)

• Snapcraft Store (linux)

  • [↪ main page ](https://snapcraft.io/shadowsocks-electron)

Plugins Downloads

> not necessary, just for some advanced users.

• kcptun

  • effect: Use the plugin for ss server speed up. You must install it on you system first and enable it on ss server configuration.
  • [↪ kcptun repo releases](https://github.com/shadowsocks/kcptun/releases/)
  • install: Download the correct version, unpack and rename it to kcptun, then put the file into system dir (such as /usr/local/bin/) on unix like systems. OR you may need to configure system variables on windows.

• v2ray-plugin

  • effect: Use the plugin for traffic obfuscation. You must install it on you system first and enable it on ss server configuration.
  • [↪ v2ray-plugin repo releases](https://github.com/shadowsocks/v2ray-plugin/releases)
  • install: Download the correct version, unpack and rename it to v2ray-plugin, then put the file into system dir (such as /usr/local/bin/) on unix like systems. OR You may need to configure system variables on windows.

Recommended ACL Files

1. Download ACL file and saved it to local directory.

• go to [github repo - SuperAcl](https://github.com/Windelight/SuperACL.git)
• [inchina.acl](https://raw.githubusercontent.com/Windelight/SuperACL/master/inchina.acl): Proxy only sites blocked by the firewall.
• [inforeign.acl](https://raw.githubusercontent.com/Windelight/SuperACL/master/inforeign.acl): Proxy the sites in china which restricted access to overseas.

2. Enable ACL Mode and load the file on settings page of client.

Why?

• The official qt-version app - [shadowsocks-qt5](https://github.com/shadowsocks/shadowsocks-qt5) has been deprecated, which has an old interface but still working.
• Only [Shadowsocks-libev](https://github.com/shadowsocks/shadowsocks-libev) and [Shadowsocks for Android](https://github.com/shadowsocks/shadowsocks-android) support ACL (bypass China IPs, etc.)

This project was heavily inspired by [shadowsocks/ShadowsocksX-NG](https://github.com/shadowsocks/ShadowsocksX-NG), which uses local Shadowsocks-libev binary to avoid complex integration with native C code. This means it can always use the latest Shadowsocks-libev version.

It also uses Electron to bring the most powerful cross-platform desktop support with great developing experience.

Credit

• [tindy2013/shadowsocks-static-binaries](https://github.com/tindy2013/shadowsocks-static-binaries)
• [robertying/shadowsocks-electron](https://github.com/robertying/shadowsocks-electron)
• [shadowsocks/shadowsocks-libev](https://github.com/shadowsocks/shadowsocks-libev)
• [shadowsocks/ShadowsocksX-NG](https://github.com/shadowsocks/ShadowsocksX-NG)