forked from paradiseduo/ShadowsocksX-NG-R8
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.swift
132 lines (89 loc) · 5.15 KB
/
readme.swift
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
# 使用须知
## 本工具是为了方便学习与工作，毕竟很多东西用Google搜比Baidu更靠谱，因此希望大家注意以下几点
- GFW=智商墙，请注意提高自己的智力，勿被境外利益集团洗脑
- 墙外≠法外，请注意自己言行，本工具是为了学习而不是让你叛国
- 爱国富强的前提是自己要有独立思考问题的能力，而不是秀智力
- 请勿在本项目的Issues里进行任何购买梯子或者搭建梯子的讨论
- 本项目所提供编译好的App程序不保证一定可用（特别是macOS 10.15），请各位技术大牛自行下载编译运行，提高使用门槛（在Xcode11.4上可以直接编译运行）
- 如果你需要使用kcptun，那么你可以看一下[这个项目](https://github.com/paradiseduo/Kcptun)
- 如果你需要使用trojan，那么你可以看一下[这个项目](https://github.com/paradiseduo/Trojan)
## 软件删除方法
首先从应用程序中将.app文件放到废纸篓（随便什么方式）
然后打开命令行，依次输入：
```
rm -rf /Library/Application\ Support/ShadowsocksX-NG-R8
rm -rf ~/Library/Application\ Support/ShadowsocksX-NG-R8
rm -rf ~/Library/LaunchAgents/com.qiuyuzhou.shadowsocksX-NG.http.plist
rm -rf ~/Library/LaunchAgents/com.qiuyuzhou.shadowsocksX-NG.local.plist
rm -rf ~/.ShadowsocksX-NG
rm -rf ~/Library/Preferences/com.qiuyuzhou.ShadowsocksX-NG.plist
rm -rf ~/Library/Caches/com.qiuyuzhou.ShadowsocksX-NG
```
如果提示权限不足，请sudo后执行
# ShadowsocksX-NG-R
Current version is 1.6.1
Continuesly release under 1.6.1
[](https://travis-ci.org/shadowsocksr/ShadowsocksX-NG)
[](https://www.python.org/downloads/)
[](https://github.com/MobSF/Mobile-Security-Framework-MobSF/)
[](https://www.gnu.org/licenses/gpl-3.0.html)
Next Generation of [ShadowsocksX](https://github.com/shadowsocks/shadowsocks-iOS) with SSR support.
**After Download Please check the GPG signature!**
First get [My pub key](https://github.com/qinyuhang/Pubkey) and [import the Pub key]()
`gpg --import pubkeys.txt`
Then [verify the signature](http://stackoverflow.com/questions/19011093/how-do-i-verify-a-gpg-signature-matches-a-public-key-file)
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.4+
- 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](http://nvie.com/posts/a-successful-git-branching-model/)
## TODO List
- [x] Embed the http proxy server [privoxy](http://www.privoxy.org/), [get it](https://homebrew.bintray.com/bottles/privoxy-3.0.26.sierra.bottle.tar.gz).
- [x] ACL mode support [Shadowsocks ACL](https://github.com/shadowsocksr/shadowsocksr-libev/tree/master/acl)
## Know Issue
Solved [Issue 1.]() Auto PAC & White list is not working on macOS 10.12 Serria because system proxy not allow [file:///](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.