一台主机,任意多台副机
m-ui 从设计上就是多服务器的 sing-box 面板,不是后加的插件。每台服务器跑同一个二进制;一台是主机负责算账,其余只管转发。

角色
| 主机 | 副机 | |
|---|---|---|
| 面板 | 完整:线路、用户、上游、代理、设置 | 只读展示主机下发的内容;本机设置、证书、日志可改 |
| 数据面 | 内嵌 sing-box,跑自己的线路 | 内嵌 sing-box,跑部署到它的线路 |
| 算账 | 汇总各机流量,判定配额、到期、设备数 | 每个用户一个单调计数器,上报增量 |
| 订阅 | 提供订阅(副机也可以,数据一样) | 同样的数据、同样的格式 |
接入一台副机
- 在新服务器上用同一条安装命令装 m-ui。
- 在它的面板里 设置 → 作为副服务器运行,配对卡片里有它的 API 地址与令牌。
- 回到主机 服务器 → 新增服务器,贴上地址和令牌,起个名字,填域名或 IP。副机证书各自签发(自签就行)。
就这些。五秒内副机显示 在线 · 已同步,开始跑部署到它的线路。
版本:主副机保持同一版本,升级时先升副机、再升主机。主机用到新功能后,版本不够的副机会整份拒收同步、按旧配置继续服务(服务器页标「版本与主机不同」),直到它升级。
同步什么、怎么同步
主机每 5 秒构造一份快照 —— 线路、上游、带凭据的用户、用户↔线路分配、外部节点、代理、订阅相关设置 —— 哈希成一个修订号,并发推给所有副机。已经是这个修订号的副机什么都不做;不是的就应用并重载数据面,用的是和主机一样的三级重载:改用户只换入站用户表,改上游只换出站,只有改线路才重启 sing-box(起不来则回滚)。
同一轮里主机再拉每台副机的报告:自上次游标以来的流量、每个用户的在线源 IP、版本、内核状态、证书剩余天数与续期结果、最近的入站连接。副机一般不配通知,它的证书续期失败、快到期由主机代发提醒。某台机器慢或失联只耽误它自己,其它机器按时同步。
跨服务器的流量、配额与设备数
- 流量只记一次。副机保存每用户的单调计数器;主机为每台副机存一个游标,只加增量。副机重装(计数器归零)会被识别并重新对齐,不会重复计费。
- 配额与到期只在主机判定。用完的用户在下一份快照里就不存在了,几秒内所有服务器都不再服务他。
- 设备数按所有服务器上的源 IP 合计:IPv4 地址与 IPv6 /64 各自计数、各自不超过上限(同一台双栈设备不会被算成两台,上限 3 时最多 3 个 IPv4 地址加 3 个 IPv6 /64)。主机合并各机的在线 IP,再把"别处看到的 IP"下发给每台机器,所以上限是整个集群合计,不是每台服务器各算。设备满了只拒新设备;被拒的连接汇总到主机概览的「最近入站连接」里,标明是哪台服务器。
多服务器时的订阅
部署到 N 台服务器的线路在用户订阅里出现 N 次,命名为 线路 – 服务器,各用自己的域名或 IP。Clash、sing-box 和通用链接的客户端按延迟选,或者让用户自己挑。给线路加一台服务器,所有人的订阅下次刷新就多出节点 —— 不用逐个改用户。只想让某个用户、某个套餐或某个代理拿一条线路在某一台服务器上的入口时,勾那个入口而不是整条线路,订阅里就只出那一个。
部署在多台服务器上的线路,Clash 和 sing-box 订阅里各出一个以线路名命名、按延迟自动选的测速组(用户在这条线路上只拿到一台时不出),节点名和顺序不变。线路名始终留给本站:外部订阅里和线路同名的节点改叫「X 2」,组出不出都一样,客户端选着线路组时不会被落到同名的第三方节点上。
副机掉线时
- 副机拿着手里的配置照常转发,上面的用户没有感觉。
- 主机把它标为离线,配置了 Telegram 的话一分钟后告警,之后每 5 秒继续尝试。
- 它回来后,游标从断点继续补齐流量,当前快照重新推送。中间被停用的用户在这次推送里被移除。
主机换机与主机挂了
两件事:设为主机是计划内把主机换到另一台;主机容灾是主机挂了(VPS 宕机、被误删)时由备用接任。都在主机面板上操作,也能用 m-ui ha status | takeover | set-master | abandon | pause | resume | yield | reset 在 SSH 里做。
设为主机
- 服务器页点那台的角色标签 →「设为主机」,输一次管理员密码。确认框写清新面板地址、代理面板地址、订阅域名该指向的 IP。
- 主机的全部数据端到端加密交给那台,它以更高的纪元成为主机,原主机自动变为副机。换到全新 VPS:像副机一样接入、同步上以后设为主机,不用备份还原。
- 写操作暂停一两分钟(最长按库大小 15–60 分钟,有截止时间);任何一步在提交前失败都自动取消,原主机照旧。
- 提交请求发出后目标没回话(结果不明)时写操作保持暂停,本机每 10 秒问一次目标;到截止时间先看副机有没有跟它,没有就以更高的纪元隔离它、恢复写操作。连不上的副机已经永久下线、凑不够确认时,在主机上执行
m-ui ha abandon --force。 - 和那台的链接是明文 http 时,要勾选风险确认才能设为主机:链路上的主动中间人能拿到并改写整库。能换 https 就先换,自签证书加指纹也行。
- 不保证一字节流量都不漏:从打包数据到两台重启之间,这两台自己线路上的流量不计入用户用量;其它副机上的照常按游标补回。
主机容灾
- 在 设置 → 主机容灾 打开,默认关闭。服务器列表里排在前面的几台副机(默认 2 台,可设 1–3)当备用,定时收到用它自己公钥加密、主机签名的数据副本。
- 接任方式:关闭、先确认再接任(默认:主机失联 3 分钟后发 Telegram,回复确认码或在备用面板上点接任)、主机失联后自动接任(10 分钟;三台以上要过半副机同意,一主一副时还要境外测点也连不上主机)。
- 失联要同时满足:备用一分钟以上没收到主机的消息、其它副机也联系不上它、境外测点也连不上它。国内到主机被墙、某一台断网、主机升级重启都不算;升级前也可以先暂停接任。
- 防脑裂:每次换主机都升一个纪元,副机只听纪元最高的那台;原主机回来自动变为副机。接任补不回最后一份副本之后的改动和原主机自己线路上那几分钟的流量。
- 和副机的链接是明文 http 时它默认不当备用,确实可信再在「高级」里打开。副机都要 v0.7.17 或更新,升级时先升副机,再升主机。
- 把主机的备份还原到另一台并启动,等于把主机换到那台:旧主机再起来会被挤成副机。只想看备份内容,别在联网的机器上启动它。
- 接任时接管什么:默认只接管主机的工作 —— 推配置、并流量、到期 / 超量停用、Telegram 机器人、外部 API 换到新主机,订阅设置照旧、DNS 不动(用户的订阅地址仍指向原主机,它失联期间刷新订阅会失败,已连上的线路照常)。选「连订阅一起接管」要订阅地址用域名、填一个只有这个域名 DNS 编辑权限的接口(Cloudflare、阿里云云解析、腾讯云 DNSPod):接任时把指向原主机的 A / AAAA 记录改到新主机,带来的订阅证书不能用就经同一个接口重签;面板也用域名时,面板、代理面板和外部 API 的地址跟着主机走,对接的商城、机器人不用改地址。DNS 接口每 6 小时自检一次。「设为主机」不受这个选项影响,总是整套迁过去。
- 流量图、订阅日志和较早的审计日志另做一份加密签名的历史数据(约每小时一份),接任时并进新库,图表不从空白开始。
- 两台同时当主机(备用接任后联系不上别的副机、原主机回来时多数副机还跟着它):两边「需要处理」红色提示、Telegram 发一次,纪元高的一方点「让回主机」(或
m-ui ha yield)。 - 开着容灾时,副机上接任要用的端口留着不给线路和中转入口;备用每 10 分钟自检这些端口,被别的程序占着就提醒,真接任时先退回自己原来的端口、再不行自动挑一个空闲端口。
流量倍率
每台服务器有一个倍率(默认 1)。走倍率 2 的服务器,流量按两倍计入用户配额 —— 适合专线或带宽贵的机器。用户的已用量、用户详情和落地页的流量图都是折算后的数,账对得上。副机的落地页只看得到经过它自己的流量,所以不显示流量图。