🆕 Что нового в 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, заголовки mKCPdns,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 Proxy | 25 апреля | перенести настройку в поле reverse пользователя VLESS |
Mux: значения concurrency от 0 до 128 поднимаются до 128 (раньше пустое значение означало 8); значения выше 128 сохраняются; число соединений на один мультиплексор ограничено 1024 | 6 ноября | уменьшить число потоков в этой версии нельзя; отрицательное 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, а не из релиза, сверяйтесь с исходниками именно этой ветки.
Источники
-
PR #7212 — TLS client: Update built-in RootCAs to remove newly low-credit certs
-
PR #6309 — XHTTP & WS & HU & gRPC servers: Require
sockopt.trustedXForwardedFor -
PR #6083 — Config: Rename inbounds’
clients/accountstousers -
PR #6426 — infra/conf/transport_internet.go: Split into multiple files; Rename
networktomethod -
PR #6084 — Config: Rename
network/address/portin Tunnel inbound and DNS outbound -
PR #6214 — DNS outbound: Replace “reject” with “return” (
rCodeis 0 by default) -
PR #7242 — Direct/Freedom outbound: Warn about migrating
fragmentandnoisesto Finalmask -
PR #6771 — WireGuard outbound: Remove
remoteDNS’ “local” mode anddomainStrategy -
PR #6201 — Finalmask: Add mkcp-legacy (UDP) to replace mkcp-* and legacy header-*
-
PR #6032 — TLS ECH: Remove
echForceQuery(ECH is forced now if configured) -
PR #6258 — XHTTP transport: Add
sessionIDTableandsessionIDLength; Renamesession*tosessionID* -
PR #6748 — XDRIVE transport: Add the Google Drive and “template” backend
-
PR #7352 — XDRIVE transport: Release notes & more optimizations for the Google Drive backend
-
PR #7182 — XDRIVE transport: Require VLESS Multiplex+Encryption; “Google Drive"→"google-drive”
-
PR #6807 — Proxy: Add MASQUE outbound & transport (IETF CONNECT-IP, RFC 9484)
-
PR #6844 — Proxy: Add MASQUE inbound (IETF CONNECT-IP server, RFC 9484)
-
PR #6810 — MASQUE client: Support HTTP/2 (Extended CONNECT, RFC 8441)
-
PR #6375 — Hysteria inbound: Support
routing’svlessRouteas well -
PR #6360 — WireGuard inbound: Support dynamic peer management
-
PR #6831 — SS2022 proxy: Refactor to remove sing* dependencies
-
PR #6149 — Socks5 server: More standard UDP ASSOCIATE (RFC 1928)
-
PR #6713 — Blackhole outbound: Add customizable response data support
-
PR #5981 — DNS outbound: Add
rules(matchesqtypeanddomain, thenaction) -
PR #6137 — Finalmask: Add Realm (UDP hole punching in Hysteria v2.9.1)
-
PR #7206 — Finalmask: Add
filterfor inbound (TCP & UDP, source IP filtering) -
PR #5920 — header-custom finalmask: Add programmable handshake templates and runtime core
-
PR #6754 — Transport: Refactor to be based on Finalmask’s dialer & listener
-
PR #5887 — TUN inbound: Add
gateway,dns,autoSystemRoutingTable,autoOutboundsInterfacefor Windows -
PR #6349 — TUN inbound: Add traffic counters; Metrics: Rely on instance
-
PR #7130 — TUN inbound: Use Xray-core’s built-in lightweight TCP/IP stack instead of gVisor
-
PR #5992 — Geodata: Support automatically updating .dat files and hot reloading
-
PR #7267 — Geodata: Limit download size, file extensions, and update frequency
-
PR #7334 — Geodata: Download
.dat.gzwhen the URL belongs to XTLS/Xray-rules-dat -
PR #7185 — GitHub Actions: Switch geodata to XTLS/Xray-rules-dat
-
PR #6553 — Routing: Add
localOSthat directly matchesruntime.GOOS -
PR #5929 — Sniffing: Add
ipsExcluded(supports IP, CIDR, “geoip:”, “ext:”) -
PR #6815 — FakeDNS: Change default FakeIPv6Pool to 2001:2::/48
-
PR #6834 — XTLS Vision: Suppress outer CloseNotify after switching to direct copy
-
PR #5776 — API & Commands: Add GetUsersStatsRequest(); Improve
api statsonlineiplist -
PR #7132 — Lua: Support inline scripts; Add
./xray base64 encode/decode [-gzip]command -
PR #7375 — VLESS Multiplex (mux.cool): Raise maxConcurrency to 128 only for XDRIVE
-
Коммит af7eb68 в Xray-core: REALITY, значение minClientVer по умолчанию
-
Коммит 47cfe99 в Xray-core: обновление REALITY, порог отключён
📚 См. также
- Документация Xray-core 26.11.9 — оглавление раздела
- Компоненты Xray-core — из чего состоит ядро и как называется каждая часть в конфиге
- Project X (Xray-core) — история проекта
- CVE-2026-98432 — почему MPTCP выключен
- Протокол VLESS и VLESS Encryption — как включить шифрование, которого теперь требует ядро
- XHTTP — главный транспорт после очистки старых
🤖 Эти статьи открыты — можно обучать на них ИИ
При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование и скачивание всего репозитория одним zip-архивом доступны в Forgejo: исходник этой заметки · весь репозиторий.