Общие вопросы

Какой роутер подойдет для 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.

    1. Удалите старый ключ из known_hosts: выполните в терминале sed -i '' '1d' ~/.ssh/known_hosts (удаляет первую строку).

    2. При желании полностью очистите файл: > ~/.ssh/known_hosts.

    3. Повторно подключитесь по 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. Так вы исключите скрытые правки и получите предсказуемую работу.