跳到主要内容

维护与生命周期

接上 Hub 之后：换机器、重装、想退出、要维护者进来看看 —— 每件事怎么做、卡住时看哪里。

一句话原则

入口属于呼号，不属于某台机器。你的机器是谁、跑在哪， Hub 不关心 —— 它只认「这个呼号现在的那把证书」。所以换机器、重装、换硬盘，麻烦都出在同一处：新证书要登记，进程要重启。

换机与迁移

最常见的一条路：旧的电脑/盒子退役，新的机器上装好 MRRC Modern、局域网能用，然后把它接回同一个呼号。

① 先停旧机器 退出旧机器上的 MRRC Modern（盒子用 systemctl stop mrrc-modern），并确认隧道进程不再运行。别让两台机器同时以同一呼号在线 —— 旧机器会占住隧道端口，新的反而连不上（见 退出与撤销）。
② 新机器走接入 用同一个呼号走一遍 接入流程（应用内「接入云端」或安装器脚本）。呼号不变，标签与端口也不变。
③ 新证书自动登记 新机器会签一张新的自签证书（私钥不出本机），把公钥登记到 Hub。Hub 每 30 秒重生成一次路由与信任包，内容有变化且 nginx 配置校验通过时自动 reload —— 不需要人工执行任何命令。
④ 重启进程，别只换文件 证书是进程启动时读进内存的。如果新证书写进了配置而进程没重启（盒子 systemctl restart mrrc-modern；桌面版退出应用再打开），入口会一直 502，而本机看起来一切正常 —— 这是这个场景最常见的坑。
怎么知道卡在哪一步

登录 https://portal.mrrc.vlsc.net/，你自己那台实例的页面会摆出判据：登记证书指纹 ↔ 现场实际出示的指纹是否一致、证书有没有进信任包、Hub 这一侧是否已经重载。哪一项没对上，就修哪一步 —— 不用猜。

证书与续期

入口的证书 *.mrrc.vlsc.net的公网真证书（Let's Encrypt），Hub 侧每日检查、剩余不足 30 天自动续期。你什么都不用做。
你实例自己的证书 自签，签给你自己的入口名<呼号>.mrrc.vlsc.net，私钥只在本机。公钥被 Hub 钉进信任包，Hub 按这个名字逐台校验 —— 校验始终开着，自签靠「钉住它」通过。
什么时候需要重签 换机器、重装系统、私钥丢失、或者你主动轮换。重签之后记得 重启进程，并按上面第 ③ 步核对登记状态。
证书会过期吗 自签证书默认按多年有效期签发；到期前重签一次、重启进程即可。入口证书的续期与你无关。

退出与撤销

撤销 ≠ 吊销 ≠ 断线

Hub 侧的撤销是把路由从注册表移除 —— 入口随即 404。但它不会去切断你机器上的隧道：那台机器只要还在跑，就会继续连回来，甚至可能占住已经分配给别人的端口。停止使用要两边都做。

临时停机 直接退出应用 / 关盒子即可。入口会变成 502（隧道不在了），呼号与路由都留着，下次开机自动恢复。
永久退出（第 1 步） 在本机停掉 MRRC Modern 与隧道服务；确认隧道进程真的不在了 —— macOS 上「退出应用」曾留下孤儿的服务端与 frpc 进程继续占着端口。
永久退出（第 2 步） 请维护者把呼号从注册表撤销（门户里撤销带审计记录）。此后入口 404、隧道无法再登记。
转让给别人 不要私下交接。呼号是身份：走撤销 + 对方重新申请，让核验再做一次。 
# 确认隧道进程真的停了（macOS / Linux）
pgrep -fl frpc            # 期望：没有任何输出
# 盒子
sudo systemctl stop mrrc-modern && systemctl status mrrc-modern --no-pager | head -5

远程协助

有些问题靠诊断包解决不了 —— 「你进来看看」。远程协助就是为此准备的：由你开启的一条限时 SSH 通道，维护者能从 Hub 连进你的这台机器。

三条设计承诺
  • 必须由你开启 —— 没有常驻后门，窗口关闭即消失。
  • 凭据在你手里 —— 用户名与口令在本机生成、只显示在你的页面上， Hub 从头到尾看不到，也不会写进任何日志；请口头或短信告诉维护者。
  • 三条路都能关 —— 你按「停止协助」、窗口到期、或维护者那一侧被强制结束。

怎么开

  1. 在 MRRC Modern 的支持页找到「远程协助」，选一个窗口（30 分钟 / 60 分钟 / 3 小时），点「开启协助」。
  2. 页面上会出现用户名、口令、剩余时间、已连接四项。把用户名与口令告诉维护者（电话、短信、微信都行）。
  3. 维护者连进来后，「已连接」会有反应；你随时可以按「停止协助」把他请出去。
它开在哪里 SSH 只监听本机回环，隧道远端也落在 Hub 的回环 —— 公网上没有端口，只在窗口开着时存在。
维护者能做什么 拿到一个和你自己同权限的 shell（盒子/桌面版就是 MRRC Modern 运行用户的权限），不提权；需要 root 的操作仍要走盒子既有的受限通道。
安全兜底 口令连错 5 次自动关闭；窗口到期自动关闭；口令不落盘、不进诊断包、不写日志。
想留记录 协助的开启与结束都会写进本机与 Hub 的审计，事后可查。

版本升级

MRRC Modern 自己带着升级通道（桌面版在应用内检查更新，盒子走镜像的更新脚本），与 Hub 接入互不干扰：升级后隧道配置和证书都在原位，但如果升级过程重签了证书或改了环境文件，按第 ② 节重启进程。

升级说明与下载在 MRRC Modern 产品站；盒子请看 W103D 完整指南里的升级一节。

什么时候找维护者

问题能写在纸上 用应用里的 🐞 诊断包：生成 → 上传，维护者能拿到日志与配置快照（口令等敏感值已脱敏）。
需要有人进来看看 用上面的远程协助开一个窗口。
产品本身的 bug/建议 提 issue （站点与 Hub 侧）；产品侧用 MRRC Modern 仓库的 issue。
先自己看一眼 排障页有四跳分诊与常用诊断命令，能区分「隧道断了」「服务没起」「证书没重启」。

接着看 → 使用与分享 · 连不上 → 排障 · 机制细节 → 设计与层层实现
本页事实基线：2026-10-16 现场复核（判据取自 portal/trust.py、help_session.py与 2026-10-11 实例生命周期取证）。