Get Started
What Throne is, which systems it runs on, and where to begin.
This section explains what Throne is, which systems it supports, and which pages to read first. Start here if you are new to Throne.
What is Throne
Throne (formerly Nekoray) is a free, open-source (GPL-3.0) proxy client for Windows, Linux and macOS. It has a Qt graphical interface and uses ThroneCore, a core based on sing-box that also runs Xray for the profiles that need it. You add servers from your provider or from your own server, choose which traffic goes through them, and connect in system proxy mode or TUN mode.
Throne for Android (formerly NekoBox for Android) is the Android app. Since version 2.0.0 it uses the same core, the same settings model and the same backup format as the desktop app, so you can move your setup between your computer and your phone. See Throne for Android.
If you used Nekoray or NekoBox before, read Coming from Nekoray / NekoBox.
Platforms
| System | Requirements | Package types |
|---|---|---|
| Windows | Windows 10 1809 or newer (x64, ARM64). Windows 7 SP1 or newer with the legacy builds (x64, 32-bit x86). | Installer, portable ZIP |
| Linux | x64 or ARM64, glibc 2.34 or newer (2.38 for ARM64 builds that bundle Qt) | Portable ZIP, .deb, .rpm, install script |
| macOS | macOS 13 or newer (Apple Silicon and Intel). macOS 10.15 or newer with the legacy build (Intel). | ZIP |
| Android | Android 7.0 or newer | APK |
Get the files from Downloads.
Highlights
- Many protocols, including VLESS with REALITY and XHTTP, Shadowsocks, Trojan, Hysteria, TUIC, WireGuard and AmneziaWG, NaïveProxy, OpenVPN and OpenConnect: Protocols & Import Formats.
- Subscriptions that update on a schedule, with User-Agent and HWID settings for each group: Subscriptions & Groups.
- System proxy or TUN mode for all apps, and proxy sharing with other devices on your network: System Proxy, TUN & LAN sharing.
- Routing profiles with rules and rule-sets, and ready-made profiles for China, Iran and Russia: Routing.
- Latency, IP and speed tests, and an Auto Selector that keeps you on a working server: Testing & Auto Selector.
- Proxy chains and your own sing-box or Xray configs: Proxy Chains & Custom Configs.
- Anti-censorship options such as TLS fragment, uTLS and ECH: Anti-Censorship Presets.
- Built-in Cloudflare WARP: Cloudflare WARP.
- Backups that work in both the desktop and the Android app: Backup, Updates & Migration.
Where to start
- Install Throne: Installation.
- Add your servers and connect: Quick Start.
- Read the Guides for the features you need, such as subscriptions, routing and TUN mode.
On Android, start with Throne for Android. If something does not work, see Troubleshooting and the FAQ.
Credits
Throne is built on these projects:
- SagerNet/sing-box: the proxy engine of the core
- XTLS/Xray-core: the Xray engine
- Qv2ray: parts of the interface and the system proxy code
- Qt: the interface toolkit
- simple-protobuf: messages between the interface and the core
- fkYAML: Clash YAML import
- quirc: QR code reading
- QHotkey: global hotkeys
- srombauts/sqlitecpp: the profile and settings database