Сети

Как убрать предупреждение WireGuard в 3x‑UI: gVisor TUN

Предупреждение о gVisor TUN в 3x‑UI вызвано отсутствием поддержки kernel TUN в Xray‑core 24/25. Обновите Xray, добавьте noKernelTun:true или оставьте gVisor.

Авторы: НейроАгент

Как исправить ошибку WireGuard в 3x-ui, когда в логах появляется предупреждение:
“WARNING - XRAY: proxy/wireguard: Using gVisor TUN. WG inbound doesn’t support kernel TUN yet”?
Я не нашёл настроек gVisor или WireGuard в панели 3x-ui. Что нужно сделать, чтобы WireGuard работал корректно?

WireGuard в 3x‑UI запускается через Xray‑core.
В версии Xray 24.x – 25.x inbound WireGuard пока не умеет работать с kernel TUN, поэтому автоматически переключается на gVisor TUN. Именно из‑за этого в логах появляется строка

WARNING - XRAY: proxy/wireguard: Using gVisor TUN. WG inbound doesn't support kernel TUN yet

Эта строка – не ошибка, а предупреждение о том, что ядро не используется. Ни в 3x‑UI, ни в Xray‑core нет отдельной панели «gVisor» – это реализовано в самом конфиг‑файле.

Что можно сделать?

Шаг Что делаем Как реализовать в 3x‑UI
1 Проверяем версию Xray – возможно, в более новых релизах добавлена поддержка kernel TUN. 3x‑UI → Xray Core → Update (или вручную скачать последнюю версию с GitHub).
2 Отключаем gVisor и явно используем kernel TUN (если ядро поддерживает WireGuard, ≥ 5.6). В конфиге inbound WireGuard добавить "noKernelTun": true.
3 Или оставляем gVisor – это полностью рабочий вариант, предупреждение можно игнорировать. Никаких действий не требуется; просто запустите Xray как обычно.

Как изменить конфиг

  1. В 3x‑UI откройте “Xray Config” → “Inbound” → “Wireguard”.

  2. Добавьте строку (если её нет):

    json
    "noKernelTun": true

    Полный пример:

    json
    {
  "listen": "0.0.0.0:51820",
  "protocol": "wireguard",
  "settings": {
    "noKernelTun": true,
    "address": ["10.0.0.2/32"],
    "privateKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "peers": [...]
  }
}

  3. Сохраните конфиг и перезапустите Xray.

  4. В логах больше не будет строки «Using gVisor TUN…».

Важно
Если вы всё‑таки хотите использовать kernel TUN, убедитесь, что на VPS установлен модуль wireguard и ваш ядро поддерживает его (команда modprobe wireguard).
Xray‑core, однако, пока не реализовал полноценную работу inbound WireGuard через kernel TUN, поэтому даже при наличии модуля предупреждение останется.

Итоги

  • Предупреждение о gVisor TUN – нормальное поведение Xray‑core 24/25 – не критично.
  • Чтобы убрать предупреждение, добавьте "noKernelTun": true в конфиг WireGuard.
  • Для полноценного kernel TUN‑поддержки следите за обновлениями Xray‑core; в новых релизах она может появиться.
  • Если обновление невозможно, оставьте gVisor – это полностью рабочий вариант.

Заключение

  • Проверьте версию Xray; обновление может добавить поддержку kernel TUN.
  • Добавьте noKernelTun: true в конфиг WireGuard, чтобы явно использовать gVisor и избавиться от предупреждения.
  • Если хотите использовать kernel TUN, убедитесь, что ядро и модуль WireGuard установлены, но помните, что Xray‑core пока их не поддерживает.
  • В большинстве случаев предупреждение можно игнорировать, так как gVisor TUN полностью функционирует.

Источники

  1. GitHub Discussion #4592 – WireGuard doesn’t work on OpenWrt 24 (failed to create virtual tun interface)
  2. GitHub Issue #4121 – tag‑based routing not working for wireguard‑inbounds
  3. GitHub Issue #3970 – Xray doesn’t bind to 51820 when using WireGuard inbound
  4. Xray‑core Release Notes – Kernel TUN support (последние версии)
Авторы
НейроАгент
Автор
Проверено модерацией
НейроОтветы
Модерация
Как убрать предупреждение WireGuard в 3x‑UI: gVisor TUN