Xray на роутере Keenetic

Проверьте модель и получите файл от поддержки до установки.

1. 1

   Включите компоненты и настройте DNS

   В веб-интерфейсе роутера откройте «Управление» → «Настройки системы» → «Обновления и компоненты KeeneticOS» → «Изменить набор компонентов». В более старом интерфейсе этот пункт находится в «Управление» → «Общие настройки». Установите:

   • поддержку USB-накопителей и файловой системы Ext; для форматирования — утилиты файловой системы Ext;
   • «Поддержка открытых пакетов» (OPKG);
   • «Модули ядра подсистемы Netfilter»;
   • «Прокси-сервер DNS-over-TLS» и/или «Прокси-сервер DNS-over-HTTPS»;
   • сервер SMB для доступа к файлам USB из домашней сети.

   Примените изменения и дождитесь возвращения роутера в сеть. Компонент «Сервер SSH» специально для Entware устанавливать не нужно. Если он уже есть, оставьте его: ниже выберем соответствующий порт.

   Откройте «Сетевые правила» → «Интернет-фильтр» → «Настройка DNS». Добавьте шифрованные DNS по инструкции производителя: например, DoT 1.1.1.1 с именем cloudflare-dns.comи DoH https://dns.google/dns-query.

   В настройках активного интернет-подключения включите «Игнорировать DNS провайдера»; проверьте также IPv6 DNS, если он используется. Само включение компонента DNS не настраивает.

   Результат: обычные сайты открываются до установки XKeen. Если интернет пропал, сначала исправьте DNS.

2. 2

   Подготовьте USB-накопитель

   Форматирование удалит данные с выбранного накопителя. Сначала скопируйте нужные файлы на компьютер и проверьте, какой диск выбран.

   На KeeneticOS 5.1 и новее откройте «Управление» → «Накопители и устройства». Выберите накопитель и форматирование в ext4, задайте метку OPKG. Подробности — форматирование в веб-интерфейсе.

   На более старой ОС подготовьте ext4-раздел на компьютере по инструкции Entware или обратитесь в поддержку. Штатное форматирование Windows не создаёт ext4. FAT32, exFAT и NTFS для этого способа не используйте.

   Результат: роутер видит накопитель OPKG с ext4. Во время работы XKeen накопитель должен оставаться подключённым.

3. 3

   Установите Entware на USB

   Entware — среда, в которой будут работать XKeen и Xray. Найдите свой номер модели в таблице автора XKeenи скачайте архив из соответствующей строки. Не выбирайте архив по названию или цене роутера.

   • aarch64-installer.tar.gz — для aarch64;
   • mipsel-installer.tar.gz — для mipsel;
   • mips-installer.tar.gz — для mips.

   Включите SMB-доступ к накопителю в разделе «Приложения» роутера и разрешите вашей учётной записи чтение и запись. В Windows откройте в Проводнике \\192.168.1.1, затем накопитель OPKG. В macOS используйте Finder → «Переход» → «Подключение к серверу» → smb://192.168.1.1.

   Создайте в корне накопителя папку install и положите в неё один архив, не распаковывая. Откройте страницу OPKG роутера, выберите этот накопитель и сохраните. Путь запуска специально не меняйте: установщик настраивает /opt/etc/initrc.

   Откройте системный журнал в разделе диагностики и дождитесь сообщения о завершении установки Entware. В нём будут логин, начальный пароль и порт SSH. Не переходите дальше, пока установка не завершена.

   Источник с примерами журнала: установка Entware на USB.

4. 4

   Войдите в Entware и смените пароль

   Подключитесь с компьютера к домашней сети роутера. Если в журнале указан порт 22:

   ssh root@192.168.1.1

   Если указан порт 222 — обычно при установленном компоненте «Сервер SSH»:

   ssh -p 222 root@192.168.1.1

   Используйте только один вариант, соответствующий журналу. При первом входе проверьте адрес домашнего роутера и подтвердите добавление его ключа словом yes. Начальный пароль Entware обычно keenetic; ориентируйтесь на журнал установки. При вводе пароля символы не показываются.

   После входа смените пароль пользователя root Entware — это отдельный пароль от веб-интерфейса:

   passwd

   Результат: пароль изменён, вы находитесь в командной строке Entware. Если видите (config)>, вы вошли в консоль KeeneticOS: выполните exit и подключитесь к порту Entware из журнала.

