README.md

使用须知

本工具是为了方便学习，毕竟很多东西上Google搜比Baidu更靠谱，因此希望大家注意以下几点

• GFW=智商墙，请注意提高自己的智力，勿被境外利益集团洗脑

• 墙外≠法外，请注意自己言行，本工具是为了学习而不是让你叛国

• 爱国富强的前提是自己要有独立思考问题的能力，而不是秀智力

• 本项目关闭Issues和Wikis，不参与任何购买梯子或者搭建梯子的讨论

• 本项目所提供编译好的App程序不保证一定可用（特别是macOS 10.15），请各位技术大牛自行下载编译运行，提高使用门槛（在Xcode11.2.1上可以直接编译运行）

ShadowsocksX-NG-R

Current version is 1.4.7

Continuesly release under 1.4.7

Next Generation of ShadowsocksX with SSR support.

After Download Please check the GPG signature!

First get My pub key and import the Pub key

gpg --import pubkeys.txt

Then verify the signature

Place the .dmg and .dmg.sig file together in a directory

gpg --verify {drag the ShadowsocksX-NG-R8.dmg.sig into your terminal}

Why?

It's hard to maintain the original implement. There are too many unused code in it. It also embed ss-local source. It's crazy to maintain depandences of ss-local. So it's hard to update ss-local version.

Now I just copy the ss-local from home brew. Run ss-local executable as a Launch Agent in background. Serve pac js file as a file url. So there are only some souce code related to GUI left. Then I rewrite the GUI code by swift.

Requirements

Running

• macOS 10.12 +

Building

• Xcode 11.1+
• cocoapod 1.8.4+

Fetures

• SSR features!
• Ability to check update from GitHub.
• White domain list & white IP list
• Use ss-local from shadowsocksr-libev 2.5.6
• Ability to update PAC by download GFW List from GitHub. (You can even customize your list)
• Ability to update ACL white list from GutHub. (You can even customize your list)
• Show QRCode for current server profile.
• Scan QRCode from screen.
• Import config.json to config all your servers (SSR-C# password protect not supported yet)
• Auto launch at login.
• User rules for PAC.
• Support for OTA is removed
• An advance preferences panel to configure:
  • Local socks5 listen address.
  • Local socks5 listen port.
  • Local socks5 timeout.
  • If enable UDP relay.
  • GFW List url.
  • ACL White List url.
  • ACL GFW list and proxy bach CHN list.
• Manual spesify network service profiles which would be configure the proxy.
• Could reorder shadowsocks profiles by drag & drop in servers preferences panel.
• Auto check update (unable to auto download)

Different from orignal ShadowsocksX

Run ss-local as backgroud service through launchd, not in app process. So after you quit the app, the ss-local maybe is still running.

Add a manual mode which won't configure the system proxy settings. Then you could configure your apps to use socks5 proxy manual.

Contributing

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

ref: GitFlow

TODO List

• Embed the http proxy server privoxy, get it.

• ACL mode support Shadowsocks ACL

Know Issue

Solved Issue 1. Auto PAC & White list is not working on macOS 10.12 Serria because system proxy not allow file:/// protocol. Issue 2. The net speed is how ever have some problem with macOS 10.12, welcome logs from all users.

License

The project is released under the terms of GPLv3.