Shadowsocks GUI application made for Ubuntu / Mac / Win users and powered by Electron.
Shadowsocks Electron is a graphical user interface application designed to provide cross-platform support for Shadowsocks and ShadowsocksR protocols across Linux, macOS, and Windows. Built using Electron, it offers a modern desktop experience with extensive customization options.
Key Features:
Cross-Platform Support: Runs seamlessly on Ubuntu, macOS, and Windows.
Multiple Proxy Modes: Includes PAC mode (using GFWList or custom rules), Global Mode (socks5 proxy for browsers), and Manual Mode.
Clipboard Integration: Supports QR-code import/export for quick server configuration sharing.
Shadowsocks GUI client with cross-platform desktop support powered by Electron⚛️, made specially for Linux / Windows users.
⚠️ For Mac OS users, If you receive system notification about "The app is broken" when start the client, Run following command in terminal to fix that: sudo xattr -r -d com.apple.quarantine /Applications/Shadowsocks\ Electron.app.
➣ Tested on:
Ubuntu20.4/21.04/22.04 (amd64)
Ubuntu22.10 (arm64)
MacOS Catalina (x64)
MacOS Monterey (arm64/x64)
Windows10/11 (x64)
➣ Future test plan
Linux Kali/Manjaro (x64)
Windows7/8 (x64/arm64)
MacOS Big Sur/Mojave (x64/arm64)
II. Features
➣ Supported
SS / SSR Protocol
PAC Mode
Auto proxy mode for browser that use as default rules.
This webapp is a browser and desktop password manager compatible with KeePass databases.
It doesnt require any server or additional resources.
The app can run either in browser, or as a desktop app.
Tabby (formerly Terminus) is a highly configurable terminal emulator, SSH and serial client for Windows 10, macOS and Linux
- Integrated SSH and Telnet client and connection manager
- Integrated serial terminal
- Theming and color schemes
- Fully configurable shortcuts and multi-chord shortcuts
- Split panes
- Remembers your tabs
- PowerShell (and PS Core), WSL, Git-Bash, Cygwin, MSYS2, Cmder and CMD support
- Direct file transfer from/to SSH sessions via Zmodem
- Full Unicode support including double-width characters
- Doesn't choke on fast-flowing outputs
- Proper shell experience on Windows including tab completion (via Clink)
- Integrated encrypted container for SSH secrets and configuration
- SSH, SFTP and Telnet client available as a web app (also self-hosted)
This webapp is a browser and desktop password manager compatible with KeePass databases.
It doesnt require any server or additional resources.
The app can run either in browser, or as a desktop app.
Tabby (formerly Terminus) is a highly configurable terminal emulator, SSH and serial client for Windows 10, macOS and Linux
- Integrated SSH and Telnet client and connection manager
- Integrated serial terminal
- Theming and color schemes
- Fully configurable shortcuts and multi-chord shortcuts
- Split panes
- Remembers your tabs
- PowerShell (and PS Core), WSL, Git-Bash, Cygwin, MSYS2, Cmder and CMD support
- Direct file transfer from/to SSH sessions via Zmodem
- Full Unicode support including double-width characters
- Doesn't choke on fast-flowing outputs
- Proper shell experience on Windows including tab completion (via Clink)
- Integrated encrypted container for SSH secrets and configuration
- SSH, SFTP and Telnet client available as a web app (also self-hosted)
Language Detection & Switching: Available in Chinese, English, and Russian.
Configuration Backup/Restore: Easily save and recover your settings.
Dark/Light Theme: Customize the appearance to suit your preferences.
Audience & Benefit:
Ideal for Linux, macOS, and Windows users seeking a secure and reliable way to manage Shadowsocks connections. The application provides seamless integration with local Shadowsocks-libev binaries, allowing users to benefit from the latest protocol updates without complex configuration or advanced technical knowledge. It can be installed via winget for easy setup on supported platforms.
install: Download a certain version plugin, unpack and rename it to kcptun, then put the file into system dir (such as /usr/bin/) on unix like systems. OR you may put the file into plugins dir on Windows (check "Open Plugins Directory" button from settings page).
v2ray-plugin
effect: Use the plugin for traffic obfuscation. You must install it on you system first and enable it on ss server configuration.
install: Download a certain version plugin, unpack and rename it to v2ray-plugin, then put the file into system dir (such as /usr/bin/) on unix like systems. OR you may put the file into plugins dir on Windows (check "Open Plugins Directory" button from settings page).
VIII. Recommended ACL Files
1. Download ACL file and saved it to local directory.
This project was heavily inspired by 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.
X. Development
1. Env
Node@^14.18
Ubuntu18.04 or higher version
Mac catalina or other versions (works in most recent versions in theory)
Windows 10 or higher version
2. Prepare
> The step is not necessary, there are some buildin ssr/ss executable files provided in bin dir, Only do this when you want to use external bin for test/dev.
Mac developers need to install shadowsocks-libev at first, use command here: brew install shadowsocks-libev. For china users, if brew is not installed, run this in terminal: /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" to install brew.
Ubuntu developers can install shadowsocks-libev with apt manager.
# for ubuntu developers
$: sudo apt install shadowsocks-libev
$: sudo snap install multipass
# for mac developers
$: brew install shadowsocks-libev
# proxy env set (if your local machine support)
export HTTPS_PROXY=http://127.0.0.1:
export HTTP_PROXY=http://127.0.0.1:
3. Run commands in terminal
# [01]clone
$: git clone https://github.com/nojsja/shadowsocks-electron.git
$: cd shadowsocks-electron
# for china developers
$: npm config set electron_mirror http://npm.taobao.org/mirrors/electron/
# [02]npm
$: npm i -g yarn
$: npm i
# [03]run scripts/download.js for env prepare
$: cd scripts
$: node download.js
# for ubuntu developers
$: cp pac/gfwlist.txt ~/.config/shadowsocks-electron/pac/
# for mac developers
$: cp pac/gfwlist.txt ~/Library/Application\ Support/shadowsocks-electron/pac/
# [04]start
$: npm start
XI. Mention
> The repo is cloned from robertying/shadowsocks-electron which is no longer maintained. I create a new repo based on that in order to be found in github search list.
