Командная строка, файлы и логи

На этой странице описаны параметры командной строки Throne для компьютера, место, где Throne хранит ваши данные, назначение каждого файла, расположение логов и способ начать заново с настройками по умолчанию.

Командная строка

Throne принимает следующие параметры:

Параметр	Что делает
-appdata	Хранит данные в папке пользователя, а не рядом с программой. См. Папка данных.
-appdata <folder>	Хранит данные в <folder>. Throne создаёт внутри неё папку config.
-tray	Запускает программу со скрытым окном. Появляется только значок в трее.
Ссылка throne://	Обрабатывает ссылку так, как если бы вы щёлкнули по ней. См. Глубокие ссылки.
Пути к файлам или URL file://	Импортирует файлы, как Программа (Program) → Добавить профиль из файла (Add profile from File(s)).

Примеры:

/opt/Throne/Throne -appdata
./Throne -appdata "$HOME/throne-test"
./Throne -tray

.\Throne.exe -appdata D:\ThroneData

• Throne считает слово после -appdata папкой, если оно не начинается с -.
• Для одной папки данных может работать только один экземпляр Throne. Если Throne уже запущен, новый запуск передаёт свою ссылку или файлы работающему Throne, выводит его окно на передний план и завершается.
• macOS: чтобы передать параметры, запустите программу внутри пакета приложения, например /Applications/Throne.app/Contents/MacOS/Throne -tray. Ссылки, по которым вы щёлкаете, macOS передаёт уже запущенному Throne.

Папка данных

Throne хранит ваши данные в папке с именем config. Чтобы открыть её, выберите Настройки (Settings) → Открыть папку конфигурации (Open Config Folder).

Throne работает в одном из двух режимов:

• Портативный режим: папка config находится внутри папки программы Throne.
• Режим appdata: папка config находится в папке пользователя. Throne использует этот режим, если запущен с -appdata, всегда в macOS, а также если не может записывать в собственную папку.

В режиме appdata папка находится здесь:

Система	Папка данных
Windows	%LOCALAPPDATA%\Throne\config, например C:\Users\<you>\AppData\Local\Throne\config
Linux	~/.config/Throne/config или $XDG_CONFIG_HOME/Throne/config, если задана переменная XDG_CONFIG_HOME
macOS	~/Library/Preferences/Throne/config

Какой режим использует ваша копия, зависит от способа установки:

Способ установки Throne	Режим	Папка данных
ZIP для Windows	Портативный	config в распакованной папке Throne
Установщик Windows, для текущего пользователя (по умолчанию)	Портативный	config в папке установки, по умолчанию %LOCALAPPDATA%\Throne\config
Установщик Windows, для всех пользователей	Appdata (автоматически)	%LOCALAPPDATA%\Throne\config каждого пользователя
ZIP для Linux	Портативный	config в распакованной папке Throne
.deb, .rpm или скрипт установки для Linux	Appdata	~/.config/Throne/config
macOS	Appdata	~/Library/Preferences/Throne/config

• Пункт в меню приложений, который создают пакеты .deb и .rpm и скрипт установки для Linux, запускает /opt/Throne/Throne -appdata.
• Если Throne не может записывать в собственную папку, например в Program Files, он сам переключается в режим appdata. В первый раз он копирует туда вашу существующую папку config. После этого он продолжает использовать папку пользователя, даже если запустить его от имени администратора.
• Пакеты из других источников (WinGet, Scoop, AUR, Nix) могут использовать другие папки. Открыть папку конфигурации всегда показывает нужную.

Несколько файлов хранятся рядом с папкой config, а не внутри неё: геофайлы Xray geoip.dat и geosite.dat, а также папка diagnostics с файлами из Основные настройки (Basic Settings) → Diagnostics. В портативном режиме это папка программы Throne. В режиме appdata — папка пользователя, например %LOCALAPPDATA%\Throne, даже если вы указали для -appdata другую папку.

Файлы в папке конфигурации

Файл или папка	Что содержит
throne.db	Ваши профили, группы, профили маршрутизации, профили OTP и настройки в базе данных SQLite. Пока Throne работает, рядом с ним появляются throne.db-wal и throne.db-shm.
throne_stats.db	Историю трафика для Утилиты (Tools) → Статистика трафика (Traffic Stats): поминутные данные за последние 48 часов и почасовые данные за 90 дней. Основные настройки → Интерфейс (Style) → Отключить агрегацию трафика (Disable Traffic Aggregation) отключает её сбор.
cache.db	Кэш ядра: загруженные наборы правил, последний выбор профиля автовыбора и, если включён Save Cache To File, кэш DNS.
logs/	Файлы логов. См. Логи.
crashes/	Аварийные дампы (только Windows). Хранятся 5 самых новых.
icons/	Собственные значки трея из Основные настройки → Интерфейс → Включить собст. иконки (Enable Custom Icons).
dashboard/	Файлы веб-панели для Clash API. Throne создаёт эту папку со страницей-заглушкой; замените заглушку файлами панели.
sb-dashboard/	Веб-панель, которую открывает Утилиты → Открыть веб-панель (Open Web dashboard).