5. 5

   На KeeneticOS 5.2 и новее создайте токен доступа

   На версии ниже 5.2 пропустите этот шаг. На 5.2+ откройте «Управление» → «Пользователи и доступ» → «Токены доступа», создайте токен с описанием XKeen и скопируйте его значение. Сделайте это до установки XKeen.

   Через доступ к USB из шага 3 создайте папку etc/xkeen, а в ней текстовый файл xkeen.json. Содержимое файла:

   {
     "xkeen": {
       "rci_token": "ВСТАВЬТЕ_СВОЙ_ТОКЕН"
     }
   }

   Замените только текст ВСТАВЬТЕ_СВОЙ_ТОКЕН своим токеном, сохранив кавычки. В Блокноте выберите тип файла «Все файлы» и UTF-8; убедитесь, что имя заканчивается на .json, а не .json.txt. На роутере файл должен оказаться по пути /opt/etc/xkeen/xkeen.json.

   Если файл уже существует, сначала сохраните его копию на компьютере и добавьте поле rci_token внутрь существующего объекта xkeen. Не заменяйте весь файл этим примером.

   Токен даёт доступ к управлению роутером: не отправляйте его в переписку и на скриншотах. Пример и пояснения: формат xkeen.json, подготовка KeeneticOS 5.2.

6. 6

   Установите XKeen с ядром Xray

   Для новой установки подготовьте пакеты Entware. Если команда закончилась ошибкой, не запускайте установщик:

   opkg update && opkg install curl tar

   Скачайте и запустите установщик из репозитория автора. Команда запускает файл только после успешного скачивания:

   cd /tmp && curl -fSL --retry 2 -o xkeen-install.sh https://raw.githubusercontent.com/jameszeroX/XKeen/main/install.sh && sh ./xkeen-install.sh

   Если файл установщика не скачивается с GitHub

   Тот же установщик через зеркало jsDelivr, указанное автором. Используйте вместо предыдущей команды, если скачивание завершилось ошибкой:

   cd /tmp && curl -fSL --retry 2 -o xkeen-install.sh https://cdn.jsdelivr.net/gh/jameszeroX/XKeen@main/install.sh && sh ./xkeen-install.sh

   • Версия XKeen: на KeeneticOS 5.1.2 и новее в этой инструкции выбирайте Beta (пункт 2 текущего установщика). На 5.2 эта ветка также обеспечивает работу с токеном RCI из шага 5. На ОС ниже 5.1.2 можно выбрать Stable. Версия XKeen и версия Xray — разные пункты.
   • Ядро: выберите Xray и стабильную версию, которую предлагает установщик, не ниже 26.3.27. Этот минимум нужен для параметров подключения, которые может содержать наш файл. Если поддержка указала другую совместимую версию, следуйте её рекомендации.
   • GeoSite и GeoIP: установите предлагаемые базы; в текущем мастере можно выбрать все. Включите их автообновление и автозапуск XKeen.
   • Исключение российских IP-подсетей:включайте, если эти адреса должны открываться напрямую. Это исключение по IP, оно не гарантирует, что каждый банк или сайт попадёт в нужную категорию. Для мобильного подключения 4G/5G выберите «нет».
   • Режим: оставьте стандартный Hybrid. Для него переносить порт 443 веб-интерфейса не нужно. TProxy и дополнительные force-proxy настройки в этой инструкции не используются.

   Почему Beta на 5.1.2+: старым стабильным выпускам требуется отдельное исправление обращения к роутеру через localhost. Для уже установленной Stable это описано в установщике автора; на 5.2 порядок с RCI описан в его инструкции.

   Результат: установщик сообщил о завершении. Пока не запускайте проксирование — сначала выберите устройства и загрузите файл подключения.

7. 7

   Выберите устройства для XKeen

   Откройте «Интернет» → «Приоритеты подключений» → «Политики доступа в интернет». Создайте политику с именем xkeen (латиницей, без пробелов) и отметьте в ней рабочее подключение провайдера. Если галочки нет, у политики не будет доступа в интернет.

   В списке клиентов зарегистрируйте тестовый компьютер или телефон. Затем во вкладке «Применение политик» перенесите его в xkeen. Остальные устройства пока оставьте в обычной политике.

   Сначала одно устройство

   Не пропускайте создание политики: без подходящей политики XKeen может перехватывать трафик всей домашней сети. Сначала проверьте одно устройство, затем добавляйте остальные.

   Политика выбирает устройства. Какие сайты и порты пойдут через сервер, определяют настройки XKeen и правила Xray. Это не обещание полного VPN для любого трафика, в том числе IPv6. Подробности: режимы XKeenи вопросы о политиках и маршрутизации.

