跳转至

QRE 用户文档

QRE 是 QUIC Routing Encapsulation。它把 RFC QUIC CONNECT-IP 隧道、REALITY 感知握手、Linux 内核数据面和尽力而为的传输伪装组合在一起，用一个 qre-tool 二进制完成配置、生命周期、诊断和调试操作。

这份文档面向部署 QRE 的用户，以及希望从源码构建、集成或贡献代码的外部开发者。主线是从配置文件到运行命令，再到排障、运维和开发入口。

典型模型

qre-tool daemon <profile>
  读取 /etc/qre/dev/<profile>.conf
  加载 qre.ko
  创建并配置 qre0 这类数据面设备
  运行 server 或 client 控制面

qre.ko
  处理内核快速路径
  维护设备、会话、CID 路由和统计

REALITY/QUIC 控制路径
  使用 ServerName、Dest、short_id 和 X25519 key 建立会话
  把派生出的数据通道材料安装到 qre.ko

QRE 当前是 server-client 模式，不是多节点路由网络。一个服务端 profile 对应一个 QRE 设备；同端口多租户时可以让多个 server profile 共享 Listen，通过 ServerName 和 RealityShortIds 分流。

快速命令

sudo systemctl start qred@qre0
sudo systemctl reload qred@qre0
sudo systemctl stop qred@qre0

sudo qre-tool daemon qre0
sudo qre-tool --dry-run up qre0
sudo qre-tool show qre0
qre-tool showconf /etc/qre/dev/qre0.conf

文档路线

  • 快速开始：安装前提、最小 server/client 配置和启动步骤。
  • 基本原理：QRE 的控制面、数据面、REALITY 握手和共享端口分流。
  • 配置文件：/etc/qre/qre.conf 与 /etc/qre/dev/*.conf 的完整字段说明。
  • qre-tool 参考：所有命令、全局选项和 key=value 参数。
  • 外部开发者：源码结构、构建方式、测试入口和贡献边界。
  • 运维指南：systemd、reload、同端口多租户、升级、文档站点发布。
  • 排障指南：常见错误、验证命令和诊断路径。