🆕 Что нового в 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, маски Finalmask header-dns, header-dtls, header-srtp, header-utp, header-wechat, header-wireguard, mkcp-original и mkcp-aes128gcm (замена — маска mkcp-legacy).
  • Новое: транспорт 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 значения security: none и zero убраны: они молча превращаются в auto. У Shadowsocks method: none и plain дают ошибку unknown cipher method (тот же PR)7 июлявыбрать настоящий шифр
Корневой блок reverse не принимается, ядро подсказывает перейти на VLESS Reverse Proxy25 апреляперенести настройку в поле reverse пользователя VLESS
Mux: значения concurrency от 0 до 128 поднимаются до 128 (раньше пустое значение означало 8); значения выше 128 сохраняются; одно соединение Mux теперь обслуживает до 1024 потоков за всё время жизни (было 128)6 ноябряуменьшить число потоков в этой версии нельзя; отрицательное concurrency отключает мультиплексор
MPTCP по умолчанию выключен для всех слушающих сокетов (PR #7291)31 октябряесли MPTCP нужен, включить sockopt.tcpMptcp; о причинах — CVE-2026-98432
Клиентский TLS доверяет встроенному списку корневых сертификатов, а не системному (PR #7105)10 октябряесли вы подключаетесь к серверу с корпоративным или самоподписанным сертификатом, включите "useSystemCA": true или задайте сертификат в настройках TLS явно
Серверы XHTTP, WebSocket, HTTPUpgrade и gRPC учитывают заголовок X-Forwarded-For, только если в запросе есть один из заголовков, перечисленных в sockopt.trustedXForwardedFor (это список имён заголовков, например X-Forwarded-For или CF-Connecting-IP, а не адресов) (PR #6309)19 июняесли сервер стоит за CDN или nginx, впишите имя заголовка, который добавляет прокси
Входящие clients и accounts называются users; старые имена по-прежнему читают все входящие (PR #6083)7 маяпереименовать при ближайшей правке
Поле транспорта network называется method; оба имени читаются (PR #6426)7 июляпереименовать при ближайшей правке
Входящий tunnel: address, port, network стали rewriteAddress, rewritePort, allowedNetwork; старые имена читаются (PR #6084)7 маяпереименовать при ближайшей правке
Исходящий dns: без rules и без старых nonIPQuery и blockTypes запросы не A и не AAAA теперь получают пустой ответ NOERROR (в 26.3.27 они получали REFUSED, потому что nonIPQuery по умолчанию был reject). Явные nonIPQuery и blockTypes из 26.3.27 работают как раньше, но с предупреждением об устаревании и только без rules. В rules (появились в пре-релизе 26.4.25) действие reject заменено на return (rCode по умолчанию 0) (PR #6214); address, port, network переименованы в rewriteAddress, rewritePort, rewriteNetwork, старые имена читаются (PR #6084)7 мая, 1 июнячтобы вернуть прежний отказ, задайте правила [{"action": "hijack", "qType": "1,28"}, {"action": "return", "rCode": 5}]
Исходящий freedom: в finalRules (они появились 2 мая в 26.5.3, в 26.3.27 их нет) поле blockDelay переименовано в delay, старое имя читается с предупреждением; добавлен logLevel (PR #7329); fragment и noises помечены к переносу в Finalmask (PR #7242)4 ноября, 29 октябряесли писали blockDelay в пре-релизе, заменить на delay; со временем перенести fragment и noises в маски
WireGuard (исходящий): domainStrategy убран и молча игнорируется (PR #6771); режим local у remoteDNS (поле появилось только в пре-релизе 26.9.9, PR #6620) касается лишь конфигов с пре-релизов21 сентябряубрать domainStrategy из конфигурации
Маски Finalmask header-dns, header-dtls, header-srtp, header-utp, header-wechat, header-wireguard, mkcp-original и mkcp-aes128gcm заменены одной маской mkcp-legacy с полями header и value (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 сентябряактуально только для самостоятельной сборки
freedom по умолчанию блокирует частные IP для трафика из входящих vless, vmess, trojan, shadowsocks, hysteria, wireguard и masque (PR #5947, PR #6027)16 апреля, 2 маяклиенты VPN теряют доступ к 127.0.0.1 и локальной сети; если он нужен, добавьте в finalRules правило с action: "allow"
Finalmask: quicParams.udpHop убран и молча игнорируется, поэтому смена портов Hysteria перестаёт работать; замена — маска udphop (PR #6327)9 сентябряперейти на маску udphop
Маска XDNS: вместо одного domain теперь domains и resolvers (PR #5872); вложенные поля переименованы в names и addrs (PR #7090). Старое domain молча игнорируется12 апреля, 5 октябряпереписать настройки маски
FakeDNS: пул IPv6 по умолчанию изменён с fc00::/18 на 2001:2::/48 (PR #6815)26 сентябрясверить, если на пул привязаны правила
Часть полей убрана без ошибки и молча игнорируется: workers у WireGuard (PR #6287), XHTTP sessionPlacement и sessionKey (теперь sessionIDPlacement и sessionIDKey), TLS verifyPeerCertInNames (в 26.3.27 давал ошибку)июньубрать из конфигурации
Исходящий proxySettings больше не принимается: ядро отвечает ошибкой и предлагает streamSettings.sockopt.dialerProxy (PR #6058)8 сентябрязаменить на streamSettings.sockopt.dialerProxy
freedom блокирует весь трафик, который пришёл через VLESS Reverse Proxy (а не только частные IP) (PR #6027)2 маяесли такой трафик должен выходить наружу, добавьте в finalRules правило с action: "allow"
Входящий hysteria теперь требует "version": 2 в settings, иначе конфиг отклоняется с ошибкой version != 2 (в 26.3.27 это проверял только исходящий) (проверку добавил коммит 345c76f9, попавший в PR #6360)27 июнядобавить "version": 2
Shadowsocks: поля uot и uotVersion (UDP через TCP) убраны и молча игнорируются (PR #6286)9 июняубрать, UDP через TCP в этом протоколе больше не включить
Транспорт kcp: поля congestion, readBufferSize, writeBufferSize убраны и молча игнорируются, по умолчанию применяется менее агрессивная стратегия, добавлен cwndMultiplier (PR #5890)14 апреляубрать поля, скорость сверить заново
Маска XICMP: вместо listenIp и id теперь ips (несколько адресов) и dgram; старые поля молча игнорируются (PR #6168)29 маяпереписать настройки маски
Исходящий freedom с sockopt.addressPortStrategy отклоняется ошибкой freedom outbound does not support "sockopt.addressPortStrategy" (PR #6058)8 сентябряубрать поле

Команда xray run -test не ловит удалённые поля: неизвестные поля JSON ядро не отвергает, они просто игнорируются, а XRAY_JSON_STRICT отключает только разбор комментариев. Поэтому после обновления стоит сверить конфиг с таблицей вручную.

Обратите внимание на строку про 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.12.2 (через 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 получил gateway, dns, autoSystemRoutingTable и autoOutboundsInterface (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 (подпись скриптов) и xray ed25519 в 26.11.9 отключены (PR #7136). Подкоманда xray buildMphCache и переменная xray.mph.cache убраны ещё в 26.4.13 (PR #5814). В корне конфигурации появился блок env (PR #6400), а переменная XRAY_JSON_STRICT=true включает строгий разбор JSON (PR #6053).

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

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

Источники

📚 См. также


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

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