v1.3.2

Установка

Установка Throne в Windows, macOS или Linux, обновление до новых версий и сборка из исходного кода.

На этой странице описано, как установить 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

Установщик

Универсальный установщик — самый простой вариант:

  • Он устанавливает Throne для вашей учётной записи в %LOCALAPPDATA%\Throne. Права администратора не нужны.
  • Он сам выбирает подходящую для вашего компьютера сборку: x64, ARM64 или 32-битную. В x64-версиях Windows, выпущенных до Windows 10 1809, он устанавливает legacy-сборку.
  • Он добавляет Throne в меню «Пуск» и на рабочий стол.
  • Установленный Throne при каждом запуске регистрирует ссылки throne://, поэтому такие ссылки открываются в Throne. См. Глубокие ссылки.

Throne хранит ваши профили и настройки в папке config внутри папки установки. Если вы устанавливали Throne старым установщиком (до 1.3.0), новый установщик использует ту же папку и сохраняет ваши данные.

Программа установки может также установить Throne для всех пользователей — в Program Files. Для этого нужны права администратора. Throne не может записывать в Program Files, поэтому хранит ваши данные в %LOCALAPPDATA%\Throne\config, а обновление в один щелчок недоступно.

Чтобы удалить Throne, удалите его из списка установленных приложений Windows. Программа удаления спросит, удалить ли заодно ваши профили, настройки и логи. Она также удаляет регистрацию ссылок throne://.

Портативный ZIP

  1. Скачайте ZIP-архив для вашей системы (см. таблицу выше).
  2. Распакуйте его в папку, в которую у вас есть права на запись, например в папку внутри вашего профиля пользователя.
  3. Откройте папку Throne и запустите Throne.exe.

Храните все файлы этой папки вместе. Throne сохраняет ваши данные в папке config рядом с Throne.exe, поэтому всю папку можно перемещать или копировать целиком как резервную копию. Если Throne не может записывать в свою папку, он использует %LOCALAPPDATA%\Throne\config.

Копии из ZIP-архива по умолчанию не регистрируют ссылки throne://. Чтобы включить регистрацию, отметьте Настройки (Settings) → Основные настройки (Basic Settings) → Общие (Common) → Зарегистрировать ссылки throne:// при запуске (Register throne:// links at startup).

macOS

Ваш Mac Файл
Apple Silicon, macOS 13 или новее Throne-<version>-macos-arm64.zip
Intel, macOS 13 или новее Throne-<version>-macos-amd64.zip
Intel, macOS с 10.15 по 12 Throne-<version>-macoslegacy-amd64.zip

  1. Скачайте ZIP-архив и распакуйте его. Внутри находится папка Throne с Throne.app.

  2. Переместите Throne.app в /Applications до первого запуска. Для режима TUN Throne выдаёт своему ядру права root через Терминал, и это может не сработать, пока приложение находится в ~/Downloads.

  3. Throne не подписан сертификатом Apple, поэтому снимите с него флаг карантина в Терминале. Без этого шага macOS сообщает, что Throne «is damaged and can't be opened» (повреждён, и его не удаётся открыть).

    xattr -d com.apple.quarantine /Applications/Throne.app

  4. Откройте Throne.

Throne хранит ваши данные в папке пользователя, а не внутри Throne.app, поэтому приложение можно заменить без потери профилей. Эту папку показывает пункт Настройки (Settings) → Открыть папку конфигурации (Open Config Folder). Для режима 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 (начиная с 1.3.0)
Файлы, имена которых заканчиваются на -system-qt.deb или -system-qt.rpm Те же пакеты, но они используют библиотеки Qt вашей системы

Сборкам для Linux нужна glibc 2.34 или новее. Файлам для ARM64 со встроенным Qt нужна glibc 2.38 или новее.

Установочный скрипт

Скрипт скачивает сборку для вашего процессора, устанавливает её в /opt/Throne и добавляет Throne в меню приложений. Ему нужны Python 3 и права root:

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

Скрипт показывает последние стабильную и нестабильную версии, а также установленную версию, если она есть. Выберите Install или Uninstall. Для Install выберите также ветку: Stable или Unstable.

Чтобы обновить или удалить Throne, запустите ту же команду ещё раз. При удалении стираются /opt/Throne и пункт меню, но ваши настройки в ~/.config/Throne сохраняются.

Портативный ZIP

ZIP-архив содержит папку Throne. Throne хранит ваши данные в папке config внутри неё.

unzip Throne-x.x.x-linux-amd64.zip
cd Throne
./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 и добавляют его в меню приложений. В этом случае Throne хранит ваши данные в ~/.config/Throne.

Пакеты с системным Qt

Qt — это инструментарий, на котором построено окно Throne. Обычные пакеты содержат собственную копию Qt. Пакеты -system-qt вместо этого используют библиотеки Qt 6 вашего дистрибутива, и менеджер пакетов устанавливает их как зависимости. Используйте пакет с системным Qt, если обычный пакет не запускается, например потому что ваш процессор слишком старый (см. Устранение неполадок), или если вы хотите, чтобы Throne использовал тему Qt вашего рабочего стола. См. также FAQ.

Менеджеры пакетов

WinGet

winget install -e --id Throneproj.Throne

Scoop

scoop bucket add extras
scoop install extras/throne

Fedora, RHEL и openSUSE

RPM-репозиторий parhelia512.github.io ведёт parhelia512, участник организации throneproj на GitHub; ссылка на этот репозиторий есть в README Throne. Он существует отдельно от файлов релизов. Официальные файлы .rpm прикладываются к каждому релизу начиная с 1.3.0.

Fedora и RHEL 9 или новее:

sudo curl -o /etc/yum.repos.d/throne.repo https://parhelia512.github.io/throne.repo
sudo dnf install -y throne --refresh

