Next Generation of ShadowsocksX (Backup) https://github.com/shadowsocks/ShadowsocksX-NG
Qiu Yuzhou acd84297d8 Update issue templates 2 weeks ago
.github/ISSUE_TEMPLATE Update issue templates 2 weeks ago
LaunchHelper Upgrade project settings. 7 months ago
Pods Make project build pass with swift 4.0 4 months ago
ShadowsocksX-NG Upgrade ss-local to version 3.1.3. 3 weeks ago
ShadowsocksX-NG.xcodeproj Upgrade ss-local to version 3.1.3. 3 weeks ago
ShadowsocksX-NG.xcworkspace Add shared schemes. 1 year ago
ShadowsocksX-NGTests Adds SIP002 URL for QR scaner 9 months ago
proxy_conf_helper Removes default bypass rules in proxy_conf_helper 6 months ago
.gitignore Update .gitingore file. 3 weeks ago
.travis.yml Edit .travis.yml in order to use xcode9 instead of xcode8. 7 months ago
ISSUE_TEMPLATE.md Update issue template. 1 year ago
LICENSE add license file 1 year ago
Podfile Remove feature ping which may make app crashed. 4 months ago
Podfile.lock Make project build pass with swift 4.0 4 months ago
README.md Bump version to 1.7.1 3 months ago
_config.yml Set theme jekyll-theme-slate 1 year ago
genstrings.py Localize *.swift files. 1 year ago

README.md

ShadowsocksX-NG

Current version is 1.7.1

Build Status

Next Generation of ShadowsocksX

Why?

It's hard to maintain the original implementation as there is too much unused code in it. It also embeds the ss-local source. It's crazy to maintain dependencies of ss-local. So it's hard to update the ss-local version.

Now I just copied the ss-local from Homebrew. Run ss-local executable as a Launch Agent in the background. Serve PAC JS file as a file URL. So there is only some source code related to GUI left. Then I will rewrite the GUI code in Swift.

Requirements

Running

  • macOS 10.11+

Building

  • Xcode 9.2+
  • CocoaPods 1.3.1+

Download

From here

Features

  • Uses ss-local from shadowsocks-libev 3.0.5
  • Could update PAC by download GFW List from GitHub.
  • Shows QRCode for current server profile.
  • Scans QRCode from screen.
  • Auto launch at login.
  • User rules for PAC.
  • Support for AEAD Ciphers
  • HTTP Proxy by privoxy
  • Over kcptun. Version 20170322
  • Export/Import configure file.
  • An advanced preferences panel for configuring:
    • Local SOCKS5 listen address.
    • Local SOCKS5 listen port.
    • Local SOCKS5 timeout.
    • If enable UDP relay.
    • GFW List URL.
  • Manually specify network service profiles which would be used to configure the proxy.
  • Could reorder shadowsocks profiles by drag-&-dropping in servers preferences panel.
  • Configurable global shortcuts for toggle running and switch proxy mode.

Difference from original ShadowsocksX

ss-local is run as a background service through launchd, not as an in-app process. So after you quit the app, the ss-local might be still running.

Added a manual mode which won't configure the system proxy settings, so that you could configure your apps to use the SOCKS5 proxy manually.

Contributing

Contributions must be available on a separately named branch based on the latest version of the main branch develop.

ref: GitFlow

License

The project is released under the terms of the GPLv3.