8. 8

   Загрузите три файла настроек

   Для этого способа нужны три согласованных файла. Первый задаёт приём трафика, второй — ваше подключение, третий — направление трафика через UnderVPN:

   • Скачать 03_inbounds.json — готовый шаблон Hybrid для этой инструкции.
   • 04_outbounds.json — персональный файл, полученный от поддержки.
   • Скачать 05_routing.json — готовые правила для выхода vless-reality из файла поддержки.

   На USB откройте etc/xray/configs — в Entware это/opt/etc/xray/configs/. Сохраните всю эту папку на компьютер, затем замените в ней 03_inbounds.json, 04_outbounds.jsonи 05_routing.json тремя файлами выше.

   Резервные копии храните вне папки configs. Проверьте точные имена: без (1) и лишнего .txt. Остальные файлы чистой установки оставьте на месте. Ссылка подписки и файл для Happ не заменяют 04_outbounds.json.

   Почему заменяем не только файл подключения

   В разных выпусках XKeen штатные шаблоны отличаются. В проверенном Beta-архиве обычный трафик направлен напрямую, а новые настройки входящих подключений несовместимы со старыми ядрами Xray. Файлы выше задают обычный Hybrid и явный маршрут через UnderVPN.

   Это комплект для первой установки. Он заменяет пользовательские правила: если вы уже настраивали другие серверы, TProxy или специальные политики, согласуйте изменения с поддержкой.

   Через сервер пойдёт перехваченный XKeen трафик; исключения IP-подсетей, настроенные в шаге 6, продолжат действовать. Автоматической смены сервера в этом комплекте нет. При смене страны, данных подключения или проблеме с сервером запросите новый персональный файл.

   Состав шаблонов и первоисточники: описание комплекта.

9. 9

   Проверьте настройки и запустите

   Сначала выполните только проверку:

   xkeen -xtest

   Продолжайте только при успешной проверке. При ошибке сохраните её текст и обратитесь в поддержку. Проверка файла ещё не подтверждает соединение с сервером.

   Если проксирование не работает через 4G/5G или для удалённых VPN-клиентов

   Для этого случая автор указывает отключение проксирования самой среды Entware и исключений GeoIPSET. Примените при таком симптоме, затем повторите запуск и проверку:

   xkeen -pr off
   xkeen -dgips

   Источник: известные проблемы XKeen.

   После успешной проверки запустите XKeen:

   xkeen -restart

   Затем проверьте состояние:

   xkeen -status

   Результат: ядро Xray запущено, ошибок политики или RCI нет. Перейдите к проверке с устройства.

10. 10

    Проверьте подключение с выбранного устройства

    1. Подключите тестовое устройство к этому роутеру. На время проверки выключите VPN-приложение и мобильную передачу данных на нём.
    2. Откройте сайт, который должен идти через UnderVPN, и обычный сайт. Затем откройте проверку IPv4: на странице появится один IP-адрес. Сравните его с ожидаемым IPv4 от поддержки. Если видите адрес провайдера, проверьте политику, замену всех трёх файлов и исключения IP. При собственных выборочных правилах сайт проверки тоже должен идти через прокси.
    3. Проверьте второе устройство вне политики XKeen: оно должно сохранять обычное подключение, если на нём не включён собственный VPN.
    4. После успешной проверки добавьте остальные нужные устройства в политику. Перезагрузите роутер в удобное время и повторите проверку — так вы проверите автозапуск.

    Если результат отличается, переходите к разделу помощи. При работающем IPv6 часть соединений может идти мимо IPv4-проксирования: обсудите настройку с поддержкой, не отключайте IPv6 наугад.

xkeen -stop

xkeen -remove

Вместо персонального файла для одной страны используется ссылка подписки. По ней роутер получает серверы и правила и обновляет их раз в 6 часов. Установка на конкретной модели требует проверки; это ограничение указано в инструкции.

Не смешивайте команды из разных установщиков. Эта инструкция рассчитана на форк jameszeroX/XKeen; совместимость SSClash с вашей моделью, прошивкой и подпиской требует отдельной проверки.

Поэтому в наших инструкциях их нет. Файл настроек для первого способа собирает поддержка UnderVPN; сторонний генератор для этого не нужен.