🧩 Компоненты Xray-core: из чего состоит ядро

О чём заметка

Каталог всех частей официального ядра Xray-core версии 26.11.9: что делает каждая, как называется в конфиге и в каком пакете лежит. Описано только официальное ядро проекта XTLS, без сторонних сборок и клиентов. История проекта — в Project X (Xray-core): что за проект и откуда он взялся; что изменилось по сравнению с предыдущей стабильной версией — в Что нового в Xray-core 26.11.9.

К какой версии привязан текст

Всё ниже сверено с исходным кодом тега v26.11.9 от 9 ноября 2026 года. Ветка main ушла дальше: 18 ноября в неё попало, например, переименование finalRules в firewall у исходящего freedom. В релиз 26.11.9 это не входит, поэтому на сервере с этой версией пишите finalRules. Если версия у вас другая, сверяйте имена полей с xray version и документацией проекта.

TL;DR

  • Xray-core собран из слоёв: ядро (core) держит реестр компонентов, протоколы (proxy) разбирают заголовки, транспорты (transport) переносят байты, служебные модули (app) отвечают за маршрутизацию, DNS, статистику и API.
  • Любое подключение проходит одну и ту же цепочку: входящий обработчик → диспетчер → маршрутизатор → исходящий обработчик → транспорт. Протоколы подключаются к цепочке через два маленьких интерфейса, Inbound и Outbound.
  • Каждый компонент регистрирует себя при запуске программы, поэтому состав ядра определяется списком импортов в одном файле, а JSON-конфиг лишь выбирает из уже зарегистрированного.
  • В 26.11.9 в ядре 15 имён протоколов (из них masque появился в сентябре 2026), 9 транспортов (из них masque и xdrive новые), три режима security (none, tls, reality) и слой масок Finalmask поверх сокета.
  • Маски и транспорты стоят под VLESS, а не внутри него. Сам VLESS разобран в отдельной заметке, слои стека — в карте слоёв.

Общая схема: восемь каталогов

Исходный код Xray-core раскладывается по каталогам так, что каждый каталог отвечает за один уровень. Сверху вниз по ходу запроса пользователя это выглядит так.

flowchart TB
    cli["main — командная строка: run, api, x25519, uuid ..."]
    conf["infra/conf — перевод JSON в protobuf-конфиг"]
    core["core — экземпляр Instance и реестр features"]
    feat["features — интерфейсы: Dispatcher, Router, DNS Client, Policy, Stats"]
    app["app — реализации: dispatcher, proxyman, router, dns, policy, stats, log, commander ..."]
    proxy["proxy — протоколы: vless, vmess, trojan, freedom, tun ..."]
    tr["transport — доставка байтов: raw, xhttp, kcp, ws, grpc; tls, reality; finalmask"]
    common["common — буферы, mux, xudp, session, sniffers, uuid, net"]
    cli --> conf --> core
    core --> feat
    feat --> app
    app --> proxy
    proxy --> tr
    app --> common
    proxy --> common
    tr --> common

Проще говоря: main читает файл конфигурации, infra/conf превращает привычный JSON в внутренний формат (protobuf), core создаёт из него работающий экземпляр, а дальше все остальные пакеты — просто компоненты, которые экземпляр собирает вместе. Каталог features содержит только описания (интерфейсы) того, что должны уметь компоненты, а app — их стандартные реализации; по замыслу авторов, любую реализацию можно заменить на сторонню, потому что ядро обращается к ним только через интерфейсы (features/feature.go).

Как компонент попадает в программу

В Go пакет может выполнить код при загрузке — функцию init(). Каждый компонент Xray-core в такой функции регистрирует свою структуру настроек и фабрику, которая по настройкам создаёт рабочий объект. Чтобы пакет загрузился, его нужно хотя бы импортировать, и именно это делает один файл, main/distro/all/all.go: в нём перечислены app/dispatcher, app/router, proxy/vless/inbound, transport/internet/splithttp и остальное. Следствие для практики: выбросить протокол из сборки можно, убрав одну строку импорта, а обычный пользователь получает все компоненты сразу и выбирает нужные именем в JSON ("protocol": "vless").

