m-uising-box panel

功能

按侧栏的顺序,面板管的每一件事。全部在一个二进制、一个 SQLite 文件里。手机上打开面板,列表自动排成卡片。面板右上角的帮助说明打开内嵌的使用说明(中英两份,带目录和页内搜索),直接定位到你当前所在页面的那一章;代理面板里打开的是代理视角的版本。

概览:最上面是需要处理,数据面重载失败、服务器离线或没同步、证书、大陆连通、上游故障、用户快到期或流量将尽、备份失败等每类一行,按轻重排,点行尾去处理,一切正常时只剩一行「✓」;下面一排数字是在线用户、24 小时流量、服务器和证书状态,点了直接跳到对应页面;再往下是流量走势、上游巡检、当前在线、最近入站连接、流量排行、最近操作、数据面状态和可收起的核心日志(手机上默认收起)。多服务器时流量走势和流量排行按全部服务器合计,卡片标题上注明范围。

线路

线路 = 入口协议 + 端口 → 出口。协议:Hysteria2(支持端口跳跃和伪装站点)、AnyTLS、TUIC、Trojan、VLESS(Reality / Vision,握手目标可一键检测、帮你挑)、VMess、Shadowsocks(含 2022 系列),以及 SOCKS、HTTP、Mixed。传输层:WebSocket、gRPC、HTTPUpgrade、HTTP。每条线路可以部署到全部服务器或指定几台。勾上按规则分流,可以让指定的域名后缀、完整域名、域名关键字、IP 段或端口走另一个上游、直连或直接拦掉,其余流量走线路选的上游。快速添加自动填好空闲端口和合理参数;每次保存都经 sing-box 干跑,并检查端口是否与面板、其它线路、本机其它程序冲突。点线路名打开线路详情:这条线路的流量(全部服务器合计或单看一台,24 小时 / 7 天 / 30 天)、各服务器分开的流量,和此刻在线的用户与 IP。中转入口:线路可以经集群里另一台服务器转发(那台用 sing-box 自带的转发把加密数据原样转给出口,不解密,TCP、UDP 都能转),也可以写上外部中转(自己跑的 realm、iptables,或买的中转)的地址,订阅里每个入口多一个节点;出口看到的来源是中转的 IP。

上游

不直连时从哪出去:VLESS、VMess、Trojan、TUIC、Hysteria2、Shadowsocks、SOCKS 出站,粘贴分享链接即可导入。一键测延迟、定时巡检、故障 / 恢复告警,Cloudflare WARP 在面板里一键接入。巡检在真正用这条上游的机器上做:每台只测自己线路用到的那些,上游页一行里并排显示各服务器的延迟,告警会点名是哪台不通。改上游是热换出站,数据面不重启。线路也能直接加为上游(链式代理):参数跟着线路走,线路改端口、换协议都不用管,专用凭据不占用户配额,流量只算一次。上游组:几条上游放一组,自动用最快能通的,挂了自动换,面板写明现在走哪条。

用户

套餐

配额、时长、设备、限速、线路分配的模板,可以另填一个只给自己看的参考价。建号、续费、延期时一键套用。用户记着自己的套餐,套餐页能看到有多少人、是谁。

用户的「更多」菜单里:续费… 一次续 1–120 期(月付套餐按季、按年卖就填 3、12),可以续费(清零流量并顺延)、延期(保留已用流量)或只归入套餐;换套餐… 三种方式 —— 立即替换、叠加(保留旧订阅剩下的时间)、按两个套餐的参考价折算剩余价值。对话框实时预览变更前后,到期提前、马上超量这类让用户吃亏的影响标红,要勾确认才执行;单个用户的对话框带防重复编号,双击、网络重试都只执行一次。用套餐续费、延期、换套餐是明确的开通动作,手动停用的用户也会被启用,面板执行前会先提示。详情里的套餐记录能看到最近的续费和换套餐。

编辑套餐时可以勾选限速规则,这个套餐现有和以后的用户都跟着走。代理有自己的套餐,和你的分开。

规则

临时限速,叠在用户自己的限速之上。时段限速:每周指定几天的某个时间段(面板时区,可跨午夜)。突发限速:最近 N 分钟内跑了 X GB 就限 M 分钟,到期自动解除,再次达到再次限速;同一用户可挂多条,各自独立。目标可以是全部用户、某个套餐的用户(含以后套用的)、某个代理名下全部用户、或逐个勾选。规则由主机判定并同步到各副机,多条命中取最严;默认开着「不超过用户自己的限速」,结果不会高于用户自己的限速。改限速对在线连接立刻生效,不用等重连。用户列表标出「限速中」;落地页不显示。

代理

给代理分配一组线路,以及流量额度、设备池、带宽池和到期日。单个用户的设备数与限速由代理自己定;池限制的是名下所有用户同时的总量:设备池跨服务器算并集、池满只拒新设备,带宽池每台服务器各一份。代理有自己的面板(默认端口 2054,路径 /dl),在里面建用户、建套餐、设置自己的落地页标题、公告与联系方式,还可以开两步验证。所有用量汇总到代理;代理超额、到期或被停用时,名下用户一并断掉。代理的用户不会混进你的用户列表。

