XKeen на Keenetic: настройка маршрутизации на весь роутер

Зачем настраивать XKeen на роутере

Приложения вроде FlClashX или Happ настраиваются на каждом устройстве отдельно: отдельная установка, отдельный ввод ключа, отдельное обновление. Для телефона и ноутбука это удобно, но для смарт-ТВ, игровой приставки или умных колонок такого приложения часто просто не существует.

XKeen решает это на уровне роутера: конфиг прописывается один раз, а дальше маршрутизация работает для всех устройств домашней сети — либо для конкретных устройств, выбранных в отдельной политике доступа Keenetic, либо сразу для всей сети без исключений. Работает XKeen поверх ядра Xray или Mihomo (Clash Meta) — то же самое ядро, что используют десктопные и мобильные клиенты, только запущенное прямо на роутере.

XKeen — открытый community-проект, не входит в прошивку Keenetic и не разрабатывается производителем роутеров. Актуальный форк (версия 2.0, обновлён в июне 2026 года) поддерживается разработчиком JamesZero, исходники и документация — на GitHub.

Формально XKeen ставится на любой Keenetic (или Netcraze — тот же роутер для российского рынка) с USB-портом и поддержкой пакетов Entware. Но по мощности процессора модели заметно различаются — от этого напрямую зависит скорость и стабильность работы.

Пошаговая установка Entware и XKeen

Сначала на роутер ставится среда Entware — она даёт доступ к пакетному менеджеру OPKG и месту для установки сторонних утилит вроде XKeen. Дальше сам XKeen устанавливается через собственный интерактивный установщик.

Команды для установки в SSH-консоли роутера:

opkg update && opkg upgrade && opkg install curl tar && cd /tmp
sh -c "$(curl -sSL https://raw.githubusercontent.com/jameszeroX/XKeen/main/install.sh)"

Установщик покажет несколько экранов выбора: сначала — ядро проксирования (Xray, Mihomo или оба), затем — их версии, при выборе Xray — списки GeoSite и GeoIP, опционально — исключение российских IP-подсетей из маршрутизации, автообновление geo-баз по расписанию и добавление XKeen в автозагрузку роутера.

Как вписать свой ключ в конфиг сервера

Для ядра Xray подключение к серверу описывается в файле /opt/etc/xray/configs/04_outbounds.json. Именно сюда нужно вставить параметры вашего ключа — адрес сервера, идентификатор, публичный ключ Reality и короткий ID.

Структура блока outbound для VLESS + Reality выглядит так — поля в угловых скобках берутся из вашего ключа:

{
  "tag": "proxy",
  "protocol": "vless",
  "settings": {
    "vnext": [
      {
        "address": "<адрес сервера из ключа>",
        "port": 443,
        "users": [
          {
            "id": "<uuid из ключа>",
            "encryption": "none",
            "flow": "xtls-rprx-vision"
          }
        ]
      }
    ]
  },
  "streamSettings": {
    "network": "tcp",
    "security": "reality",
    "realitySettings": {
      "serverName": "<sni из ключа>",
      "publicKey": "<publicKey из ключа>",
      "shortId": "<shortId из ключа>",
      "fingerprint": "chrome"
    }
  }
}

Списки маршрутизации: что и как направлять через сервер

Второй файл — /opt/etc/xray/configs/05_routing.json — описывает, какой трафик идёт через outbound «proxy», а какой — напрямую (outbound «direct»). Это и есть выборочная маршрутизация: сайты и сервисы из списка идут через сервер, всё остальное — как обычно, через провайдера.

{
  "routing": {
    "rules": [
      {
        "domain": ["geosite:category-you-need", "example.com"],
        "outboundTag": "proxy"
      },
      {
        "network": "tcp,udp",
        "outboundTag": "direct"
      }
    ]
  }
}

Правила читаются сверху вниз: домены и подсети из первого правила уходят через «proxy», всё, что не попало ни в одно правило выше, — направляется в конце через «direct» по умолчанию. Готовые подборки доменов (GeoSite) можно скачать при установке или обновить позже командой xkeen -ug.

Один сервер для отдельных устройств или для всей сети

В веб-интерфейсе Keenetic можно создать отдельную политику доступа в интернет и привязать к ней только нужные устройства (например, только смарт-ТВ и приставку) — тогда маршрутизация через сервер будет применяться исключительно к ним, а ноутбук и телефон продолжат ходить в интернет как обычно. Если политику не создавать и не привязывать к ней конкретные устройства, маршрутизация по правилам из 05_routing.json применяется сразу ко всем клиентам роутера.

Частые ошибки и как их исправить

Более широкий сборник вопросов и ответов по XKeen ведёт сам разработчик проекта:

Подробное пошаговое руководство по установке с иллюстрациями каждого экрана — в официальной вики проекта: