todo/xray-core/changes-26-11-9.md
loop-uh 911497ce90
Some checks failed
Published content check / validate (push) Failing after 7s
Xray: заметки сверены вторым кругом с кодом v26.11.9, добавлена схема-обзор в начало карты слоёв
В начале xray-core/vless-stack-map появилась схема «Что где лежит в конфиге»: протокол, транспорт и слой безопасности как три разных поля, flow и encryption внутри протокола VLESS, то, что слоем не является, и примеры связок.

Правки по итогам независимой сверки девяти заметок с кодом и первоисточниками:
- vless-stack-map: пара hysteria односторонняя (протоколу нужен транспорт, транспорту с auth протокол не нужен), у masque двусторонняя; Vision работает и на kcp с TLS, а на xdrive flow запрещён; при concurrency -1 TCP идёт мимо Mux, но xudpProxyUDP443 по умолчанию режет UDP/443; направление слоёв в таблице splice; история запрета VLESS без защиты и PR #6640 и #6741.
- vless-flow-mux-russia: слова «for now» добавил RPRX, а не M03ED; выводы вынесены из блока подтверждённого; добавлен код v2rayN, Happ и Throne; точнее цитаты и статусы.
- vless, xtls-vision, reality, vless-encryption, xhttp: убрана выдуманная строка ошибки для старых flow, исправлены оговорки про транспорты, FEC в mKCP, третье условие REALITY (X25519MLKEM768), SNI в XHTTP, USENIX про Vision, актуальность пре-релизов.
- components и changes-26-11-9: исправлены xray lua и ed25519, PR XDNS, blackhole, WireGuard, DNS и добавлены тихие поломки конфига (proxySettings, freedom и обратный прокси, version 2 у входящего hysteria и другие).
- Схема vless-encryption-layers перерисована: шифрование показано полем протокола VLESS, а не слоем.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-18 18:32:37 +03:00

42 KiB
Raw Permalink Blame History

date tags aliases description
2026-11-18
xray
xray-core
changelog
миграция
vless
Что нового в Xray-core 26.11.9
Xray-core 26.11.9 изменения
Чем Xray 26.11.9 отличается от 26.3.27
Что сломалось в конфиге Xray после обновления
Xray-core changelog 2026
Разница между Xray-core 26.11.9 и предыдущей стабильной 26.3.27: что убрали, что стало обязательным, новые транспорты, Finalmask, TUN, Lua и безопасность.

[!mirror] Резервное зеркало Актуальная версия этой страницы — на основной вики: pyzluhgrnw.osjcpjzipyb.click/xray-core/changes-26-11-9

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

[!info] О чём заметка Сравнение официального ядра Xray-core версии 26.11.9 (9 ноября 2026) с предыдущей стабильной версией 26.3.27 (27 марта 2026): что в конфигурации перестало работать, что поведение изменило молча, и что добавилось. Устройство самих компонентов — в xray-core/components; история проекта — в xray/project-x.

[!warning] Откуда взяты данные Официальные заметки к релизу 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 Proxy 25 апреля перенести настройку в поле reverse пользователя VLESS
Mux: значения concurrency от 0 до 128 поднимаются до 128 (раньше пустое значение означало 8); значения выше 128 сохраняются; одно соединение Mux теперь обслуживает до 1024 потоков за всё время жизни (было 128) 6 ноября уменьшить число потоков в этой версии нельзя; отрицательное concurrency отключает мультиплексор
MPTCP по умолчанию выключен для всех слушающих сокетов (PR #7291) 31 октября если MPTCP нужен, включить sockopt.tcpMptcp; о причинах — xray/mptcp-linux-kernel-rce-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). Сами маски разобраны в xray-core/components.

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), клиент стал по умолчанию открывать меньше параллельных соединений. Разбор самого транспорта — в xray/xhttp. В XTLS Vision исправлена совместимость с Go 1.27.3 (PR #7176) и убрано лишнее закрывающее уведомление внешнего TLS после перехода на прямое копирование (PR #6834). Соответствие флага flow и других полей протоколу — в xray/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, а не из релиза, сверяйтесь с исходниками именно этой ветки.

Источники

📚 См. также


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