订阅

服务器

一主多副。主机每 5 秒推送线路、上游、用户、凭据,拉回流量增量与在线 IP;副机只管转发。每台服务器可设流量倍率,线路按服务器部署,双栈服务器可按线路选 IPv4 或 IPv6,连接跟踪跨服务器汇总;大陆连通检测从移动、电信、联通的家宽测点定时测每台服务器,被墙就发 Telegram。

IPv6 入站检测:服务器默认走 IPv6、或有线路选了 IPv6 时,同一轮从境外的 IPv6 测点连它的 IPv6 地址和线路端口,结果标在服务器页和线路上;UDP 线路(Hysteria2、TUIC)测不了,会写明。概览的最近入站连接按服务器列出谁连进来了、走的哪条线路;被设备数或代理设备池拒的标红;到了但没过 TLS / REALITY 握手或协议认证的来源在「握手失败」筛选里并写明原因,排查"用户说连不上"时先看这里(有几类失败不会被记录,比如 Hysteria2 / TUIC 的 QUIC 握手失败,卡片标题旁的「?」里列着)。

设为主机与主机容灾:设为主机一键把主机换到另一台服务器,数据端到端加密交接过去,原主机自动变为副机,换到全新 VPS 也不用备份还原(交接时写操作暂停一两分钟,这两台自己线路上那一两分钟的流量不计入用量)。主机容灾(默认关闭)让排在前面的几台副机当备用,保存加密的数据副本;主机失联时按你选的方式接任:先确认再接任(默认,Telegram 回复确认码或在备用面板上点接任)或主机失联后自动接任。纪元只升不降防脑裂,原主机回来自动变为副机。接任时接管什么可选:默认只接管主机的工作(推配置、并流量、到期 / 超量停用、Telegram 机器人、外部 API),也可以连订阅一起接管(填 Cloudflare、阿里云云解析或腾讯云 DNSPod 的 DNS 接口:自动改解析、需要时重签订阅证书,面板用域名时面板和外部 API 的地址也跟过去)。流量图、订阅日志和较早的审计随加密的历史数据带过去;两台同时当主机时两边红色提示,可以一键让回。和副机的链接是明文 http 的,设为主机要勾风险确认,默认也不当备用。命令行 m-ui ha status | takeover | set-master | abandon | pause | resume | yield | reset。

详见 多服务器。

证书

一台服务器可以放多张证书。Let's Encrypt,HTTP-01、Cloudflare DNS-01 或手动 DNS,支持泛域名,签发前预检 DNS 与端口。没有域名一键自签。也可以用自己的证书文件。线路默认、面板、订阅各选各的,每条线路也能单独选一张,抽屉里按服务器标出哪台有、还剩几天。

自动续期:启动几分钟后先查一次、之后每小时查,进入有效期最后三分之一就续(90 天的证书剩 30 天时),续好后热更新不重启。失败按 1、2、4 小时退避重试,第一次失败就通知;证书库里每张都写着能不能自动续、上次续期、失败次数和下次重试时间,也能单张关掉自动续期或立刻续。副机一般不配通知,它的续期失败、快到期由主机代发提醒。手动 DNS 签的证书不能自动续。面板、订阅、代理面板的证书文件万一读不出来,先用临时自签证书顶着启动并在顶部提醒,不会整个起不来。

运维

安全

两步验证(TOTP)、按 IP 的登录限速、按角色隔离的会话、服务端强制的代理隔离、安装脚本与更新器都校验摘要、没有遥测。任何配置改动都绕不过校验。面板放在反向代理后面时,在设置里填「受信任的反向代理」,登录与外部 API 的失败限流按真实来源算。

外部 API

令牌鉴权的 HTTP API:建用户、改用户、启停、读用量、取订阅链接 —— 给发卡站、机器人和自动化用。套餐操作:/plan(别名 /renew)一次续 N 期,/change 换套餐(立即替换 / 叠加 / 按参考价折算),/plan-ops 查套餐记录。带 dryRun 只预览不执行(商城可以拿来报价);带 requestId 或请求头 Idempotency-Key(比如订单号),重试只执行一次;会让用户吃亏的换套餐返回 409,确认后带 force 再调。续费、换套餐会启用手动停用的用户。代理有自己的令牌,只能动名下的用户和自己的套餐。管理员页的接口一览带着填好前缀和令牌的 curl 示例。除了默认令牌,还能生成多把附加密钥,每把单独勾权限(查看 / 创建 / 修改 / 删除用户、续费与换套餐、查看套餐、面板信息),可停用、重新生成;来源 IP 白名单可选。面板信息接口(/overview、/servers、/lines、/onlines、/users/{名字}/traffic)给 Telegram 机器人和商城后台看面板状态,代理的密钥只看到自己名下的。见 docs/API.md。