Общие вопросы
Какой роутер подойдет для XKeen?
Не подходят роутеры без USB-порта. Модели Keenetic 4G (KN-1210/1211/1213), Launcher (KN-1221), Carrier (KN-1721) и Extra (KN-1714) оснащены USB-разъемом для работы исключительно с совместимыми USB-модемами 3G/4G. Подключение USB-принтеров в этих моделях не поддерживается. Исключением являются модели Hero 4G (KN-2310/2311) и 4G (KN-1212), оснащенные многофункциональным USB-портом.
Требования к USB-накопителю
Требуется маршрутизатор с USB-портом и достаточным объёмом памяти: минимум 256 МБ флеш-памяти и 256 МБ RAM (рекомендуется 512 МБ флеш-памяти для комфортной работы Entware). USB-накопитель должен быть отформатирован в формате ext4 и иметь ёмкость не менее 512 МБ (256 МБ может работать, но места для обновлений и логов будет мало). Например, подойдёт любая флешка объёмом ≥ 1 ГБ. Подойдут носители USB 2.0/3.0 с умеренной скоростью записи (от 5 МБ/с и выше).
В чем разница баз GeoIP и GeoSite
В готовый пресет включены все основные заблокированные сервисы. Дополнительная информация про базы: zkeen domians и zkeen ip. Другие GEO параметры являются альтернативой. Вы можете выбрать необходимые. Здесь можно узнать больше про v2fly.
Представленные базы данных для загрузки правил выполняют одну и ту же функцию, но внутри себя используют свои варианты баз доменов и адресов.