openSUSE и SLES:

sudo zypper addrepo -fc https://parhelia512.github.io/throne-sle.repo
sudo zypper install -y throne

Для RHEL 8 выполните шаги, описанные на странице репозитория.

Arch Linux (AUR)

Throne есть в Arch User Repository под именем throne. Установите его с помощью AUR-помощника, например yay -S throne или paru -S throne.

NixOS

Добавьте это в конфигурацию NixOS:

programs.throne = {
  enable = true;
  tunMode.enable = true; # optional, needed for TUN mode
};

Nix

В NixOS канал обычно называется nixos:

nix-env -iA nixos.throne

В других дистрибутивах канал обычно называется nixpkgs, поэтому используйте nixpkgs.throne. Чтобы попробовать Throne без установки, выполните nix-shell -p throne.

Сборка из исходного кода

Throne состоит из двух частей, которые собираются отдельно: интерфейса (Throne, написан на C++ с Qt) и ядра (ThroneCore, написано на Go). Без ядра интерфейс не может подключаться, поэтому ядро должно лежать рядом с исполняемым файлом Throne. В репозитории нет подмодулей Git, поэтому достаточно обычного git clone.

Часть Требования
Интерфейс CMake 3.20 или новее, компилятор C++20, Qt 6.2 или новее (Widgets, Network, LinguistTools, а в Linux также DBus), заголовочные файлы X11 для разработки в Linux
Ядро Go 1.26 или новее, protoc, protoc-gen-go и protoc-gen-go-grpc. CGO в Linux и macOS: в Linux — набор инструментов Chromium из cronet-go (он нужен для outbound NaïveProxy), в macOS — инструменты командной строки Xcode.

Пример для Ubuntu 22.04 или новее на x64:

  1. Установите инструменты сборки и Qt:

    sudo apt update
sudo apt install build-essential cmake ninja-build git curl protobuf-compiler libx11-dev \
  qt6-base-dev qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools libqt6svg6-dev \
  qt6-translations-l10n libglx-dev libgl1-mesa-dev

  2. Установите Go 1.26 или новее с go.dev/dl. В большинстве дистрибутивов пакеты Go более старые.

  3. Соберите интерфейс. Для сборки в папке 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

  4. Установите плагины protobuf тех версий, которые используют официальные сборки, и добавьте папку bin из Go в PATH:

    go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.36.12
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.6.2
export PATH="$PATH:$(go env GOPATH)/bin"

  5. Скачайте набор инструментов Chromium. Замените <commit> на коммит cronet-go, который извлекается на шаге Clone cronet-go в .github/workflows/build.yml:

    git clone https://github.com/throneproj/cronet-go.git ~/cronet-go
cd ~/cronet-go
git checkout <commit>
git submodule update --init --recursive --depth=1
go run ./cmd/build-naive --target=linux/amd64 download-toolchain
eval "$(go run ./cmd/build-naive --target=linux/amd64 env --export)"

    Последняя команда задаёт CC, CXX и CGO_LDFLAGS только для текущего терминала. Выполните следующий шаг в том же терминале.

  6. Соберите ядро и скопируйте его в папку с интерфейсом. 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/

  7. Запустите Throne командой ./build/Throne.

Для ARM64 используйте --target=linux/arm64 и GOARCH=arm64.

  • macOS: добавьте -DNKR_PACKAGE_MACOS=1 к команде cmake — так собирается Throne.app. Соберите ядро с GOOS=darwin и скопируйте ThroneCore в Throne.app/Contents/MacOS/.
  • Windows: в официальных сборках интерфейс компилируется с помощью MSVC и Ninja, а ядро кросс-компилируется в Linux с GOOS=windows (для Windows скрипт отключает CGO). Скопируйте ThroneCore.exe и libcronet.dll из папки DEST в папку с Throne.exe.

Точные шаги официальных сборок описаны в .github/workflows/build.yml в репозитории Throne.

Обновление

Копии из ZIP-архива и установка через установщик Windows для текущего пользователя (вариант по умолчанию) умеют обновляться сами: нажмите Утилиты (Tools) → Проверить наличие обновлений (Check For Update), затем Обновление (Update). Все остальные копии обновляйте тем же способом, которым устанавливали: запустите новый установщик, установите новый пакет .deb или .rpm, снова запустите установочный скрипт, замените Throne.app в macOS или воспользуйтесь менеджером пакетов. Ваши профили и настройки сохраняются.

Подробности, бета-версии и резервное копирование описаны на странице Резервное копирование, обновление и перенос. После обновления в Linux или macOS Throne может снова запросить права, необходимые для режима TUN.

Устранение неполадок

  • Предупреждение антивируса. Некоторые антивирусы помечают Throne или ThroneCore как опасные — в основном потому, что программа обновления скачивает и заменяет файлы программы. См. FAQ.
  • Throne не запускается и сообщает «Incompatible processor. This Qt build requires the following features: sse4.2 popcnt» (несовместимый процессор). Ваш процессор слишком стар для встроенного Qt. В Windows используйте windowslegacy64.zip. В Linux используйте пакет -system-qt. См. также FAQ.
  • Linux: Throne сообщает, что не может загрузить плагин платформы Qt «xcb». Установите libxcb-cursor0 (Debian, Ubuntu) или xcb-util-cursor (Fedora, RHEL) либо используйте пакет -system-qt.
  • Linux с GNOME: нет значка в трее. Установите для GNOME расширение AppIndicator.
  • macOS: «Throne is damaged and can't be opened» (Throne повреждён, и его не удаётся открыть). Флаг карантина всё ещё установлен. Выполните команду xattr из инструкции для macOS.

О проблемах, возникающих после установки, см. Устранение неполадок.