Ядро: экземпляр и реестр компонентов

Центральный объект — core.Instance из core/xray.go. Он делает три вещи.

Хранит список features. Feature — это любой компонент, у которого есть тип (какую роль он играет) и методы Start и Close. Диспетчер, маршрутизатор, DNS-клиент, менеджер политик, менеджер статистики — всё это features; на каждую роль в нормальной конфигурации приходится один компонент, и другие компоненты находят его по типу роли.

Связывает компоненты по требованию. Компонент не создаёт соседей сам, а просит у экземпляра: «когда появятся менеджер исходящих, маршрутизатор и менеджер политик, вызови мою функцию с ними». Это вызов RequireFeatures. Если все нужные роли уже зарегистрированы, функция срабатывает сразу, если нет — откладывается до момента, когда последняя недостающая роль появится. Так порядок объявления в конфиге почти не имеет значения, а циклических импортов между пакетами нет.

Подставляет безопасные заглушки. Если в конфиге не оказалось DNS, политик, маршрутизатора или статистики, экземпляр добавляет локальный DNS-клиент, политики по умолчанию, маршрутизатор-пустышку и «немую» статистику. Диспетчер и менеджеры входящих и исходящих обязательны: без них ядро не заработает.

Запуск происходит в два шага. Сначала New создаёт все объекты по конфигу (в этот момент порты ещё не слушаются), затем Start по очереди запускает features в порядке добавления, и только после этого ядро пишет в журнал строку вида Xray 26.11.9 started. Остановка (Close) обходит те же компоненты и собирает ошибки в одну.

