Qt based Desktop cross-platform GUI proxy utility, empowered by Sing-box

Supports Windows 11/10/8/7 / Linux / MacOS out of the box.

Now supporting headless mode, running as a service or in a container, controlled with thronectl: see Headless Throne.

If Throne is useful to you, you can support its development with crypto (USDT, USDC, TRX or Monero) or through GitHub Sponsors.

Apple platforms have a very strict security policy and since Throne does not have a signed certificate, you will have to remove the quarantine using xattr -d com.apple.quarantine /path/to/throne.app. Move Throne.app to /Applications before the first launch — the built-in privilege escalation opens Terminal to make the core setuid-root, and that step can fail while the app is still inside ~/Downloads. The Homebrew cask does both for you.

curl -fsSL https://raw.githubusercontent.com/throneproj/Throne/dev/script/install_linux.py | sudo python3

Every stable release is published to signed APT and RPM repositories (the system-Qt packages, x64 and ARM64) and to the AUR, so your package manager keeps Throne up to date. See the installation guide for details.

Debian / Ubuntu:

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSLo /etc/apt/keyrings/throne.asc https://throneproj.github.io/Throne/throne.asc
sudo curl -fsSLo /etc/apt/sources.list.d/throne.list https://throneproj.github.io/Throne/apt/throne.list
sudo apt update && sudo apt install throne

Fedora / RHEL 9+:

sudo curl -fsSLo /etc/yum.repos.d/throne.repo https://throneproj.github.io/Throne/rpm/throne.repo
sudo dnf install throne --refresh

openSUSE / SLES:

sudo zypper addrepo -fc https://throneproj.github.io/Throne/rpm/throne.repo
sudo zypper install throne

Arch Linux (AUR): yay -S throne or paru -S throne

Every stable release is also published to Throne's own Homebrew tap (macOS 14.4 or newer, Apple Silicon and Intel). The cask installs Throne.app to /Applications and removes the quarantine flag; update with brew upgrade --cask throne. See the installation guide for details.

brew install --cask throneproj/tap/throne

• SOCKS
• HTTP(S)
• Shadowsocks
• Trojan
• VMess
• VLESS
• TUIC
• Hysteria
• Hysteria2
• AnyTLS
• Mieru
• Snell
• NaïveProxy
• Juicity
• TrustTunnel
• ShadowTLS
• Wireguard
• AmneziaWG
• MASQUE
• SSH
• Xray VLESS
• OpenVPN/OpenConnect
• Custom Outbound (Both Sing-box and Xray)
• Custom Config (Both Sing-box and Xray)
• Chaining outbounds
• Extra Core

Various formats are supported, including share links, various JSON representation of Sing-box configs, and v2rayN link format as well as limited support for Shadowsocks and Clash formats.

Deeplinks are also supported, read the documentation for more information.

• SagerNet/sing-box
• XTLS/Xray-core
• Qv2ray
• Qt
• simple-protobuf
• fkYAML
• quirc
• srombauts/sqlitecpp

How does this project differ from the original Nekoray?
Nekoray's developer partially abandoned the project on December of 2023, some minor updates were done recently but the project is now officially archived. This project was meant to continue the way of the original project, with lots of improvements, tons of new features and also, removal of obsolete features and simplifications.

Why does my Anti-Virus detect Throne and/or its Core as malware?
Throne's built-in update functionallity downloads the new release, removes the old files and replaces them with the new ones, which is quite simliar to what malwares do, remove your files and replace them with an encrypted version of your files.

Is setting the SUID bit really needed on Linux?
To create and manage a system TUN interface, root access is required, without it, you will have to grant the Core some Cap_xxx_admin and still, need to enter your password 3 to 4 times per TUN activation. You can also opt to disable the automatic privilege escalation in Basic Settings->Security, but note that features that require root access will stop working unless you manually grant the needed permissions.

Why does my internet stop working after I force quit Throne?
If Throne is force-quit while System proxy is enabled, the process ends immediately and Throne cannot reset the proxy.
Solution:

• Always close Throne normally.
• If you force quit by accident, open Throne again, enable System proxy, then disable it- this will reset the settings.

Where are the downloadable route profiles/rulesets coming from?
They are located at the routeprofiles repository.

How does "Throne-<version>-debian-system-qt-x64.deb" differ from "Throne-<version>-debian-x64.deb" and why is the latter 3 times heavier then the former?
The first one does not pack the Qt libraries and relies on those installed on the host. The second one packs everything needed with itself, thus being heavier. The reason the first one exists is that on legacy systems provided Qt libraries use unsupported system features. If a graphical interface fails to load for your system, you may try to download the system-qt version and install fitting Qt libraries from your package manager or compile them from source.