- Stars
- 32,862
- Forks
- 7,703
- Open issues
- 0
- Last commit
- 7 days ago
What is it?
ShadowsocksX-NG2 is a macOS menu bar client for Shadowsocks proxy servers. It lets you add or import server configurations, organize them into groups, and subscribe to HTTPS SIP-008 subscription feeds that show traffic and expiry information.
Traffic can be routed in global, rules, or direct mode. Rules mode includes bundled rules and supports custom rules that decide whether each destination goes through the proxy or connects directly. The app exposes local SOCKS5 and HTTP proxies for Mac applications, and LAN listeners with access credentials can be enabled when needed.
The client bundles v2ray-plugin and Cloak for obfuscation, and v2ray-plugin also supports a Hysteria2 transport mode that requires matching configuration on both ends. Local configuration is encrypted with age, and diagnostic reports omit passwords, plugin options and subscription URLs. The project provides only the client, not servers or subscription services, and requires macOS 15 or later on Apple Silicon.
Key features
- 01Import Shadowsocks configurations and organize servers into groups with favorites.
- 02Add HTTPS SIP-008 subscriptions and view traffic and expiry information.
- 03Switch between global, rules, and direct routing modes with custom rules.
- 04Provide local SOCKS5 and HTTP proxies, with optional LAN access and credentials.
- 05Include v2ray-plugin and Cloak, plus support for custom plugins.
- 06Encrypt local configuration with age and exclude sensitive data from diagnostics.
Use cases
- Routing selected Mac apps through a Shadowsocks server while keeping other traffic direct.
- Managing several Shadowsocks servers and subscription feeds from the menu bar.
- Sharing a Mac's proxy with other devices on the local network with credentials enabled.
- Running Shadowsocks alongside the legacy 1.x client on the same Mac.
Quick start
- 1
Download the latest ShadowsocksX-NG2 release from GitHub Releases
Things to know
- Requires macOS 15 or later on an Apple Silicon Mac.
- The project is undergoing a major rewrite and NG2 is still in development.
- New Issues and PRs are temporarily restricted until the v2 code is stable.
- Licensed under GPL-3.0, a copyleft license.
In collections
Topics
FAQ
- What is ShadowsocksX-NG?
- A native macOS menu bar Shadowsocks client for Apple Silicon Macs, with SOCKS5 and HTTP proxy endpoints for local apps. ShadowsocksX-NG2 is a macOS menu bar client for Shadowsocks proxy servers. It lets you add or import server configurations, organize them into groups, and subscribe to HTTPS SIP-008 subscription feeds that show traffic and expiry information.
- Is ShadowsocksX-NG free to use? What license does it have?
- ShadowsocksX-NG is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
- Is ShadowsocksX-NG still maintained?
- Actively maintained. The last commit to ShadowsocksX-NG was on Oct 31, 2026.
- What can I use ShadowsocksX-NG for?
- Routing selected Mac apps through a Shadowsocks server while keeping other traffic direct. Managing several Shadowsocks servers and subscription feeds from the menu bar. Sharing a Mac's proxy with other devices on the local network with credentials enabled. Running Shadowsocks alongside the legacy 1.x client on the same Mac.
- How do I install ShadowsocksX-NG?
- Download the latest ShadowsocksX-NG2 release from GitHub Releases
- Where can I get ShadowsocksX-NG?
- The source code and installation instructions are on GitHub: https://github.com/shadowsocks/ShadowsocksX-NG
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
An Android client for the V2Ray proxy platform, supporting both Xray core and v2fly core.
Cross-platform client that forces TCP and UDP traffic from chosen applications through SOCKS5 or HTTP proxies, a Proxifier alternative for Windows, macOS and Linux.
A LuCI plugin that runs the Mihomo (Clash Meta) proxy client on OpenWrt routers, with rule-based traffic splitting and transparent proxying.
A macOS gateway app that turns a Mac into a Surge-style transparent proxy with per-device routing, DHCP/DNS via dnsmasq, and mihomo as the proxy engine.
A menu bar and iPhone app that shows your home as a live 3D model and controls its lights and air conditioners via Smart Life, Home Assistant, Hue and Apple Home.