Help

Shadowsocks for iOS

Shadowsocks is a cross-platform tunnel proxy which can help you get through firewalls.

This iOS version is for non-jailbroken devices. It has two features.

Please visit the App Store.

Shadowsocks works as a multi-tab web browser. It's really easy to use.

Tap the + button to open menu.
Tap Settings to configure Shadowsocks proxy settings.
Tap New Tab to open a new Tab. Tap URL field on the top to input URL.
Swipe a tab to scroll the tabs. Hold and press a tab to swap tabs.
If you've changed Proxy Mode, a restart is needed to take effect. (Kill the app, then open the app again).

Shadowsocks works as a background global PAC proxy, with some restrictions.

Only works with Wi-Fi network. But we are working on the cellular network.
Only works for a few minutes. Due to iOS restrictions, Shadowsocks can't keep running in the background. It's killed after you leave it for a while. To keep it running for an extended period of time, you have to come back to the Shadowsocks app every few minutes.
If you are an iOS developer, you can find some commented code in the source code, which keeps playing silence music in the background. Thus the app can keep running all the time. But this prevents us from getting approved on the App Store. You have to build the app for yourself, and use the app yourself.

So it's a little tricky to use global proxy.

Set up proxy settings in shadowsocks.
Copy this link http://127.0.0.1:8090/proxy.pac
Open iOS Settings -> Wi-Fi -> i icon on the right of your connected Wi-Fi -> HTTP Proxy. Choose Auto, paste the link in the URL field. Tap back.
Other apps now go through the proxy. If they don't, kill and restart them.
Come back every few minutes to keep Shadowsocks running in the background.

If you want to use your own server, you can set up a Shadowsocks server on your VPS.

You can choose one of the following servers:

You can find all available servers here.

Some FAQs are in the Troubleshooting page of the Wiki.

First, you have to update submodules:

git submodule update --recursive --init
open shadowsocks.xcodeproj

Then build with XCode.