Skip to content

halibiram/XKeen

 
 

Repository files navigation

Xray-Keenetic

Warning

Данный материал подготовлен в научно-технических целях. Утилита XKeen предназначена для управления межсетевым экраном роутера Keenetic, защищающим домашнюю сеть. Разработчик не несёт ответственности за иное её использование. Перед использованием XKeen убедитесь, что ваши действия соответствуют законодательству вашей страны. Использование XKeen в противоправных целях строго запрещено

Note

Установка XKeen гарантируется только на внешние USB-накопители, при этом установка на внутреннюю память роутера возможна, но требует знаний и опыта пользователя. Если возникли трудности с установкой на внутреннюю память, не сообщайте об этом, как об ошибке в установщике. Проблема не в XKeen

Версия 1.1.3.8

Сравнение форка с оригинальным XKeen

Изменения:

  • Исправлено добавление портов в исключения (ранее команду xkeen -ape нужно было прерывать по ctrl+c)
  • Исправлена совместная работа режима TProxy и socks5 (ранее Xkeen запускался в Mixed режиме, что приводило к неработоспособности прозрачного проксирования)
  • Исправлен автозапуск XKeen при старте роутера (ранее XKeen в некоторых случаях не запускался или запускался для всего устройства, а не только для своей политики - FAQ п.12)
  • Переработана логика загрузки XKeen, Xray, Mihomo и GeoFile из интернета, уменьшающая вероятность их повреждения
  • Переработана логика применения правил iptables и ip6tables (ранее XKeen применял все правила, даже при не установленном компоненте IPv6)
  • Переработана логика добавления и удаления портов проксирования и исключаемых портов
  • При обновлении геофайлов, добавлении/удалении портов проксирования или портов исключений, а также выполнении других настроек, требующих перезапуск XKeen, прокси-клиент теперь перезапускается если был до этого запущен
  • При запуске xkeen -d без цифрового параметра, теперь отображается информация о текущей задержке автозапуска
  • При запуске или перезапуске XKeen теперь отображается информация о режиме работы - TProxy, Mixed, Redirect, Other
  • Не актуальные GeoSite и GeoIP antifilter-community заменены на базы Re:filter
  • Объединены задачи планировщика по обновлению GeoSite и GeoIP. В связи с этим упразднены параметры запуска -ugs, -ugi, -ugsc, -ugic, -dgsc, -dgic
  • Параметр запуска -ux для обновления ядра Xray теперь поддерживает повышение/понижение версии
  • Корректная деинсталляция xray-core (ранее пакет xray не удалялся при деинсталляции)
  • Справка (xkeen -h) выровнена по табуляции и повышен контраст текста
  • Рефакторинг кода скриптов
  • Актуализация конфигурационных файлов xray-core

Добавлено:

  • Поддержка ядра Mihomo
  • Возможность сменить ядро проксирования (Xray/Mihomo) параметрамии -xray и -mihomo
  • Возможность OffLine установки (параметр -io)
  • Возможность установки GeoIP базы zkeenip.dat
  • Обновление zkeen.dat и zkeenip.dat по расписанию средствами XKeen
  • При недоступности GitHub API используется резервный источник релизов для XKeen, Xray и Mihomo
  • При недоступности репозитория GitHub загрузка компонентов XKeen выполняется через прокси
  • Защита от случайного ввода дефиса вместо двоеточия при указании диапазона портов проксирования или портов исключений
  • Поддержка внешнего файла /opt/etc/xkeen_exclude.lst c IP-адресами и подсетями для исключения из проксирования (образец)
  • При установке теперь можно выбрать, добавлять ли XKeen в автозагрузку при включении роутера или нет
  • При пропуске установки Xray, его конфигурационные файлы и геобазы так же пропускаются и не устанавливаются
  • Mihomo и парсер yaml-файлов Yq устанавливаются и регистрируются в entware, как полноценные ipk-пакеты
  • Параметр запуска -remove для полной деинсталляции XKeen (ранее деинсталляцию нужно было выполнять покомпонентно)
  • Параметры запуска -ug (обновление геофайлов), -ugc (управление заданием Cron, обновляющим геофайлы), -dgc (удаление задания Cron, обновляющего геофайлы)
  • Параметр запуска -um для обновления/установки ядра Mihomo (поддерживается повышение/понижение версии)
  • Параметры запуска: -rrm (обновить регистрацию Mihomo), -drm (удалить регистрацию Mihomo)
  • Параметр запуска -dm для деинсталляции ядра Mihomo
  • Параметр запуска -g, позволяющий переустановить (добавить/удалить) геофайлы для Xray
  • Параметр запуска -channel, позволяющий выбрать канал обновления XKeen между Stable и Dev ветками
  • Возможность резервного копирования и восстановления конфигурации Mihomo (параметры -mb, -mbr)
  • Возможность контролировать число открытых файловых дескрипторов, используемых прокси-клиентом и перезапускать процесс при исчерпании лимита подробнее

Удалено:

  • Возможность установки GeoSite Antizapret (база повреждена в репозитории)
  • Конфигурационный файл 02_transport.json (не используется новыми ядрами xray-core)
  • Запрос на перезапись и сама перезапись конфигурационных файлов Xray, если они уже существуют на момент установки XKeen
  • Создание резервных копий Xray, так как теперь можно интерактивно установить предыдущую версию ядра параметром -ux. В связи с этим упразднены параметры запуска -xb и -xbr
  • Логирование процесса установки XKeen в директорию /opt/var/log/xkeen (на практике не использовалось)
  • Задачи планировщика по автообновлению XKeen/Xray. В связи с этим упразднены параметры запуска -uac, -ukc, -uxc, -dac, -dkc и -dxc
  • Параметры запуска: -x (заменён на -ux), -rk (заменён на -rrk), -rx (заменён на -rrx), -rc (не актуален)

Все параметры запуска с их описанием доступны в справке по команде xkeen -h

Порядок установки

opkg update && opkg upgrade && opkg install curl tar
curl -OL https://raw.githubusercontent.com/jameszeroX/XKeen/main/install.sh
chmod +x install.sh
./install.sh

Альтернативный вариант:

opkg update && opkg upgrade && opkg install curl tar
curl -OL https://ghfast.top/https://github.com/jameszeroX/XKeen/releases/latest/download/xkeen.tar.gz
tar -xvzf xkeen.tar.gz -C /opt/sbin > /dev/null && rm xkeen.tar.gz
xkeen -i

Установка OffLine

Поддержка

Форк XKeen, как и оригинал, совершено бесплатен и не имеет каких либо ограничений по использованию. Надеюсь, доработки XKeen, многие из которых я сделал по Вашим просьбам, оказались полезны, так же, как и мои консультации в телеграм-чате. Для меня очень важно понимать, что труд и время потрачены не зря. Буду благодарен за любую Вашу поддержку:

CloudTips

ЮMoney

Карта МИР: 2204 1201 2976 4110

USDT, сеть TRC20: TQhy1LbuGe3Bz7EVrDYn67ZFLDjDBa2VNX

USDT, сеть ERC20: 0x6a5DF3b5c67E1f90dF27Ff3bd2a7691Fad234EE2

Источники

Origin https://github.com/Skrill0/XKeen

Xray-core https://github.com/XTLS/Xray-core

Mihomo https://github.com/MetaCubeX/mihomo

FAQ https://jameszero.net/faq-xkeen.htm

Telegram https://t.me/+SZWOjSlvYpdlNmMy (обсуждение, инструкции по установке, советы по использованию)

About

Утилита для управления межсетевым экраном роутера Keenetic, защищающим домашнюю сеть

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Shell 100.0%