Feb 21, 2018 The utility runs a SOCKS5 proxy on your Mac, and allows you to make sure your traffic is protected. Shadowsocks client that can help you route and secure your traffic. To conclude, if you are looking for a flexible solution to route traffic through and encrypted proxy server, without having to deal with very complex tools.
Document your code
Every project on GitHub comes with a version-controlled wiki to give your documentation the high level of care it deserves. It’s easy to create well-maintained, Markdown or rich text documentation alongside your code.
Sign up for free See pricing for teams and enterprises Shadowsocks GUI designed for OS X 10.8+, automatically configuring system proxy settings, with a GFWList PAC.
中文帮助Download
Basic Usage
- Open dmg file and move ShadowsocksX to Applications. Open it.
- If any security prompt come out, please select Allow.
- Shadowsocks will automatically configure the global system proxy settings.
- Close any other proxy or VPN program. If you are using SwitchySharp, please set its mode to Use System Proxy Settings.
- You can find Shadowsocks icon on the right side of the menu bar.
Advanced
- If you'd rather use SwitchySharp than a global PAC proxy, you can turn global proxy off in the menu bar icon. Shadowsocks will still be running at
127.0.0.1:1080
. - You can use your own server instead of the public server. The server preferences are also in the menu bar icon.
- You may need to restart Chrome after you choose another server.
- You can check the logs in the Console.app. Logs beginning with
ShadowsocksX:
are the logs of Shadowsocks.
Clone this wiki locally
Current version is 2.23
It's based on the old Shadowsocks software developed by clowindy,written in objc.
Requirements
Running
- macOS X 10.8+ (Mountain Lion and later versions)
Building
- Xcode 9.0.1+
Download
Mac Version:
--Download From Website: Shadowsocks X v2.23
--Download From Github: https://github.com/yangfeicheung/Shadowsocks-X/releases/
Windows Version:
--Download From Website: Shadowsocks for Windows v4.17
How to use
- Download the zip file and unzip,put the ShadowsocksX.app under Applications folder.
- Choose one server,if there's none,add one or buy one.
- Choose Auto Mode and you can acess prohibited sites like google.com now, for Oversea students(not in mainland China),you can use Oversea Mode,and choose a server in china,then you can access chinese sites without restriction of ip.
Modes Introduction
There are total four modes in this app:
- Auto Mode: all sites in GFW List would be accessed via ss server,while the rest accessed directly.You can also add customed sites to Custom Rules so they can be accessed via ss server as well.
- Global Mode: all sites are accessed via ss server.
- Oversea Mode: if you are oversea(outside China mainland) and want to access sites within China,use this mode together with a server located in China,all chinese ip would be access via ss server(which as we mentioned,a server located in china),thus you can access services like QQ Music,Youku etc without any restriction.
- Blacklist Mode: all sites are accessed via ss server, except those in Custom Rules, this rule file is a different one from Auto Mode.
Features
- Supports High Availability Mode, app could automatically choose the best server for you.
- Supports two more modes: Oversea Mode & Blacklist Mode(which some also calls Whitelist Mode)
- Supports Ping Servers Service.
- Supports Http Proxy(polipo),it's integrated into this app,you don't have to install anything,no command line needed.
- Block AD function lets you block those annoying ads when surfing online.
- Could update GFW List by download GFW List from GitHub.
- Shows QRCode for current active server.
- Scans QRCode from screen.
- Supports Launch At Login.
- Users can customize their own rules.
- Support for AEAD Ciphers
- Supports KCP kcptun.
- Import and export servers list from and to json file
Difference from original Shadowsocks-X
- Block AD function is added
- Two more Modes: Oversea Modes & Blacklist Modes
- Supports Kcptun
- Embedded with a http proxy
- Ping Servers Service
- Bypass proxy settings for customized hosts & domains under Preferences Panel
License
The project is released under the terms of the GPLv3.