Shadowsocks-Qt5

中文用户指南

Introduction

Shadowsocks-Qt5 is a fast, reliable and cross-platform GUI fronted for Shadowsocks.

Features

• Shadowsocks-Qt5 is written in C++/Qt5.
• Intuitive and native UI. This is not a clumsy Web App.
• Keep your favourite Shadowsocks port as backend if you want.
• Easy-to-use and highly customisable.
• The gui-config.json file is partially compatible with shadowsocks-gui. In order to serve better, some new values have been added.
• gui-config.json is located under ~/.config/shadowsocks on UNIX platforms, or under the main programme's directory in Windows.

Note

• By default, ss-qt5 works with libQtShadowsocks. While you can still use a shadowsocks backend such as [Shadowsocks-libev] ss-libev and [Shadowsocks-Python] ss-python.
• [Shadowsocks-Python] ss-python is highly recommended to serve as backend for better performance and stability.
• Don't be panic if you encounter a bug. Please feel free to open issues. Just remember to run from terminal or cmd and paste the output to the description of issue.

Installation

Windows

1. Download prebuilt binaries from releases.
2. Install/update your favourite shadowsocks backend. (You may want to download prebuilt ss-libev).

For those who want to build from source, follow the instructions below.

Open this project using Qt Creator and build it.

Or type the command in MSYS/MinGW.

qmake INSTALL_PREFIX=../ss-qt5
make
make install

You will get ss-qt5.exe and gui-config.json in ../ss-qt5 directory.

For 64-bit build, please use mingw-w64 toolchain (there are unofficial Qt builds using mingw-w64) and use the command below instead.

qmake INSTALL_PREFIX=../ss-qt5 DEFINES+="mingw64"
make
make install

Linux

We build ss-qt5 in a dynamically linking style on UNIX platfroms, which means there'll be some dependencies to be solved.

Dependencies

• qt5-qtbase >= 5.2
• qrencode (or libqrencode in Debian/Ubuntu)
• libQtShadowsocks (libqtshadowsocks in Debian/Ubuntu)
• botan = 1.10.x (libbotan1.10 in Debian/Ubuntu)

Fedora/Red Hat Enterprise Linux

The Copr build RPM for Fedora 20, 21, rawhide and RHEL6, RHEL7. If you're using other RHEL-based distributions such as CentOS, you can just use the EPEL repo in Copr.

You can enable the repo via dnf:

sudo dnf copr enable librehat/shadowsocks
sudo dnf update
sudo dnf install shadowsocks-qt5

You may need to install dnf plugins by below command before you can enable copr repo.

sudo dnf install dnf-plugins-core

If your distribution doesn't have dnf, you can download the corresponding yum repo from Copr and put it under /etc/yum.repos.d/, then install shadowsocks-qt5 via yum:

sudo yum update
sudo yum install shadowsocks-qt5

Debian

By running the command below, you'll get a deb package on upper directory.

dpkg-buildpackage -uc -us -b

Then, install it by sudo dpkg -i shadowsocks-qt5-<VER_ARCH_ETC>.deb.

Ubuntu

Make sure you're running at least Ubuntu 14.04.

sudo add-apt-repository ppa:hzwhuang/ss-qt5
sudo apt-get update
sudo apt-get install shadowsocks-qt5

Generic Linux

The development packages of qt5-qtbase, botan-1.10 (or libbotan1.10) and qrencode (or libqrencode) are required.

# Some distros use seperated qmake-qt4, qmake-qt5. Then, just run `qmake-qt5`. You can specify INSTALL_PREFIX=/usr/local if needed. default is /usr
qmake INSTALL_PREFIX=/usr
make
make install

Others

Other platforms are not tested and they're NOT supported officially. Well, I do hope you can help me mantain the compatibility if you have spare time.

LICENSE

Copyright © 20014-2015 Symeon Huang

This project is licensed under version 3 of the GNU Lesser General Public License.