Throne manages proxy profiles and subscriptions, routes traffic with rule-based routing profiles, and works either as a system proxy or as a Tun VPN. It also runs headless, as a service or in a container, controlled with thronectl: see Headless Throne.

Installation

Portable ZIPs and installers for every platform are on GitHub Releases. The installation guide covers the rest, including the Linux install script, the APT and RPM repositories, the AUR and the other package managers.

macOS

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 (macOS 14.4 or newer, Apple Silicon and Intel) does both for you; update with brew upgrade --cask throne.

brew install --cask throneproj/tap/throne

Supported protocols

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

Subscription Formats

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.

Credits

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

Supporting Throne

If Throne is useful to you, you can support its development through GitHub Sponsors or with a crypto donation to one of these addresses:

Coin	Network	Address
USDT · TRX	TRON (TRC20)	THR2gbWMaTZh8ACk3VYAAyNRVffvdTRikj
USDT · USDC	BNB Smart Chain (BEP20) · Ethereum (ERC20)	0x7c2dF1867f5AaEE807a835fB3c55E4de4507888A
XMR	Monero	4AYwwN8qMQCSUb3XfwzfrLNPMHfDme6U7CmNtQY4idCF8GtHHLG68VA3iZK867ypuKFr8J7CjXiJ96eFUA2T6aLVRUbgY3A