Are you happy with your logging solution? Would you help us out by taking a 30-second survey? Click here


A cross-platform shadowsocks GUI client

Subscribe to updates I use shadowsocks-qt5

Statistics on shadowsocks-qt5

Number of watchers on Github 4324
Number of open issues 20
Average time to close an issue 9 days
Main language C++
Average time to merge a PR 1 day
Open pull requests 2+
Closed pull requests 5+
Last commit about 2 years ago
Repo Created almost 6 years ago
Repo Last Updated almost 2 years ago
Size 6.46 MB
Organization / Authorshadowsocks
Latest Releasev3.0.0
Page Updated
Do you use shadowsocks-qt5? Leave a review!
View open issues (20)
View shadowsocks-qt5 activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating shadowsocks-qt5 for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)


Build Status

Please check project's wiki for how-tos.


Shadowsocks-Qt5 is a native and cross-platform shadowsocks GUI client with advanced features.


  • Shadowsocks-Qt5 is written in C++ with Qt 5.
  • Support traffic statistics
  • Support server latency (lag) test
  • Use multiple profiles simultaneously
  • config.ini is located under ~/.config/shadowsocks-qt5/ on *nix platforms, or under the application's directory on Windows.


Copyright 2014-2017 Symeon Huang

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

shadowsocks-qt5 open issues Ask a question     (View All Issues)
  • over 3 years An invalid socket connection was rejected,Please make sure the connection type is SOCKS5
  • over 3 years Hash 校验和不符
  • over 3 years Ubuntu 16.04启动之后无法使用
  • over 3 years connection start failed on ubuntu
  • over 3 years 使用普通用户导入设置会卡死,只能kill掉进程重新启动。
  • over 3 years 编译错误
  • over 3 years Auto configuration of system Internet connection in Windows
  • over 3 years shadowsocks-libev+qt5+chrome+switchyomega,遇到问题
  • over 3 years linux版本打开就闪退,系统也没有托盘
  • over 3 years Crash when proxying battlefield 4 with ProxyCap on Windows 10 64bit RS1
  • over 3 years 希望能在右键菜单里多添加一些功能
  • over 3 years centos7 桌面环境是gnome-classic,有应用程序,但是无法点开
  • over 3 years 在ubuntu14.04上运行,过一段时间会导致整个系统卡死
  • over 3 years Add .appdata.xml
  • over 3 years Crashes on HTTP mode with BitTorrent on Windows 2008 R2
  • over 3 years qt5一次验证的问题
  • almost 4 years 按延迟排序的时候,建议把超时的放到最后
  • almost 4 years Win7 连接两个服务器sandboxie必崩溃bug
  • over 4 years 切换代理服务器时十分容易崩溃
  • over 4 years Customisable Toolbar
shadowsocks-qt5 open pull requests (View All Pulls)
  • Run lupdate to refresh ts files; update zh_CN translation
  • Optimize the connection steps
shadowsocks-qt5 questions on Stackoverflow (View All Questions)
  • Use shadowsocks qt5 in ubuntu can not connect
shadowsocks-qt5 list of languages used
shadowsocks-qt5 latest release notes
v3.0.0 v3.0.0

What's New

  1. Minimum requirement of libQtShadowsocks is bumped to 2.0.0, which brings Shadowsocks AEAD support (Botan-2 is required for this feature) and Shadowsocks SIP002 URI scheme support
  2. Log viewer is now removed due to the logging changes in libQtShadowsocks
  3. Application indicator is now removed (#522)
  4. CMake build system (#521)
  5. Other bugs fixed (#562 #577)
  6. You need a compiler that supports C++14 to build this project
  7. debian directory is removed from this repository and I will no longer maintain the Ubuntu PPA. All packaging is now up to communities except for Fedora Copr.

For any x86_64 Linux distributions, download AppImage file, run chmod a+x Shadowsocks-Qt5-3.0.0-x86_64.AppImage then you can enjoy shadowsocks-qt5 on your system by simply double clicking (or run it fro m terminal).

The AppImage is built on Debian Wheezy with custom built Qt 5.10, Botan 2.3.0, GCC 5.5


a9c885ff84c4f1dda2b1ffbb4a5ed636cbf9631b  Shadowsocks-Qt5-3.0.0-x86_64.AppImage
v2.9.0 v2.9.0
  1. Re-implemented single instance with QLocalSocket (easy recover from crashes)
  2. Start at login in general settings
  3. Updated Chinese translations to keep keyboard shortcuts available
  4. Fixed #500 #450

Starting from this release, all libraries used in building the Windows binaries are from MSYS2/MinGW64

ss-qt5-v2.9.0-win64.7z sha1sum: fec371532497cfbd2999c55c189875f91f1abd6c

An experimental AppImage is now provided for Linux users

Shadowsocks-Qt5-x86_64.AppImage sha1sum: 9eee6c05d79c6f3acf2d415cefa056df4b886a50 Shadowsocks-Qt5_botan2-x86_64.AppImage sha1sum: ca69f6d9a7612d2a88e3340c39d76d600e7df378

On any recent Linux distributions, download the AppImage file, then:

chmod a+x Shadowsocks-Qt5-x86_64.AppImage

That is it! Please open an issue if you are not able to run it. Once you've given it permission to execute, you can just double click it to run from file manager as well (just like exe on Windows).

Other projects in C++