Порядок добавления задаёт сборщик конфигурации в infra/conf/xray.go: сначала журнал, диспетчер и менеджер исходящих, затем API, метрики, статистика, маршрутизатор, DNS, политики, наблюдатели, проверка версии и geodata, и в самом конце менеджер входящих. Менеджер входящих стоит последним намеренно: порты начинают слушаться только когда всё остальное уже готово принять соединение (изменение от 29 октября 2026, PR #7284; в релизы оно попало с версией 26.10.31). FakeDNS ставится в начало списка.

Входящие и исходящие обработчики: proxyman

Слово inbound (входящее) в конфиге означает точку приёма: порт, на котором ядро ждёт соединений от клиента или от другого узла. Outbound (исходящее) — способ, которым ядро отправляет трафик дальше. Модуль app/proxyman строит из конфига обработчики обоих видов и хранит их в менеджерах по тегам.

Входящий обработчик состоит из трёх частей: настроек приёма (список портов, адрес прослушивания, streamSettings, режим sniffing, флаг receiveOriginalDestination), настроек протокола (какие пользователи, какой flow) и самого протокола, реализующего интерфейс Inbound. Для каждого порта создаётся рабочий процесс: TCP-воркер на каждое принятое соединение запускает отдельную горутину, где заводит контекст сессии (откуда пришло соединение, на какой тег, каким пользователем) и вызывает Process протокола (app/proxyman/inbound/worker.go). Для UDP работает отдельный воркер, который сопоставляет пакеты с «соединениями» по паре адресов.

Исходящий обработчик (app/proxyman/outbound/handler.go) принимает от диспетчера пару потоков и перед передачей протоколу делает подготовку по настройкам отправки (SenderConfig):

  • sendThrough и viaCidr — с какого локального IP исходить (в том числе origin и srcip, то есть «тот же адрес, на который пришло соединение» и «адрес источника»);
  • targetStrategy — нужно ли заранее превращать домен назначения в IP и как выбирать IPv4/IPv6;
  • streamSettings — какой транспорт и какая защита используются для связи с удалённой стороной;
  • mux — завернуть ли соединения в мультиплексор (см. раздел про common ниже).

Затем обработчик вызывает Process протокола и передаёт себя же как Dialer, чтобы протокол мог открыть соединение с сервером через настроенный транспорт. Если протокол вернул ошибку, обработчик прерывает оба потока, а нормальные завершения (EOF, закрытый канал) ошибкой не считает.

Два интерфейса, на которых держатся протоколы

Весь контракт между протоколом и ядром описан в proxy/proxy.go и умещается в две сигнатуры:

  • Inbound: метод Network() сообщает, какие сети поддерживаются (TCP, UDP, Unix), а Process(ctx, network, conn, dispatcher) получает принятое соединение и диспетчер, чтобы отправить расшифрованный трафик дальше;
  • Outbound: Process(ctx, link, dialer) получает пару потоков (link) и сам решает, как их отправить: открыть соединение через dialer и написать заголовок протокола.

Протоколы, у которых есть пользователи (VLESS, VMess, Trojan, Shadowsocks, Hysteria, WireGuard), дополнительно реализуют UserManager с методами добавления, удаления и перечисления пользователей. Именно через него gRPC API меняет список пользователей без перезапуска.

Диспетчер и маршрутизатор

Когда протокол расшифровал заголовок и узнал, куда хочет клиент, он вызывает диспетчер (app/dispatcher/default.go). Диспетчер создаёт две встроенные трубы (pipe): одна несёт трафик от клиента к исходящему, другая в обратную сторону. Концы труб превращаются в Link из пары «читатель и писатель». Один Link отдаётся входящему протоколу, второй — исходящему обработчику. Если у пользователя включён учёт трафика, писатель оборачивается в счётчик байтов.

Перед выбором исходящего диспетчер при необходимости определяет протокол по содержимому (sniffing). Он ждёт первые байты не дольше 200 мс суммарно и пытается распознать HTTP (берёт Host), TLS (берёт SNI), BitTorrent, QUIC и uTP. Поддерживается и QUICv2. Результат может заменить адрес назначения, если протокол есть в списке destinationOverride; режим routeOnly подменяет адрес только для маршрутизации, а отправляет по исходному. Исключения задаются domainsExcluded и ipsExcluded. Подробнее о том, как sniffing совмещается с FakeDNS и маршрутизацией, — в заметке о маршрутизации.

Затем вызывается маршрутизатор (app/router). Он перебирает правила и возвращает тег исходящего обработчика; если ни одно правило не сработало, берётся первый исходящий из конфига. Если тег указывает на несуществующий исходящий, трафик не уходит на исходящий по умолчанию, а обрывается: это сделано намеренно, чтобы не пустить трафик в обход в случаях вроде обратного прокси VLESS, когда исходящий появится позже.

ЧтоКак устроено
Условия правиладомен, IP получателя и источника, порт, сеть, протокол после sniffing, тег входящего, пользователь, процесс (process), операционная система (localOS), байты UUID (vlessRoute); разбор — в маршрутизации
Балансировщикиrandom, roundrobin, leastping, leastload (последний принимает веса, базовые линии RTT, ожидаемое число узлов и допуск tolerance)
Данные для балансировщиковмодули наблюдения: observatory (периодические пробы по URL) и burstObservatory (серии измерений)
Расширенияуведомление по webhook при срабатывании правила и Lua-скрипт для правил (с версии 26.10.10)
Управление на ходуgRPC: добавить, удалить, перечислить правила, проверить маршрут, подменить цель балансировщика

Протоколы (proxy): 15 имён в конфиге

Протокол — это пара реализаций Inbound и Outbound (или одна из них). В таблице имя именно так, как оно пишется в "protocol". Столбец «Куда» показывает, где имя допустимо: in — во входящих, out — в исходящих.

ИмяКудаЧто делаетПакет
vlessin, outосновной протокол: аутентификация по UUID, поле flow (XTLS Vision), fallbacks, обратный прокси, встроенное шифрование; разбор — в VLESSproxy/vless
vmessin, outпредшественник VLESS со своим шифрованием; режимы без шифрования (none, zero, plain) убраны в июле 2026; см. VMessproxy/vmess
trojanin, outпароль внутри TLS-соединения; см. Trojanproxy/trojan
shadowsocksin, outShadowsocks, в том числе варианты 2022; шифр без шифрования (none) убран в июле 2026; см. Shadowsocksproxy/shadowsocks, proxy/shadowsocks_2022
socksin, outSOCKS5, UDP ASSOCIATE по RFC 1928; имя mixed во входящих создаёт ту же структуру настроекproxy/socks
httpin, outHTTP-прокси (CONNECT и обычные запросы)proxy/http
tunnel (он же dokodemo-door)inпринимает соединение и передаёт его на заранее заданный адрес либо на исходный адрес (прозрачный прокси через redirect и tproxy)proxy/dokodemo
freedom (он же direct)outвыходит в интернет напрямую; умеет domainStrategy, redirect (подмена адреса назначения), proxyProtocol, правила finalRules и список ipsBlocked с безопасными значениями по умолчанию; fragment и noises оставлены, но ядро советует перенести их в Finalmaskproxy/freedom
blackhole (он же block)outсбрасывает соединение, при желании отдавая заданный ответproxy/blackhole
dnsoutперехватывает DNS-запросы и отвечает на них по правилам (тип записи и домен, действие) либо пересылает на другой серверproxy/dns
loopbackoutвозвращает трафик в другой входящий по тегу, чтобы он прошёл маршрутизацию второй раз; умеет sniffingproxy/loopback
wireguardin, outWireGuard внутри процесса Xray, без ядра ОСproxy/wireguard
hysteriain, outHysteria 2 поверх QUIC; работает только в паре с одноимённым транспортом hysteriaproxy/hysteria
masquein, outтуннель IP по IETF CONNECT-IP (RFC 9484), с поддержкой WARP; работает только в паре с одноимённым транспортом masqueproxy/masque
tuninсоздаёт виртуальный сетевой адаптер и принимает через него весь системный трафикproxy/tun

Пояснения к трём строкам, которые чаще всего вызывают вопросы.

tun — единственный входящий, у которого нет порта. Остальные протоколы ждут соединения на порту, а tun забирает IP-пакеты из виртуального адаптера и собирает из них TCP- и UDP-соединения. Входящий tun есть и в предыдущей стабильной версии, но раньше для сборки соединений использовался стек gVisor, а с октября 2026 (PR #7130) работает собственный облегчённый TCP/IP-стек ядра. Параметры входящего: name, gateway, dns, autoSystemRoutingTable (сам прописывает маршруты), autoOutboundsInterface (чтобы исходящие не зацикливались обратно в адаптер), autoSystemDnsToGateway, desc для Windows и autoSystemWfpBlockLeak для блокировки утечек на Windows. Работает на Linux, Windows, macOS и FreeBSD; на Linux и Android готовый дескриптор адаптера можно передать ядру через переменную окружения XRAY_TUN_FD.

loopback и dns не выходят во внешнюю сеть. Это исходящие-«стрелки»: loopback заворачивает трафик внутрь ядра, dns отвечает сам. Обычная связка — отправить в dns всё, что идёт на порт 53, чтобы запросы прошли через DNS-модуль ядра с его кэшем и правилами.

VLESS и Trojan без шифрования запрещены к публичным адресам. С июля 2026 ядро при чтении конфигурации отказывается собирать исходящее vless без TLS, REALITY или encryption, а также trojan без TLS, если адрес сервера не частный (infra/conf/xray.go). Для частного IP или домена исключение остаётся.

Транспорт: как байты доходят до другой стороны

У протокола есть два вопроса, на которые он не отвечает сам: по какому каналу отправить байты и чем их защитить. На них отвечают настройки streamSettings внутри входящего или исходящего. В них несколько независимых слоёв, и их удобно держать в голове по порядку, в котором строится исходящее TCP-соединение (transport/internet/tcp/dialer.go).

flowchart LR
    A["Протокол: vless, trojan ..."] --> B["Security: tls или reality"]
    B --> C["Маскировка потока: tcp-заголовок"]
    C --> D["Finalmask: tcp-маски"]
    D --> E["Сокет: sockopt, dialerProxy, sendThrough"]
    E --> F["Сеть"]

Строго говоря, при исходящем соединении сначала открывается сокет (с учётом finalmask, если он задан), потом поверх него поднимается TLS или REALITY, потом включается необязательный HTTP-заголовок транспорта raw, и уже в получившееся соединение пишет протокол. Для транспортов, построенных на HTTP или QUIC (XHTTP, gRPC, WebSocket, Hysteria, MASQUE), порядок свой, но принцип тот же: Finalmask лежит под всем, у самого сокета.

Транспорты

Имя транспорта в JSON задаётся полем method (в более ранних версиях и сейчас как синоним — network).

ИмяСостояние в 26.11.9Что это
raw (он же tcp)основнойобычный TCP; умеет добавлять HTTP-заголовок и принимать PROXY protocol; см. слои стека
xhttp (splithttp)основной, рекомендуемыйHTTP-запросы по H1/H2/H3, режимы packet-up, stream-up, stream-one, auto; работает через CDN; см. XHTTP
kcp (mkcp)рабочийнадёжный транспорт поверх UDP со своими настройками окна
grpcрабочий, при запуске выдаёт предупреждение об устареванииHTTP/2 gRPC; ядро рекомендует вместо него XHTTP stream-up по H2
ws (websocket)рабочий, при запуске выдаёт предупреждение об устареванииWebSocket; рекомендуемая замена — XHTTP по H2 и H3
httpupgradeрабочий, при запуске выдаёт предупреждение об устареванииHTTP Upgrade без полноценного WebSocket
hysteriaрабочийтранспорт QUIC от Hysteria 2; работает только в паре с протоколом hysteria
masqueновыйCONNECT-IP поверх HTTP/2 или HTTP/3; работает только в паре с протоколом masque
xdriveновыйхранилище как канал: трафик ходит через облачное хранилище или любой сервис, который удаётся описать шаблоном
h2, h3, httpубраныконфигурация с этими именами отклоняется с подсказкой использовать XHTTP stream-one
quicубранотклоняется, замена — XHTTP stream-one по H3

XDRIVE. Это самый необычный из новых транспортов (PR #5645): клиент и сервер не соединяются напрямую, а обмениваются файлами в общем хранилище, поэтому такой канал не зависит от белых списков IP-адресов. Поддерживаются сервисы google-drive, s3, template (описание произвольного сервиса шаблоном) и local (локальный каталог, для проверки). Ядро накладывает жёсткие условия: только VLESS с encryption, без flow, и обязательно включённый mux (infra/conf/xray.go). Подробный разбор транспорта выходит за рамки каталога.

Security: TLS, REALITY, ничего

Поле security принимает три значения: none, tls и reality. Устаревшее xtls ядро отвергает с сообщением, что нужно использовать flow: xtls-rprx-vision вместе с TLS или REALITY. Разбор REALITY — в отдельной заметке, а режим flow — в XTLS Vision.

Клиентский TLS построен на uTLS, то есть подделывает «отпечаток» ClientHello известного браузера. Если fingerprint не указан, берётся профиль HelloChrome_Auto — самый свежий Chrome из подключённого форка uTLS; в заметках к релизу 26.11.9 сказано, что по умолчанию используется отпечаток Chrome 155 и новее, а в списке имён для него добавлен hellochrome_155. Ядро по умолчанию доверяет собственному встроенному списку корневых сертификатов, а не системному (PR #7105). У серверной части REALITY есть необязательные параметры minClientVer и maxClientVer: они отсекают клиентов по версии ядра. Значения по умолчанию в этой версии не заданы.

Finalmask: маски на уровне сокета

Finalmask — это слой, который оборачивает уже созданное соединение и «маскирует» поток под что-то другое. Раньше такие приёмы были разбросаны по транспортам (отдельные header у mKCP, fragment и noises у freedom); теперь они собраны в единую модель, а сами транспорты строятся поверх диалера и слушателя Finalmask (изменение сентября 2026, PR #6754). Интерфейс описан в transport/internet/finalmask/finalmask.go: маска получает соединение и возвращает обёрнутое, причём отдельно для клиентской и серверной стороны. Список масок задаётся в finalmask, при построении он разворачивается в обратном порядке, так что первая в списке маска оказывается внешней.

Маски делятся на TCP и UDP:

ИмяTCPUDPЧто делает
fragmentданетрежет первые пакеты на части с настраиваемыми длинами и задержками
header-customдадапрограммируемые шаблоны заголовка и рукопожатия
sudokuдадаобфускация по паролю с таблицей и добавлением мусора (padding)
xmcданетпридаёт потоку форму трафика Minecraft: рукопожатие входа и временной профиль пакетов
filterдадапропускает или отсекает подключения по IP источника, только для входящих
noiseнетдавставляет пакеты-шум до или во время соединения
mkcp-legacyнетдапрежние заголовки mKCP
salamanderнетдаобфускация пакетов, заимствованная из Hysteria
realmнетдапробивание NAT методом UDP hole punching, как в Hysteria 2.9.1
udphopнетда«прыжки» по набору UDP-портов
xdnsнетдапересылка данных внутри DNS-запросов через указанные резолверы
xicmpнетдапересылка данных внутри ICMP

Параметры сокета (sockopt)

Нижний уровень настраивается блоком sockopt: tproxy (прозрачный прокси redirect или tproxy), acceptProxyProtocol, domainStrategy, dialerProxy (провести исходящее соединение через другой исходящий по тегу, то есть построить цепочку), tcpCongestion, interface (привязка к интерфейсу), penetrate, tcpMptcp, addressPortStrategy (искать адрес и порт в SRV- и TXT-записях DNS) и happyEyeballs (параллельные попытки IPv4 и IPv6). С версии 26.10.31 MPTCP по умолчанию выключен, включить его можно параметром tcpMptcp; причины — в заметке об уязвимости.

Служебные модули (app)

Эти модули не обрабатывают трафик сами, а дают ядру общие возможности. В конфиге им соответствуют верхнеуровневые блоки.

Блок конфигаПакетЗа что отвечает
logapp/logжурнал ошибок и журнал доступа (в файл, в консоль или отключён); dnsLog для запросов DNS; maskAddress скрывает часть адреса клиента
dnsapp/dnsсвой DNS-клиент: серверы по UDP, TCP, DoH, QUIC, локальный; статические hosts; кэш, устаревшие ответы (serveStale), параллельные запросы, правила по доменам; необязательный Lua-скрипт (поле script)
fakednsapp/dns/fakednsпулы поддельных адресов (по умолчанию IPv6 из 2001:2::/48), по ним домен восстанавливается из IP
routingapp/routerправила и балансировщики, см. выше и маршрутизацию
policyapp/policyуровни пользователей: таймауты, учёт трафика, размер буфера
statsapp/statsсчётчики трафика и списки онлайн-пользователей
apiapp/commanderсервер gRPC для управления ядром без перезапуска
metricsapp/metricsHTTP-сервер с метриками
observatory, burstObservatoryapp/observatoryпроверка доступности исходящих: данные для балансировщиков
geodataapp/geodataзагрузка и обновление файлов geoip и geosite по расписанию, горячая замена в работающем ядре
versionapp/versionзапрет запуска, если версия ядра вне допустимого диапазона из конфига
env—переменные окружения, которые применяются при чтении конфигурации

Политики: таймауты по умолчанию

Модуль политик (features/policy/policy.go) задаёт уровни level, и каждому пользователю присваивается один из них. Таймауты по умолчанию такие: рукопожатие — 60 секунд, простой соединения — 300 секунд, uplinkOnly и downlinkOnly — по 1 секунде (время, которое остаётся после закрытия одной из сторон). Время рукопожатия в коде намеренно совпадает с client_header_timeout у nginx, чтобы значение не выдавало, какой именно сервер отвечает. Буфер на соединение по умолчанию зависит от архитектуры: 512 КБ на обычных amd64-системах, 4 КБ на arm64 и mips64, а на 32-битных arm и mips буфер отключён.

Статистика

Счётчики имеют предсказуемые имена вида user>>>почта>>>traffic>>>uplink и …downlink, inbound>>>тег>>>traffic>>>…, outbound>>>тег>>>traffic>>>… и user>>>почта>>>online для списка IP онлайн. Счётчики пользователя включаются на уровне политики (statsUserUplink, statsUserDownlink, statsUserOnline), счётчики входящих и исходящих — в системной политике (statsInboundUplink, statsInboundDownlink, statsOutboundUplink, statsOutboundDownlink). Пользователю для учёта нужен непустой email.

gRPC API

Модуль api (app/commander/commander.go) запускает сервер gRPC. Если задано поле listen, сервер слушает этот адрес: TCP или Unix-сокет, если значение начинается с / или @. Если listen пуст, ядро регистрирует внутренний исходящий с тегом из поля tag, и запросы доходят до сервера через обычную маршрутизацию, обычно от входящего tunnel с правилом на этот тег. Набор служб выбирается списком services:

  • управление обработчиками (HandlerService): добавить, удалить и изменить входящие и исходящие, перечислить пользователей и их число;
  • статистика: прочитать счётчик, запросить по маске, получить системные данные, список IP онлайн;
  • маршрутизация: добавить, удалить и перечислить правила, проверить маршрут, подписаться на события, подменить цель балансировщика;
  • журнал: перезапустить логгер;
  • наблюдатель: состояние исходящих.

Все эти вызовы доступны и через командную строку подкомандой xray api.

Обратный прокси

Модуль app/reverse — кирпичики мостов (bridge) и порталов (portal) для обратного прокси, когда сервер за NAT сам соединяется наружу, а трафик ходит в обратную сторону. Старый корневой блок reverse в конфиге ядро больше не принимает и подсказывает перейти на VLESS Reverse Proxy (поле reverse у пользователя VLESS).

Общие библиотеки (common)

Здесь лежит то, на что опираются все остальные слои.

  • Буферы (common/buf): единица данных — буфер на 8192 байта; наборы буферов (MultiBuffer) позволяют передавать данные без копирования.
  • Трубы (transport/pipe): внутрипроцессные каналы между входящим и исходящим с ограничением размера.
  • Сессия (common/session): контекст, который проносит по цепочке сведения о соединении: источник, тег входящего, пользователь, цель, определённый протокол.
  • Мультиплексор (common/mux): Mux.Cool упаковывает много потоков в одно соединение. Кадр содержит длину (2 байта), номер сессии (2), статус (1: New, Keep, End, KeepAlive), опции (1: есть данные, есть ошибка), для новой сессии — сеть, порт и адрес (common/mux/frame.go).
  • XUDP (common/xudp): UDP поверх Mux.Cool с глобальным идентификатором потока (8 байт), чтобы у приложения сохранялась схема «один сокет, много адресатов» (Full Cone NAT).
  • Распознаватели протоколов (common/protocol): sniffers для HTTP, TLS, BitTorrent и QUIC, разбор адресов, пользователи и аккаунты.
  • Данные geoip и geosite (common/geodata): быстрые сопоставители доменов и IP-диапазонов.
  • Lua (common/lua): встроенный интерпретатор для скриптов в routing, dns и маске noise; по умолчанию работает в песочнице с белым списком функций, а встроенные в конфиг (inline) скрипты в этой сборке отключены.
  • Прочее: защита от повторов (antireplay), криптография, повтор попыток, диспетчеризация задач, определение платформы.

Командная строка (main)

Исполняемый файл xray — это набор подкоманд (main/commands/all). Без подкоманды выполняется run.

КомандаЧто делает
run (по умолчанию)запускает ядро; ключи -c (можно несколько файлов), -confdir, -format, -test (проверка без запуска), -dump (печать объединённого конфига); при ошибке конфигурации выходит с кодом 23, чтобы systemd не перезапускал службу
versionверсия ядра и сборки
apiклиент gRPC API: статистика, правила, обработчики, пользователи, логгер
convertперевод конфигурации между форматами
uuidгенерирует UUID, в том числе из строки
x25519, ed25519, mldsa65, mlkem768ключи для REALITY и для шифрования VLESS
vlessencготовая пара настроек decryption и encryption для VLESS
wgключи WireGuard
tlsвыпуск сертификата (cert), ключи ECH (ech), проверка домена (ping)
base64, luaкодирование Base64 (с gzip) и подпись Lua-скриптов

Форматы конфигурации: JSON (включая комментарии), TOML и YAML; конфигурацию можно получить из файла, каталога (несколько файлов объединяются) или по HTTP(S).

Источники

📚 См. также


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

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