os-xray v3.1.2 — первый стабильный релиз нашего форка от оригинального проекта MrTheory
Данный проект является форком оригинального проекта MrTheory/os-xray, основанным на ветке разработки:
https://github.com/MrTheory/os-xray/tree/develop
Оригинальная ветка develop послужила основой проекта и предоставила базовую функциональность os-xray.
В рамках форка основной упор был сделан на стабилизацию работы, исправление проблем совместимости и подготовку production-релиза для актуальных версий OPNsense.
После тестирования и исправления выявленных проблем выпущен первый стабильный релиз нашего форка:
Основные изменения относительно оригинальной develop версии:
1. Исправлен порядок запуска при загрузке OPNsense
В процессе эксплуатации была обнаружена проблема взаимодействия между загрузкой OPNsense, настройкой маршрутизации и созданием TUN-интерфейса.
В некоторых сценариях OPNsense пытался применить настройки интерфейсов и маршрутов до того, как Xray/tun2socks успевали создать виртуальный интерфейс.
Возникали ошибки:
В v3.1.2 изменён порядок инициализации:
Теперь после перезагрузки системы TUN-интерфейс корректно поднимается до применения маршрутов.
---
2. Улучшена инициализация TUN-интерфейса
Добавлено:
---
3. Исправлен механизм запуска сервисов
Изменения:
---
4. Улучшена диагностика подключения
Исправлен механизм testconnect:
---
5. Проведён аудит стабильности перед релизом
Проверено:
---
6. Новая структура разработки форка
После стабилизации проект переведён на собственную структуру веток:
Текущий стабильный релиз:
---
Репозитории:
Оригинальный проект MrTheory:
https://github.com/MrTheory/os-xray
Наш форк:
https://github.com/SpyLive/os-xray
Спасибо MrTheory за оригинальную разработку и основу проекта.
Дальнейшее развитие форка будет продолжаться с сохранением открытого подхода и обратной совместимости с оригинальной архитектурой os-xray.
Данный проект является форком оригинального проекта MrTheory/os-xray, основанным на ветке разработки:
https://github.com/MrTheory/os-xray/tree/develop
Оригинальная ветка develop послужила основой проекта и предоставила базовую функциональность os-xray.
В рамках форка основной упор был сделан на стабилизацию работы, исправление проблем совместимости и подготовку production-релиза для актуальных версий OPNsense.
После тестирования и исправления выявленных проблем выпущен первый стабильный релиз нашего форка:
Code Select
os-xray v3.1.2
Основные изменения относительно оригинальной develop версии:
1. Исправлен порядок запуска при загрузке OPNsense
В процессе эксплуатации была обнаружена проблема взаимодействия между загрузкой OPNsense, настройкой маршрутизации и созданием TUN-интерфейса.
В некоторых сценариях OPNsense пытался применить настройки интерфейсов и маршрутов до того, как Xray/tun2socks успевали создать виртуальный интерфейс.
Возникали ошибки:
Code Select
Unable to configure nonexistent interface
refusing to set interface route on addressless interface
В v3.1.2 изменён порядок инициализации:
Code Select
xray-core
↓
tun2socks
↓
создание TUN-интерфейса
↓
назначение IP и MTU
↓
reload routing/firewall
Теперь после перезагрузки системы TUN-интерфейс корректно поднимается до применения маршрутов.
---
2. Улучшена инициализация TUN-интерфейса
Добавлено:
- увеличено время ожидания появления TUN-интерфейса;
- автоматическая установка MTU;
- назначение IPv4-адреса из конфигурации OPNsense;
- проверка корректности адресации перед обновлением маршрутизации.
---
3. Исправлен механизм запуска сервисов
Изменения:
- удалён устаревший дублирующий startup hook;
- оставлен единый механизм запуска через
Code Select
50-xray;- исправлена проверка UUID инстансов при старте.
---
4. Улучшена диагностика подключения
Исправлен механизм testconnect:
- используется актуальный SOCKS5 порт из конфигурации;
- DNS-запросы выполняются через Xray;
- устранены ошибки из-за локального DNS resolver OPNsense.
---
5. Проведён аудит стабильности перед релизом
Проверено:
- соответствие Git и установленной системы OPNsense;
- корректность boot lifecycle;
- запуск xray-core и tun2socks;
- создание и настройка TUN-интерфейса;
- маршрутизация через PF;
- реальный проход трафика через VPN;
- работа диагностических инструментов;
- статические тесты совместимости.
---
6. Новая структура разработки форка
После стабилизации проект переведён на собственную структуру веток:
Code Select
main
└── стабильные релизы форка
develop
└── дальнейшая разработка
fix/*
└── отдельные исправления
Текущий стабильный релиз:
Code Select
os-xray v3.1.2
---
Репозитории:
Оригинальный проект MrTheory:
https://github.com/MrTheory/os-xray
Наш форк:
https://github.com/SpyLive/os-xray
Спасибо MrTheory за оригинальную разработку и основу проекта.
Дальнейшее развитие форка будет продолжаться с сохранением открытого подхода и обратной совместимости с оригинальной архитектурой os-xray.
"