6.2 KiB
RemLink v1.0 实现状态
日期：2026-08-25
Phase 0–10 的实现工作均已进入代码。specs/tasks.md 明确区分“已实现子任务”和“需要外部主机的验收项”。
已完成的代码与自动化测试
- 稳定协议：20 字节 Session 头、13 种 Control 消息、14 个精确错误码。
- Linux 内核 WireGuard 编排、SQLite 迁移、IPAM、Bootstrap、Join/Node Token、Control Hub、心跳状态与重连策略。
- 单 Wintun wireguard-go Client、PacketMux、自有 Windows 路由、本地重叠检查、普通 Overlay UDP Session 传输和严格数据包验证。
- 单进程 gVisor netstack 网关、通用 TCP/UDP relay 与受约束 ICMP Echo relay；不使用 WinNAT、Windows forwarding 或协议专用代理。
- Site TCP/UDP flow 上限和 UDP 空闲超时可配置，默认
2048/4096/60s，并通过 capability 上报。 - 七状态双边 Session 编排、超时、统计、reconcile、rebootstrap、Admin 审计事件和七步 Overlay 网络迁移。
- 网络迁移会原子暂停 Session 创建、关闭现有 Session、发布新 Bootstrap、在旧 Control 仍在线时通知节点、切换
wg0/监听，并在失败时恢复内核和应用状态。 - Windows 节点在旧 Control 在线时预检新 Overlay；本地重叠会保持旧配置以报告
OVERLAY_LOCAL_CONFLICT，Server 记录 ERROR 事件。 - PREPARE 拒绝与 CREATE 请求关联，陈旧结果不能终止后续请求；完全相同的 netstack PREPARE 重试幂等。
- Site 和 Server 信任边界都拒绝
DEFAULT_ONLY。数据包注入失败只关闭受影响 Session 并报告SESSION_INJECT_FAILED，节点监听仍可用。 - 被拒 Session 数据报和 PacketMux 丢包只输出元数据、限速安全警告；默认不记录高频数据包 DEBUG，也没有接收载荷字节的日志 API。
- PacketMux 在拦截/注入边界计数；UDP relay 空闲回收、Sender 关闭与 netstack 重试路径有 race/幂等覆盖。
- Wails Engineer GUI 和内嵌 Vue Server Web UI 已实现；Server 五个管理页及指定 API 完整。节点显示 WG 握手，Session 显示持续时间，日志支持五维过滤，Token 轮换只显示一次，Engineer 显示 Site capability 与 LastSeen。
- 浏览器侧 SessionID 使用十进制字符串，避免 JavaScript 舍入随机
uint64。新的 Node Bootstrap 会关闭 Server 侧本地运行时已经丢失的 Session；短 Control 重连保留运行时。 - Engineer GUI 对所有非终态单 Session 状态做操作门禁；生产启动和输入默认失败关闭；Server 运行表刷新不会覆盖正在编辑的网络配置。
- 多 Engineer、多 Site 并发与重复 CIDR flow 隔离已实现。
- 配置、Bootstrap、IPAM、Client WG、Session 和 Admin 信任边界都拒绝 Overlay 网络/广播地址以及
/0Exit Node。Server 事件模块限制为规格定义的 11 个名称。 - Server WireGuard 私钥并发发布原子；成功的 Linux 内核变更不会被误报为取消。
- 固定依赖、CI、Windows/Linux 发布脚本、受限 Docker Compose、启动预检、第三方声明和自包含 T01–T18 证据工具已提供。
- Docker 使用
./data:/app/data持久化和对称REMLINK_WG_PORT映射，并支持限制 HTTP bind。源码 Compose 与发布包预编译二进制 Compose 分离。 - Server 的 Join Token 打印/轮换 CLI 在 Session 恢复清理之前退出，不会因运维读取 Token 而关闭活动 Session。
- Admin 空节点/Session/事件列表统一编码为
[]，Server 前端也会把旧版null响应归一为空数组，避免首次正确鉴权后的概览白屏。 - 发布验证器会解压 ZIP、检查必需项、重算全部校验和、拒绝未覆盖文件，并冒烟运行包内验收初始化器，不伪造结果。
- Engineer、Site、Server 生成三个独立目录和 ZIP，发布验证器会拒绝混入其他角色的可执行文件；Windows 两端默认以各自 EXE 目录保存 YAML、DPAPI 身份、日志和校验后的 Wintun DLL，不再写入或共享
ProgramData文件。 - Engineer/Site YAML 支持明文
join_token作为自用部署便捷项；命令行和REMLINK_JOIN_TOKEN仍可覆盖 YAML，注册后的 Node Token 与 WireGuard 私钥继续由 DPAPI 保护。 - Engineer 按 Site NodeID 在 EXE 旁的
site-profiles.json独立记忆 Remote CIDR；选择现场时只加载该现场网段。Site 心跳进入 OFFLINE 后，Server 自动以SITE_OFFLINE关闭相关会话并释放 Engineer 会话门禁。 - Server、Engineer、Site 的操作员日志与界面状态已中文化；稳定协议状态、模块名和错误码以括号形式保留，Server 管理页还能翻译旧数据库中的常见英文事件。
- Engineer 发布构建固定使用 Wails
desktop,production标签，并写入BUILD-INFO.json；架构检查会拒绝退回缺少标签、启动时只弹 Wails 错误框的普通 Go 构建。
待外部物理验收
Gate A–D 与 T01–T18 当前为 NOT_RUN，不是失败也不是通过。它们需要 Linux 内核 WireGuard、管理员权限 Windows Engineer/Site、真实路由、重复现场网络、目标服务、热点切换以及进程/网络重启。执行方式见 docs/validation/T01-T18-runbook.md。
本地验证说明
本地基线已执行 npm 清洁安装、Vue 类型检查和生产构建、go mod verify、全量 Go test、go vet、架构策略扫描、Windows/Linux 交叉构建、发布校验和验证以及包内验收初始化冒烟。
渲染 QA 使用已安装 Microsoft Edge 与 Playwright：Engineer 的 ACTIVE→断开→IDLE 与 Settings 导航通过；Server 的 SESSION 日志过滤和 Join Token 轮换通过；两个页面均无框架错误覆盖和浏览器 warning/error。
本机没有 Docker，因此不在本地声称镜像已构建；Linux CI 负责源码镜像构建。由于本机没有 C 编译器，race 测试由 Linux CI 承担。Windows EXE 未做 Authenticode 签名；工作区没有 commit 时 BUILD-INFO.json 会记录 unknown。这些限制均不能记为已通过的 Gate 或物理验收结果。
本次中文文档与发布包部署入口修改后，应以最新一次 scripts/build-release.ps1 生成的 Engineer、Site、Server 三个独立 ZIP、各包 SHA256SUMS.txt 和实际命令输出为准，不沿用旧包哈希。