Get Started
What Throne is, which systems it runs on, and where to begin.
What is Throne
Throne (formerly Nekoray) is a free, open-source (GPL-3.0) proxy client for Windows, Linux and macOS. Its core, ThroneCore, is based on sing-box and also runs Xray for the profiles that need it. You add servers, choose which traffic goes through them, and connect in system proxy or TUN mode.
- Throne for Android (formerly NekoBox for Android) uses the same core, settings and backup format, so you can move your setup between computer and phone.
- Headless Throne runs without a window on a server, a router or in a container, controlled with
thronectl. - 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.28 or newer, for example Debian 10, Ubuntu 20.04 or RHEL 8. The -system-qt packages need glibc 2.34 or newer. |
Portable ZIP, .deb, .rpm, install script, APT and RPM repositories, AUR |
| macOS | macOS 14.4 or newer (Apple Silicon and Intel). macOS 10.15 or newer with the legacy build (Intel). | ZIP, Homebrew |
| 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, AmneziaWG, NaïveProxy, OpenVPN, OpenConnect and DNS tunnels.
- Subscriptions that update on a schedule.
- System proxy, TUN mode and LAN sharing.
- Routing rules, with ready-made profiles for China, Iran and Russia.
- Latency and speed tests, and an Auto Selector that keeps you on a working server.
- Proxy chains and custom configs, anti-censorship options such as TLS fragment, and built-in Cloudflare WARP.
- A kill switch, and control with
thronectlfrom scripts and other devices. - A Simple mode for new users, and
Ctrl+Ksearch for commands and settings.
Where to start
- Install Throne: Installation.
- Add your servers and connect: Quick Start.
- Read the Guides for the features you need.
On Android, start with Throne for Android. If something does not work, see Troubleshooting and the FAQ.
Credits
Throne is built on sing-box, Xray-core, Qv2ray, Qt, simple-protobuf, fkYAML, quirc and SQLiteCpp.
To support Throne, click Support Throne in Program → About, or on the About screen of Throne for Android.