Skip to content

Commit f3e5f88

Browse files
parhelia512parhelia512
authored
Merge pull request #4 from ionnixf/docs-installation-improvement
Update and synchronize installation guides (EN/RU)
2 parents 3afbcba + a62a091 commit f3e5f88

2 files changed

Lines changed: 168 additions & 74 deletions

File tree

‎content/get_started/installation/index.md‎

Lines changed: 81 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -13,24 +13,26 @@ Throne supports Windows, Linux, and macOS. Choose the appropriate installation m
1313

1414
Go to [GitHub Releases](https://github.com/throneproj/Throne/releases/latest) and download the file for your platform.
1515

16-
### Version matrix
17-
18-
Platform | Architecture | Minimum Version | File Suffix
19-
-- | -- | -- | --
20-
Windows | x64 | Windows 10 | windows64-installer.exe
21-
Windows | x64 | Windows 10 | windows64.zip
22-
Windows | ARM64 | Windows 10 | windows-arm64.zip
23-
Windows | x64 | Windows 7 SP1 | windowslegacy64.zip
24-
Windows | x86 | Windows 7 SP1 | windows32.zip
25-
Linux | x64 | GLIBC 2.34 | linux-amd64.zip
26-
Linux | x64 | GLIBC 2.34 | debian-amd64.deb
27-
Linux | x64 | GLIBC 2.34 | debian-amd64-system-qt.deb
28-
Linux | ARM64 | GLIBC 2.38 | linux-arm64.zip
29-
Linux | ARM64 | GLIBC 2.38 | debian-arm64.deb
30-
Linux | ARM64 | GLIBC 2.34 | debian-arm64-system-qt.deb
31-
macOS | ARM64 | macOS 13 | macos-arm64.zip
32-
macOS | x64 | macOS 13 | macos-amd64.zip
33-
macOS | x64 | macOS 10.15 | macoslegacy-amd64.zip
16+
### Version Matrix
17+
18+
| Platform | Architecture | Package Type / Distro | Min. Version | File Suffix |
19+
| :--- | :--- | :--- | :--- | :--- |
20+
| **Windows** | x64 | Installer | Windows 10 | `windows64-installer.exe` |
21+
| | x64 | Portable (ZIP) | Windows 10 | `windows64.zip` |
22+
| | ARM64 | Portable (ZIP) | Windows 10 | `windows-arm64.zip` |
23+
| | x64 | Legacy (Win 7/8) | Windows 7 SP1 | `windowslegacy64.zip` |
24+
| | x86 | Legacy (32-bit) | Windows 7 SP1 | `windows32.zip` |
25+
| |
26+
| **Linux** | x64 | **Generic** (Binary) | GLIBC 2.34 | `linux-amd64.zip` |
27+
| | x64 | **Debian / Ubuntu** | GLIBC 2.34 | `debian-amd64.deb` |
28+
| | x64 | **Debian / Ubuntu** (System Qt) | GLIBC 2.34 | `debian-amd64-system-qt.deb` |
29+
| | ARM64 | **Generic** (Binary) | GLIBC 2.38 | `linux-arm64.zip` |
30+
| | ARM64 | **Debian / Ubuntu** | GLIBC 2.38 | `debian-arm64.deb` |
31+
| | ARM64 | **Debian / Ubuntu** (System Qt) | GLIBC 2.34 | `debian-arm64-system-qt.deb` |
32+
| |
33+
| **macOS** | ARM64 | Apple Silicon | macOS 13 | `macos-arm64.zip` |
34+
| | x64 | Intel | macOS 13 | `macos-amd64.zip` |
35+
| | x64 | Legacy (Intel) | macOS 10.15 | `macoslegacy-amd64.zip` |
3436

3537
### Windows
3638

@@ -42,8 +44,24 @@ Extract the ZIP file and run `Throne.exe`.
4244

4345
Run `Throne-x.x.x-windows64-installer.exe`.
4446

47+
#### Scoop/WinGet
48+
49+
You can also install Throne on Windows using [Scoop](https://scoop.sh/#/apps?id=b77aee518a6b60c7a582cc24dfb3269c93f697c6&q=throne) or [WinGet](https://winstall.app/apps/Throneproj.Throne).
50+
51+
### macOS
52+
53+
Extract the ZIP file. Due to Apple's strict security policy, you must remove the quarantine attribute:
54+
55+
```bash
56+
xattr -d com.apple.quarantine /path/to/Throne.app
57+
```
58+
59+
To enable built-in privilege escalation, grant `Throne` (or `Terminal` if running from CLI) Full Disk Access in `System Settings` → `Privacy & Security` → `Full Disk Access`.
60+
4561
### Linux
4662

63+
Throne provides several ways to install depending on your distribution.
64+
4765
#### Portable (ZIP)
4866

4967
Download the ZIP package:
@@ -56,35 +74,64 @@ unzip Throne-x.x.x-linux-*.zip
5674
#### Debian/Ubuntu (.deb)
5775

5876
```bash
59-
sudo dpkg -i Throne-x.x.x-debian-*.deb
77+
sudo apt install ./Throne-x.x.x-debian-*.deb
6078
```
6179

62-
The `-system-qt` version does not bundle Qt libraries and relies on system-installed ones. If the GUI fails to load, try the system-qt version.
80+
Note: The -system-qt version does not bundle Qt libraries and relies on system-installed ones. Use this version if you encounter theme conflicts or if the standard GUI fails to load.
6381

64-
### macOS
82+
### Fedora/RHEL9+
6583

66-
Extract the ZIP file. Due to Apple's strict security policy, you must remove the quarantine attribute:
84+
```bash
85+
sudo curl -o /etc/yum.repos.d/throne.repo https://parhelia512.github.io/throne.repo
86+
sudo dnf install -y throne --refresh
87+
```
88+
For older RHEL versions, visit the [Throne RPM repository](https://parhelia512.github.io/).
6789

90+
### openSUSE/SLES
6891
```bash
69-
xattr -d com.apple.quarantine /path/to/Throne.app
92+
sudo zypper addrepo -fc https://parhelia512.github.io/throne-sle.repo
93+
sudo zypper install -y throne
7094
```
7195

72-
To enable built-in privilege escalation, grant `Terminal` Full Disk Access in `System Preferences` → `Security & Privacy` → `Privacy` → `Full Disk Access`.
96+
### Arch Linux (AUR)
7397

74-
## Package managers
98+
Throne is available in the **Arch User Repository** as `throne-bin`. You can install it using your favourite AUR helper.
7599

76-
Distro | Repository
77-
-- | --
78-
Fedora/RHEL | [Throne RPM repository](https://parhelia512.github.io/)
79-
Fedora/RHEL | [Terra](https://github.com/terrapkg/packages/tree/frawhide/anda/apps/throne)
80-
openSUSE/SLES | [Throne RPM repository](https://parhelia512.github.io/)
81-
Arch Linux | [AUR](https://aur.archlinux.org/packages/throne-bin)
82-
Any distro | [Nix](https://search.nixos.org/packages?channel=unstable&show=throne)
83-
Windows | [Scoop](https://scoop.sh/#/apps?id=b77aee518a6b60c7a582cc24dfb3269c93f697c6&q=throne)
84-
Windows | [WinGet](https://winstall.app/apps/Throneproj.Throne)
100+
```bash
101+
# If you use yay
102+
yay -S throne-bin
103+
104+
# If you use paru
105+
paru -S throne-bin
106+
```
107+
108+
#### NixOS
109+
110+
Add the following Nix code to your NixOS Configuration.
111+
112+
```nix
113+
programs.throne = {
114+
enable = true;
115+
# tunMode.enable = true; Add this line to enable tun mode
116+
};
117+
```
118+
119+
### Nix
120+
121+
You can also install Throne using the Nix package manager on any supported distribution.
122+
123+
```bash
124+
nix-env -iA nixos.throne
125+
```
126+
Or you can use nix-shell to try it out without installing.
127+
```bash
128+
nix-shell -p throne
129+
```
85130

86131
## Build from source
87132

133+
You also have an option to build Throne from source.
134+
88135
```bash
89136
git clone --recursive https://github.com/throneproj/Throne.git
90137
cd Throne

‎content/get_started/installation/index.ru.md‎

Lines changed: 87 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -11,40 +11,58 @@ Throne поддерживает Windows, Linux и macOS. Выберите под
1111

1212
## Скачать исполняемый файл
1313

14-
Перейдите в [GitHub Releases](https://github.com/throneproj/Throne/releases/latest) и скачайте файл для вашей платформы.
14+
Перейдите на страницу [GitHub Releases](https://github.com/throneproj/Throne/releases/latest) и скачайте файл для вашей платформы.
1515

1616
### Таблица версий
1717

18-
Платформа | Архитектура | Мин. версия | Суффикс файла
19-
-- | -- | -- | --
20-
Windows | x64 | Windows 10 | windows64-installer.exe
21-
Windows | x64 | Windows 10 | windows64.zip
22-
Windows | ARM64 | Windows 10 | windows-arm64.zip
23-
Windows | x64 | Windows 7 SP1 | windowslegacy64.zip
24-
Windows | x86 | Windows 7 SP1 | windows32.zip
25-
Linux | x64 | GLIBC 2.34 | linux-amd64.zip
26-
Linux | x64 | GLIBC 2.34 | debian-amd64.deb
27-
Linux | x64 | GLIBC 2.34 | debian-amd64-system-qt.deb
28-
Linux | ARM64 | GLIBC 2.38 | linux-arm64.zip
29-
Linux | ARM64 | GLIBC 2.38 | debian-arm64.deb
30-
Linux | ARM64 | GLIBC 2.34 | debian-arm64-system-qt.deb
31-
macOS | ARM64 | macOS 13 | macos-arm64.zip
32-
macOS | x64 | macOS 13 | macos-amd64.zip
33-
macOS | x64 | macOS 10.15 | macoslegacy-amd64.zip
18+
| Платформа | Архитектура | Тип пакета / Дистрибутив | Мин. версия | Суффикс файла |
19+
| :--- | :--- | :--- | :--- | :--- |
20+
| **Windows** | x64 | Установщик | Windows 10 | `windows64-installer.exe` |
21+
| | x64 | Портативная (ZIP) | Windows 10 | `windows64.zip` |
22+
| | ARM64 | Портативная (ZIP) | Windows 10 | `windows-arm64.zip` |
23+
| | x64 | Legacy (Win 7/8) | Windows 7 SP1 | `windowslegacy64.zip` |
24+
| | x86 | Legacy (32-бит) | Windows 7 SP1 | `windows32.zip` |
25+
| |
26+
| **Linux** | x64 | **Общий** (Бинарный файл) | GLIBC 2.34 | `linux-amd64.zip` |
27+
| | x64 | **Debian / Ubuntu** | GLIBC 2.34 | `debian-amd64.deb` |
28+
| | x64 | **Debian / Ubuntu** (System Qt) | GLIBC 2.34 | `debian-amd64-system-qt.deb` |
29+
| | ARM64 | **Общий** (Бинарный файл) | GLIBC 2.38 | `linux-arm64.zip` |
30+
| | ARM64 | **Debian / Ubuntu** | GLIBC 2.38 | `debian-arm64.deb` |
31+
| | ARM64 | **Debian / Ubuntu** (System Qt) | GLIBC 2.34 | `debian-arm64-system-qt.deb` |
32+
| |
33+
| **macOS** | ARM64 | Apple Silicon | macOS 13 | `macos-arm64.zip` |
34+
| | x64 | Intel | macOS 13 | `macos-amd64.zip` |
35+
| | x64 | Legacy (Intel) | macOS 10.15 | `macoslegacy-amd64.zip` |
3436

3537
### Windows
3638

37-
#### Портативная (ZIP)
39+
#### Портативная версия (ZIP)
3840

39-
Распакуйте ZIP-файл и запустите `Throne.exe`.
41+
Распакуйте ZIP-архив и запустите `Throne.exe`.
4042

4143
#### Установщик (.exe)
4244

4345
Запустите `Throne-x.x.x-windows64-installer.exe`.
4446

47+
#### Scoop/WinGet
48+
49+
Вы также можете установить Throne в Windows с помощью [Scoop](https://scoop.sh/#/apps?id=b77aee518a6b60c7a582cc24dfb3269c93f697c6&q=throne) или [WinGet](https://winstall.app/apps/Throneproj.Throne).
50+
51+
### macOS
52+
53+
Распакуйте ZIP-архив. Из-за строгой политики безопасности Apple необходимо удалить атрибут карантина:
54+
55+
```bash
56+
xattr -d com.apple.quarantine /path/to/Throne.app
57+
```
58+
59+
Чтобы включить встроенную функцию повышения привилегий, предоставьте `Throne` (или `Terminal`, если запуск идет через CLI) полный доступ к диску в разделе `Системные настройки` → `Конфиденциальность и безопасность` → `Полный доступ к диску`.
60+
4561
### Linux
4662

47-
#### Портативная (ZIP)
63+
Throne можно установить несколькими способами в зависимости от вашего дистрибутива.
64+
65+
#### Портативная версия (ZIP)
4866

4967
Скачайте ZIP-пакет:
5068

@@ -56,35 +74,64 @@ unzip Throne-x.x.x-linux-*.zip
5674
#### Debian/Ubuntu (.deb)
5775

5876
```bash
59-
sudo dpkg -i Throne-x.x.x-debian-*.deb
77+
sudo apt install ./Throne-x.x.x-debian-*.deb
6078
```
6179

62-
Версия `-system-qt` не включает библиотеки Qt и зависит от установленных в системе. Если графический интерфейс не загружается, попробуйте версию system-qt.
80+
Примечание: Версия `-system-qt` не содержит библиотек Qt и полагается на системные. Используйте эту версию, если возникают конфликты тем или графический интерфейс не загружается.
6381

64-
### macOS
82+
### Fedora/RHEL9+
6583

66-
Распакуйте ZIP-файл. Из-за строгой политики безопасности Apple вам необходимо удалить атрибут карантина:
84+
```bash
85+
sudo curl -o /etc/yum.repos.d/throne.repo https://parhelia512.github.io/throne.repo
86+
sudo dnf install -y throne --refresh
87+
```
88+
Для старых версий RHEL посетите [RPM-репозиторий Throne](https://parhelia512.github.io/).
6789

90+
### openSUSE/SLES
6891
```bash
69-
xattr -d com.apple.quarantine /path/to/Throne.app
92+
sudo zypper addrepo -fc https://parhelia512.github.io/throne-sle.repo
93+
sudo zypper install -y throne
7094
```
7195

72-
Чтобы включить встроенную функцию повышения привилегий, предоставьте `Terminal` полный доступ к диску в `Системные настройки` → `Безопасность и конфиденциальность` → `Конфиденциальность` → `Полный доступ к диску` (System Preferences → Security & Privacy → Privacy → Full Disk Access).
96+
### Arch Linux (AUR)
7397

74-
## Менеджеры пакетов
98+
Throne доступен в **Arch User Repository** под именем `throne-bin`. Вы можете установить его с помощью вашего любимого AUR-помощника.
7599

76-
Дистрибутив | Репозиторий
77-
-- | --
78-
Fedora/RHEL | [Репозиторий Throne RPM](https://parhelia512.github.io/)
79-
Fedora/RHEL | [Terra](https://github.com/terrapkg/packages/tree/frawhide/anda/apps/throne)
80-
openSUSE/SLES | [Репозиторий Throne RPM](https://parhelia512.github.io/)
81-
Arch Linux | [AUR](https://aur.archlinux.org/packages/throne-bin)
82-
Любой дистрибутив | [Nix](https://search.nixos.org/packages?channel=unstable&show=throne)
83-
Windows | [Scoop](https://scoop.sh/#/apps?id=b77aee518a6b60c7a582cc24dfb3269c93f697c6&q=throne)
84-
Windows | [WinGet](https://winstall.app/apps/Throneproj.Throne)
100+
```bash
101+
# Если вы используете yay
102+
yay -S throne-bin
103+
104+
# Если вы используете paru
105+
paru -S throne-bin
106+
```
107+
108+
#### NixOS
109+
110+
Добавьте следующий код в конфигурацию NixOS.
111+
112+
```nix
113+
programs.throne = {
114+
enable = true;
115+
# tunMode.enable = true; # Добавьте эту строку для включения tun-режима
116+
};
117+
```
118+
119+
### Nix
120+
121+
Вы также можете установить Throne с помощью менеджера пакетов Nix в любом поддерживаемом дистрибутиве.
122+
123+
```bash
124+
nix-env -iA nixos.throne
125+
```
126+
Или воспользуйтесь nix-shell, чтобы попробовать программу без установки.
127+
```bash
128+
nix-shell -p throne
129+
```
85130

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

133+
Вы также можете собрать Throne из исходного кода самостоятельно.
134+
88135
```bash
89136
git clone --recursive https://github.com/throneproj/Throne.git
90137
cd Throne
@@ -97,14 +144,14 @@ make -j$(nproc)
97144

98145
## Обновление
99146

100-
В Throne есть встроенная функция обновления. Вы также можете скачивать новые версии вручную со [страницы Releases](https://github.com/throneproj/Throne/releases).
147+
В Throne есть встроенная функция обновления. Вы также можете скачивать новые версии вручную со [страницы релизов](https://github.com/throneproj/Throne/releases).
101148

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

104151
### Обнаружение антивирусом
105152

106-
Некоторые антивирусные программы могут помечать Throne как вредоносное ПО, поскольку его функция обновления скачивает, удаляет и заменяет файлы, что похоже на поведение программ-вымогателей. Кроме того, функция `System DNS` изменяет системные настройки DNS, что некоторые антивирусные приложения считают опасным.
153+
Некоторые антивирусные программы могут помечать Throne как вредоносное ПО, поскольку его функция обновления скачивает, удаляет и заменяет файлы — что похоже на поведение программ-вымогателей. Кроме того, функция `System DNS` изменяет системные настройки DNS, что некоторые антивирусные приложения считают опасным.
107154

108-
## Что дальше
155+
## Следующие шаги
109156

110-
После установки перейдите в [Конфигурация](/get_started/configuration/) для настройки профилей прокси.
157+
После установки перейдите к разделу [Конфигурация](/get_started/configuration/) для настройки профилей прокси.

0 commit comments

Comments
 (0)