Skip to content

About

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

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

XrayUtils — выбор конфигурации из подписок для Xray

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

Как пользоваться

  1. Запустите программу.
  2. Выберите добавление подписки и вставьте её URL.
  3. Откройте подписку и при необходимости обновите данные.
  4. Выберите нужный профиль для экспорта в Xray.
  5. Перезапустите или перечитайте конфигурацию Xray средствами вашей системы.

Кому подойдёт

XrayUtils подойдёт пользователям Linux, которые:

  • уже используют Xray-core;
  • получают конфигурации через одну или несколько подписок;
  • предпочитают терминал веб-панели;
  • хотят держать инструмент выбора профилей отдельно от самого Xray.

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

Использование ИИ

ИИ использовался как вспомогательный инструмент при подготовке следующих файлов: LICENSE, run.sh, TECHNICAL.md и README.md. Исходный код приложения в src/ написан вручную, без использования ИИ.

Лицензия

Проект распространяется по лицензии Unlicense. Разрешено свободное использование, копирование, изменение и распространение проекта, в том числе в коммерческих целях, без ограничений и обязательного указания авторства.

About

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

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages