XrayUtils — небольшая консольная утилита для Linux, которая помогает работать с URL-подписками Xray. Она загружает профили из подписок, показывает их в интерактивном меню и экспортирует выбранную конфигурацию в установленный Xray.
Проект подходит тем, кто хранит несколько серверов или подписок и хочет быстро переключаться между профилями без ручного копирования JSON-файлов.
- добавление нескольких URL-подписок;
- обновление подписок и выбор нужного профиля;
- удаление подписок с подтверждением;
- импорт локальной JSON-подписки;
- экспорт выбранного профиля и доступных GeoIP/GeoSite-данных для Xray;
- сохранение списка подписок между запусками.
- Простая задача и понятный интерфейс. Утилита запускается в терминале и не требует отдельной панели управления.
- Быстрое переключение. Нужный профиль выбирается из меню, без ручного редактирования конфигурации.
- Минимальный размер. Проект решает одну задачу и не включает лишние функции полноценного клиента.
- Локальный контроль. Конфигурация выбирается и экспортируется на вашем Linux-компьютере.
- Поддержка routing-ресурсов. Если подписка их предоставляет, GeoIP и GeoSite загружаются вместе с профилем.
- Только Linux. Проект рассчитан на Linux и системные пути установки Xray.
- Нет графического интерфейса. Управление выполняется в терминале.
- Перезапуск службы выполняется отдельно. Основная программа не управляет службой Xray; для запуска программы с последующим перезапуском службы используйте
run.sh. - Ограниченный контроль конфигурации. Утилита выбирает профиль из подписки и применяет базовые параметры подключения; полноценного редактора конфигураций нет.
- Нужен доступ к источнику подписки. Для удалённых подписок требуется интернет и рабочий URL.
- Без встроенной проверки доверия. Добавляйте только подписки и локальные файлы из источников, которым доверяете.
| Критерий | XrayUtils | Happ | Hiddify | v2rayA | GoXray |
|---|---|---|---|---|---|
| Основная задача | Выбор профиля из подписки и экспорт конфигурации в установленный Xray | Клиент для работы с прокси на базе Xray | Кроссплатформенный клиент; отдельно доступен Hiddify Manager для настройки собственного сервера | Веб-клиент и служба для управления прокси и прозрачным проксированием | Графический клиент Xray с управлением конфигурациями |
| Интерфейс | Терминал | Графический | Графический | Веб-интерфейс | Графический, с быстрым доступом через трей |
| Платформы | Linux | Компьютеры, мобильные устройства и ТВ-платформы | Linux, Windows, macOS, Android и iOS | Linux, Windows и macOS | Linux и macOS |
| Работа с трафиком | Готовит конфигурацию для Xray; запуск и настройка проксирования остаются Xray | Полноценный клиент на базе Xray | Клиент поддерживает много протоколов и типов подписок | Поддерживает маршрутизацию, правила и прозрачное проксирование | Поддерживает статистику по конфигурациям и TUN с дополнительными правилами маршрутизации |
| Кому подходит | Тем, кому нужен небольшой инструмент выбора и экспорта профиля в Linux | Тем, кому нужен клиент Xray на разных устройствах | Тем, кому нужен готовый клиент на разных платформах или отдельное решение для своего сервера | Тем, кому нужны веб-управление, правила и прозрачное проксирование | Тем, кому нужен графический Xray-клиент на Linux или macOS |
XrayUtils подходит, если Xray уже установлен и требуется только выбрать профиль из подписки и записать его конфигурацию. Для подключения в графическом интерфейсе или управления маршрутизацией рассмотрите Happ, Hiddify, v2rayA или GoXray в зависимости от платформы и нужных функций.
Сначала установите Xray-core официальным способом:
bash -c "$(curl -L https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ installЗатем из корня репозитория создайте окружение, установите зависимости и запустите программу:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python src/main.pyТехнические пути, формат хранения данных и настройки экспорта описаны в TECHNICAL.md.
Для запуска XrayUtils с последующим перезапуском службы используйте скрипт из корня проекта:
./run.sh- Запустите программу.
- Выберите добавление подписки и вставьте её URL.
- Откройте подписку и при необходимости обновите данные.
- Выберите нужный профиль для экспорта в Xray.
- Перезапустите или перечитайте конфигурацию Xray средствами вашей системы.
XrayUtils подойдёт пользователям Linux, которые:
- уже используют Xray-core;
- получают конфигурации через одну или несколько подписок;
- предпочитают терминал веб-панели;
- хотят держать инструмент выбора профилей отдельно от самого Xray.
Если нужен готовый графический клиент, автоматическое управление службой или сложная настройка маршрутизации, стоит выбрать более функциональное решение.
ИИ использовался как вспомогательный инструмент при подготовке следующих файлов: LICENSE, run.sh, TECHNICAL.md и README.md. Исходный код приложения в src/ написан вручную, без использования ИИ.
Проект распространяется по лицензии Unlicense. Разрешено свободное использование, копирование, изменение и распространение проекта, в том числе в коммерческих целях, без ограничений и обязательного указания авторства.