🆕 Что нового в Xray-core 26.11.9: разница с предыдущей стабильной 26.3.27

О чём заметка

Сравнение официального ядра Xray-core версии 26.11.9 (9 ноября 2026) с предыдущей стабильной версией 26.3.27 (27 марта 2026): что в конфигурации перестало работать, что поведение изменило молча, и что добавилось. Устройство самих компонентов — в каталоге компонентов; история проекта — в Project X.

Откуда взяты данные

Официальные заметки к релизу 26.11.9 почти пусты: в них только две ссылки (транспорт XDRIVE и отпечаток Chrome 155). Автор проекта в заметках к релизу 26.10.21 прямо написал, что полное описание накопленных за полгода изменений отложено. Поэтому список ниже восстановлен по истории коммитов между тегами v26.3.27 и v26.11.9 (388 коммитов) и по коду самих тегов. Названия параметров проверены в коде, а мотивы изменений в сообщениях коммитов не всегда объяснены, так что там, где они не названы, текст их не додумывает. Перед обновлением боевого сервера проверьте конфигурацию командой xray run -test.

TL;DR

  • «Предыдущая стабильная» здесь — 26.3.27. После неё GitHub 13 раз выпускал версии с пометкой pre-release (от 26.4.13 до 26.9.30), а следующей стабильной стала только 26.10.21, поэтому разница накопилась за полгода и разом.
  • Самое важное для сервера: VLESS и Trojan без шифрования к публичному адресу больше не принимаются, Mux по умолчанию получает 128 потоков вместо 8, MPTCP выключен, а встроенный корневой список сертификатов заменил системный.
  • Из конфигураций уходят: корневой reverse (замена — обратный прокси VLESS), режимы без шифрования у VMess и Shadowsocks, заголовки mKCP dns, dtls, srtp, utp, wechat, wireguard (замена — маска mkcp-legacy), blockDelay.
  • Новое: транспорт XDRIVE (хранилище как канал), протокол и транспорт MASQUE, пять новых масок Finalmask, скрипты Lua в маршрутизации и DNS, модуль geodata с автообновлением, собственный TCP/IP-стек вместо gVisor.
  • После тега 26.11.9 в main уже есть ломающие правки (например, finalRules → firewall), которых в этом релизе нет.

Какая версия считается стабильной

На странице релизов GitHub у каждой версии есть пометка: стабильная или pre-release. Проект выпускает много версий подряд, и обычный пользователь получает только те, что помечены стабильными. Вот как выглядит последний год по этим пометкам: 26.2.6 → 26.3.27 (стабильные) → 13 pre-release от 26.4.13 до 26.9.30 → 26.10.21 → 26.10.31 → 26.11.9 (стабильные).

Две из трёх последних стабильных версий вышли как срочные исправления безопасности. Версия 26.10.21 убрала из встроенного списка корневых сертификатов три записи: поводом названо вскрытие закрытых ключей нескольких индийских промежуточных сертификатов, ключи которых оказались слишком простыми. Она собрана на Go 1.27.3, чтобы такие сертификаты отфильтровывались, даже если список в операционной системе не обновлён; версии 26.10.10 и 26.10.17 автор отозвал. Версия 26.10.31 закрыла опасность MPTCP на Linux (версия 26.10.29 тоже отозвана). Версия 26.11.9 — первая после них с обычным набором изменений.

Что может сломать старый конфиг

Таблица собрана по сообщениям коммитов и проверена по коду тега 26.11.9. В столбце «Дата» указан день попадания изменения в основную ветку: в релиз оно вошло со следующей по времени версией.

