
Xboard ノードバックエンド:Xray-core v26.10.31 に基づき、単一パッチでデバイス数/速度制限を実装、Xboard V2 契約に厳密に準拠、CVE-2026-98432 の緩和策を内蔵
cedar2025/Xboard パネル向けの次世代ノードバックエンドです。
wyx2685/v2node の最新プロトコルへの対応とコアの統合方式、および cedar2025/Xboard-Node の**運用層(プッシュ、マシンモード、証明書、デュアルコア)**を取り入れています。コアの基準バージョンは 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 hunks) |
| 対応プロトコル | 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 はコンパイル時に拒否 |
| プッシュ | WS ハンドシェイクによるプッシュ | ポーリングのみ(ETag + msgpack) | WS プッシュ + ポーリングへのフォールバック |
| 証明書 | certmagic + 21 の libdns プロバイダー | lego | certmagic + libdns(xbn の方式を継承) |
| マシンモード | 対応(複数ノード/単一プロセス) | 単一プロセスで複数の Nodes | 対応 |
重要な結論:両プロジェクトの**本当の違いは機能ではなく、「xray のデータプレーンへどのように組み込むか」**にあります。
app/usergate パッケージと 3 hunks を追加する方法を選びます。データプレーンの意味論は xray 自身の dispatcher が担い、ゲートは純粋関数 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 がないマシン(例えば Windows 上の git-bash)では bash scripts/verify.sh を直接実行してください。これは make verify と等価です;
make vendor は 1 本の 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 トランスポートはビルド層で直接エラーになります(上流で削除済み)。tcp へ暗黙にダウングレードされることはありません。shortIds の非空検証、dest は必須、maxTimeDiff のデフォルトは 90s、オプションで mldsa65Seed/xver/limitFallback*。minClientVer は配信しません;パネルが配信した場合は WARN を記録し /status で公開します。これにより mihomo 系クライアントが暗黙にフォールバックするのを防ぎます。