m-ui 帮助说明代理面板帮助说明
按目录找功能(手机上点右上角的「目录」),或者用上面的搜索框。灰框里的字和面板上的按钮、标题一模一样,照着找、照着点就行。这里只列代理面板用得上的内容。
快速上手
m-ui 是一个自己搭的代理面板:线路、用户、订阅、证书、备份和多台服务器,都在网页里管。
代理面板用来管你名下的用户:建号、续费、看用量,再把订阅地址发给用户。
先认识几个词
面板里反复出现这几个概念,弄清楚了后面就好懂。
- 线路:客户端连进来的入口,等于"协议 + 端口",再决定流量从哪出去。用户订阅里的节点就是由线路生成的。
- 上游:线路的出口。默认 direct(本机直出),也可以是 WARP 或别的落地机。
- 用户:一个订阅地址,带流量、到期、设备数和限速。流量用完或到期会自动停用;设备数满了只拒绝新设备,限速只限制速度。
- 套餐:流量、时长、设备数、限速、线路的模板,建号、续费时一键套用。
- 订阅:给客户端导入的地址;同一个地址用浏览器打开,是用户自己的落地页。
- 主服务器 / 副服务器:主机存全部数据、负责算账;副机只转发流量,配置由主机推送。
- 代理:帮站长卖号的人,在自己的代理面板里只管自己名下的用户。
第一次登录
装好后用浏览器打开面板,第一件事是把默认密码改掉。
- 打开
http://服务器IP:2053/app/(端口和路径以安装结束时打印的为准)。 - 用默认账号
admin/admin登录。 - 顶部红条提示还是默认密码:点 立即修改,在 管理员 页的 登录账号 里填 原密码 和 新密码,点 更新账号,然后用新密码重新登录。
- 只打开
http://服务器IP:2053/会是 404,这是故意的:不把面板路径告诉扫端口的人。地址要带上完整路径。 - 打不开:先看云服务器的安全组 / 防火墙有没有放行 2053/tcp。
- 忘了地址或密码:SSH 登录服务器执行
m-ui,菜单 1 查看面板地址,菜单 5 重置管理员密码。
五步开始用
概览页的 快速开始 清单就是这几步,做完前四步就能给人用了。
- 改默认密码(见上一节)。
- 准备证书:证书 页 → 添加证书。有域名选 有域名(自动签发) 签一张;没有域名选 无域名(自签),点 生成自签证书。详见 证书。
- 建线路:线路 页 → 快速添加,新手选 Hysteria2 或 AnyTLS,保存。详见 线路与协议。
- 建用户:用户 页 → 新增用户,填用户名和额度,勾上 可用线路,保存。
- 发订阅:点用户名打开详情,订阅 下面有两个地址,把不带
?format=的那个(通用地址)发给用户:用浏览器打开是他自己的落地页,能一键导入客户端;客户端来拉时按类型给格式(见 订阅地址、二维码与临时共享)。
https://域名…,旧地址立即失效,每个客户端都要重新导入,签发前会再提示一次。不勾就保持原地址,用户刷新一次订阅即可。代理:三步开始用
站长给你开通代理之后,按这三步就能开始卖号。
- 打开站长给你的代理面板地址(默认端口 2054,路径
/dl/)。用户名填代理名,第一次登录密码留空,直接点 登录,按提示设置密码。详见 第一次登录与设密码。 - (可选)到 套餐 页建几个套餐,以后建号、续费一键套用。
- 到 用户 页点 新增用户:填名称,选套餐或者手填额度,勾上 可用线路,保存;点用户名打开详情,把 订阅 下不带
?format=的那个地址发给用户。
界面导览
左边是功能导航,右上角是帮助和反馈;要你处理的事集中在 概览 最上面的 需要处理,其它页面顶部的彩色横条也会提醒。
- 左侧导航依次是:概览、线路、上游、外部节点、用户、代理、套餐、规则、服务器、证书、备份、运维、日志、管理员、设置。
- 左下角:主题切换(◐ 跟随系统、☀ 浅色、☾ 深色)、语言、退出登录。版本号旁出现箭头表示有新版本,点它就能更新(见 更新)。
- 右上角:帮助说明(就是本页)和 建议 / 支持(联系作者、反馈问题)。
- 需要处理:数据面重载失败、服务器离线或没同步、证书要处理、大陆连通异常、上游故障、用户快到期或流量将尽、定时备份失败等,每类一行,按轻重排,点行尾的链接去处理;一切正常时只剩一行「✓」。证书和大陆连通可以点 知道了,情况有变化会再出现。
- 顶部提醒条:在概览以外的页面,默认密码没改、证书要处理、大陆连通异常、数据面重载失败等会在页面顶部提醒,按提示处理。
- 副服务器的面板里,线路、用户这些页面是只读的,要到主机面板改。
- 快捷键:/ 跳到当前页的搜索框,Esc 关闭弹窗,Ctrl + Enter 提交弹窗。手机上点左上角 ☰ 打开导航。
服务器与主副机
一台主服务器管全部数据,可以再接任意多台副服务器当入口;订阅里每条线路在每台服务器上各出一个节点,客户端挑延迟低的用。
要不要加副机
一台服务器就能用;想给用户更多地区、更多入口时再加副机。
- 主机每 5 秒把线路、用户推给副机,同时收回各台的流量和在线设备;配额、到期只在主机上判定。
- 副机只转发流量。主机临时连不上时,副机继续按最后一份配置服务用户;恢复后流量按记录补齐,不会重复计费。
- 加一台服务器,所有人的订阅里自动多出对应的节点。
接入一台副机
在副机上装好 m-ui,把它的配对信息填到主机就行。
- 在副机服务器上同样安装 m-ui,登录副机面板(先把默认密码改掉)。
- 副机 设置 → 角色:勾 作为副服务器运行,点 保存。
- 副机 设置 → 配对信息:复制 API 地址 和 配对令牌。
- 主机 服务器 页 → 新增服务器:填 名称(会成为订阅里节点名的后缀,如"香港")、API 地址和配对令牌。副机面板用自签证书或 IP 访问时勾 跳过证书校验。
- 保存后几秒,这一行显示 已同步 就好了。
- API 地址是
http://时,令牌和全部用户凭据都是明文传输,列表里会标 明文。建议给副机面板开 HTTPS(自签就行),或者让副机面板端口只对主机 IP 放行。 - 副机的证书在副机自己的 证书 页签发,各自续期。
- 副机面板改成 HTTPS 后(副机证书页勾了 用于面板 HTTPS,重启后生效),要到主机 服务器 页编辑这一行,把 API 地址 换成副机 配对信息 里新的
https://地址(自签证书或用 IP 访问的勾 跳过证书校验),不然这台会显示离线。在副机上签正式证书时这一项默认勾着,不打算改 API 地址就取消它。 - 副机面板里线路、用户、套餐这些页面是只读的,改动都在主机上做。
- 主副机版本要一致:列表里标 版本与主机不同 时,把副机升级到同一版本。用到较新的功能后,版本不够的副机会整份拒收同步、继续按旧配置服务:按规则分流要 v0.6.14 及以上,线路作上游、上游组、外部节点的排除关键词要 v0.7.16 及以上,外部节点的隐藏和改名要 v0.7.17 及以上。
连接地址与 IPv4 / IPv6
订阅里的节点地址默认用每台服务器自动探测到的公网 IP,域名只作 SNI,免得客户端 DNS 被污染连不上。
- 编辑服务器 → 连接地址(可填 IP):留空就用探测到的公网 IP;想用固定的 IP 或域名就手填。
- 自动地址用:双栈服务器默认给 IPv4,可以改成 IPv6;选的那个没探测到就用另一个。手填了连接地址就不看这一项。
- 双栈服务器在线路表单里还能按线路单独选 IP 版本。
- 想让订阅里写域名而不是 IP:设置 → 订阅 → 订阅里的节点地址 选 域名。选之前先给每台服务器填好 域名 / IP(本机留空就用面板域名):这个模式下 连接地址(可填 IP) 不生效,没填域名的服务器不会出现在订阅里。
::/0 或者本机防火墙拦了 IPv6。每台只测一个端口,别的端口要各自放行;UDP 线路(hysteria2、tuic)测不了,只能在服务器上抓包确认。- 云服务器的 IPv6 要在安全组里给
::/0单独放行(TCP、UDP 分开加);系统里的 ip6tables / ufw 也要放行,只清空 iptables 不会放开 IPv6。 - WARP、NAT 这类只能出站的 IPv6 不能给用户连。
- 纯 IPv6 的机器:检查更新前要先装 WARP(见 WARP);直连出口打不开只有 IPv4 的网站,线路上游选 warp 才能访问全网。
流量倍率
给贵的服务器多扣流量:经过这台服务器的流量按倍率计入用户用量。
- 编辑服务器 → 流量倍率:
2就是双倍扣量,节点名会带x2标记;1是原样。主机自己也能设。 - 用户的已用量、详情里的流量图、落地页上的数字都是折算后的,账对得上;线路、上游的统计是实际流量。
大陆连通检测
看服务器在中国大陆是不是被墙了:从大陆移动、电信、联通的家庭宽带测点去连,香港测点作对照。
- 服务器 页的 大陆连通 一列显示结果:点格子看明细,点 检测大陆连通 一次测全部。
- 结果怎么看:正常;部分不通(某一家运营商连不上);疑似被墙;IP 被墙(要换 IP);端口被封(换个端口);境外也不通(是服务器、端口或安全组的问题,不是墙)。
- 定时巡检:设置 → 大陆连通检测 → 自动巡检,默认开着:m-ui 启动约 2 分钟后测第一轮,之后默认每 90 分钟一轮,发现被墙或恢复时发 Telegram。
- 检测时服务器地址(IP 和端口)会发给 Globalping 公共测试网络,自动巡检也一样;不想发就去掉 自动巡检,只在需要时手动点检测。免登录每小时约 250 个测点次,测一台约用 15 个;不够用就在设置里填免费申请的 Globalping 令牌(可选)。
- 测的是这台第一条 TCP 线路的端口;只有 hysteria2、tuic(UDP)线路时,只能看出 IP 有没有被墙。目前只测 IPv4:大陆的家庭宽带测点大多没有 IPv6,拿它们测 IPv6 会把正常的服务器误判成被墙(见 已知限制)。
停用、删除与离线排查
停用或删除副机会让它立刻停止服务;副机显示离线时,先看列表里写的原因。
- 编辑服务器去掉 启用:那台立刻停止为任何人服务,重新启用后恢复。
- 删除服务器:只部署在它上面的线路会被停用,只用它的用户 / 代理会失去那条线路;操作后会列出受影响的线路和人。
- 标 下线通知未送达:那台还没收到停止服务的通知,主机会一直重试。要立刻停掉,就 SSH 到那台机器上执行
systemctl disable --now m-ui(停掉并取消开机自启),或者用m-ui菜单 14 卸载。只关掉副机模式停不了服务:它会变成一台独立的主机,按最后一份配置继续给所有人用。 - 离线原因:连接超时、连接被拒绝(端口没放行或面板没在运行)、域名解析失败、证书不受信任(勾上跳过证书校验)、令牌不匹配(重新复制配对令牌)、证书指纹变了(确实重签过副机证书,就在那一行的 更多 里点 重置指纹)。
- 换一台副机:新副机装好后,在 服务器 页编辑原来那一行,换成新的 API 地址和令牌,主机会自动重新推送。域名和 API 地址不变(域名已经解析到新机器)的,只把令牌换成新机器的就行:主机当它是一台新机器,不再复用连着旧机器的连接,推送、拉报告、设备数合并立刻都走新机器;勾了 跳过证书校验 的,记住的旧指纹随令牌一起作废,新机器第一次连上时重新记住,不用再点 重置指纹。
设为主机与主机容灾
两件事:设为主机 一键把主机换到另一台服务器(计划内换机、换到全新 VPS 都用它);主机容灾 在主机挂了(VPS 宕机、被误删)时由备用接任为主机。容灾默认关闭。
设为主机
在主机面板上把任意一台副机设为主机:数据一次交接过去,原来的主机自动变为副机。
- 服务器 页,点那台服务器 状态 一栏开头的角色标签(如「副机 ▾」「备用 1 ▾」),在弹出的卡片里点 设为主机;行末的 ⋯(更多)菜单里也有。
- 确认框里写清会发生什么:检查结果、新的面板地址和代理面板地址、订阅域名的 DNS 该指向哪个 IP。输一次管理员密码(开了两步验证再输动态码)。
- 之后全程有进度,完成后给出新面板和代理面板地址。账号、密码、两步验证都不变,到新面板重新登录。
- 主机的全部数据(用户、线路、套餐、代理、设置、流量记录)端到端加密后交给那台,它成为主机;原来的主机变为副机,继续用自己的线路服务。两台各重启一次,连在这两台上的用户断开几秒后自动重连,别的服务器不受影响。
- 提交之前任何一步失败(包括传得太慢、快到截止)都会自动取消:原主机照旧当主机,写操作恢复,数据不变。
- 换到全新 VPS:照常装好 m-ui,像副机一样接入(见 接入一台副机),显示 已同步 后对它点 设为主机,不用备份、还原。
- 和那台的链接是明文 http 时,确认框里要勾选 我知道和它的链接是明文 http:链路上的主动中间人能拿到并改写整库,仍要继续 才能点。能换成 https 就先换(自签证书 + 指纹也行)。
- 订阅地址不变:订阅的域名、端口、路径和证书跟着主机走,把订阅域名的 DNS 改指向新主机就行。订阅地址用的是 IP、或者迁过去的订阅端口和那台的面板 / 代理面板 / WARP 端口或线路端口相同时,那台继续用自己的订阅端口,订阅地址会变,确认框的 注意 里提前说。面板和代理面板用新主机自己的地址。
- 订阅证书是 已有证书(由 certbot 等工具续期)、新主机上又没有同名证书的,带过去的是一份副本,新主机上没人续它:做完后就在新主机 证书 页重新签发,或者在新主机装好 certbot 后重新添加。
- 离线、停用、配置没同步上、版本太旧、磁盘不够(那台和本机都要够)、它连不上本机、本机作为副机的地址拼不出来时不能设为主机,卡片里写明原因。代理面板端口在那台被线路占着时,成为主机后代理面板起不来,也在 注意 里列出。
- 交接期间两台自己线路上的流量照常计费:原主机从暂停写操作起另记一本账,变为副机后由新主机只收打包之后的那段;那台收到数据之后自己记的,换上新库时并进去;其它副机线路上的流量照常补回。
- 交接期间写操作暂停,通常一两分钟,最长按库的大小算(15–60 分钟),进度框和页面顶部写着截止时间:面板只读,外部 API、代理面板、Telegram 机器人、订阅页的临时共享返回 503,对接的程序要能重试。
- 提交请求发出后没收到回话,进度框显示结果不明:写操作继续暂停,原主机每 10 秒问一次那台。到截止还没结论,或你点 放弃(隔离目标) 并再输一次密码,原主机先再问一次那台、看各副机跟的是谁:已经有副机跟了那台,就按换主机完成;否则以更高的纪元继续当主机、恢复写操作,那台之后就算起来,副机也不认它,它会自动变为副机,它那份数据不生效。隔离要副机确认收到撤销才做:截止前放弃要那台以外的副机全部确认,截止后过半即可;确认不够时写操作继续暂停,连不上的副机恢复后自动完成。
主机容灾怎么工作
在主机的 设置 → 主机容灾 里打开(保存时要输管理员密码)。开启后,服务器顺序排在最前面的几台副机当备用,保存加密的数据副本。
- 备用台数 默认 2(可设 1–3),按 服务器 页的顺序挑,列表里标「备用 1」「备用 2」;调顺序就是调谁先接任。前排暂时离线、磁盘不够时名次先保留 30 分钟再顺延;新进名单的备用会发 Telegram。
- 主机定时把数据副本发给备用(默认每 5 分钟一份,有改动后 30 秒内补一份)。副本用备用自己的公钥加密、主机签名,只有接任时才解开。发送连续失败时,卡片和 就绪检查 写出原因。
- 主机失联期间副机照常转发,已连上的用户不受影响;接任是为了恢复管理、计费、订阅和告警。
- 接任后它就是主机,可以长期当。副机线路上的流量会自动补回。补不回来的:最后一份副本之后在原主机上做的管理改动、原主机自己线路上那几分钟的流量。流量时序图(概况、落地页的图表,外部 API 的按天流量)、订阅日志和 7 天以前的操作审计另外约每小时单独发一份「历史数据」给备用,接任时一并带过来,图表最多缺接任前约一小时的一段;备用还没收到过的话这些从空白开始(成为主机的提示里会写明)。原主机回来也不会合并回来。
- 设置页的 就绪检查 逐项打勾:合格的备用、副机版本、副本自检、和副机的链接是不是 https、订阅是不是用域名、Telegram、副机之间是否互通、境外见证;没通过的给一句修法。
- 备用卡片里有它的公钥指纹,和那台副机 设置 → 主机容灾 里显示的本机指纹应该一样。
- 副机都要升级到 v0.7.17 或更新:旧版照常同步,但不能当备用。升级时先升副机,再升主机:版本比主机旧的备用保留名次和手里的旧副本,但收不到新副本,合格备用不够时告警一次。
- 和副机的链接是明文 http 时,它默认不当备用:http 链接上的主动中间人能拿到并改写数据副本。确实可信时,在 高级 里打开 允许明文链接的副机当备用。
- 副机之间要互相放开面板端口,好互相确认主机是不是真的失联;不通时只能靠境外测点或人工确认。
- 备用重装过 m-ui,它的公钥会变:卡片里点 重新信任,核对指纹、再输一次管理员密码后才会再给它发副本。指纹对不上又没重装过,可能是有人在冒充它。
接任方式
打开容灾时三选一,默认是 先确认再接任。
- 关闭:主机挂了要人来处理,副机照常用自己的线路服务。
- 先确认再接任(默认,推荐):备用确认主机失联 3 分钟后发 Telegram,回复消息里给的
/takeover 码(或「接任 码」),或者到备用的面板上点 接任为主机,它就接任。按钮只在发出确认之后才出现;没到时间、证据不够时,备用页面顶部写着为什么不接任。主机在这之前回来,提醒自动取消。 - 主机失联后自动接任:失联 10 分钟后备用自己接任。三台以上要过半副机同意;一主一副时还要境外测点也连不上主机,所以必须开着 境外测点见证。这个模式不给接任按钮,真要强行接任用命令行
m-ui ha takeover --force。 - 什么算失联:备用 1 分钟以上没收到主机的消息,其它副机也联系不上它,境外测点(美、德、日、新、港)也连不上它的公网 IP。只是国内到主机被墙、某一台和主机之间断网,或者主机在升级、重启,都不算。
- 防脑裂:每次接任或设为主机都换一个更高的纪元,副机只听纪元最高的那台。主机推给副机的状态带签名,交接标记带时效、绑定新主机的公钥,只拿到副机令牌伪造不了。
- 等多久发确认、等多久自动接任、副本间隔,都在 高级 里调。
- 升级、维护前可以先暂停接任(设置页的暂停按钮,或主机上
m-ui ha pause 分钟数)。在面板里点升级、改端口这类会重启的操作,以及m-ui菜单里的升级(暂停 15 分钟)和重启(暂停 5 分钟),都会自动先暂停。 - 没开 Telegram 通知时,确认模式只能到备用的面板上点接任。
- 订阅地址里是 IP 时,接任后用户要重新导入订阅。订阅最好用域名;想接任后订阅地址不变,在下面选 连订阅一起接管。
- 备用的数据副本比它现在的纪元旧(上一任新主机期间的改动不在里面)时不给接任按钮;真要接任用命令行
m-ui ha takeover --force,那些改动会丢。
原主机回来了
原主机恢复后自动变为副机,不会和新主机抢着当主机。
- 新主机的服务器列表里它先标「原主机 · 失联」,暂时不进订阅;回来后变回「副机」,重新收到配置,线路回到订阅。
- 它失联期间如果还收了改动,变为副机前会先留一份备份,页面顶部提示有几条改动没进新主机。
- 备用在原主机其实还在时接任过(比如网络分区),多数副机仍跟着原主机时,它会把主机让回去,自动改过的 DNS 也改回原值,页面顶部写明是「让回」而不是失联。
- 想让它重新当主机,在服务器列表里对它点 设为主机。
备份、还原与换机
纪元只升不降:在主机上还原一份旧备份、或在菜单里「重置全部设置」,都不会让纪元回退,副机照常跟着,页面顶部提示一次纪元已恢复。
- 把主机的备份还原到别的机器并启动,等于把主机换到那台:新机以更高的纪元接管全部副机;旧主机之后若被服务商重启,会自动变为副机并提示「同一份数据已在另一台服务器上当主机」。旧机不要了就在它上面执行
systemctl disable --now m-ui。 - 只想看看备份里有什么,别在联网的机器上启动它。
- 删除一台副机、在副机上 更换令牌,都会清掉它的容灾记录,它可以再被别的主机接入。副机离线时被删,它回来后照样会清。
- 把主机降回 0.7.16 或更早之前,先在每台副机执行
m-ui ha reset,不然旧主机管不了进过纪元的副机。
接任时接管什么:只接管主机的工作,或连订阅一起接管
在 主机容灾 设置的 接任时接管什么 里二选一。默认 只接管主机的工作。
- 只接管主机的工作:推配置给副机、并流量、到期 / 超量停用、Telegram 机器人、外部 API 换到新主机;新主机的订阅设置照旧是它自己的,DNS 不动。用户的订阅地址仍指向原主机:原主机失联期间刷新订阅会失败(已连上的线路照常可用),它回来变成副机后照样提供订阅。订阅证书(含私钥)也不随副本带到备用。
- 连订阅一起接管:新主机还换上原主机的订阅域名、端口、路径和证书,经 DNS 接口把订阅域名改指到新主机,用户的订阅地址不变。要订阅地址用域名,并填好 DNS 服务商 的接口;没满足时保存会直接说缺什么。面板用域名时,面板和代理面板的地址(外部 API 挂在面板上)也一起跟过去:新主机换上原主机面板的域名、端口、路径、证书和受信任的反向代理,面板域名也改指过来,对接外部 API 的商城、机器人和代理们都不用改;API 密钥、权限、白名单本来就在数据副本里。面板用 IP 时跟不过去,就绪检查会提醒给面板配域名。
- 设为主机(计划内换主机)不受这个选项影响:订阅总是一起迁过去,订阅证书随整库数据带过去;配了 DNS 接口、订阅域名在名单里就自动改解析,否则确认框里写着该指向哪个 IP。
- DNS 服务商可选 Cloudflare(API 令牌,见 Cloudflare API 令牌怎么创建)、阿里云云解析(只授权 AliyunDNSFullAccess 的 RAM 用户的 AccessKey)、腾讯云 DNSPod(只授权 QcloudDNSPodFullAccess 的子用户 API 密钥)。凭据单独存、不回显。点 测试 DNS 接口与记录 看哪些记录会被改;凭据不对、域名不在这个账号下时这里直接写出错误。
- 订阅证书:订阅走 https 时,备用随加密副本带着主机的订阅证书;接任时它用不了(没带过来、过期、半个月内到期、不含订阅域名),新主机会用同一个 DNS 接口给订阅域名重签一张(DNS 验证不用等解析指过来),签好自动用于订阅、订阅服务原地重启,以后的续期也走这个接口。就绪检查里能看到订阅证书还剩几天。
- 只改 跟着主机走的域名(订阅域名自动加上)里当前指向原主机 IP 的 A / AAAA 记录,线路、TTL、橙云都不动,别的记录不碰;改不成只告警,不挡换主机。结果分全部改好、只改好一部分、失败三种,页面顶部和 Telegram 写出每条记录的原值 → 新值,没改成的列出来要你手动改。
- 误接任后让回原主机时,本机自动改过、而且现在仍指向本机的记录会改回原值。
- 开过容灾的集群(纪元 ≥ 1)不能在面板上把副机直接改成主机:别的副机只认带纪元的主机,会一律拒收。换主机用 设为主机,主机没了等备用接任;确实要脱离集群,先在每台执行
m-ui ha reset。主机改成副机可以,会顺手清掉本机的容灾状态。 - 开着主机容灾时,副机接任后要用的端口不能给线路和中转入口:它自己的代理面板端口(副机平时不监听,接任后才起),选了 连订阅一起接管 时还有主机的订阅端口(随主机迁过去)。开容灾时已有占着的会被拦下并点名,保存线路、改订阅端口时也会拦;只走 UDP 的线路(hysteria2、tuic)不冲突。各台的面板端口是各自的,接任后不变,不用避开。
- 端口被别的程序占着(m-ui 自己的线路会避开,但管不了别的程序):备用每 10 分钟试一下它接任后要用的端口,被占的在 就绪检查 里列出、Telegram 提醒一次。真到接任时还被占:先退回新主机自己原来的端口(云防火墙一般已经放行),还不行才自动挑一个空闲端口顶上,绝不让新主机起不来;通知和 Telegram 里写清实际地址,并提醒在云防火墙 / 安全组放行新端口。
- 两台同时当主机:备用接任后联系不上别的副机(比如副机的防火墙只放行原主机的 IP),原主机回来时多数副机还跟着它,两台就都当着主机,订阅和改动会分叉。两边的 需要处理 都会红色提示、Telegram 发一次;要原主机继续当主机,在新主机上点 让回主机(或执行
m-ui ha yield),它变为副机、改过的 DNS 改回去;要新主机当主机,放开防火墙让它联系得上其它副机。就绪检查里的「备用和其它副机之间互通」事先就会提醒。 - 设为主机结果不明(提交请求发出后目标没回话)时写操作保持暂停:冻结截止前本机每 10 秒问一次目标,截止后先看副机有没有跟它,没有就以更高的纪元隔离它、恢复写操作 —— 要目标以外的副机确认收到撤销(截止前全部,截止后过半)。连不上的副机已经永久下线、截止后仍凑不够时,在主机上执行
m-ui ha abandon --force强制放弃;截止前不行,没收到撤销的副机手里的交接标记那时还有效。 - 环境变量
M_UI_TEST_CF_API能把 DNS 服务商的接口换成测试地址,只供演练、测试用;设了它,设置页会提示、操作审计里有记录。
命令行
SSH 到服务器上用 m-ui ha(要 root);m-ui 菜单第 15 项也是主机容灾。
m-ui ha status:本机角色、纪元、模式、备用、副本时间、本机公钥指纹;服务停着时也能看个大概。m-ui ha takeover:在备用上接任为主机,证据不够时会被拒绝;加--force不等确认、不看证据直接接任,只在确认主机已经不在时用。在主机上加--force是以高于已知最高的纪元把跟过别的主机的副机收回来,只在两台主机僵持时用。m-ui ha set-master 服务器名或 id:在主机上把一台副机设为主机,做完打印新面板地址;链接是 http 时要加--allow-plain。结果不明时打印原因和最晚截止时间。m-ui ha pause 分钟数/m-ui ha resume:在主机上暂停 / 恢复接任。m-ui ha reset:清掉本机的容灾记录(纪元、跟随的主机、副本),本机可以再被别的主机接入;在主机上要加--force。
线路与协议
线路决定客户端怎么连进来:入口协议 + 端口 → 从哪出去。每条线路在它部署的每台服务器上各出一个节点。
新建线路
新手用 快速添加 最省事:协议参数是配好的,端口也自动挑好。
- 线路 页右上角点 快速添加,选一个预设:Hysteria2、AnyTLS、VLESS + Reality、Trojan、Shadowsocks 2022、VMess + WS。
- 表单已经填好,看一眼 名称(订阅里显示的节点名)和 端口,保存。
- 想自己配就点 新增线路:选 协议、填端口;上游 默认是 direct(本机直出)。
- 新建时默认勾着 分配给全部现有用户(不含代理名下);不勾的话,要到用户里逐个勾上,新线路才会出现在他们的订阅里。
- 端口会自动填一个空闲的五位数端口,可以改;和面板、订阅端口或本机其它程序撞了,保存时会直接报错。
- 保存前整份配置先交给内核试跑,过不了就不生效,也不影响正在用的线路。改线路会让数据面重启一下,在线用户会自动重连。
线路的流量与在线
- 在 线路 页点线路名或 详情:上面四格是所选时段这条线路的流量合计、部署的服务器台数、此刻在线的用户数和 IP 数。
- 流量 图默认是 全部服务器合计,可以切 24 小时 / 7 天 / 30 天;右上角下拉或点下面 各服务器 里的一行,只看那一台,再点一次回到合计。
- 在线用户与 IP 每 5 秒刷新,写明每个人在哪台服务器上、用哪些 IP 连着;人多时能搜,一次显示 40 个,点用户名去用户页。
- 副机的线路流量记在副机自己那里,打开详情时现取;联系不上、停用或版本太旧的服务器在表里标出来,不算进合计。
- 线路流量是服务器上实际走过的字节数,不乘服务器的流量倍率,所以和用户用量加起来不一定相等。
中转入口:让用户经另一台机器连进来
用户直连这台服务器慢、或者连不上(比如大陆连海外机器绕路、IP 被墙)时用:让他们先连一台线路更好的机器 —— 你的另一台服务器,或者买的中转 —— 由它把流量原样转给这台。数据走向是「用户 → 中转 → 出口(这条线路的服务器)→ 网站」。中转只搬数据、不解密,看不到内容。用不上就别开。
- 编辑线路,勾上 中转入口(默认不勾);取消勾选再保存会清掉。
- 每一条是一句话:用户连 哪台中转 的端口 多少 → 转给 哪台出口(括号里是转到的地址和线路端口)。选你的另一台服务器当中转,转发它会自动做;端口自动挑一个那台空着的(先试线路自己的端口)。
- 用自己跑的 realm / iptables 或买的中转:选 别处的中转(填地址),填它的地址和端口(粘贴「地址:端口」会自动拆开);下面一行写着要在中转上把什么流量、哪个端口转到哪里。
- 第二行左边是 订阅节点 的名字(中转那一段可以改),右边是要做的事(在哪台的防火墙放行哪个端口)。端口撞了(那台的面板 / 订阅、部署在那台的线路、别的中转)当场标红,保存不了。
- 两台内网互通时,点括号里的地址改成内网地址;不想用了先勾 暂停。线路列表里线路名后面的「⇄ N」是有几个中转入口,线路详情的顶上逐个列出。
- 中转服务器的防火墙(云厂商安全组)要放行这个端口:hysteria2 / TUIC 是 UDP,shadowsocks 是 TCP 和 UDP,其余是 TCP。
- 出口服务器看到的来源是中转的 IP:同一个人经同一台中转连进来的几台设备,在出口上只算一个 IP,设备数限制管不住走中转的设备;在线 IP 里中转的 IP 会标「⇄ 服务器名」。
- 中转节点不带端口跳跃;流量照常按出口服务器的倍率计。删掉一台服务器时,经它中转、转给它的中转入口一起去掉。
协议怎么选
拿不准就这样配:主力用 Hysteria2,再配一条 TCP 的(AnyTLS 或 VLESS + Reality)当备用。
| 协议 | 走 | 证书 | 特点 / 适合 |
|---|---|---|---|
| Hysteria2 | UDP | 需要(自签也行) | 速度快、抗丢包,首选。运营商限 UDP 时配端口跳跃。 |
| TUIC | UDP | 需要 | 和 Hysteria2 同类(基于 QUIC),作备选。 |
| AnyTLS | TCP | 需要 | 流量特征弱;UDP 不好用时首选的 TCP 方案。 |
| VLESS + Reality | TCP | 不需要 | 不要域名和证书,借大站的 TLS 握手,抗探测强;建议开 Vision。 |
| Trojan | TCP | 需要 | 经典的 TLS 协议,客户端基本都支持。 |
| VMess / VLESS + WS | TCP | 可选 | 能套 CDN(要有域名);直连时不如上面几种。 |
| Shadowsocks | TCP / UDP | 不用 | 不要证书,客户端支持最广。2022 算法更安全,但老内核 Clash 不支持,订阅会自动不发给它们。 |
| SOCKS / HTTP / Mixed | TCP | — | 普通代理,适合内网设备或给别的程序当中转,不建议直接拿来翻墙。 |
TLS:节点证书、Reality、无
TLS 模式 决定节点怎么加密和伪装;Hysteria2、TUIC、AnyTLS 必须用 TLS。
- 节点证书:用本机证书,客户端按域名校验。默认用每台服务器证书页设的默认证书,也可以在 证书 里给这条线路单独选一张。
- Reality:不用证书,伪装成 握手目标(伪装域名) 那个网站的 TLS。点 检测 看能不能用,点 帮我挑 自动测一批常见大站、按延迟列出,点一下就填入。私钥 旁边点 生成密钥对,Short ID 旁边点 生成。
- 无:明文,只用于 CDN 回源或内网。
- 客户端指纹 一般保持默认。
- Reality 的握手目标要支持 TLS 1.3 和 H2,并且从服务器连得上;线路部署在别的服务器时,检测出的延迟只作参考。
- 用自签证书时客户端要允许不安全证书:订阅里会自动带上,一般不用管(设置项是 订阅允许不安全证书)。
传输方式
只有 VLESS、VMess、Trojan 能选 传输方式;拿不准就用默认的 TCP(直连)。
- TCP(直连):最快。
- ws、httpupgrade:可以套 CDN。
- grpc:适合配 Reality。
- VLESS 建议勾 启用 XTLS Vision(仅 TCP + TLS,推荐)。
Hysteria2 的端口跳跃与伪装
运营商对单个 UDP 端口限速时用端口跳跃;不想被人探测出是代理,用伪装站点。
- 端口跳跃范围:比如
20000-30000。服务器把这一段 UDP 端口都转到线路端口,客户端在范围内随机换端口。安全组 / 防火墙要放行这整段 UDP;留空就是不用。 - 伪装站点:别人探测这个端口时看到的是这个网站,而不是一个报错的代理。要写完整网址,新线路默认
https://www.bing.com;留空 = 不伪装。 - 上行带宽 Mbps(0=不限) / 下行带宽 Mbps(0=不限):一般留 0。
- 混淆密码(salamander,留空=不用):一般留空;填了的话订阅会自动带给客户端。
部署到哪些服务器
有多台服务器时,一条线路可以只在其中几台上开。
- 部署到服务器:默认全部勾着 = 全部服务器,以后新加的服务器也会自动开这条线路(全都不勾也按全部算);只勾其中几台,才是只在这几台上开,订阅也只出这些入口。从部署里去掉某台服务器时,用户、代理授权、套餐在这条线路上选了那台的,一并去掉那台;只选了被去掉的服务器的,改回这条线路的全部服务器(保存后弹窗点名),不会悄悄没了这条线路。
- 双栈服务器那一行多一个下拉,可以让这条线路在那台单独用 IPv4 或 IPv6(默认跟服务器页的设置)。
- 一条线路部署在几台服务器上就是几个"入口";给用户、套餐、代理分配线路时,可以只勾其中某台服务器上的入口。
按规则分流
同一条线路里,让指定的网站走别的出口(比如流媒体走解锁机),或者直接拦掉。
- 编辑线路,勾 按规则分流。
- 点 + 添加规则:选 匹配方式(域名后缀、完整域名、域名关键字、IP 段、端口),填匹配内容(多个用逗号或换行隔开),选 出口:direct、某个上游,或者 拦截。
- 想按应用加:在旁边的输入框填应用名(如 抖音、netflix、openai),点 查域名,规则自动加好,出口在规则里选。
- 保存。
- 从上往下,第一条命中的生效;都没命中的走线路自己的 上游。
- 一个 App 常常要好几个域名,要一起加;关键字太短(比如 ai)会误伤别的网站;按域名访问的流量不一定能按 IP 段匹配上,优先用域名规则。
- 取消勾选 按规则分流 再保存,会清掉全部规则。
批量操作、排序与克隆
勾选多条线路后,顶部会出现批量操作条。
- 启用、停用、设上游、部署服务器(有多台服务器时才有)、取消选择。批量改只重载一次数据面。
- 拖动行调整顺序,订阅里的节点按这个顺序排。
- 行末 更多 里有 克隆(会重新挑一个端口)、把线路加为上游(见 线路作上游)和删除。
上游与外部节点
上游决定线路的流量从哪出去;外部节点把别处的节点并进用户的订阅。
添加上游
上游就是"落地机":加好后在线路的 上游 里选它,用户的流量就从那台机器出去。
- 上游 页 → 新增上游。
- 把落地节点的分享链接粘贴到 从分享链接导入,点 解析填表,核对后保存;也可以手动选类型、填参数。
- 点 测试 看延迟;再到 线路 里把线路的上游改成它。
- 支持 VLESS、VMess、Trojan、TUIC、Hysteria2、Shadowsocks、SOCKS 落地。
- 还有线路在用的上游删不掉,先把那些线路的上游改掉。
WARP
Cloudflare WARP 给线路一个干净的出口,常用来解锁流媒体,或者让纯 IPv6 的机器访问 IPv4 网站。
- 运维 页的 Cloudflare WARP 卡片里,依次点 安装、启用。
- 点 检测出口,确认出口 IP 正常。
- 上游 一栏还没有 warp 的话,点 添加为上游 warp。
- 在线路的上游里选 warp。
- WARP 的本地端口(SOCKS5 端口)默认 40000,被占用会启用失败;改了端口要重新启用。
- 一键安装只支持 Ubuntu / Debian;其它系统要自己装 cloudflare-warp(代理模式),让它的 SOCKS5 监听同一个端口。运维任务只在 Linux 上、m-ui 以 root 运行时能用。
- 安装时本机 DNS 解析不了软件源(有的云厂商自带的 DNS 偶尔会这样),任务会临时改用公共 DNS(1.1.1.1 / 8.8.8.8,只有 IPv6 的机器用 2606:4700:4700::1111 / 2001:4860:4860::8888;不是 systemd-resolved 的系统改为临时写 /etc/hosts),装完自动恢复,输出里会写明;一个域名都解析不了就停下并说明是哪个域名。本机 DNS 正常、只是某个第三方源已废弃(域名已不存在)时只提示一句,照常安装,不改 DNS。apt 被系统自动更新占着时会等最多 5 分钟,并写明是哪个进程。安装到一半取消时,正在解包/配置的软件包会先装完,不会弄坏软件包数据库。
- 有多台服务器时,warp 上游指向的是每台服务器自己的
127.0.0.1:端口:用 warp 的线路部署在哪几台,就要在哪几台的 运维 页都安装并启用 WARP(端口和主机一样);做不到就把这条线路只部署到装了 WARP 的服务器。
线路作上游(链式代理)
让入口线路的流量再转到你自己的另一条线路出去,比如国内中转机进、海外机出。
- 上游 页点 把线路加为上游(或在线路行末的 更多 里点),选线路和 用它在哪台服务器上的入口。
- 参数跟着线路自动走,线路改端口、换协议都不用管;用的是专用凭据,不占用户配额,流量只算一次。
- 成环、线路被删、入口服务器被删都会被拦下或标出来。副机要 v0.7.16 及以上。
上游组(自动切换)
几条上游组成一组,自动用最快且能通的那条,挂了自动换。
- 上游 页 → 新增上游组,成员 至少选两条;线路的上游选这个组。
- 每 30 秒测一次;现在用的这条只要不比最快的慢 300 毫秒以上就不换,免得来回切。切换时断开旧连接,让应用马上重连。
- 上游页会写明每台服务器现在走的是哪一条。
- 副机要 v0.7.16 及以上:只要建了上游组(哪怕还没有线路在用),版本更低的副机就会整份拒收同步。
巡检与告警
面板定时测试上游,出故障和恢复时可以发 Telegram。
- 每台服务器只测自己线路用到的上游;没有线路用的标 未使用,不测也不告警。
- 状态列可能显示 故障、待测、数据过期;点行末箭头看每台服务器的检查详情和报错。
- 设置 → 上游巡检:巡检间隔(分钟)(0 = 关闭)、连续失败几次判定故障。
- 概览页的 上游巡检 卡片可以点 立即巡检。
外部节点
把别处的节点(机场订阅、单条分享链接)并进你的用户订阅,排在本站节点后面。
- 外部节点 页 → 新增外部节点:类型选 外部订阅(一个订阅地址,定时抓取)或 分享链接(单条节点)。
- 填 链接 / 订阅地址;可以加 节点名前缀(如 "[中转] ")方便用户区分。保存。
- 到 用户 里编辑要给的人,勾上 外部节点。
- 主机定时抓取,间隔在 设置 → 订阅 → 外部订阅刷新间隔(分钟);抓取失败时保留上次成功的内容,列表里写明错误。
- 支持 base64 / 明文链接列表、Clash YAML、sing-box JSON。
隐藏、改名、排除关键词
机场塞的"剩余流量""官网"之类信息节点,和不想给用户的节点,都可以不输出。
- 点 展开节点 看解析出的全部节点;勾选后点 隐藏选中 / 显示选中;单个节点可以 改名。
- 隐藏和改名按名字 + 节点指纹(地址、端口、密码等)一起记,机场改名、调顺序后照样认得。
- 排除关键词:名字含这些词的节点不输出,逗号分隔,如
官网,到期,剩余流量,套餐;以后新出现的也管用。名字每次刷新都会变的信息节点,用它最合适。 - 节点暂时消失时,隐藏 / 改名记录会保留,回来照样生效;确定不要了点 清理。
- 有副机时:隐藏和改名要求副机 v0.7.17 及以上,排除关键词要求 v0.7.16 及以上,版本更低的副机会整份拒收同步。
测速、测大陆连通、作上游
展开节点后可以直接测它们能不能用,也能把好用的节点变成上游。
- 测速全部 / 测速选中:从每台启用的服务器真连一次测延迟,代表它作为上游时好不好用;勾 含已隐藏 连隐藏的一起测;随时可以 停止测速。显示 不支持 的是协议转不成本站出站、没法测。
- 测大陆连通:从大陆三网测点连选中的节点,看有没有被墙;hysteria2、tuic 这类 UDP 协议只能 ping 地址;国内中转入口香港不通属正常。
- 添加为上游:勾选节点、各起一个名字,直接变成上游(重名会报错,不会自动改名)。
证书
证书让线路、面板、订阅走 TLS / HTTPS。一台服务器可以放多张,签发后会自动续期。
添加证书
证书 页 → 添加证书,按有没有域名选 证书来源。
- 有域名(自动签发):先到域名服务商把 A 记录解析到服务器 IP。填域名,选 验证方式:
- HTTP(临时监听 80 端口):80 端口要空闲、公网能访问。
- DNS(Cloudflare API):域名在 Cloudflare 上时用,填 Cloudflare API Token(要有这个域名的 DNS 编辑权限,怎么创建见 Cloudflare API 令牌怎么创建),不用开 80 端口,能自动续期。
- DNS(手动加 TXT 记录):其它 DNS 服务商用,按页面提示加 TXT 记录,公共 DNS 查到后自动继续。
*.example.com)只能用 DNS 验证。 - 无域名(自签):点 生成自签证书;证书包含的地址(留空自动) 留空就用本机公网 IP。订阅里每个节点会自动带"允许不安全",客户端不用设置;面板和订阅建议保持 HTTP。
- 已有证书:服务器上已经有 certbot、宝塔、nginx 或商业证书时,填 证书文件(fullchain) 和 私钥文件 的路径,点 使用该证书。
http:// 变成 https://,旧地址立即失效,客户端要重新导入(添加前、在 正在使用 里换订阅证书时、在设置页「订阅」里直接填上或清空证书路径时都会再提示一次);勾了 用于面板 HTTPS,重启后面板也换成 https://。Cloudflare API 令牌怎么创建
用 DNS(Cloudflare API) 签证书,要一个 Cloudflare API 令牌。只让它管你这个域名的 DNS,泄露了也动不了别的。
- 打开 Cloudflare 的令牌创建页(已预填权限),登录你的 Cloudflare 账号。权限已经填好:「区域 → 区域 → 读取」和「区域 → DNS → 编辑」,令牌名叫 m-ui。
- 「区域资源」改成「包括 → 特定区域 → 你的域名」,不要留「所有区域」。
- 点「继续以显示摘要」,再点「创建令牌」。
- 复制页面上显示的令牌,粘贴到 m-ui 证书页的 Cloudflare API Token。令牌只显示这一次,离开页面就看不到了,丢了只能重新创建。
- 权限最小化:只要上面两项权限,区域只选要用的域名。不要用「Global API Key」(全局 API 密钥),也不要给账户级的权限。
- 令牌泄露了:到同一页把它删掉或轮转,再把新令牌填回 m-ui。
- 主机容灾接管订阅用的 DNS 接口单独填一个令牌(见 接任时接管什么),照同样的步骤再建一个就行。
证书用在哪
线路默认、面板、订阅 各用各的证书,在 正在使用 卡片里换。代理面板 默认和面板共用一张;要单独用,到 设置 → 代理面板 填 证书文件 和 私钥文件 的路径(保存即生效)。
- 点每一项旁边的 更换,从证书库里挑一张,或者选 不用 HTTPS。
- 订阅的改动立即生效(用户要换成新的 https 地址);面板的证书改了几秒后自动换上,浏览器跟着跳到新地址(副机上还是要 重启 m-ui 才生效);换线路默认证书会让数据面重启一次。
- 某条线路要单独用一张:编辑线路 → 证书;没有这张证书的服务器继续用它自己的默认证书。
自动续期
签发的证书到期前自动续,续好后自动换上,不用重启。
- 启动几分钟后先查一次,之后每小时查一次;进入有效期最后三分之一时开始续(90 天的证书剩 30 天时)。
- 失败按 1、2、4 小时退避重试;第一次失败马上通知,之后每天提醒。
- 证书库 的 自动续期 一列能看到每张证书的状态:上次续期时间、失败次数、下次重试时间。可以点 续期 立刻续,也能关掉某张的自动续期。
- 证书出问题(续期失败、快到期、已过期、文件读不出来)时,页面顶部会出现"证书要处理"的提醒,点 查看 去处理;副机的证书也会在主机上提醒。
- 用 DNS(手动加 TXT 记录) 签的证书不能自动续期,每次都要重新加 TXT;想自动续,就改用 Cloudflare 验证重新签发。
- HTTP 验证每次续期都要临时占用 80 端口,有 TCP 线路占着 80 会续期失败。
- 域名多出一条不指向本机的 AAAA(IPv6)记录会让验证失败:改成本机的地址,或者删掉它。
- Let's Encrypt 已经不发到期提醒邮件了:至少在主机上配好 Telegram 或 Webhook(见 通知)。
- 已有证书 由签发它的工具(如 certbot)续期,面板只读文件,剩 14 天起提醒。换机还原时放进
/etc/m-ui/cert/restored/的是备份那一刻的副本,没有工具再续它:证书库里标 还原的副本,没人续期,剩 30 天起每天提醒,要自己重新签发或重新添加(见 还原)。
副机的证书
每台服务器各管各的证书,在各自面板的 证书 页签发、续期。
- 证书按名字跨服务器匹配:线路选了某张证书,没有这张的服务器用它自己的默认证书;线路的证书选择框里能看到哪台有、还剩几天。
- 副机一般不配通知:它的续期失败、快到期由主机代发提醒,主机的服务器页也会标出 证书续期失败。
- 在副机上签正式证书时 用于面板 HTTPS 默认勾着;勾了的话,副机重启后主机要改用
https://的 API 地址(见 接入一台副机),不打算改就取消这一项。
用户与套餐
一个用户就是一个订阅地址,带流量、到期、设备数和限速;套餐是这些额度的模板。
新建用户
用户 页 → 新增用户,填好额度、勾上线路,保存后就有订阅地址了。
- 用户名(即订阅地址):主面板默认用用户名当订阅地址,不能含空格和 / ? # &,全站不能重名。知道用户名就能拿到他的订阅,别用 test、user1、姓名拼音这类好猜的名字;更稳妥的是在 设置 → 订阅 关掉 用用户名作订阅地址,之后新建的用户地址是一串随机令牌(用户名只是个名称),已有的用户点 重置订阅链接 换成随机地址。
- 用户名:只是个名称,不出现在订阅地址里(订阅地址自动生成一串随机令牌)。但不能含空格和 / ? # &,而且全站唯一:别的代理或主面板用过的名字也不能再用,建议统一加上自己的前缀。
- 有套餐就选 所属套餐,点 按套餐填写 一键填好额度。没有就手填:流量配额 GB(0=不限)、到期日(留空=不限)、同时在线设备(0=不限)、上行限速 Mbps(0=不限)、下行限速 Mbps(0=不限)。
- 按月清零的(月付),勾 周期重置流量,填 重置周期(天)。
- 勾 可用线路。一条线路在几台服务器上就有几个入口,可以只给其中某台(按服务器切换分组勾选,已勾的不会丢)。
- 外部节点:勾上的外部节点会追加到他订阅里本站节点的后面。
- 备注:记订单号、联系方式之类。注意:你和主面板都没填 订阅标题(Profile-Title) 和 页面标题 时,客户端里显示的订阅名就是备注(备注也空就用用户名),不想让用户看到的内容别写进备注。
流量、到期、设备数怎么算
超量或到期会自动停用并踢下线;续费、重置流量后自动恢复。
- 流量:上传 + 下载合计;配额可以写小数(0.1 约等于 100 MB)。经过设了流量倍率的服务器时按倍率计。
- 到期:到点自动停用。填了"首次连接后 N 天到期"就不看到期日。
- 周期重置:每过 N 天把已用流量清零,因超量被停用的也会自动解禁。
- 设备数:按同时在线的来源 IP 算,所有服务器合在一起算。同一个 WiFi(同一个公网 IPv4,或同一个 IPv6 /64 网段)下的几台设备算 1 台;IPv4 和 IPv6 各自对上限计数,同一台设备同时走 IPv4 和 IPv6 不会被当成两台。
- 设备满了只拒绝新设备,已经连着的不受影响;别的设备下线约 1 分钟后名额就空出来了。
- 被拒的连接会在概览的 最近入站连接 里整行标红、带 被拒 徽章,鼠标停在徽章上看原因(设备数超限被拒);最近 10 分钟有被拒的,需要处理 里也会提一句。
- 限速:同一台服务器上,这个用户的全部连接共享这份带宽;他同时走几台服务器就有几份。改了马上生效。
订阅地址、二维码与临时共享
点用户名(或 详情)打开详情,订阅地址和二维码就在最上面。
- 订阅 下面有两个地址:带
?format=clash的是 Clash 专用;不带?format=的是通用地址,发给用户的就是它(浏览器打开是落地页,客户端来拉时按类型给格式)。点旁边的 复制。 - 详情里的二维码是 Clash 地址,适合用 Clash 系客户端直接扫;用手机相机扫只会下载到一个配置文件,这种情况让用户打开落地页,在那里扫码或一键导入。
- 列表里的 更多 菜单也能直接复制 Clash 订阅、链接订阅(就是通用地址)、sing-box 订阅。
- 用户用浏览器打开自己的订阅地址,会看到落地页:用量、到期、各客户端的一键导入、二维码(见 订阅与落地页)。
- 临时共享:用户在落地页生成给朋友用的临时地址,流量和设备都算他自己的。详情里能看到这个地址,点 收回 立即作废。
- 地址泄露了:更多 → 重置订阅链接。地址换成新的随机令牌,全部协议凭据重新生成,旧地址立刻失效、在线设备被断开,再把新地址发给用户。
- 详情里还能看到 在线设备(IP)(每个 IP 正在用哪条线路)、流量图和可用线路。
续费、延期与换套餐
列表的 更多 菜单(或用户详情)里,续费… 和 换套餐… 管续费、升级、降级。
- 续费…:先 选择套餐(默认是他现在的套餐),再选方式:续费(清零流量并顺延)、延期(保留已用流量),或 只归入这个套餐(流量与到期都不动)。期数 是一次续几期(1–120),月付套餐按季、按年卖就填 3、12;单个用户时,下面会实时显示到期和配额会变成多少。用套餐续费、延期是明确的开通动作,会把 手动 停用的人也一并启用(对话框里会先提示;选 只归入这个套餐(流量与到期都不动) 不改启停)。
- 延长 30 天:有到期日的用户一键加 30 天(还没开始计时的"首次连接后 N 天"加到 N 上);因到期停用的会恢复,手动停用的仍停着。
- 换套餐…:换成 选新套餐,方式 三选一:
- 立即替换:新套餐从现在开始算 N 期,旧订阅剩下的时间和流量作废。
- 叠加:保留旧订阅剩下的时间(和一次性流量),再加 N 期;按周期重置的套餐,流量是每期额度,不叠加。已经过期的旧订阅不结转;新套餐不限期或不限量时,原来有限的到期或配额照旧保留。
- 按价值折算:按两个套餐的 参考价(可选),把旧订阅剩下的价值折成新套餐的时长(一次性流量的套餐同时折流量),新套餐从现在开始;用户要有所属套餐、换成另一个套餐,两个都要填参考价,期数可以填 0。
- 本周期用量:自动(立即替换和折算清零,叠加保留)、保留(接着算)、清零(从新周期开始)。
- 对话框下方实时预览 变更前 和 变更后,标出 升级 还是 降级。到期提前、马上超量这类会让用户吃亏的影响标红,要勾 我已确认上面标红的影响,仍然执行 才能 确认换套餐。
- 只选一个用户时,续费… 和 换套餐… 的对话框每次打开都带一个防重复的编号:双击、网络重试都只会执行一次。勾了多个用户再批量 套用套餐 时没有这层保护:中途报错,已经续上的人不会撤回;重试前先看列表里的到期日(或者详情里的 套餐记录),把已经续上的人去掉再选。
- 详情里的 套餐记录 能看到最近的续费和换套餐。
套餐
套餐是额度的模板,建号、续费、批量操作都能直接套用。
- 套餐 页 → 新增套餐:填 名称(如 100G/月)、说明、流量(GB)、时长(天)、设备数和上下行限速。
- 按月清零的勾 周期重置流量;发卡、礼品卡勾 从首次连接开始计时。
- 线路:套用时把用户的线路换成这些;留空 = 套用时不改动用户已有的线路。
- 限速规则:勾上的规则对这个套餐的用户(现有的和以后套用的)都生效。
- 参考价(可选):只在换套餐用"按价值折算"时用,不给用户看;两个套餐填同样的价就是同价互换。
- 套餐页显示每个套餐有多少用户。
- 改套餐不会自动改已经套用过的用户;要让他们按新额度走,就给他们续费或换套餐。
- 代理只看得到、也只能用自己建的套餐。
批量操作
勾选多个用户后,顶部出现批量操作条(表头的全选只勾当前这一页)。
- 启用、停用、延期、套用套餐、重置流量、删除。
- 批量生成:按 用户名前缀 一次建 数量 个,命名方式 选 前缀 + 随机 8 位 或 前缀 + 序号(001…,订阅地址用随机串);生成后列出每个人的订阅地址,可以整段复制。这里给的是 Clash 地址(带
?format=clash),发给不用 Clash 的用户时,去掉末尾的?format=clash就是通用地址。 - 导出 CSV:导出用户列表,订阅那一列也是 Clash 地址。
停用原因与踢线
列表的状态一列写明为什么停用,也就决定了怎么恢复。
- 超量、到期:续费、重置流量或延长到期后自动恢复。
- 手动:手动停用的不会因为重置流量、延长到期或周期重置而自动恢复。但用套餐续费或延期(续费…、批量 套用套餐)和 换套餐… 是明确的开通动作,会把他一并启用:续费、批量套用套餐和换套餐的对话框里会先提示里面有手动停用的人、做完会被启用,批量时列出是谁,不想启用的先取消勾选。外部 API 的续费、换套餐也一样会启用。
- 限速中:正被规则临时限速(见 规则)。
- 踢下线:断开这个用户在所有服务器上的连接(hysteria2、TUIC、AnyTLS 整条会话一起关)。没停用的话客户端会马上重连,想彻底断就先停用。
- 列表上方可以按 全部、在线、启用、停用、已过期、超量 筛选,也可以只看某个套餐。在当前页全选后(手机上勾任意一个后),批量条上可以一键选中全部筛选结果,一起操作;这一下会换掉之前勾的人,只留当前的筛选结果。换筛选、换搜索之前勾的人会一直留着,批量操作时其中有当前列表里看不到的,会先问一句再处理。
从旧面板导入用户
线路已经在 m-ui 上建好、只想把老用户搬过来时用。
- 用户 页点 从旧面板导入,上传旧面板的 .db 文件,点 开始导入。
- 同名用户会被旧库的值覆盖用量、配额、到期、启停、周期重置,以及旧库里不空的备注和说明;其余的新建,沿用旧面板的用户凭据。可以勾 给新建的用户分配全部现有线路。
- 只导入用户时,线路、入站端口、订阅端口和路径都还是 m-ui 自己的:用户要用 m-ui 的新订阅地址重新导入,停掉旧面板之前先把新地址发给大家。
- 连线路、上游、设置一起搬,见 从旧面板迁移。
规则(临时限速)
规则给用户加临时限速:比如晚高峰全员限到 30 Mbps,或者 10 分钟内跑了 1 GB 的人限速 20 分钟。
两种规则
- 时段限速:每周指定几天的某个时间段内限速,走出时段自动恢复。按面板时区算,结束早于开始表示跨午夜;星期 全不勾等于每天。
- 突发限速:最近 统计窗口(分钟) 内上下行合计达到 触发流量(GB,上下行合计),就限速 限速时长(分钟);到时自动解除,再次达到再次限速。
新建规则
- 规则 页 → 新增规则:起个名字,选 类型,填条件。
- 填 上行 Mbps / 下行 Mbps,0 = 这个方向不改。
- 不超过用户自己的限速:开着(默认)时结果不会高于用户自己的限速,只会更严;关掉就直接用规则的值,可以用来在某个时段放宽。
- 目标 可以叠加:全部用户(含以后新建的)、某个套餐的用户、某个代理名下的全部用户、逐个勾选。
- 保存。
生效与查看
- 多条规则同时命中同一个用户时,取最严的一条。
- 规则列表的 生效中 一列点 查看,看现在谁被限速、还剩多久;用户列表也会标 限速中。
- 改动对在线连接立即生效,不用等重连;规则由主机每 10 秒判定一次,自动同步到副机。停用规则后,它造成的限速马上解除。
- 规则限速不显示在用户的落地页上。突发限速触发时想收到通知:设置 → 通知 → 突发限速触发时通知。
代理(分销)面板
代理是帮你卖号的人:你给他线路和额度,他在自己的代理面板里建用户;他只看得到自己名下的用户和自己建的套餐。
代理面板只管你名下的用户:站长给你线路和额度,你在这里建号、续费、看用量。
开通一个代理
- 代理 页 → 新增代理:名称 就是代理的登录名。
- 勾 可用线路:代理只能把这些线路分给他的用户;可以只授权某台服务器上的入口。
- 填额度:流量额度 GB、用户数上限、设备池、带宽池 · 上行 Mbps / 带宽池 · 下行 Mbps、到期日(留空=不限);0 = 不限。
- 保存后把代理面板地址发给他:代理列表下方写着,新建成功的提示里也有(默认端口 2054、路径
/dl/)。
- 新代理没有密码:24 小时内他用名称登录、密码留空直接点登录,进去后先设密码。过期没认领、或者忘了密码:更多 → 重置密码(会一并清掉他的两步验证和外部 API 令牌,再开 24 小时)。
- 取消勾选某条线路,他名下的用户马上就不能用这条线路了。
- 重置流量:把他名下所有用户的已用流量清零。
- 代理的用户不出现在主面板的用户页里;要看就点这个代理的 详情。
- 代理面板的端口、路径、证书在 设置 → 代理面板 里改,用不上可以关掉 启用代理面板;记得在防火墙放行 2054/tcp。
额度怎么算
- 流量额度:按名下所有用户的全部用量算,代理自己重置流量、续费、删号都抵不掉;只有主面板的"重置流量"能清零。
- 设备池:名下所有用户同时在线的设备总数上限(所有服务器合计)。池满只拒绝新设备,已连着的不受影响。
- 带宽池:名下所有用户合计的速率上限,每台服务器各一份。
- 给单个用户填多少都行,但总量受这几个池限制。
- 到期、被停用、流量超额,任何一条踩线,名下全部用户立刻停用、订阅打不开。
第一次登录与设密码
- 打开站长给的代理面板地址(默认
http(s)://服务器地址:2054/dl/)。 - 用户名填代理名;第一次登录密码留空,直接点 登录。
- 按提示 设置登录密码(至少 8 位),以后用新密码登录。
代理面板里能做什么
- 概览:已用额度、账号到期、用户数、在线用户和设备;额度、到期、设备池快到头时 需要处理 会提醒;即将到期 和 流量快用完 列出该续费的用户。
- 用户:新增、编辑、续费、延期、重置流量、踢线、重置订阅链接、批量操作、看用量曲线和在线设备。建号只填名称,订阅地址是随机令牌。
- 套餐:只看得到、也只能用自己建的套餐。
- 账号:额度、密码、两步验证、自己的订阅页文案、外部 API。
- 只能分配站长授权的线路(授权可能只到某台服务器)。
账号页
代理面板的 账号 页管登录安全、额度,以及你的用户看到的订阅页。
订阅与落地页
订阅地址给客户端导入;同一个地址用浏览器打开,就是用户自己的落地页。
订阅地址与格式
- 形如
http(s)://域名或IP:2056/sub/用户名(或一串随机令牌)。 - 一个地址就够:客户端来拉时按它的类型给格式。Clash 系(Clash Verge、mihomo、Stash)拿 Clash 配置,sing-box 系(SFA、SFI 等)拿 sing-box 配置,NekoBox、v2rayN、Shadowrocket 等拿通用链接。
- 想指定格式就在地址后面加:
?format=clash(Clash)、?format=json(sing-box)、?format=mihomo(强制按新内核 Clash 给)。 - 每条线路在每台服务器上各出一个节点,节点名后缀是服务器名;流量倍率不是 1 的服务器会带
x2之类的标记。 - 节点地址默认用服务器 IP(域名只作 SNI),免得客户端 DNS 被污染连不上。
- 用户被停用、到期、用完时,客户端拉订阅会拿到 404,线路也不再放行。
用户怎么导入
- 最简单:把通用订阅地址(不带
?format=的那个)发给用户,让他用手机或电脑浏览器打开,在落地页点自己客户端的一键导入,或者扫二维码。 - 落地页一键导入按钮右上角的下载箭头,会打开各系统客户端的下载页(iOS、Android、Windows、macOS、Linux)。这一页的地址里带着本人的订阅地址(页内「← 返回订阅页」也是),不要转发;想让别人装客户端,转发各客户端的官网或发布页。
- 也可以复制地址,粘贴到客户端的"添加订阅"里。
- 客户端里显示的订阅名依次取你填的 订阅标题(Profile-Title)、页面标题、主面板的订阅标题和页面标题、用户的 备注、用户名,用第一个不空的。不想让客户看到站长的名字,就自己填一个订阅标题。Shadowrocket、Clash Verge 只在添加订阅那一刻定名字,改了标题要让用户删掉重加,或者用落地页的一键导入(会把标题一起带上)。
订阅设置
在 设置 → 订阅 和 订阅格式与模板 两组里。
- 订阅标题(Profile-Title)、更新周期(小时)。
- 用用户名作订阅地址:默认开;关掉后新建用户的地址是随机令牌,已有用户不变。
- 订阅允许不安全证书:默认自动(用自签证书时打开)。
- 订阅里的节点地址:IP(推荐) 或 域名。
- 链接订阅 base64 编码、顶部显示流量提示节点、外部订阅刷新间隔(分钟)。
- 按客户端自动给格式:默认开;关掉后不带
?format=的地址一律给通用链接。 - 自定义模板:Clash 模板(YAML,留空用内置) / sing-box 模板(JSON,留空用内置),可以先点 填入内置 Clash 模板 再照着改;节点和分组由面板填进去,写错了保存时会报错。
落地页
用户在浏览器里打开订阅地址看到的页面:用量、到期、一键导入、二维码,还有你的公告和联系方式。
- 在 设置 → 订阅页 里改;代理在自己的 账号 → 订阅页 里改(留空跟主面板)。
- 在 账号 → 订阅页 里改,留空就用主面板的。
- 浏览器打开订阅地址时显示订阅页:关掉后浏览器也只拿到订阅内容。
- 页面标题、页脚联系方式、公告(支持换行)。
- 选购 / 续费链接:填了以后落地页出现"选购 / 续费"按钮(用户到期、用完、被停用时它是主按钮)。
- 落地页底部显示 Powered by m-ui:代理的落地页不显示。
- 落地页 logo:点 上传 / 更换,上传即生效,不用点保存。支持 PNG、JPEG、GIF、WebP、SVG,会先缩到 480×160 以内并转成 PNG(不超过 64 KB);落地页上显示高 28 像素、最宽 160,也用作浏览器标签图标。落地页跟随访客的深色模式,深色时 logo 下面垫一块浅色底,设置里的预览并排显示两种效果;透明底的白色 logo 两种都看不清。恢复默认 换回内置 logo。代理没设时用主面板的,副机随主机同步。
- 用户用完、到期、被停用时,浏览器里仍能打开自己的落地页,顶部写明原因和找谁续费;客户端拉取则是 404。地址对不上任何用户时,浏览器显示"订阅地址无效"。
公告和联系方式里写链接
公告(支持换行) 和 页脚联系方式 里可以写可点的链接,页面上只显示文字。
| 这样写 | 页面上显示 |
|---|---|
客服小王(https://t.me/xiaowang) | "客服小王"可以点 |
[Clash/Mihomo 教程](https://example.com/a) | "Clash/Mihomo 教程"可以点 |
官网 https://example.com | 地址本身变成链接 |
Tg: @username | @username,点了打开 Telegram |
WhatsApp: +34 600 000 000 | 号码,点了打开 WhatsApp |
- 文字里带
/、冒号,或者链接里有括号时,用[文字](链接)的写法。方括号、圆括号半角全角都行,中文输入法打出来的【文字】(链接)也认。 文字(链接)的括号前可以空一格;链接文字从括号往前取,到最近的标点或上一个链接为止。- Telegram 的关键词认 Tg、Telegram、电报、飞机,后面跟
@用户名或+号码;WhatsApp 认 WhatsApp、WA、WS,后面跟+号码;冒号中英文都行。 - 只认 http(s)、tg、mailto、tel 链接,别的原样显示、不能点。
- 公告最多 4000 字,联系方式最多 300 字,输入框下面显示当前字数。
备份与迁移
一个 zip 就是整个面板:数据库(线路、用户、流量、设置)加证书,设置和证书库里引用的数据目录外的证书文件(比如 certbot 签的)也在里面。备份好它,换机、重装都能把数据原样恢复。
备份
- 备份 页 → 立即备份:下载 到本地,或者 保存到服务器(在 服务器上的备份 列表里)。
- 定时备份:每天几点(-1 关闭)(按面板时区,见 设置 → 面板 → 时区)、保留份数;可以勾 同时推送到 Telegram(先配好 Telegram 通知)。
- 命令行:
m-ui backup -db /etc/m-ui/m-ui.db -out 备份.zip,或者m-ui菜单 9。
还原
- 备份 页 → 还原:选备份文件(zip 或 .db),点 还原。
- 确认后 m-ui 自动重启,替换数据库和证书。设置和证书库里引用的数据目录外的证书文件(比如 已有证书、从旧面板导入的证书路径)不往原路径写:这台机器原路径上的证书能接着用(现在有效、包含备份里那张的全部域名、和私钥配得上,而且不比备份里的旧或者还剩两周以上)就接着用它;不能用才把备份里那份放进
/etc/m-ui/cert/restored/,并把设置和证书库改指过去。还原结果在页面顶部提示一次。面板、订阅和代理面板的证书文件万一还是缺了,先用临时自签证书启动(仍走 HTTPS)并告警,不会起不来。 - 原来的库保留为
.bak-*文件,只留最近两份:连着还原几次,最早那份会被删掉。拿不准该用哪份备份时,先点 立即备份 把当前的库下载下来再试。
- 新机器可以在安装时一步装好并还原(命令见下面的 换服务器)。
- 服务停着时也能用命令行还原:
m-ui restore -db /etc/m-ui/m-ui.db -from 备份.zip。
- 放进
/etc/m-ui/cert/restored/的是备份那一刻的副本:原来由 certbot、宝塔等工具续期的,以后没人再续它,证书库里标 还原的副本,没人续期。还原后就到证书页重新签发,或者在这台装好 certbot 后重新用 已有证书 添加,再换过去,别等剩 30 天的到期提醒。 - 把主机的备份还原到另一台机器并启动,这台就成了主机:它以更高的纪元接管全部副机,原主机之后再起来会自动变为副机(没开过主机容灾也一样,见 备份、还原与换机)。只想看看备份里有什么,别在联网的机器上还原并启动它。
- 顶着临时自签证书期间,客户端更新订阅会报证书错误,浏览器打开面板、代理面板也会提示不安全:照页面顶部的证书提醒把证书补上,或者换一张。
换服务器
备份 页的 换机向导 用备份分四步把整个面板搬到新服务器。订阅用的是域名时,端口、凭据、订阅地址都不变,把域名解析改到新机,用户就跟过来了。
systemctl disable --now m-ui(见 备份、还原与换机)。- 把备份 zip 传到新机,执行
bash <(curl -fsSL https://raw.githubusercontent.com/Maoyangui/m-ui/main/deploy/install.sh) --restore /root/m-ui-20261111-030000.zip(换成你的文件路径;amd64、arm64 都是这一条,脚本先装最新版再还原,证书一起还原)。向导里也有这条命令。 - 用新机 IP 打开面板(端口和路径同旧机),确认线路在运行;有副机的话,新主机会自动重新连上它们。
- 到 DNS 服务商把域名解析改到新机 IP,用向导里的 检查解析 看主流解析器是否都已生效。
- 新机上用户都正常后,在旧机上执行
systemctl disable --now m-ui(停掉并取消开机自启),或者用m-ui菜单 14 卸载。只systemctl stop不够:旧机和新机是同一份数据、同一套副机令牌和 Telegram 机器人,旧 VPS 一重启(比如服务商维护)它就会自己起来,拿过期的数据继续服务、给副机推送、发通知。
- 订阅地址里是 IP(没给订阅配域名)时,换机后订阅地址和主机上的节点地址都会变成新机的 IP,第 3 步也用不上。最好先给订阅配一个域名、把新地址发给用户一次再换机;只能换机后再把新地址发给所有用户的,旧机要一直开到大部分人换好,这期间照下面两条做。
- 有副机、旧机又要多开一阵的,还原之前先到每台副机 设置 → 配对信息 点 更换令牌,新机还原好后把各台的新令牌填进新主机 服务器 页对应的那一行(编辑 → 配对令牌),旧主机拿着旧令牌就推不动副机了。不换的话,两台同时运行期间旧主机上一有自动发生的改动(用户到期或超量被自动停用、周期重置),它就把过期的配置推给副机,新主机上新建、续费的用户在副机上就连不上了。
- 旧机要多开一阵的,在旧机 设置 → 通知 取消 启用 Telegram 通知:两台是同一个机器人,一起跑会互相顶掉,发给机器人的命令可能落到旧机上、改的是旧数据,通知也会收到两份。
- 新机的安全组和防火墙要放行和旧机一样的端口:面板、订阅、代理面板、每条线路(Hysteria2、TUIC 和端口跳跃的范围要放 UDP)。
- WARP 是装在系统里的,不在备份里:线路上游用了 warp 的,先在新机 运维 页安装并启用 WARP(端口和旧机一样)。
- 原来用 已有证书 接 certbot、宝塔等工具的,新机上没有这些工具,还原出来的是一份不会再续期的副本(见 还原):换机后就在新机证书页重新签发,或者在新机装好 certbot 后重新添加。
- 副机的面板端口只对旧主机 IP 放行的,先把新主机的 IP 加进去,不然新主机连不上副机。
- 两台同时运行期间,旧面板上除了关掉 Telegram 通知,别的都不要改;同时运行的时间越短越好。
从旧面板迁移
- 整机迁移(线路、上游、用户、设置都带过来):在新服务器上安装时加参数,
bash <(curl -fsSL https://raw.githubusercontent.com/Maoyangui/m-ui/main/deploy/install.sh) --import /path/to/旧面板.db。入站端口、用户凭据、面板路径和订阅路径都保留;下面几项要自己对上,客户端才不用改:- 证书:面板和订阅都沿用旧面板的面板证书路径,证书文件不会跟着数据库过来。旧面板开了 HTTPS 的,先把证书和私钥拷到新机同样的路径再装;拷来的文件在新机上没人续期,域名解析到新机后到 证书 页重新签发一张换上。
- 旧面板的订阅单独配了证书的(订阅域名和面板域名不同时通常如此),导入后订阅用的是面板那张,客户端更新时会报证书不匹配:把订阅那张也拷过来,装好后到 证书 页 添加证书 → 已有证书,在 添加后用于 里只勾 用于订阅 HTTPS。旧面板的订阅是 http、面板却是 https 的,导入后订阅也成了 https:在 正在使用 里点 订阅 旁边的 更换,选 不用 HTTPS。
- 订阅端口会改成 2056:旧面板的订阅不在 2056 端口的,装好后用
m-ui菜单 6 改回原来的。 - 单独的订阅域名不会带过来:用
m-ui set -db /etc/m-ui/m-ui.db subDomain=域名补上。 - 订阅地址用的是域名的,把它解析到新机;用的是旧机 IP 的,换机后地址会变,要把新地址发给用户。
- 只搬用户:用户 页 从旧面板导入(见 从旧面板导入用户)。
通知(Telegram)
用 Telegram(或 Webhook)收告警:用户到期、上游故障、证书续期失败、服务器被墙……还能在手机上用机器人管用户。
配置 Telegram 通知
- 在 Telegram 里找 @BotFather 创建一个机器人,拿到 Token(形如
123456:ABC-DEF…)。 - 给 @userinfobot 发条消息,拿到你的 Chat ID(群和频道的 ID 是负数)。再给你自己的机器人发一条消息,它才能主动给你发。
- 设置 → 通知:勾 启用 Telegram 通知,填 Bot Token 和 Chat ID,点 保存。
- 点 发送测试消息,手机收到就好了。
socks5://127.0.0.1:40000。发哪些通知
在 通知 这一组里逐项勾选;Telegram 和 Webhook 共用这些开关。
- 面板登录 / 连续登录失败
- 用户被自动禁用(到期/超量)、用户即将到期(提前天数在 到期前几天提醒)、用户流量告急(比例在 用量达到百分比时提醒)
- 突发限速触发时通知
- 上游故障 / 恢复、数据面停止 / 恢复
- 大陆连通异常 / 恢复
- 证书签发 / 续期 / 到期提醒(副机证书的也由主机发)
- 每日报告,几点发在 每日报告时间(小时,0–23,按面板时区)
- 主机容灾:备用发现主机失联、等你回复确认码接任、接任完成、设为主机做完或没做成、原主机回来变为副机时,也会发通知(见 设为主机与主机容灾);这些通知不受 数据面停止 / 恢复 开关管。
Telegram 机器人
勾上 Telegram 机器人 后,可以直接在手机上给 Bot 发命令管用户。
| 命令 | 作用 |
|---|---|
/status | 概况 |
/find 关键词 | 找用户 |
/user 名字 | 用户详情和订阅地址 |
/extend 名字 天数 | 延长到期 |
/reset 名字 | 重置流量 |
/enable 名字、/disable 名字 | 启用 / 停用(停用会同时断开连接) |
/kick 名字 | 断开连接 |
/backup | 发一份备份 |
/help | 看全部命令 |
Webhook
想把告警接到自己的系统里(企业微信、钉钉中转、工单……),用 Webhook。
- Webhook 地址:勾选的事件也会 POST 到这里,JSON 里有
event、text、time。留空就不发。 - Webhook 密钥:填了就带
X-M-UI-Signature头(sha256=正文的 HMAC),对方可以验证真伪。
运维、日志与更新
服务器调优、查日志、排查连接、升级版本,都不用回终端。
系统优化
运维 页的 系统优化:swap、文件句柄上限、时间同步、内核参数和 BBR,一般 VPS 用默认值就行。
- 点 一键优化 全做一遍,也可以逐项改参数后点 执行;任务输出实时显示在 任务输出 里。
- 同一页还能限制系统日志(journald)的占用和保留天数:它装的是整台机器所有服务的日志,限制它不影响面板。
- 建 swap 时磁盘不够会按余量减小(给系统留 2G、不超过盘的四分之一),不够 512MB 就不建:小盘上建大 swap 会把盘占满。
- WARP 也在这一页(见 WARP)。运维任务只在 Linux 上、m-ui 以 root 运行时可用。
磁盘快满了:提醒与清理
每台服务器上报 m-ui 数据目录所在那块盘的占用。用了 90% 以上或只剩不到 1GB 算快满了,97% 以上或不到 300MB 算满了:写库、写日志、签证书随时会失败。
- 副机快满了:服务器 页那一行状态里出现 💾 和已用百分比(悬停看系统日志、软件包缓存、swap 各占多少),概况 需要处理 里算一项,Telegram 发一次(变成满了再发一次,降到 87% 以下、剩 1.5GB 以上才说恢复)。主机自己的盘一样提醒,指路到运维页。
- 清理:主机的服务器页在那一行的 更多 里点 清理磁盘,不用登录副机;本机在 运维 页点 清理磁盘 那一项的 执行。会清掉软件包缓存、把 journald 回收到上限、超过 100MB 的文本日志只留最后 5MB、删掉一天前轮转下来的旧日志,再装一个每小时检查的定时器(m-ui-syslog-cap.timer),syslog 超过 200MB 就立刻轮转。m-ui 的数据和备份不动,线路不中断。
- 谷歌云的机器装着 Ops Agent 时,清理框里多一个勾选项:它上报失败会把整段报错刷进 syslog,是小盘被撑满的常见原因;勾了就停用并屏蔽它(谷歌云控制台里就看不到这台的监控指标了)。
- 老版本副机没有远程清理:先升级它,或登录它自己的面板在运维页清理。
- 撤销定时器:
systemctl disable --now m-ui-syslog-cap.timer;恢复 Ops Agent:对它的三个服务systemctl unmask,再systemctl enable --now google-cloud-ops-agent。
日志
日志 页有三类:订阅访问、核心日志、操作审计。
- 订阅访问:谁、从哪个 IP、用什么客户端拉了订阅。
- 核心日志:数据面和面板的运行日志。面板里这份只存在内存里(最多约 1 万条,重启就清);同样的内容也会写进系统日志(
journalctl -u m-ui能看到),清空 只清面板里这一份,系统日志的占用和保留天数在 运维 页限制。记录日志 可以关掉省资源。 - 数据面级别:默认 warn,只记警告和错误;排障时临时调到 info 或 debug,改了立即生效,查完记得改回 warn(info 一小时就几万行,会拖慢磁盘)。
- 操作审计:谁在什么时候做了什么(面板、外部 API、Telegram 机器人的操作都在)。
- 订阅访问和操作审计可以设 自动清理(保留 1 天、1 周、1 个月或不清理);每类都能 清空。
最近入站连接
概览页的 最近入站连接 用来排查"用户说连不上":看他的 IP 有没有连到服务器、连的哪条线路。
- 记录的是通过了协议握手和认证的连接,带用户、线路、服务器、次数和最近时间。
- 被设备数上限或代理设备池拒绝的连接也会列出来:整行标红、带 被拒 徽章,鼠标停在徽章上看是 设备数超限被拒 还是 代理设备池已满被拒。
- 默认列最近 10 条,点「显示全部」在卡片里展开(可以按 IP、用户、线路筛选);上方的筛选切换连接、被拒和握手失败。
- 包到了、却没过握手或认证的来源(证书、SNI、REALITY 公钥 / short_id、密码 / UUID 不对)在「握手失败」筛选里,分 TLS 握手失败 和 认证失败,写明原因;hysteria2、tuic 只记认证失败。版本较旧的副机不上报这一项,卡片里写明是哪几台。
- 列表里没有某个 IP,多半是包没到服务器(安全组、防火墙、客户端网络)。要确认包到没到:TCP 线路可以到日志页把 数据面级别 临时调到 info,看有没有
inbound connection from。Hysteria2、TUIC 这类 UDP 线路只有握手和认证都成功后才记这一行(证书、SNI 不对时哪里都不记,密码不对的只在「握手失败」里),看不到不代表包没到,要在服务器上抓包确认,比如tcpdump -ni any udp port 端口。
更新
有新版本时,左下角版本号旁会出现箭头,点它就能一键更新。
- 点箭头 → 立即更新:校验下载的程序后替换并重启,十几秒后面板自动刷新;用户、线路、订阅地址和证书都不变,这台机器上的连接会断一下。
- 新版本起不来会自动换回旧版本,页面顶部会说明;点 知道了 关掉提示。
- 副机也是完整安装,在各自的面板里更新;主副机版本要保持一致。
- 也可以 SSH 执行
m-ui选菜单 10。它和面板的更新箭头一样,直连 GitHub 不通时会自动经本机的 WARP 再试,所以纯 IPv6 机器(连不上 GitHub)装好 WARP 就能更新。重新执行一键安装脚本也能更新,但脚本不会自己走 WARP:纯 IPv6 机器要先执行export ALL_PROXY=socks5h://127.0.0.1:40000(端口按 WARP 的设置),或者手动上传安装包。
命令行与 SSH 菜单
面板打不开、忘了密码时,在服务器上执行 m-ui 用数字菜单。
- 菜单:1 查看面板地址 / 账号、2 重启、3 停止、4 启动、5 重置管理员密码、6 修改面板端口 / 路径 / 订阅端口、7 重置全部设置、8 查看最近日志、9 立即备份、10 更新到最新版、11 生成自签证书、12 切换主机 / 副机角色、13 关闭两步验证、14 卸载。
m-ui info:打印面板地址、路径和账号状态。m-ui passwd:重置管理员密码(同时关掉两步验证)。m-ui set -db /etc/m-ui/m-ui.db 键=值:直接改设置,比如webPort=3053。m-ui render:打印并校验当前的 sing-box 配置。- 菜单 15 和
m-ui ha status/takeover/set-master/pause/resume/reset:主机容灾与设为主机(见 命令行)。菜单里的升级、重启会先暂停接任。 - 数据在
/etc/m-ui/:m-ui.db(数据库)、cert/(证书)、backups/(定时备份)。
设置一览
设置 页按分组保存,每组右上角有自己的 保存。端口、监听地址和证书改了保存就生效:面板在原地换好监听,浏览器自动跳到新地址,订阅、代理面板也一样;页头的 重启 m-ui 一般用不着(副机的面板端口、证书例外,见下面的问答)。
角色与面板
订阅、订阅页与代理面板
通知、巡检与数据面
- 通知:见 通知(Telegram)。
- 上游巡检:巡检间隔(分钟)(0 = 关闭)、连续失败几次判定故障。
- 大陆连通检测:自动巡检、巡检间隔(分钟)、Globalping 令牌(可选)。
- 数据面:数据面证书、上游测试地址、统计粒度(秒)、流量记录保留(天)、允许用户访问内网 / 本机地址(默认关)、屏蔽 BT 下载。后两项改了数据面会重启一次并同步到副机。
- 关于:版本号、面板地址和订阅地址的样子。
外部 API
给商城、计费系统、机器人用:凭一个令牌就能建号、续费、换套餐、启停、取订阅地址,不用登录面板。
开启与令牌
- 管理员 页 → 外部 API:打开卡片右上角的开关(鼠标停上去写着 开启 / 关闭外部 API),复制 接口前缀 和 令牌。
- 账号 页 → 外部 API:打开卡片右上角的开关(鼠标停上去写着 开启外部 API),复制 接口前缀 和 令牌。
- 每个请求带上令牌:请求头
Authorization: Bearer 令牌(或X-API-Key: 令牌),请求体用 JSON。 - 开启后令牌下面有 接口一览(每个接口的说明)和 示例(curl)(已经填好你的接口前缀和令牌),可以直接照抄;没开时接口一览折叠着,也能先看。
- 令牌等于你在面板里的全部权限,只放在服务端程序里,不要写进网页或客户端。泄露了就点 重新生成,旧令牌立刻失效。
- 接口只在主服务器上调用;副机上的写操作会被拒绝。
- 代理的令牌只能动你名下的用户、你自己的套餐和站长授权给你的线路;代理被停用、到期或被重置密码后,令牌立刻失效。
多把密钥、权限与来源 IP 白名单
- 上面那一把是 默认密钥,全部权限,升级以后照旧可用。开着外部 API 时卡片里还有 附加密钥:点 新建密钥,起个名字(比如「商城」「TG 机器人」),只勾它需要的权限。
- 七项权限:查看用户、创建用户、修改用户(改字段、启停、清零用量、踢线、重置订阅链接)、删除用户、续费与换套餐、查看套餐、面板信息(概况、服务器、线路、在线用户)。没勾的接口调了返回 403,并写明缺哪项。
- 每把可以单独 编辑、重新生成(旧令牌立刻失效)、删除,列表里能看到最近一次是什么时候、从哪个 IP 用的。总开关关着时所有密钥都不能用。
- 来源 IP 白名单:默认关闭;打开后只有名单里的 IP 或网段能调用(默认密钥和附加密钥都算),一行一个,页面上会显示你当前的来源 IP,点 加进名单 就行。主面板和每个代理各有一份,互不影响。
- 面板挂在反向代理(Nginx、Caddy 等)后面时,先在 设置 → 面板 填「受信任的反向代理」,白名单才认得出真实来源;不然所有请求的来源都是反代自己。
- 附加密钥只在主服务器上生效;开了主机容灾的,备用接任以后照常可用。
常用接口
路径都接在接口前缀后面;{name} 可以是用户名,也可以是用户 id。
| 接口 | 做什么 |
|---|---|
GET /ping | 连通性与版本 |
GET /plans | 套餐列表 |
GET /users | 用户列表(?q= 搜索) |
POST /users | 建号,可以带 plan 直接套用套餐 |
GET /users/{name} | 用户详情(含订阅地址、在线 IP) |
PATCH /users/{name} | 改字段:到期、流量、设备数、线路…… |
POST /users/{name}/enable · /disable | 启用 / 停用 |
POST /users/{name}/reset · /kick | 本周期用量清零 / 踢下线 |
POST /users/{name}/rotate | 重置订阅链接与凭据 |
POST /users/{name}/plan | 续费(renew)或延期(extend),可带 periods 一次续 N 期;请求里完全不带套餐就续当前套餐。/renew 是它的别名 |
POST /users/{name}/change | 换套餐:replace(立即替换)、stack(叠加)、prorate(按价值折算) |
GET /users/{name}/plan-ops | 套餐记录,最新的在前 |
GET /users/{name}/sub | 订阅地址 |
DELETE /users/{name} | 删除用户 |
先预览、防重复、降级确认
续费和换套餐会动用户的钱和时间,接口提供了三道保险。
- 预览:请求里带
"dryRun": true只计算不执行,返回变更前后的对比,商城可以拿来报价。 - 防重复(幂等):带
requestId(或请求头Idempotency-Key,比如用订单号),同一个编号重试只执行一次,不会重复加时。 - 降级确认:换套餐会让用户马上超量、或到期提前时,接口返回 409 和完整预览,确认后带
"force": true再调一次才执行。 - 面板的接口一览里标着 幂等、可预览 的接口支持这些。
- 续费、换套餐是明确的开通动作:被手动停用的用户也会被启用,要先停掉的人别拿去续费。
安全
改掉默认密码、打开两步验证、藏好面板地址,就挡住了绝大多数风险。
账号与两步验证
- 改密码、改用户名:管理员 页的 登录账号。
- 改密码:账号 页的 登录密码。
- 两步验证(2FA):点 生成密钥,用认证器 App(Google Authenticator、Microsoft Authenticator、Authy、1Password 等)扫二维码,填 App 上的 6 位码,点 验证并开启。开启后登录要密码 + 6 位码。
- 手机丢了进不去:SSH 执行
m-ui,菜单 13 关闭两步验证;菜单 5 重置密码也会一起关掉。 - 手机丢了或忘了密码:找站长在主面板重置密码(两步验证会一起清掉)。
面板地址与端口
- 把默认的端口和路径改掉:设置 → 面板 → 端口 / 路径。只打开
IP:端口/永远是 404,别人扫到端口也看不出这是面板。 - 面板走 HTTPS:证书页添加证书时勾 用于面板 HTTPS,几秒后自动换上,浏览器跳到 https 地址(副机要重启才生效)。
- 防火墙只放必要的端口;副机的面板端口只对主机 IP 放行(换了主机记得把新主机的 IP 加进去)。这只防得住外面的人,防不住经代理连进来的用户,见下一节。
- 登录保护:同一来源 10 分钟内输错 10 次,先挡 5 分钟;连续输错 5 次可以发 Telegram 提醒(面板登录 / 连续登录失败)。外部 API 令牌错 10 次同样暂停这个来源 5 分钟(和登录分开计数)。
- 面板、代理面板或外部 API 挂在反向代理(Nginx、Caddy 等)后面时,在 设置 → 面板 → 受信任的反向代理 填反代的地址(同机反代填
127.0.0.1, ::1)。不填的话所有请求的来源都是反代自己,一个人连错 10 次就把所有人(管理员、代理、商城、机器人)一起挡 5 分钟。填了以后,只有来自名单里地址的请求才按X-Forwarded-For(从右往左第一个不在名单里的地址)或X-Real-IP认来源;反代要自己追加或覆盖这个头(Nginx:proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;,Caddy 默认就会)。没用反代就留空。
数据面的安全开关
- 允许用户访问内网 / 本机地址:默认关,用户经代理碰不到只监听 127.0.0.1 的服务(比如 WARP 端口)、你的内网和云厂商的元数据地址(169.254.169.254)。服务器的公网地址不拦:经代理打开面板、走代理的商城或机器人调外部 API、连着代理刷新订阅、登代理面板都照常。也因此,按来源 IP 限制面板访问时,用户经集群里的服务器转一下,来源就成了那台服务器的 IP;面板和外部 API 靠密码、两步验证、令牌把关。确实要给用户访问内网服务时再打开。
- 面板端口不在此列:用户经代理照样能打开
服务器公网IP:面板端口;公网 IP 直接绑在网卡上的 VPS(很常见)上,这类流量走本机回环,防火墙的 IP 白名单拦不住。所以别只靠白名单保护面板:改掉默认的端口和路径,用强密码,打开两步验证。 - 屏蔽 BT 下载:拒绝经代理的 BT 连接,免得 VPS 招来版权投诉。
- 副机的 API 地址用 HTTPS,否则同步时令牌和用户凭据走明文。
- 备份 zip 里有用户凭据和证书私钥;外部 API 令牌等于管理员权限:都要妥善保管。
面板会连哪些外部地址
m-ui 没有遥测,不收集使用数据。除了你自己的服务器,面板只在下面这些情况主动连外部服务,各自怎么关也写在表里。
| 连到哪 | 什么时候、为什么 | 怎么关 |
|---|---|---|
| GitHub | 检查新版本:启动后约 20 秒查一次,之后每 6 小时一次;订阅服务每 6 小时查一次落地页客户端下载页要用的客户端版本。点更新时也从这里下载。 | 关不掉;连不上也不影响使用,只是看不到新版本提示 |
Cloudflare(cdn-cgi/trace)、ipify | 测本机的公网 IPv4 / IPv6(订阅里的节点地址默认用它):启动时一次,之后每小时一次 | 关不掉 |
| Globalping | 大陆连通检测:把服务器的 IP 和端口发给它的公共测试网络。点检测时,以及 自动巡检(默认开,每 90 分钟) | 设置 → 大陆连通检测 → 去掉 自动巡检 |
| Let's Encrypt | 签发、续期 有域名(自动签发) 的证书;平时只在本机查到期日,到了该续的时候才连。用 DNS 验证(Cloudflare 或手动加 TXT)时,还会向 Cloudflare、Google 的公共 DNS(1.1.1.1、8.8.8.8)查 TXT 记录生效没有 | 不用自动签发,或在证书库里关掉那张的自动续期 |
| Cloudflare API | 用 DNS(Cloudflare API) 签发、续期时加删 TXT 记录 | 不用这种验证方式就不连 |
| Telegram | 发通知、跑 Telegram 机器人 | 设置 → 通知 不启用就不连 |
| GitHub、jsDelivr、ntfy.sh、TronGrid | 功德箱:打开 建议 / 支持 页时读名单(最多一小时一次),点留名、核对到账时;在线设备数:每天从 GitHub 下载一次空文件 | 设置 → 面板 → 关掉 功德箱与在线设备数 |
| Globalping、Cloudflare / 阿里云 / 腾讯云 DNSPod 的 API | 主机容灾:判断主机是否失联时让境外测点连主机;选了连订阅一起接管时,主机变了以后经 DNS 接口改订阅域名的解析、必要时给订阅域名重签证书 | 关掉 境外测点见证;选 只接管主机的工作(默认)就不连 DNS 接口 |
Google(www.gstatic.com) | 上游巡检和测试:上游测试地址 默认就是它。本机有线路用了上游(WARP、落地机等)时,每 10 分钟经各条上游连一次;线路用了上游组的,内核还会每 30 秒经组里每条上游连一次;点上游的 测试、外部节点测速时也连 | 把 上游测试地址 换成别的地址;巡检间隔(分钟) 填 0 只关掉定时巡检,上游组的测速照样跑 |
| 你自己填的地址 | Webhook、外部订阅、Telegram 代理 | 不填就不连 |
| 点了才连 | 更新、安装 WARP(Cloudflare 的软件源;本机 DNS 解析不了软件源时还会向 1.1.1.1、8.8.8.8 查解析)和 检测出口、按规则分流里的 查域名(GitHub 上的 v2fly 域名列表)、Reality 的 检测 和 帮我挑(连候选网站)、外部节点测速、证书页的 预检 DNS / 端口 和换机向导的 检查解析(向 Cloudflare、Google、阿里的公共 DNS 查解析,并测一次本机公网 IP) | 不点就不连 |
常见问题 / 排错
先按症状找;没找到就用上面的搜索框搜关键词。
连不上
- 订阅能刷新,但节点连不上?
- 先让用户刷新一次订阅,再按顺序查:线路端口有没有在安全组 / 防火墙放行(Hysteria2、TUIC 要放 UDP);用户是否被停用(看状态一列);设备数是不是满了。概览的 最近入站连接 能看到他的 IP 有没有连到服务器。
- 提示设备数超限 / 有的设备连不上?
- 同时在线的设备(按来源 IP 算,所有服务器合计)到了上限,新设备会被拒绝。等别的设备下线约 1 分钟,或者调高设备数。手机切换 WiFi 和流量会换 IP,短时间内可能算两台。
- IPv6 的节点不通?
- 多半是云安全组没给
::/0放行(TCP、UDP 分开加),或者系统的 ip6tables / ufw 拦着;再确认用户自己的网络有 IPv6。WARP、NAT 之类只能出站的 IPv6 不能给用户连。服务器页的 IPv6 入站检测能直接告诉你通不通(见 连接地址与 IPv4 / IPv6)。 - 某个地区突然全连不上?
- 到 服务器 页点 检测大陆连通:IP 被墙 要换 IP,端口被封 换个端口就行。
面板与服务器
- 打开
IP:2053/是 404? - 故意的:根路径不跳转,免得把面板路径告诉扫端口的人。打开完整地址,比如
http://IP:2053/app/。忘了路径就 SSH 执行m-ui选菜单 1。 - 忘记密码 / 手机丢了进不去?
- SSH 执行
m-ui:菜单 5 重置管理员密码(同时关闭两步验证),或者菜单 13 只关闭两步验证。 - 改了端口、监听地址、证书,页面没跳过去?
- 主面板保存后一两秒就在原地换好监听,浏览器等新地址能连上就跳过去。一直跳不过去,多半是防火墙(安全组)没放行新端口、证书不受信任,或者域名还没指向这台,页面上会给出新地址可以直接点。副机的面板端口、证书改了不会自动换(主机连它用的就是这个地址):先到主机服务器页改好 API 地址,再在副机设置页页头点 重启 m-ui,或菜单 2。改路径保存就生效。
- 副机显示离线?
- 看服务器页写的原因,对照 离线排查。用自签证书的副机要勾 跳过证书校验;重签过副机证书要在 更多 里点 重置指纹。
- 证书续期失败?
- 看证书库 自动续期 一列的原因:HTTP 验证要 80 端口空闲;手动 DNS 的证书不能自动续;域名多了指向别处的 AAAA 记录也会失败。见 自动续期。
- WARP 启用失败?
- 看运维页的任务输出。常见原因:40000 端口被占用,换个 SOCKS5 端口 再启用;系统不是 Ubuntu / Debian,一键安装不支持,要自己装(见 WARP)。
- 订阅返回 429?
- 同一个 IP 每分钟拉订阅超过 120 次被限流了,一般是客户端更新太频繁。这个限流也是防别人猜用户名批量拿订阅的主要手段,别关掉;确实需要就调大(比如 600):
m-ui set -db /etc/m-ui/m-ui.db subRateLimit=600,同时建议关掉 用用户名作订阅地址,让新用户用随机令牌。
订阅与用户
- 客户端里订阅名不对?
- 到 设置 → 订阅 填 订阅标题(Profile-Title)(代理在自己账号页的订阅页里填,他的订阅标题和页面标题都空着时,他名下的用户也用你的);没填时依次用页面标题、用户备注、用户名。到 账号 → 订阅页 填 订阅标题(Profile-Title);没填时依次用你的页面标题、主面板的订阅标题和页面标题、用户备注、用户名。不想让客户看到站长的名字,就自己填一个订阅标题。Shadowrocket、Clash Verge 只在添加订阅时定名字,要让用户删掉重加,或者用落地页的一键导入。
- 用户用完、到期后看到什么?
- 浏览器打开订阅地址仍是他的落地页,顶部写明原因、联系方式和续费按钮(如果填了选购链接);客户端拉订阅拿到 404。续费或重置流量后马上恢复。
- 订阅地址泄露了?
- 用户的 更多 → 重置订阅链接,旧地址和凭据立刻失效,把新地址发给用户。
- 代理登录不上?
- 新代理第一次登录密码留空;24 小时认领时间过了、或忘了密码,要站长在主面板 代理 页 更多 → 重置密码。
已知限制
这几处是现在的设计边界,不是故障;以后可能改进。
- VLESS / VMess 的多路复用(Mux)与 XUDP:客户端开了 Mux,或用 XUDP 转发 UDP 时,一条外层连接只认证一次,里面再开多少条流都不再看用户表;服务端碰到就接受,线路上没有开关能拦。停用、删除用户、重置订阅链接或踢线时只断得了里面正在跑的流,外层连接还活着,客户端断开重连之前仍能在里面开新流。要立刻彻底断开,停用这条线路再启用(会全量重载),或重启 m-ui。Hysteria2、TUIC、AnyTLS 没有这个问题:停用和踢线会关掉整条会话。
- 跨服务器的设备数约有 5 秒的判定窗口:各台服务器的在线 IP 由主机每 5 秒汇总一轮再下发,同一个用户在这几秒里同时从几台服务器连进来,合计可能超过上限。超出后不会把已经连上的设备踢掉(设备满了只拒新设备,已连接的不动),等多出来的设备空闲约 1 分钟下线后才回到上限以内。
- 全量重载时 Hysteria2 不发关闭通知:新建 / 删除线路、改端口或协议这类改动要全量重载数据面,正在连着的 Hysteria2 客户端收不到连接关闭的通知,要等约 30 秒的空闲超时才发现断了并重连,这段时间里像是卡住。只改用户、限速、上游时是热更新,不受影响。
- 大陆连通检测只测 IPv4:大陆的家庭宽带测点大多没有 IPv6,用它们测 IPv6 会把正常的服务器误判成被墙,所以只测 IPv4;IPv6 入站另从境外测点测一项(只看端口通不通,不判断墙)。见 大陆连通检测。
建议与支持 · 功德箱
面板右上角的 建议 / 支持:找作者、报问题、支持这个项目。
反馈问题
- 页面里有作者的 Telegram、文档、报告 Bug 和讨论区的入口。报问题时带上版本号(页面上点一下就能复制)。
- 日志里的令牌、UUID、订阅地址先打码再发。
功德箱
- 在"支持这个项目"里填你的名字和金额,点 留名,再按页面给出的金额转 USDT(TRC20),60 分钟内到账就记到这个名字上。
- 上榜靠 GitHub 上的定时任务对账,GitHub 常把定时任务推迟几个小时,所以到账后通常要几个小时才出现在所有面板的 功德箱 里;超过一天还没上榜,在 Telegram 联系作者。
- m-ui 没有遥测,不收集使用数据。功德箱和在线设备数(每台面板每天从 GitHub 下载一次空文件,按下载次数算有多少台在运行)是仅有的两处和面板功能无关的联网,都不带任何标识。
- 不想要这两处联网:设置 → 面板 → 关掉 功德箱与在线设备数。这个开关只管这两处;面板为各项功能还会连 GitHub(检查更新)、Globalping(大陆连通检测)、Let's Encrypt、Telegram 等,清单和各自怎么关见 面板会连哪些外部地址。