نصب

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
Windows 7 SP1 یا جدیدتر، 32 بیتی (x86) Throne-<version>-windows32.zip

نصب‌کننده

نصب‌کنندهٔ universal بیلد مناسب رایانهٔ شما را انتخاب می‌کند و آن را بدون دسترسی مدیر (administrator) در %LOCALAPPDATA%\Throne نصب می‌کند. داده‌های شما در پوشهٔ config آن نگه داشته می‌شوند. اگر به‌جای آن Throne را برای همهٔ کاربران در Program Files نصب کنید، Throne داده‌های شما را در %LOCALAPPDATA%\Throne\config نگه می‌دارد و نمی‌تواند خودش را به‌روزرسانی کند.

برای حذف Throne، آن را از فهرست برنامه‌های نصب‌شده در Windows حذف کنید. برنامهٔ حذف می‌پرسد که آیا نمایه‌ها و تنظیمات شما هم پاک شوند یا نه.

ZIP قابل حمل

فایل ZIP را در پوشه‌ای استخراج کنید که بتوانید در آن فایل بنویسید و Throne.exe را از پوشهٔ Throne اجرا کنید. داده‌های شما در پوشهٔ config در کنار آن ذخیره می‌شوند، بنابراین می‌توانید کل پوشه را جابه‌جا کنید یا از آن پشتیبان بگیرید.

برخلاف نصب‌کننده، نسخهٔ ZIP تا وقتی گزینهٔ تنظیمات (Settings) ← تنظیمات پایه (Basic Settings) ← متداول (Common) ← Register throne:// links at startup را تیک نزنید، لینک‌های throne:// را باز نمی‌کند (فقط در حالت پیشرفته؛ حالت ساده و پیشرفته را ببینید).

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 استفاده کنید که این کار را برایتان انجام می‌دهد:

  1. فایل ZIP را استخراج کنید و پیش از اینکه Throne.app را برای نخستین بار باز کنید، آن را به /Applications منتقل کنید. اگر برنامه در ~/Downloads باشد، Throne ممکن است نتواند دسترسی‌های لازم برای حالت TUN را بگیرد.

  2. Throne با گواهی Apple امضا نشده است، بنابراین پرچم قرنطینه (quarantine) را حذف کنید؛ وگرنه macOS می‌گوید Throne «is damaged and can't be opened» (آسیب دیده است و باز نمی‌شود):

    xattr -d com.apple.quarantine /Applications/Throne.app
    
  3. 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 بسته‌های system-Qt، که مدیر بستهٔ شما آن‌ها را به‌روز نگه می‌دارد

فایل‌های ZIP، اسکریپت نصب و بسته‌های معمولی نسخهٔ خودشان از Qt را همراه دارند و به glibc 2.28 یا جدیدتر نیاز دارند: Debian 10، Ubuntu 20.04، RHEL 8 (و AlmaLinux یا Rocky Linux 8)، Raspberry Pi OS (64 بیتی) 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 را. برای به‌روزرسانی یا حذف، همین دستور را دوباره اجرا کنید. حذف، تنظیمات شما را در ~/.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 بسته‌های system-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 بسته‌های system-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 helper نصب کنید، برای مثال 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.

رابط کاربری را بسازید. فرایند ساخت به srslist.h، یعنی فهرست نام‌های مجموعه‌قوانین، در پوشهٔ build نیاز دارد:

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 آمده است.

به‌روزرسانی

نسخه‌های ZIP برای Windows و Linux و نصب مخصوص کاربر با نصب‌کنندهٔ Windows خودشان را به‌روزرسانی می‌کنند: برنامه (Program) ← بررسی به‌روزرسانی (Check For Update) و سپس به‌روزرسانی (Update). اگر یک Throne بدون رابط گرافیکی از همان نصب اجرا می‌شود، ابتدا آن را متوقف کنید. بقیهٔ نسخه‌ها را به همان روشی به‌روزرسانی کنید که نصب کرده‌اید: نصب‌کنندهٔ جدید را اجرا کنید، بستهٔ جدید را نصب کنید، اسکریپت نصب را دوباره اجرا کنید، در macOS Throne.app را جایگزین کنید، یا از مدیر بستهٔ خود استفاده کنید. نمایه‌ها و تنظیمات شما باقی می‌مانند.

پس از به‌روزرسانی در Linux یا macOS، Throne ممکن است دسترسی‌هایی را که برای حالت TUN لازم دارد دوباره درخواست کند. برای نسخه‌های بتا و پشتیبان‌گیری، پشتیبان‌گیری، به‌روزرسانی و مهاجرت را ببینید.

عیب‌یابی

اگر Throne پس از نصب اجرا نمی‌شود یا خطایی نشان می‌دهد، مشکلات اجرا و محیط دسکتاپ را ببینید. اگر آنتی‌ویروس شما Throne را خطرناک تشخیص می‌دهد، پرسش‌های متداول را ببینید.