Чтобы перенести данные на другой компьютер или на Android, создайте резервную копию .thrbackup, а не копируйте файлы. См. Резервное копирование и восстановление.

Логи

Вкладка Логи (Logs) в нижней части главного окна показывает сообщения Throne и ядра. Щёлкните лог правой кнопкой мыши, чтобы скопировать текст или очистить лог командой Очистить (Clear).

Параметры логов находятся в Настройки → Основные настройки → Логирование (Logging):

Параметр	По умолчанию	Что делает
Макс. кол-во строк в логах (Max log lines)	200	Сколько строк хранит вкладка Логи.
Авто-скролл логов (Auto-scroll log)	Вкл.	Прокручивает лог так, чтобы была видна самая новая строка.
Уровень логирования Sing-box (Sing-box Log level)	info	Насколько подробно пишет ядро: trace, debug, info, warn, error, fatal или panic.
Уровень логирования Xray (Xray Log level)	warning	Насколько подробно пишет Xray: debug, info, warning, error или none.
Фильтрация логов (Log Filtering)	Выкл.	Использовать правила включения (Enable Include Rules) показывает только строки, совпадающие с вашими ключевыми словами или регулярными выражениями. Использовать правила исключения (Enable Exclude Rules) скрывает совпадающие строки. Фильтры меняют только вкладку Логи, но не файл лога.

Для отчёта об ошибке установите Уровень логирования Sing-box в значение debug, снова запустите профиль и воспроизведите проблему. Затем следуйте инструкциям на странице Как сообщить об ошибке.

Файл лога

Throne также записывает лог в файл logs/throne.log в папке конфигурации.

• Файл начинается с версии Throne, сведений о вашей операционной системе, параметров командной строки и папки логов.
• Он содержит всё, что есть на вкладке Логи, и более подробные сведения от самого Throne.
• Throne начинает новый файл при каждом запуске. Когда файл достигает 4 MB, Throne переименовывает его в throne.log.1 и начинает новый. Хранится до трёх старых частей, от throne.log.1 до throne.log.3.
• Если Throne завершил работу некорректно, он сохраняет лог этого сеанса как crashed-YYYYMMDD-HHMMSS.log в той же папке. Хранятся 5 самых новых. При следующем запуске на вкладке Логи появляется сообщение «[Предупреждение] В прошлый раз Throne не завершил работу корректно. Результаты диагностики сохранены в: …» («[Warn] Throne did not shut down cleanly last time. Diagnostics were saved to: …»), за которым следует путь к папке логов.

Android: откройте боковое меню и нажмите Журналы (Logs). Share logs и Save logs… экспортируют лог. Hide sensitive data по умолчанию включён. При экспорте он скрывает пароли, ключи, UUID, имена серверов, публичные IP-адреса, названия сетей Wi-Fi и пути в URL. Уровень логирования задаётся в Настройки (Settings) → Core → Тип журнала (Log level) (по умолчанию warn). См. Устранение неполадок на Android.

Сброс Throne

В Throne нет кнопки сброса. Чтобы начать заново с настройками по умолчанию, дайте Throne новую пустую папку конфигурации:

1. Если хотите что-то сохранить, сначала создайте резервную копию: Настройки → Основные настройки → Резервное копирование и восстановление (Backup and Restore) → Создать резервную копию (Create Backup...).
2. Выберите Настройки → Открыть папку конфигурации, чтобы увидеть, где находится папка.
3. Завершите работу Throne командой Выход (Exit) в меню трея или в меню Программа. Закрыть окно недостаточно.
4. Переименуйте папку config, например в config-old.
5. Запустите Throne. Он создаст новую папку config с настройками по умолчанию.

Чтобы вернуть часть старых данных, нажмите Восстановить из копии (Restore from Backup...) на той же вкладке и выберите только нужные части. См. Резервное копирование и восстановление.

Чтобы отменить сброс, завершите работу Throne, удалите новую папку config и переименуйте config-old обратно в config.

Сброс не затрагивает то, что хранится вне папки конфигурации: Запускать вместе с системой (Start with system) (это запись автозапуска операционной системы), регистрацию ссылок throne:// и геофайлы Xray.

Windows: если вы установили Throne с помощью установщика, при удалении программа спросит «Also delete your Throne profiles, settings and logs?» (удалить также профили, настройки и логи Throne?). Выберите Yes, чтобы удалить и папку конфигурации.

Android: Настройки (Settings) → Восстановить настройки по умолчанию (Restore default settings) сбрасывает все настройки, но сохраняет профили, группы и профили маршрутизации. Затем приложение перезапускается. Чтобы удалить всё, очистите данные приложения в настройках приложений Android. Throne для Android хранит данные в закрытом хранилище приложения, которое файловые менеджеры открыть не могут, поэтому, чтобы скопировать данные наружу, используйте резервную копию .thrbackup.