sing-box 的用户管理,集中做
sing-box 认识凭据,不认识配额、到期日,也不知道一个人用了几台手机。m-ui 把这些状态放在一处,在它管理的每台服务器上执行。
一个用户是什么
一个名字,一套为每种协议自动生成的凭据(Hysteria2 和 Shadowsocks 是密码,VLESS / VMess / TUIC 是 UUID,以此类推),能用的线路,以及下面这些限制。名字同时是订阅地址,除非你在设置里改成随机令牌。建用户时主机和每台副机换的是入站用户表,别人不重连。
流量配额
按 GB 设,或者不限。用量是所有服务器上下行之和,按每台服务器的流量倍率折算(专线可以按双倍计)。周期重置从首个重置日起每 N 天清零,并把因超量被停用的用户重新启用 —— 也就是常见的月付。历史累计另外保存,重置不丢历史。
到期
一个日期,或者不限。到期的用户停用并踢线;落地页会告诉他。「延长 30 天」和「续费」(再套用一次套餐)在用户上一键完成,整个列表也能批量延期。Telegram 可以在到期前 N 天提醒你。
设备数
一台设备 = 任一入站看到的一个不同源 IP。主机合并各副机的在线 IP,再把"别处看到的 IP"下发给每台副机,所以上限 3 是整个集群三台设备,不是每台服务器三台。超出的连接被拒绝;用户详情里列出当前 IP 和它们所在的线路。
限速
按用户设上下行 Mbps,由每台服务器的数据面执行。适合试用账号,也防止一个用户把小鸡的带宽吃满。
套餐
套餐是模板:配额、时长、设备数、限速、重置周期、分配哪些线路。建用户、续费、批量生成时套用。代理有自己的套餐,和你的分开。
订阅
每个用户一个地址、三种格式(通用链接、Clash / Mihomo、sing-box JSON),外加带用量、到期、一键导入和二维码的落地页。你可以允许用户生成临时共享地址,随时能取消。细节在 sing-box 面板页。
批量操作
按前缀和套餐批量生成 N 个用户;跨页勾选后批量启用、禁用、延期、重置、套用套餐或删除;导出 CSV;从旧面板数据库导入用户。用户列表分页可搜索,几千个用户也管得过来。
代理
给代理分配流量额度、设备池、带宽池,一个到期日,一组线路。他有单独的面板建自己的用户和套餐;所有用量计入他的额度,用完或到期时名下用户一并断掉。他的用户不会出现在你的列表里。
怎么执行
面板每 10 秒从内嵌内核读流量和在线连接;每分钟在主机上判定配额、到期和周期重置。不合格的用户在库里停用,并从下一份推给各副机的快照里消失,所以全集群几秒内一致,从不依赖副机自己做决定。看同步协议是怎么做的。