Установка
Установка Throne в Windows, macOS или Linux, обновление до новых версий и сборка из исходного кода.
Скачать файлы можно на странице загрузок. Об установке на Android см. Установка и обновление.
Windows
| Ваш компьютер | Файл |
|---|---|
| Любой компьютер с Windows, если вы не уверены | Throne-<version>-windows-universal-installer.exe |
| Windows 10 1809 или новее, x64 | Throne-<version>-windows64.zip |
| Windows на ARM64 | Throne-<version>-windows-arm64.zip |
| От Windows 7 SP1 до Windows 10 1803 (x64) или процессор без SSE4.2 | Throne-<version>-windowslegacy64.zip |
| 32-битная (x86) Windows 7 SP1 или новее | Throne-<version>-windows32.zip |
Установщик
Универсальный установщик сам выбирает подходящую для вашего компьютера сборку и устанавливает её в %LOCALAPPDATA%\Throne, без прав администратора. Ваши данные хранятся в её папке config. Если вместо этого установить Throne для всех пользователей в Program Files, Throne хранит ваши данные в %LOCALAPPDATA%\Throne\config и не может обновляться сам.
Чтобы удалить Throne, удалите его из списка установленных приложений Windows. Программа удаления спросит, удалить ли заодно ваши профили и настройки.
Портативный ZIP
Распакуйте ZIP-архив в папку, в которую у вас есть права на запись, и запустите Throne.exe из папки Throne. Ваши данные хранятся в папке config рядом с ним, поэтому всю папку можно перемещать или копировать целиком как резервную копию.
В отличие от установщика, копия из ZIP-архива открывает ссылки throne:// только после того, как вы отметите Настройки (Settings) → Основные настройки (Basic Settings) → Общие (Common) → Регистрировать обработчик ссылок throne:// при запуске (Register throne:// links at startup) (только в расширенном режиме, см. Простой и расширенный режим).
macOS
| Ваш Mac | Файл |
|---|---|
| Apple Silicon, macOS 14.4 или новее | Throne-<version>-macos-arm64.zip |
| Intel, macOS 14.4 или новее | Throne-<version>-macos-amd64.zip |
| Intel, macOS с 10.15 по 14.3 | Throne-<version>-macoslegacy-amd64.zip |
Установите ZIP-архив так, или используйте Homebrew, который сделает это за вас:
-
Распакуйте ZIP-архив и переместите
Throne.appв/Applicationsдо первого запуска. Из~/DownloadsThrone может не получить права, нужные для режима TUN. -
Throne не подписан Apple, поэтому снимите флаг карантина, иначе macOS сообщит, что Throne «is damaged and can't be opened» (повреждён, и его не удаётся открыть):
xattr -d com.apple.quarantine /Applications/Throne.app -
Откройте Throne.
Ваши данные хранятся в папке пользователя, поэтому Throne.app можно заменить без потери профилей. Для режима TUN нужна учётная запись администратора; см. Режим TUN.
Linux
| Файл | Для чего подходит |
|---|---|
| Установочный скрипт | Любой дистрибутив. Устанавливает ZIP-сборку в /opt/Throne. |
Throne-<version>-linux-amd64.zip, …-linux-arm64.zip |
Портативная копия в папке на ваш выбор |
Throne-<version>-debian-amd64.deb, …-debian-arm64.deb |
Debian, Ubuntu, Linux Mint и другие системы на основе Debian |
Throne-<version>-fedora-amd64.rpm, …-fedora-arm64.rpm |
Fedora и системы на основе RHEL |
Файлы, имена которых заканчиваются на -system-qt.deb или -system-qt.rpm |
Те же пакеты, но с Qt вашей системы |
| APT-репозиторий и RPM-репозиторий | Пакеты с системным Qt, которые поддерживает в актуальном состоянии ваш менеджер пакетов |
ZIP-файлы, установочный скрипт и обычные пакеты содержат собственную копию Qt, и им нужна glibc 2.28 или новее: Debian 10, Ubuntu 20.04, RHEL 8 (а также AlmaLinux и Rocky Linux 8), Raspberry Pi OS (64-bit) bullseye или новее. Пакеты -system-qt используют Qt 6 вашего дистрибутива, и им нужна glibc 2.34 или новее, например в Debian 12 или Ubuntu 22.04. Используйте их, если обычный пакет не запускается, например на старом процессоре, или если вы хотите, чтобы Throne использовал тему Qt вашего рабочего стола.
Установочный скрипт
Скрипту нужен Python 3:
curl -fsSL https://raw.githubusercontent.com/throneproj/Throne/dev/script/install_linux.py | sudo python3
Выберите Install и ветку (Stable или Unstable) либо Uninstall. Чтобы обновить или удалить Throne, запустите ту же команду ещё раз. При удалении ваши настройки в ~/.config/Throne сохраняются.
Портативный ZIP
unzip Throne-x.x.x-linux-amd64.zip
cd Throne
./Throne
Ваши данные хранятся в папке config внутри Throne.
Debian и Ubuntu (.deb)
sudo apt install ./Throne-x.x.x-debian-amd64.deb
Fedora и RHEL (.rpm)
sudo dnf install ./Throne-x.x.x-fedora-amd64.rpm
Оба пакета устанавливают Throne в /opt/Throne и хранят ваши данные в ~/.config/Throne. Чтобы получать обновления через менеджер пакетов, используйте вместо этого репозиторий.
APT-репозиторий
Подписанный APT-репозиторий содержит пакеты с системным Qt для каждого стабильного релиза, для amd64 и arm64. Ему нужен Debian 12, Ubuntu 22.04 или новее; в более старых системах используйте обычный .deb.
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
После этого sudo apt upgrade обновляет и Throne.
RPM-репозиторий
Подписанный RPM-репозиторий содержит пакеты с системным Qt для каждого стабильного релиза, для x86_64 и aarch64. Им нужны Qt 6.5 и glibc 2.34 или новее, поэтому в RHEL 8 и его пересборках используйте обычный .rpm.
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
При первом использовании dnf и zypper просят подтвердить доверие к ключу подписи.
Менеджеры пакетов
WinGet
winget install -e --id Throneproj.Throne
Scoop
scoop bucket add extras
scoop install extras/throne
Homebrew
brew install --cask throneproj/tap/throne
В официальный tap попадает каждый стабильный релиз. Cask устанавливает Throne.app в /Applications, снимает флаг карантина и требует macOS 14.4 или новее; на старых Mac с Intel используйте ZIP-архив macoslegacy. Всегда указывайте полное имя: brew install --cask throne не находит Throne.
Обновляйте Throne командой brew upgrade --cask throne; после этого Throne снова запрашивает права, нужные для режима TUN. brew uninstall --zap --cask throne также удаляет ваши данные в ~/Library/Preferences/Throne.
Arch Linux (AUR)
Установите throne с помощью AUR-помощника, например yay -S throne или paru -S throne. Пакет собирает Throne из исходного кода, устанавливает его в /usr/lib/throne и обновляется с каждым стабильным релизом. Ваши данные хранятся в ~/.config/Throne.
Nix
В NixOS добавьте это в конфигурацию:
programs.throne = {
enable = true;
tunMode.enable = true; # optional, needed for TUN mode
};
Или установите его через nix-env. В NixOS канал обычно называется nixos, в других дистрибутивах — nixpkgs:
nix-env -iA nixos.throne
Чтобы попробовать Throne без установки, выполните nix-shell -p throne.
Сборка из исходного кода
Throne состоит из двух частей: интерфейса (Throne, C++ и Qt) и ядра (ThroneCore, Go). Ядро должно лежать рядом с исполняемым файлом Throne.
| Часть | Требования |
|---|---|
| Интерфейс | CMake 3.20 или новее, компилятор C++20, Qt 6.2 или новее (Widgets, Network, LinguistTools, а в Linux также DBus), заголовочные файлы X11 и xcb для разработки в Linux |
| Ядро | Go 1.26 или новее, protoc, protoc-gen-go и protoc-gen-go-grpc. CGO: в Linux — набор инструментов Chromium из cronet-go (для NaïveProxy), в macOS — инструменты командной строки Xcode. |
Соберите интерфейс. Для сборки в папке build нужен файл srslist.h — список имён наборов правил:
git clone https://github.com/throneproj/Throne.git ~/Throne
cd ~/Throne
mkdir build
cd build
curl -fLso srslist.h https://raw.githubusercontent.com/throneproj/routeprofiles/rule-set/srslist.h
cmake -GNinja -DCMAKE_BUILD_TYPE=Release ..
ninja
Затем соберите ядро скриптом script/build_go.sh и скопируйте его в папку с интерфейсом. В Linux сначала настройте набор инструментов cronet-go в том же терминале. build_go.sh удаляет папку DEST перед сборкой, поэтому укажите для неё отдельную папку:
cd ~/Throne
GOOS=linux GOARCH=amd64 DEST="$PWD/deployment/linux-amd64" ./script/build_go.sh
cp deployment/linux-amd64/ThroneCore build/
В macOS добавьте -DNKR_PACKAGE_MACOS=1 к команде cmake, соберите ядро с GOOS=darwin и скопируйте ThroneCore в Throne.app/Contents/MacOS/. Точные шаги для всех платформ, включая набор инструментов cronet-go, версии плагинов protobuf, Windows и legacy-сборки, описаны в .github/workflows/build.yml в репозитории Throne.
Обновление
Копии для Windows и Linux из ZIP-архива и установка через установщик Windows для текущего пользователя обновляются сами: Программа (Program) → Проверить наличие обновлений (Check For Update), затем Обновить (Update). Если из той же установки работает headless Throne, сначала остановите его. Все остальные копии обновляйте тем же способом, которым устанавливали: запустите новый установщик, установите новый пакет, снова запустите установочный скрипт, замените Throne.app в macOS или воспользуйтесь менеджером пакетов. Ваши профили и настройки сохраняются.
После обновления в Linux или macOS Throne может снова запросить права, необходимые для режима TUN. Бета-версии и резервное копирование описаны на странице Резервное копирование, обновление и перенос.
Устранение неполадок
Если после установки Throne не запускается или показывает ошибку, см. Проблемы с запуском и рабочим окружением. Если антивирус помечает Throne, см. FAQ.