Что изменилосьДатаЧто делать
Исходящий vless без TLS, REALITY или encryption и исходящий trojan без TLS отклоняются, если адрес сервера не частный IP и не частный домен (PR #6303)7 июлявключить security: tls или reality, либо задать encryption (ключи — xray vlessenc)
У VMess и Shadowsocks убраны режимы без шифрования: none, zero, plain (тот же PR)7 июлявыбрать настоящий шифр
Корневой блок reverse не принимается, ядро подсказывает перейти на VLESS Reverse Proxy25 апреляперенести настройку в поле reverse пользователя VLESS
Mux: значения concurrency от 0 до 128 поднимаются до 128 (раньше пустое значение означало 8); значения выше 128 сохраняются; число соединений на один мультиплексор ограничено 10246 ноябряуменьшить число потоков в этой версии нельзя; отрицательное concurrency отключает мультиплексор
MPTCP по умолчанию выключен для всех слушающих сокетов (PR #7291)31 октябряесли MPTCP нужен, включить sockopt.tcpMptcp; о причинах — CVE-2026-98432
Клиентский TLS доверяет встроенному списку корневых сертификатов, а не системному (PR #7105)10 октябряесли вы подключаетесь к серверу с корпоративным или самоподписанным сертификатом, задайте его в настройках TLS явно
Серверы XHTTP, WebSocket, HTTPUpgrade и gRPC учитывают заголовок X-Forwarded-For только от адресов из sockopt.trustedXForwardedFor (PR #6309)19 июняесли сервер стоит за CDN или nginx, перечислите их адреса
Входящие clients и accounts называются users; для VLESS старое clients ядро читает по-прежнему (PR #6083)7 маяпереименовать при ближайшей правке
Поле транспорта network называется method; оба имени читаются (PR #6426)7 июляпереименовать при ближайшей правке
Входящий tunnel: address, port, network стали rewriteAddress, rewritePort, allowedNetwork; старые имена читаются (PR #6084)7 маяпереименовать при ближайшей правке
Исходящий dns: действие reject заменено на return (rCode по умолчанию 0) (PR #6214)1 июнязаменить в правилах
Исходящий freedom: в finalRules поле blockDelay переименовано в delay, добавлен logLevel (PR #7329); fragment и noises помечены к переносу в Finalmask (PR #7242)4 ноября, 29 октябрязаменить blockDelay на delay; со временем перенести fragment и noises в маски
WireGuard (исходящий): убраны режим local у remoteDNS и domainStrategy (PR #6771)21 сентябряубрать из конфигурации
Заголовки mKCP dns, dtls, srtp, utp, wechat, wireguard заменены маской mkcp-legacy (PR #6201)29 маяперейти на маску Finalmask
TLS: убран параметр echForceQuery (ECH теперь применяется всегда, если настроен) (PR #6032); удалены ещё несколько устаревших полей (PR #6226)2 мая, 3 июняубрать
XHTTP: параметры session* переименованы в sessionID* и добавлены sessionIDTable, sessionIDLength (PR #6258); у клиента по умолчанию maxConnections теперь 3 (27 июня вместо прежнего maxConcurrency: 1 задали maxConnections: 6, 28 июля снизили до 3; оба выпуска были пре-релизами, в стабильных версиях значение 3 с 26.10.21)9 июня, 28 июлясверить, если вы полагались на значение по умолчанию
Для Go нужна версия 1.27 (go.mod: было 1.26)8 сентябряактуально только для самостоятельной сборки

Обратите внимание на строку про Mux: она не вызывает ошибку, поведение меняется молча. Клиент с mux.concurrency: 8 теперь складывает в одно соединение до 128 потоков, и причина возможного падения скорости из журнала не видна. В релизе 26.11.9 это действует для всех транспортов; в main уже есть правка, ограничивающая значение 128 транспортом XDRIVE.

Отдельно про REALITY: значение по умолчанию minClientVer: 26.3.27 действовало только в пре-релизах. Его добавили 11 июля (тогда сервер переставал принимать клиентов старше 26.3.27), а 8 сентября отключили при обновлении библиотеки REALITY: в коде осталась закомментированная строка. В стабильных версиях 26.10.21, 26.10.31 и 26.11.9 порога по умолчанию нет, он включается только если задать minClientVer в конфиге самому.

Новые компоненты

Транспорты и протоколы

XDRIVE — транспорт, в котором клиент и сервер обмениваются данными не напрямую, а через общее хранилище. Он появился в сентябре (PR #5645, бэкенд Google Drive и шаблонный бэкенд — PR #6748) и к ноябрю получил бэкенд S3 (PR #7231), поддержку HTTP/3 (PR #7187) и серию оптимизаций, о которых говорится в заметках 26.11.9. С 17 октября он требует VLESS с encryption и включённый mux (PR #7182).

MASQUE — туннель IP по стандарту IETF CONNECT-IP (RFC 9484): исходящий и транспорт добавлены 24 сентября (PR #6807), входящий — 27 сентября (PR #6844), позже поддержка HTTP/2 (PR #6810), WARP (PR #6878) и XMUX (PR #7121).

Hysteria обновлена с 2.8.2 (PR #6041) до официальной 2.12.2 (PR #6565); входящий Hysteria теперь понимает vlessRoute в маршрутизации (PR #6375).

WireGuard (входящий) получил управление пирами на лету (PR #6360), у исходящего появился remoteDNS с учётом TTL (PR #6620).

Shadowsocks 2022 переписан без зависимостей от библиотек sing (PR #6831); SOCKS5 строже следует RFC 1928 в UDP ASSOCIATE (PR #6149); у blackhole можно задать собственный ответ (PR #6713); у dns-исходящего появились правила по типу записи и домену (PR #5981); у loopback — sniffing (PR #6326).

Finalmask

За полгода Finalmask из набора отдельных приёмов превратился в общий слой. Новые маски: realm (PR #6137), udphop (PR #6327), xmc (PR #6210), filter (PR #7206) и mkcp-legacy. У header-custom появились программируемые шаблоны рукопожатия (PR #5920), у fragment — lengths и delays (PR #6334), у xdns — поддержка DoH и список резолверов, а noise умеет выполнять Lua-скрипт (PR #7124). Транспорты теперь строятся поверх диалера и слушателя Finalmask (PR #6754). Сами маски разобраны в каталоге компонентов.

TUN и собственный сетевой стек

Входящий tun существовал и в 26.3.27, но с тех пор вырос: получил поддержку Windows (PR #5887) и FreeBSD (PR #5891), параметры autoSystemRoutingTable и autoOutboundsInterface для Linux и macOS (PR #6366), счётчики трафика (PR #6349) и на Windows защиту от утечек вне туннеля (autoSystemWfpBlockLeak). В октябре ядро перестало зависеть от gVisor: TUN (PR #7130), WireGuard и MASQUE (PR #7156) используют встроенный облегчённый TCP/IP-стек.

Маршрутизация, DNS и geodata

Lua — скрипты для правил маршрутизации и DNS (PR #6823), с 16 октября в песочнице с белым списком функций, а inline-скрипты временно отключены (PR #7136). Geodata вынесена в отдельный модуль с обновлением по расписанию и горячей заменой файлов (PR #5992), с ограничениями на размер, расширения и частоту загрузки (PR #7267) и разбором сжатых файлов .dat.gz (PR #7334). Сборки ядра на GitHub теперь берут встроенные списки из репозитория XTLS/Xray-rules-dat. В правилах появилось условие localOS (PR #6553), условие process научилось работать на macOS, а на Android — с UID. Sniffing получил ipsExcluded (PR #5929), geosite: в domainsExcluded (PR #5927) и поддержку QUICv2 (PR #6695). Балансировщик leastload наконец реализовал заявленный параметр tolerance (PR #6156). У FakeDNS пул IPv6 по умолчанию стал 2001:2::/48 (PR #6815).

XHTTP и безопасность соединения

В XHTTP серверы получили h2Params (PR #7295) и возможность принимать OPTIONS как метод загрузки (PR #7290), клиент стал по умолчанию открывать меньше параллельных соединений. Разбор самого транспорта — в заметке про XHTTP. В XTLS Vision исправлена совместимость с Go 1.27.3 (PR #7176) и убрано лишнее закрывающее уведомление внешнего TLS после перехода на прямое копирование (PR #6834). Соответствие флага flow и других полей протоколу — в XTLS Vision.

API, команды, конфигурация

В API появился запрос статистики пользователей GetUsersStats (PR #5776), xray api adu научился работать с Hysteria (PR #6847). Новые подкоманды — xray base64 (PR #7132) и xray lua sign для подписи скриптов. В корне конфигурации появился блок env (PR #6400), а переменная XRAY_JSON_STRICT=true включает строгий разбор JSON (PR #6053).

Что уже есть в main, но не вошло в 26.11.9

Тег 26.11.9 поставлен 9 ноября. С того времени в ветку main вошли правки, которых в релизе нет: finalRules переименован в firewall, добавлен reply, исходящие block и blackhole объединены, proxyProtocol перенесён (18 ноября); маска xmc перешла на «родное» дополнение кадров, и это ломающее изменение (PR #7402); поведение Mux 128 ограничено транспортом XDRIVE (PR #7375). Если сервер собран из main, а не из релиза, сверяйтесь с исходниками именно этой ветки.

Источники

📚 См. также


🤖 Эти статьи открыты — можно обучать на них ИИ

При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование и скачивание всего репозитория одним zip-архивом доступны в Forgejo: исходник этой заметки · весь репозиторий.