
Backend de nœuds Xboard : basé sur Xray-core v26.10.31, limitation du nombre d'appareils et de la bande passante via un seul patch, alignement strict sur le contrat Xboard V2, atténuation intégrée de CVE-2026-98432
Le backend de nœuds de nouvelle génération pour le panneau cedar2025/Xboard.
Il reprend la couverture des protocoles modernes et le mode d'intégration du cœur de wyx2685/v2node, ainsi que la couche d'exploitation (push, mode machine, certificats, double cœur) de cedar2025/Xboard-Node. La version de référence du cœur est fixée à Xray-core v26.10.31.
Documentation : docs/ARCHITECTURE.md (architecture et journal des décisions) · docs/CONTRACT.md (contrat avec le panneau, champ par champ, avec numéros de ligne des preuves) · docs/PANEL-PATCH.md (correctif du panneau : pourquoi, comment l'installer et revenir en arrière) · docs/STATUS.md (ce qui est implémenté, ce qui ne l'est pas et comment vérifier) · docs/PANEL-IMPROVEMENTS.md (liste des améliorations du panneau à plus long terme)
| Dimension | Xboard-Node (dev 2026-04) | v2node (2026-10) | Ce projet |
|---|---|---|---|
| Version du cœur | fork figé à v26.3.27 | v26.9.30 | v26.10.31 (MPTCP désactivé par défaut) |
| Nombre d'appareils / limitation de débit | détournement d'un registre non exporté via //go:linkname | copie complète du paquet dispatcher dans son propre module | correctif unique app/usergate (3 hunks) |
| Protocoles | vless/vmess/trojan/ss/hysteria2/tuic/anytls (xray+sing-box) | vless/vmess/trojan/ss/hysteria2/tuic/anytls, avec VLESS encryption / mldsa65Seed / xver | côté xray : vless/vmess/trojan/ss2022 + durcissement REALITY complet ; anytls/tuic/hysteria2 sont confiés à sing-box (aucun correctif de protocole) |
| Transports | ws/grpc/httpupgrade/h2 (supprimé)/xhttp | tcp/ws/grpc/httpupgrade/xhttp | priorité à xhttp ; h2/quic refusés à la compilation |
| Push | push au handshake WS | polling uniquement (ETag + msgpack) | push WS + repli sur le polling |
| Certificats | certmagic + 21 fournisseurs libdns | lego | certmagic + libdns (solution xbn conservée) |
| Mode machine | pris en charge (plusieurs nœuds / un processus) | un processus, plusieurs Nodes | pris en charge |
Conclusion essentielle : la véritable divergence entre les deux projets concerne moins les fonctions que « la manière de s'insérer dans le plan de données de xray ».
app/usergate et 3 hunks dans le xray fourni dans vendor. La sémantique du plan de données reste portée par le dispatcher de xray ; la couche de contrôle ne réalise que les deux fonctions pures 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/ # 架构决策记录、面板改造清单
Dépendances : Go 1.27+ (requis par 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 单测 + 补丁幂等
Sur les machines sans make (par exemple git-bash sous Windows), exécutez directement bash scripts/verify.sh, qui est équivalent à make verify ;
make vendor peut être remplacé par un simple pipeline tar, voir l'implémentation dans le Makefile.
Attention sous Windows : si
%TEMP%n'est pas accessible en écriture, go signaleracreating work dir: ... Access is denied, il suffit d'exécuterexport TMP=D:/tmp TEMP=D:/tmpavant la compilation (scripts/verify.shprend en charge la variableGO_TMP).
L'état actuel est décrit dans docs/STATUS.md : go build ./..., go test ./..., -smoke,
ainsi que les tests unitaires des composants vendored app/usergate et app/dispatcher passent tous.
SetMultipathTCP(false) (CVE-2026-98432), sauf si la configuration spécifie explicitement sockopt.tcpMptcp: true.debug.SetGCPercent, on vérifie si GODEBUG contient multipathtcp=0 ; en cas d'absence, un WARN est émis et l'exécution continue ; install.sh l'écrit par défaut.allowInsecure est rejeté au niveau de la compilation et traduit en pinnedPeerCertSha256 / verifyPeerCertByName.h2/http/h3/quic provoquent une erreur directe au niveau de la compilation (supprimés en amont) et ne se dégradent pas silencieusement en tcp.shortIds non vide, dest obligatoire, maxTimeDiff par défaut à 90s, mldsa65Seed/xver/limitFallback* en option.minClientVer n'est pas transmis ; si le panneau le transmet, un WARN est enregistré et exposé dans /status, afin d'éviter que les clients de la famille mihomo ne basculent silencieusement en repli.