当前阶段：P17（阶段十七）代理网络控制面统一入口与真实客户端验收
本阶段实施主题：把现有 2S-UI + 内嵌 sing-box 代理网络补成统一入口、独立节点面板、Console 架构页和三端真实客户端验收闭环，不重建数据面，不改动旧链路。
阶段状态：进行中
计划状态：修订中
当前工作包：P17-9 360T7 Xray 主备与自动回切
📌 当前结论
P17 已进入统一 Reality 与 360T7 主备收口。 P16 的 102 只读备用控制面、Auth 一致性快照、Edge 本地回退和 RR 重启演练继续保持归档状态。P17 将 proxy.yohan.fun 保持为 Master 与订阅入口，为 MM、d02、dog、dd 增加 panel-*.yohan.fun 独立面板，把 Console 的代理控制面入口改为 #proxyNetwork 架构页，并在 Windows、Android、iOS 上验证节点切换和回切。2026-10-12 用户最终确认五台节点只保留 VLESS + REALITY，一个 agentmeshos-main client 共享同一 VLESS UUID，现有订阅 URL 和用户管理结构不变；dog、DD、RR 旧协议先保留，新增 Reality 验证后再移除。P17-7 已完成五台 Reality 的真实连通与吞吐验证；P17-8 已刷新公网订阅与当前在线的 Home、OfficeSummer，Summer、S20、Magic2 仍需上线刷新；360T7 已建立 MM 主 Balancing 和四节点后备 Balancing 并通过隔离主备测试，但新 Xray 全局透明代理在 GitHub 控制面出现连接重置，已回滚 Global node 到旧 f9Re2U27，稳定性根因和整机重启恢复仍待验收。依据是 docs/plans/state.json、P17 计划和 P16 完成归档。
当前详细计划入口：phase-17-placeholder.md。上一阶段完成归档入口为 completed-phase-16-control-plane-backend-resilience.md。
🗂️ 目录
🧾 计划状态
| 项目 | 当前值 | 依据 |
|---|---|---|
| 当前阶段 | P17 | docs/plans/state.json |
| 阶段状态 | 进行中 | 用户已批准 P17 实施计划 |
| 计划状态 | 修订中 | 工作包、接口、验收和回退已冻结，生产验收尚在执行 |
| 当前工作包 | P17-9 360T7 Xray 主备与自动回切 |
P17-7 五台 Reality 已完成真实连接；P17-8 已发布五节点订阅并刷新 Home、OfficeSummer；360T7 主备结构已建立，但全局透明代理稳定性 A/B 失败并已回滚到旧节点 |
| 上一阶段 | P16 已完成并归档 | 只读备用控制面、Edge 回退和 RR 重启演练完成 |
| 生产权威 | RR 仍是唯一控制面写权威 | 102 只提供只读降级服务 |
🔜 需求闸门
| 闸门 | 进入条件 | 不满足时的状态 |
|---|---|---|
| 用户目标 | 说明要解决的问题、期望结果和不能接受的边界 | 继续等待评审，不预设实现 |
| 当前事实 | 说明现有节点、服务、网络、存储、凭据和文档现状 | 先做只读调查，不得直接改造 |
| 执行边界 | 明确执行位置、访问范围、回退方式和失败关闭条件 | 保持现状，不下发生产变更 |
| 验收证据 | 明确本地测试、Actions、101 Runner、生产回读和回退证据 | 不允许以“已部署”代替验收 |
📊 已验证证据摘要
| 事项 | 最新事实 | P16 的处理 |
|---|---|---|
| 代理控制面 | RR Master 与四个节点均为 2S-UI 1.8.3，内嵌 sing-box；四个远程节点已绑定 panel-* 面板域名，Master base_url 全部切换，dirty=0 |
不改数据面协议、端口、凭据或订阅顺序 |
| 面板入口 | 四个公网域名 HTTPS /app/ 返回 307，四张独立 ECC 证书有效期至 2027-01-02，认证态 /app/ws 返回 101 |
MM 终止 TLS，RR 100.64.0.1:39200 按 Host 转节点 Tailnet 2095 |
| Master 节点健康 | 认证后 api/load 返回 MM、d02、dog、dd 全部 online，dog 延迟约 81 ms |
2S-UI Master 1.8.3 实时健康回读，不以 SQLite last_seen 单列代替健康判断 |
| 端口边界 | 四个节点公网 2095/2096 探测均超时 |
节点仍只监听 Tailnet，不扩大公网面 |
| Console | 生产镜像 sha-d7230777c1c9feb3b5b9745231a18f1472e2cdb6 为 running/healthy，app.js/styles.css 与仓库哈希一致，四个 panel-* 链接和 #proxyNetwork 已回读 |
无；后续发布使用新的精确 SHA |
| Magic2 真机 | Headscale 实时 given_name=andriod-magic2、地址 100.64.0.13；Exit Node 生效后 Google ping 3/3、约 173–179 ms；Gemini 真实消息返回 Hello! How can I help you today?；TermRover 9 saved，实际登录 RR/101 返回 root shell |
已关闭 Google/Gemini 与 TermRover 九主机门禁；继续观察 Termux 进程长期驻留 |
| 客户端资料 | Windows/Android 包哈希与 File-Hub 长期目录回读通过，iOS 元数据已归档 | Android/iOS 真机切换和回切仍未执行 |
| Windows 真机 | Home、OfficeSummer 已刷新五节点 Reality profile；新规则已回读，agentrouter.org 在两台机器上均返回 HTTP 200 |
仍需在 Windows 上按新五节点订阅执行一次真实故障切换；旧 12 步证据只适用于旧协议组 |
| 单一协议 | 五台节点均已有 24443/tcp VLESS Reality，并逐台通过真实连接、ICMP 与吞吐验证；旧异构 Inbound 暂时保留 |
离线客户端刷新完成后执行旧协议下线，不提前删除 |
| 360T7 | 已安装三个新 Reality 节点、MM 主 Balancing 和四节点后备 Balancing；隔离主备测试通过，但新 Xray 全局透明代理引起 GitHub 控制面连接重置；Global node 已回滚到旧 f9Re2U27 |
先定位 Xray 全局路径稳定性，再重新切换；未通过前不清理旧 Balance/sslocal/HAProxy |
🧩 分布式底座接入
接入结论：P17 接入现有 Network、Compute、Credentials、Observability 和 docs-governance，不新增第二调度器、第二 Runtime 或公网业务端口。
Nomad 是唯一任务调度器；RR 继续承载 2S-UI Master，proxy 与四个 panel-* 通过 CNAME 跟随逻辑 edge.yohan.fun，由健康 Edge 承担公网 TLS 与反向代理，Tailnet 只承载节点控制和管理流量。节点 2095/2096 不因 P17 扩大公网监听；DNS、证书和 Console 页面均有独立回退。
| 使用层 | 当前状态 | 边界 |
|---|---|---|
| Network | P16 已具备 Edge 本地回退和 101 单观察者安全路径 | 不擅自扩大 DNS 写入、DERP 或 Peer Relay 范围 |
| Compute | 102 只读备用与现有生产载荷继续运行 | 不新增第二调度器或第二 Runtime |
| Storage | Auth 与拓扑快照保持单向同步和 last-known-good | 不让备用节点覆盖 RR 原始数据 |
| Observability | 控制台、拓扑、告警和健康状况有生产回读 | 旧快照必须显示 stale/unavailable，不伪装实时 |
| Credentials | 关键密钥只在 root-only 环境 | 不进入仓库、前端、日志或普通回复 |
| Lifecycle | P16 的回退材料继续保留 | 新需求必须重新设计生命周期和回退 |
⚠️ 未决项 / 需要用户决策
| 事项 | 当前事实 | 需要用户决定 |
|---|---|---|
| 客户端实测窗口 | Windows 已完成；S20 已升级 v0.4.0 并通过 ADB bridge 恢复真实上下行；Magic2 当前使用 v0.3.8 且资源快照为 stale，100.64.0.13:8022 拒绝连接、Home 未发现 ADB 设备；Magic2 的 Exit Node、TermRover 九主机与 Gemini 真实对话此前已通过；Android Clash 真机切换未执行，iOS 无在线真机 |
先恢复 Home 的 Magic2 USB/ADB 会话并升级探针，再执行 Clash Meta 切换/回切；继续观察 Magic2 长时间锁屏和系统内存压力下的 Termux 驻留；iOS 需提供在线设备 |
| 控制面独立节点 | RR 同时承载 Master 和末位数据面 | P17 接受该风险，不新增 VPS |
| 旧链路下线 | 新旧链路并行，360T7 旧 sslocal 和 HAProxy 在 P17-9 稳定前保持 |
P17-10 只关闭有证据确认无业务依赖的进程；系统 HAProxy 444/81/60000 单独审计 |
| 共享客户端身份 | 用户确认接受五台共享同一个 VLESS UUID，现有 agentmeshos-main 和订阅 URL 不变 |
不再拆分 client 或增加聚合服务；P17-7 只复核 Reality 服务端参数 |
| 在线客户端刷新 | Home、OfficeSummer 已完成刷新；Summer、S20、Magic2 当前离线 | 客户端上线后逐个刷新并回读；360T7 已单独更新 PassWall，待重启验证 |
| 连接数 | 当前 conntrack 为 30720/15360 |
P17-10 稳定后先提升到 65536/32768；131072 需真实峰值和内存证据 |