Значительное снижение скорости Wi-Fi на всех устройствах после установки XKeen
XKeen по умолчанию обрабатывает весь трафик через nfqueue, что может нагружать ЦП и снижать пропускную способность.
Исключите ненужные устройства из политики XKeen в веб-интерфейсе Keenetic, чтобы они работали напрямую.
Уменьшите число портов обработки (
ap,dp) или настройте отдельные политики для разных групп устройств.
Не удаётся подключиться по SSH к роутеру
Пример: «ssh: connect to host 192.168.1.1 port 222: Connection refused», а на порт 22 пароль root не подходит.
Ответ: убедитесь, что установлен компонент ssh server и работает Entware. По умолчанию XKeen использует порт 222. Если его нет, попробуйте 22. При отсутствии ssh-модуля его нужно доустановить.
После обновления перестал работать весь трафик через XKeen
Ответ: чаще всего это происходит из-за несовпадения версий Xray. Решение — обновить или откатить обе стороны (сервер и клиент) до одинаковой версии.
Настройка маршрутизации
Порядок применения правил маршрутизации XKeen
Правила маршрутизации в xray обрабатываются последовательно сверху вниз. Оставляйте правило default (outboundTag direct) последним и не меняйте его позицию.
Где XKeen читает файл роутинга?
XKeen загружает маршрутизацию исключительно из файла
/opt/etc/xray/05_routing.json. Все правила должны быть определены именно в этом файле.
Как исключить ru-зону или другие сегменты из туннеля?
Ответ: панельные блокировки работают не полностью. В
routingпропишите правилоdomain:ru → direct. Для гарантии исключения указываются именно в конфигурации.
Как настроить обход CDN или игровых сервисов с множеством IP?
Ответ: ручное добавление неэффективно. Используйте базы
geosite/geoip. При необходимости создайте свой список и подключите его как внешний (ext:geosite_custom.dat).
Как завести несколько VLESS-ключей через XKeen (балансировка)?
Добавьте все ключи в 04_outbounds.json, настройте balancer с strategy: random или leastPing. В 05_routing.json укажите использование этого балансировщика. Так можно объединить несколько серверов. Обратитесь в нашу службу поддержки — мы поможем с этим.
DNS и фильтрация
Как снять ограничения на порты, выставленные ранее через XKeen?
Пример: «Я задавал порты через xkeen -ap, как их убрать?»
Ответ: используйте команду
xkeen -dp(без параметров или с диапазоном). Она сбрасывает ограничения, заданные ранее через CLI.
Как отключить использование провайдерских DNS в Keenetic?
Пример: «DNS я задал, но тест всё равно показывает адреса провайдера».
Ответ: нужно отключить «Транзит DNS-запросов» в настройках роутера и снять галочку «Многопутевая передача» у политики XKeen. После этого DNS-запросы будут идти только через выбранные публичные серверы.
Совместимость и сервисы
Не работает приложение Gemini (Google) через XKeen.
Ответ: сервис проверяет реальную страну по IP. Если ваш VPS не подходит, нужно сменить сервер или указать другой узел с допустимой геолокацией.
Почему не работает ChatGPT через XKeen?
Ответ: OpenAI может банить IP-адреса, принадлежащие хостингам. Даже если прописан
ext:geosite_v2fly.dat:openai, возможна блокировка UDP/443. Решение — убедиться, что провайдер не блокирует этот порт, или направить ChatGPT через другой outbound (например, WARP/прокси).
Почему не работает Telegram через XKeen?
Ответ: в стандартных базах v2fly есть домены и IP для TG. В zkeen также есть IP Meta/WhatsApp. Добавьте
ext:geosite_v2fly.dat:telegramилиext:geoip_zkeenip.dat:telegram, чтобы трафик направлялся через VPS.
Работает ли WhatsApp через XKeen?
Ответ: да, WhatsApp включён в категорию Meta. Используйте
ext:geosite_v2fly.dat:facebookиext:geosite_v2fly.dat:instagram, а такжеext:geoip_zkeenip.dat:meta— туда входят IP WhatsApp. Для звонков иногда помогает использовать мобильные клиенты напрямую (v2rayNG/nekobox,Happ).
Почему Instagram/Meta не работает даже при добавленных доменах?
Ответ: для Meta/Instagram блокировка идёт не только по доменам, но и по IP. Нужно использовать IP-базу (
ext:geoip_zkeenip.dat:meta) или добавить конкретные IP-адреса. Также стоит проверить работу IPv6 — иногда Meta работает только при его отключении.
Игры и стриминговые сервисы
Почему Battlefield 3 или другие игры не подключаются через XKeen?
Ответ: EA и другие игровые компании не публикуют подсети, их IP постоянно меняются. Для стабильной работы используйте базы
geoip/geositeи добавьте необходимые диапазоны UDP-портов (например, 3659, 14000–14016 для EA). Ручное добавление IP неэффективно.
Почему Steam ограничивает скорость?
Ответ: если в конфигурации Steam находится в исключениях
direct, то провайдер может ограничивать прямое соединение и снижать скорость.Решение: убрать Steam из
direct, чтобы трафик шёл через VPS. Также проверьте работу IPv6: иногда при его отключении скорость восстанавливается.
Диагностика и отладка
Как проверить успешную авторизацию XKeen к серверу?
Выполните команду
xkeen -status— ищите статус «connected» или «online».Проверьте логи в
/opt/var/log/xkeen/status.logи/opt/var/log/xkeen/error.log.
Почему Xkeen не запускается, хотя конфиг и политика созданы?
Пример: «Сделал всё по инструкции, а статус XKeen — "не запущен"».
Ответ: частая причина — ошибка в конфиге (
04_outbounds.jsonили05_routing.json). Проверьте файлы и перезапустите сервис через SSH командойxkeen -restart.
Что делать, если перестали работать зарубежные сайты, а RU открываются?
Пример: «Через XKeen открываются только российские сайты».
Ответ: проверить статус
xkeen -status(если «не запущен» — перезапустить). Убедиться, что отключён «транзит DNS» и политика активна. Часто проблема в повреждённом05_routing.jsonили конфликте с другими VPN/прокси на устройстве.
Полное удаление XKeen
Запустите
xkeen -remove: эта команда полностью деинсталлирует XKeen. Она удаляет все компоненты XKeen с роутера, если больше не требуется использование утилиты.Затем удалите каталоги /opt/etc/xray, /opt/var/log/xkeen, /opt/bin/xkeen, очистите /opt/usr/lib/xui.
Ошибка «chmod: ./install.sh: No such file or directory, unexpected newline»
Пример: команда
chmod +x ./install.shвозвращаетNo such file or directory, unexpected newline.Решение: ошибка указывает на опечатку или неверный путь. Убедитесь, что вы находитесь в правильной директории и файл
install.shдействительно присутствует. Используйтеlsдля проверки и исправьте путь или имя файла перед выполнением команды.
Предупреждение в PuTTY: «WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!»
Пример: при попытке подключения по SSH появляется сообщение
WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!Решение: это означает, что SSH-ключ сервера изменился. Возможно, вы переустанавливали ОС или произошёл At&ck Man-in-the-Middle.
Удалите старый ключ из
known_hosts: выполните в терминалеsed -i '' '1d' ~/.ssh/known_hosts(удаляет первую строку).При желании полностью очистите файл:
> ~/.ssh/known_hosts.Повторно подключитесь по SSH и подтвердите новый ключ.
Синтаксическая ошибка JSON в конфигурационных файлах
Пример: при перезапуске
xkeenв логах появляетсяfailed to parse config: unexpected character '}'илиparse error near line 12.Решение: проверьте JSON-конфигурации (
03_inbounds.json,04_routing.json,05_outbounds.json): убедитесь, что нет лишних или пропущенных запятых, кавычек, скобок.
Не начинается процесс установки Entware
Пример: после того, как вы вставили флешку с названием OPKG, создали папку install, поместили туда файл для установки Entware (aarch64, mipsel или mips) и выбрали этот накопитель в разделе OPKG, в системном журнале не начинается процесс установки.
Решение: проверьте имя файла установки. Например: в конце aarch64-installer.tar допишите формат «.gz». Удалите файл и замените на корректный. Название должно быть «aarch64-installer.tar.gz».
Xkeen не запускается после перезагрузки
Ошибка
mkdir: can't create directory '/opt/backups': Structure needs cleaning.Ответ: проверьте, существует ли
/opt/backups. Если нет — создайте вручную. У некоторых папкаbackupsпоявляется в корне — путь нужно исправить.
Как выполнить диагностику XKeen
Выполните команду
xkeen -diag. Она проводит диагностику текущих настроек прокси-клиента, чтобы найти и устранить ошибки.После выполнения команды перейдите в директорию OPKG/opt/ и загрузите файл diagnostic.txt.

Совместимость с другими сборками/скриптами
Можно ли поставить XKeen поверх KVAS или держать обе системы одновременно?
Пример: «KVAS уже стоит. Если я просто отключу KVAS, XKeen будет работать нормально?»
Ответ: не рекомендуется. KVAS меняет системные настройки (DNS, iptables, автозапуск служб), из‑за чего возникают конфликты и «двойное проксирование». Лучший вариант — полный сброс роутера к заводским, затем установка Entware и чистая установка XKeen. Так вы исключите скрытые правки и получите предсказуемую работу.