
Бэкенд узлов Xboard: на базе Xray-core v26.10.31, ограничение числа устройств и скорости в одном патче, строгое соответствие контракту Xboard V2, встроенное смягчение CVE-2026-98432
Серверная часть узлов нового поколения для панели cedar2025/Xboard.
От wyx2685/v2node взяты поддержка современных протоколов и способ интеграции ядра,
от cedar2025/Xboard-Node — эксплуатационный слой (push, машинный режим, сертификаты, два ядра).
Базовая версия ядра зафиксирована: Xray-core v26.10.31.
Документация: docs/ARCHITECTURE.md (архитектура и записи решений) · docs/CONTRACT.md (полевой контракт с панелью, включая номера строк с доказательствами) · docs/PANEL-PATCH.md (патч панели: причины, установка и откат) · docs/STATUS.md (что реализовано, что не реализовано и как проверить) · docs/PANEL-IMPROVEMENTS.md (список долгосрочных изменений панели)
| Аспект | Xboard-Node (dev 2026-04) | v2node (2026-10) | Этот проект |
|---|---|---|---|
| Версия ядра | fork зафиксирован на v26.3.27 | v26.9.30 | v26.10.31 (MPTCP по умолчанию отключён) |
| Число устройств / ограничение скорости | Перехват неэкспортированного реестра через //go:linkname | Копирование всего пакета dispatcher в собственный модуль | Один патч app/usergate (3 участка hunk) |
| Протоколы | vless/vmess/trojan/ss/hysteria2/tuic/anytls (xray+sing-box) | vless/vmess/trojan/ss/hysteria2/tuic/anytls, включая VLESS encryption / mldsa65Seed / xver | На стороне xray: vless/vmess/trojan/ss2022 + полное усиление REALITY; anytls/tuic/hysteria2 передаются sing-box (без патчей протоколов) |
| Транспорт | ws/grpc/httpupgrade/h2(удалён)/xhttp | tcp/ws/grpc/httpupgrade/xhttp | Приоритет xhttp, h2/quic отклоняются при компиляции |
| Push | Push при WS handshake | Только опрос (ETag + msgpack) | WS push + резервный опрос |
| Сертификаты | certmagic + 21 провайдер libdns | lego | certmagic + libdns (схема xbn сохранена) |
| Машинный режим | Поддерживается (несколько узлов / один процесс) | Несколько Nodes в одном процессе | Поддерживается |
Главный вывод: реальное различие двух проектов заключается не в функциях, а в том, как они встраиваются в плоскость данных xray.
app/usergate и 3 участка hunk в vendor-версию xray. Семантику плоскости данных обеспечивает собственный dispatcher xray, а шлюз выполняет только две чистые функции: Admit/Limit.cmd/xboard-core/ # 入口(node 模式 / machine 模式 / standalone)
internal/config/ # YAML 配置 + 校验 + 热重载
internal/panel/ # 面板契约:/api/v2/server/*(含 V1 兼容)
internal/kernel/ # 内核抽象(xray / singbox 双实现)
internal/kernel/xray/ # 配置构建(安全默认在此集中收敛)+ 运行时热更新
internal/gate/ # 设备数 + 限速闸门(被 usergate 补丁调用)
internal/sysinfo/ # 面板 status 必填项(cpu/mem/swap/disk,零依赖)
internal/traffic/ # 每用户流量计数与上报
internal/metrics/ # Prometheus 指标 + 健康检查
internal/cert/ # ACME 证书管理(certmagic + libdns)
third_party/xray/ # vendored Xray-core + 补丁序列
panel-patch/ # 面板侧补丁(对 cedar2025/Xboard 的零迁移改动)
docs/ # 架构决策记录、面板改造清单
Зависимости: Go 1.27+ (требуется в go.mod), git, GNU patch.
make vendor # clone Xray-core v26.10.31 到 third_party/xray
make patches # 打 patches/*.patch(幂等)
make build # -> bin/xboard-core
bash scripts/verify.sh # gofmt + vet + test + build + smoke + vendored 单测 + 补丁幂等
На машинах без make (например, git-bash в Windows) запускайте напрямую bash scripts/verify.sh — он эквивалентен make verify;
make vendor можно заменить одним конвейером tar, см. реализацию в Makefile.
Примечание для Windows: если
%TEMP%недоступен для записи, go выдастcreating work dir: ... Access is denied, перед сборкой достаточно выполнитьexport TMP=D:/tmp TEMP=D:/tmp(scripts/verify.shподдерживает переменнуюGO_TMP).
Текущее состояние см. в docs/STATUS.md: go build ./..., go test ./..., -smoke,
юнит-тесты vendored app/usergate и app/dispatcher — все пройдены.
SetMultipathTCP(false) (CVE-2026-98432), если только в конфигурации явно не задано sockopt.tcpMptcp: true.debug.SetGCPercent также проверяется, содержит ли GODEBUG значение multipathtcp=0; при отсутствии — WARN и продолжение работы; install.sh записывает это по умолчанию.allowInsecure отклоняется на уровне сборки и транслируется в pinnedPeerCertSha256 / verifyPeerCertByName.h2/http/h3/quic на уровне сборки сразу выдают ошибку (удалены в upstream) и не откатываются молча на tcp.shortIds, обязательный dest, maxTimeDiff по умолчанию 90s, опциональные mldsa65Seed/xver/limitFallback*.minClientVer не передаётся; если панель его передаёт, фиксируется WARN и он отображается в /status, чтобы клиенты семейства mihomo не откатывались молча.