m-ui 帮助说明代理面板

m-ui 帮助说明代理面板帮助说明

按目录找功能(手机上点右上角的「目录」),或者用上面的搜索框。灰框里的字和面板上的按钮、标题一模一样,照着找、照着点就行。这里只列代理面板用得上的内容。

快速上手

m-ui 是一个自己搭的代理面板:线路、用户、订阅、证书、备份和多台服务器,都在网页里管。

代理面板用来管你名下的用户:建号、续费、看用量,再把订阅地址发给用户。

先认识几个词

面板里反复出现这几个概念,弄清楚了后面就好懂。

  • 线路:客户端连进来的入口,等于"协议 + 端口",再决定流量从哪出去。用户订阅里的节点就是由线路生成的。
  • 上游:线路的出口。默认 direct(本机直出),也可以是 WARP 或别的落地机。
  • 用户:一个订阅地址,带流量、到期、设备数和限速。流量用完或到期会自动停用;设备数满了只拒绝新设备,限速只限制速度。
  • 套餐:流量、时长、设备数、限速、线路的模板,建号、续费时一键套用。
  • 订阅:给客户端导入的地址;同一个地址用浏览器打开,是用户自己的落地页。
  • 主服务器 / 副服务器:主机存全部数据、负责算账;副机只转发流量,配置由主机推送。
  • 代理:帮站长卖号的人,在自己的代理面板里只管自己名下的用户。

第一次登录

装好后用浏览器打开面板,第一件事是把默认密码改掉。

  1. 打开 http://服务器IP:2053/app/(端口和路径以安装结束时打印的为准)。
  2. 用默认账号 admin / admin 登录。
  3. 顶部红条提示还是默认密码:点 立即修改,在 管理员 页的 登录账号 里填 原密码 和 新密码,点 更新账号,然后用新密码重新登录。
常见坑
  • 只打开 http://服务器IP:2053/ 会是 404,这是故意的:不把面板路径告诉扫端口的人。地址要带上完整路径。
  • 打不开:先看云服务器的安全组 / 防火墙有没有放行 2053/tcp。
  • 忘了地址或密码:SSH 登录服务器执行 m-ui,菜单 1 查看面板地址,菜单 5 重置管理员密码。

五步开始用

概览页的 快速开始 清单就是这几步,做完前四步就能给人用了。

  1. 改默认密码(见上一节)。
  2. 准备证书:证书 页 → 添加证书。有域名选 有域名(自动签发) 签一张;没有域名选 无域名(自签),点 生成自签证书。详见 证书。
  3. 建线路:线路 页 → 快速添加,新手选 Hysteria2 或 AnyTLS,保存。详见 线路与协议。
  4. 建用户:用户 页 → 新增用户,填用户名和额度,勾上 可用线路,保存。
  5. 发订阅:点用户名打开详情,订阅 下面有两个地址,把不带 ?format= 的那个(通用地址)发给用户:用浏览器打开是他自己的落地页,能一键导入客户端;客户端来拉时按类型给格式(见 订阅地址、二维码与临时共享)。
没有域名也能用自签证书 + 服务器 IP 就行:订阅会自动告诉客户端"允许不安全证书",客户端不用另外设置。以后有了域名签正式证书时注意:已经有用户时证书页默认不勾 用于订阅 HTTPS;勾了的话所有用户的订阅地址都会变成 https://域名…,旧地址立即失效,每个客户端都要重新导入,签发前会再提示一次。不勾就保持原地址,用户刷新一次订阅即可。
常见坑线路的端口要在云服务器安全组和系统防火墙里放行:Hysteria2、TUIC 走 UDP,其它大多走 TCP。没放行是"连不上"最常见的原因。

代理:三步开始用

站长给你开通代理之后,按这三步就能开始卖号。

  1. 打开站长给你的代理面板地址(默认端口 2054,路径 /dl/)。用户名填代理名,第一次登录密码留空,直接点 登录,按提示设置密码。详见 第一次登录与设密码。
  2. (可选)到 套餐 页建几个套餐,以后建号、续费一键套用。
  3. 到 用户 页点 新增用户:填名称,选套餐或者手填额度,勾上 可用线路,保存;点用户名打开详情,把 订阅 下不带 ?format= 的那个地址发给用户。
代理面板只有四页概览、用户、套餐、账号。你只看得到自己名下的用户和自己建的套餐。

界面导览

左边是功能导航,右上角是帮助和反馈;要你处理的事集中在 概览 最上面的 需要处理,其它页面顶部的彩色横条也会提醒。

  • 左侧导航依次是:概览、线路、上游、外部节点、用户、代理、套餐、规则、服务器、证书、备份、运维、日志、管理员、设置。
  • 左下角:主题切换(◐ 跟随系统、☀ 浅色、☾ 深色)、语言、退出登录。版本号旁出现箭头表示有新版本,点它就能更新(见 更新)。
  • 右上角:帮助说明(就是本页)和 建议 / 支持(联系作者、反馈问题)。
  • 需要处理:数据面重载失败、服务器离线或没同步、证书要处理、大陆连通异常、上游故障、用户快到期或流量将尽、定时备份失败等,每类一行,按轻重排,点行尾的链接去处理;一切正常时只剩一行「✓」。证书和大陆连通可以点 知道了,情况有变化会再出现。
  • 顶部提醒条:在概览以外的页面,默认密码没改、证书要处理、大陆连通异常、数据面重载失败等会在页面顶部提醒,按提示处理。
  • 副服务器的面板里,线路、用户这些页面是只读的,要到主机面板改。
  • 快捷键:/ 跳到当前页的搜索框,Esc 关闭弹窗,Ctrl + Enter 提交弹窗。手机上点左上角 ☰ 打开导航。

服务器与主副机

一台主服务器管全部数据,可以再接任意多台副服务器当入口;订阅里每条线路在每台服务器上各出一个节点,客户端挑延迟低的用。

要不要加副机

一台服务器就能用;想给用户更多地区、更多入口时再加副机。

  • 主机每 5 秒把线路、用户推给副机,同时收回各台的流量和在线设备;配额、到期只在主机上判定。
  • 副机只转发流量。主机临时连不上时,副机继续按最后一份配置服务用户;恢复后流量按记录补齐,不会重复计费。
  • 加一台服务器,所有人的订阅里自动多出对应的节点。

接入一台副机

在副机上装好 m-ui,把它的配对信息填到主机就行。

  1. 在副机服务器上同样安装 m-ui,登录副机面板(先把默认密码改掉)。
  2. 副机 设置 → 角色:勾 作为副服务器运行,点 保存。
  3. 副机 设置 → 配对信息:复制 API 地址 和 配对令牌。
  4. 主机 服务器 页 → 新增服务器:填 名称(会成为订阅里节点名的后缀,如"香港")、API 地址和配对令牌。副机面板用自签证书或 IP 访问时勾 跳过证书校验。
  5. 保存后几秒,这一行显示 已同步 就好了。
常见坑
  • 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) 不生效,没填域名的服务器不会出现在订阅里。
IPv6 入站检测订阅里这台有走 IPv6 的线路时(自动地址用 选了 IPv6,或者有线路的 IP 版本 选了 IPv6),主机在大陆连通检测的同一轮里,从境外有 IPv6 的测点连它订阅里的 IPv6 地址和第一条走 IPv6 的 TCP 线路的端口(每台约多用 4 个测点次),结果是 服务器 页 大陆连通 一列里的 v6 小格,点格子看明细。显示不通,多半是安全组没放行 ::/0 或者本机防火墙拦了 IPv6。每台只测一个端口,别的端口要各自放行;UDP 线路(hysteria2、tuic)测不了,只能在服务器上抓包确认。
IPv6 常见坑
  • 云服务器的 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. 服务器 页,点那台服务器 状态 一栏开头的角色标签(如「副机 ▾」「备用 1 ▾」),在弹出的卡片里点 设为主机;行末的 ⋯(更多)菜单里也有。
  2. 确认框里写清会发生什么:检查结果、新的面板地址和代理面板地址、订阅域名的 DNS 该指向哪个 IP。输一次管理员密码(开了两步验证再输动态码)。
  3. 之后全程有进度,完成后给出新面板和代理面板地址。账号、密码、两步验证都不变,到新面板重新登录。
  • 主机的全部数据(用户、线路、套餐、代理、设置、流量记录)端到端加密后交给那台,它成为主机;原来的主机变为副机,继续用自己的线路服务。两台各重启一次,连在这两台上的用户断开几秒后自动重连,别的服务器不受影响。
  • 提交之前任何一步失败(包括传得太慢、快到截止)都会自动取消:原主机照旧当主机,写操作恢复,数据不变。
  • 换到全新 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。

线路与协议

线路决定客户端怎么连进来:入口协议 + 端口 → 从哪出去。每条线路在它部署的每台服务器上各出一个节点。

新建线路

新手用 快速添加 最省事:协议参数是配好的,端口也自动挑好。

  1. 线路 页右上角点 快速添加,选一个预设:Hysteria2、AnyTLS、VLESS + Reality、Trojan、Shadowsocks 2022、VMess + WS。
  2. 表单已经填好,看一眼 名称(订阅里显示的节点名)和 端口,保存。
  3. 想自己配就点 新增线路:选 协议、填端口;上游 默认是 direct(本机直出)。
  • 新建时默认勾着 分配给全部现有用户(不含代理名下);不勾的话,要到用户里逐个勾上,新线路才会出现在他们的订阅里。
  • 端口会自动填一个空闲的五位数端口,可以改;和面板、订阅端口或本机其它程序撞了,保存时会直接报错。
  • 保存前整份配置先交给内核试跑,过不了就不生效,也不影响正在用的线路。改线路会让数据面重启一下,在线用户会自动重连。
常见坑端口要在安全组 / 防火墙放行,UDP 协议(Hysteria2、TUIC)记得放 UDP。

线路的流量与在线

  1. 在 线路 页点线路名或 详情:上面四格是所选时段这条线路的流量合计、部署的服务器台数、此刻在线的用户数和 IP 数。
  2. 流量 图默认是 全部服务器合计,可以切 24 小时 / 7 天 / 30 天;右上角下拉或点下面 各服务器 里的一行,只看那一台,再点一次回到合计。
  3. 在线用户与 IP 每 5 秒刷新,写明每个人在哪台服务器上、用哪些 IP 连着;人多时能搜,一次显示 40 个,点用户名去用户页。
常见坑
  • 副机的线路流量记在副机自己那里,打开详情时现取;联系不上、停用或版本太旧的服务器在表里标出来,不算进合计。
  • 线路流量是服务器上实际走过的字节数,不乘服务器的流量倍率,所以和用户用量加起来不一定相等。

中转入口:让用户经另一台机器连进来

用户直连这台服务器慢、或者连不上(比如大陆连海外机器绕路、IP 被墙)时用:让他们先连一台线路更好的机器 —— 你的另一台服务器,或者买的中转 —— 由它把流量原样转给这台。数据走向是「用户 → 中转 → 出口(这条线路的服务器)→ 网站」。中转只搬数据、不解密,看不到内容。用不上就别开。

  1. 编辑线路,勾上 中转入口(默认不勾);取消勾选再保存会清掉。
  2. 每一条是一句话:用户连 哪台中转 的端口 多少 → 转给 哪台出口(括号里是转到的地址和线路端口)。选你的另一台服务器当中转,转发它会自动做;端口自动挑一个那台空着的(先试线路自己的端口)。
  3. 用自己跑的 realm / iptables 或买的中转:选 别处的中转(填地址),填它的地址和端口(粘贴「地址:端口」会自动拆开);下面一行写着要在中转上把什么流量、哪个端口转到哪里。
  4. 第二行左边是 订阅节点 的名字(中转那一段可以改),右边是要做的事(在哪台的防火墙放行哪个端口)。端口撞了(那台的面板 / 订阅、部署在那台的线路、别的中转)当场标红,保存不了。
  5. 两台内网互通时,点括号里的地址改成内网地址;不想用了先勾 暂停。线路列表里线路名后面的「⇄ N」是有几个中转入口,线路详情的顶上逐个列出。
和「把线路加为上游」的区别那种是在中转机上解密再转,中转机也要跑这个协议;中转入口只搬字节,少一半加解密,hysteria2、TUIC 这类 UDP 协议也能转。
常见坑
  • 中转服务器的防火墙(云厂商安全组)要放行这个端口:hysteria2 / TUIC 是 UDP,shadowsocks 是 TCP 和 UDP,其余是 TCP。
  • 出口服务器看到的来源是中转的 IP:同一个人经同一台中转连进来的几台设备,在出口上只算一个 IP,设备数限制管不住走中转的设备;在线 IP 里中转的 IP 会标「⇄ 服务器名」。
  • 中转节点不带端口跳跃;流量照常按出口服务器的倍率计。删掉一台服务器时,经它中转、转给它的中转入口一起去掉。

协议怎么选

拿不准就这样配:主力用 Hysteria2,再配一条 TCP 的(AnyTLS 或 VLESS + Reality)当备用。

协议走证书特点 / 适合
Hysteria2UDP需要(自签也行)速度快、抗丢包,首选。运营商限 UDP 时配端口跳跃。
TUICUDP需要和 Hysteria2 同类(基于 QUIC),作备选。
AnyTLSTCP需要流量特征弱;UDP 不好用时首选的 TCP 方案。
VLESS + RealityTCP不需要不要域名和证书,借大站的 TLS 握手,抗探测强;建议开 Vision。
TrojanTCP需要经典的 TLS 协议,客户端基本都支持。
VMess / VLESS + WSTCP可选能套 CDN(要有域名);直连时不如上面几种。
ShadowsocksTCP / UDP不用不要证书,客户端支持最广。2022 算法更安全,但老内核 Clash 不支持,订阅会自动不发给它们。
SOCKS / HTTP / MixedTCP—普通代理,适合内网设备或给别的程序当中转,不建议直接拿来翻墙。
没有域名时VLESS + Reality 最省事;也可以用自签证书跑 Hysteria2 / AnyTLS,订阅会自动带上"允许不安全"。

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(默认跟服务器页的设置)。
  • 一条线路部署在几台服务器上就是几个"入口";给用户、套餐、代理分配线路时,可以只勾其中某台服务器上的入口。

按规则分流

同一条线路里,让指定的网站走别的出口(比如流媒体走解锁机),或者直接拦掉。

  1. 编辑线路,勾 按规则分流。
  2. 点 + 添加规则:选 匹配方式(域名后缀、完整域名、域名关键字、IP 段、端口),填匹配内容(多个用逗号或换行隔开),选 出口:direct、某个上游,或者 拦截。
  3. 想按应用加:在旁边的输入框填应用名(如 抖音、netflix、openai),点 查域名,规则自动加好,出口在规则里选。
  4. 保存。
  • 从上往下,第一条命中的生效;都没命中的走线路自己的 上游。
  • 一个 App 常常要好几个域名,要一起加;关键字太短(比如 ai)会误伤别的网站;按域名访问的流量不一定能按 IP 段匹配上,优先用域名规则。
  • 取消勾选 按规则分流 再保存,会清掉全部规则。

批量操作、排序与克隆

勾选多条线路后,顶部会出现批量操作条。

  • 启用、停用、设上游、部署服务器(有多台服务器时才有)、取消选择。批量改只重载一次数据面。
  • 拖动行调整顺序,订阅里的节点按这个顺序排。
  • 行末 更多 里有 克隆(会重新挑一个端口)、把线路加为上游(见 线路作上游)和删除。

上游与外部节点

上游决定线路的流量从哪出去;外部节点把别处的节点并进用户的订阅。

添加上游

上游就是"落地机":加好后在线路的 上游 里选它,用户的流量就从那台机器出去。

  1. 上游 页 → 新增上游。
  2. 把落地节点的分享链接粘贴到 从分享链接导入,点 解析填表,核对后保存;也可以手动选类型、填参数。
  3. 点 测试 看延迟;再到 线路 里把线路的上游改成它。
  • 支持 VLESS、VMess、Trojan、TUIC、Hysteria2、Shadowsocks、SOCKS 落地。
  • 还有线路在用的上游删不掉,先把那些线路的上游改掉。

WARP

Cloudflare WARP 给线路一个干净的出口,常用来解锁流媒体,或者让纯 IPv6 的机器访问 IPv4 网站。

  1. 运维 页的 Cloudflare WARP 卡片里,依次点 安装、启用。
  2. 点 检测出口,确认出口 IP 正常。
  3. 上游 一栏还没有 warp 的话,点 添加为上游 warp。
  4. 在线路的上游里选 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 = 关闭)、连续失败几次判定故障。
  • 概览页的 上游巡检 卡片可以点 立即巡检。

外部节点

把别处的节点(机场订阅、单条分享链接)并进你的用户订阅,排在本站节点后面。

  1. 外部节点 页 → 新增外部节点:类型选 外部订阅(一个订阅地址,定时抓取)或 分享链接(单条节点)。
  2. 填 链接 / 订阅地址;可以加 节点名前缀(如 "[中转] ")方便用户区分。保存。
  3. 到 用户 里编辑要给的人,勾上 外部节点。
  • 主机定时抓取,间隔在 设置 → 订阅 → 外部订阅刷新间隔(分钟);抓取失败时保留上次成功的内容,列表里写明错误。
  • 支持 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 查到后自动继续。
    先点 预检 DNS / 端口 看看,再点 签发证书。泛域名(*.example.com)只能用 DNS 验证。
  • 无域名(自签):点 生成自签证书;证书包含的地址(留空自动) 留空就用本机公网 IP。订阅里每个节点会自动带"允许不安全",客户端不用设置;面板和订阅建议保持 HTTP。
  • 已有证书:服务器上已经有 certbot、宝塔、nginx 或商业证书时,填 证书文件(fullchain) 和 私钥文件 的路径,点 使用该证书。
选用途在 添加后用于 里勾:设为线路默认证书、用于面板 HTTPS、用于订阅 HTTPS;没勾的用途不受影响。默认勾选:还没有正式证书时勾着 设为线路默认证书;添加的不是自签证书、而面板还没用 HTTPS 时勾着 用于面板 HTTPS;订阅还没用 HTTPS 且一个用户都还没有时勾着 用于订阅 HTTPS,已有用户时默认不勾。勾了 用于订阅 HTTPS,所有用户的订阅地址都会从 http:// 变成 https://,旧地址立即失效,客户端要重新导入(添加前、在 正在使用 里换订阅证书时、在设置页「订阅」里直接填上或清空证书路径时都会再提示一次);勾了 用于面板 HTTPS,重启后面板也换成 https://。

Cloudflare API 令牌怎么创建

用 DNS(Cloudflare API) 签证书,要一个 Cloudflare API 令牌。只让它管你这个域名的 DNS,泄露了也动不了别的。

  1. 打开 Cloudflare 的令牌创建页(已预填权限),登录你的 Cloudflare 账号。权限已经填好:「区域 → 区域 → 读取」和「区域 → DNS → 编辑」,令牌名叫 m-ui。
  2. 「区域资源」改成「包括 → 特定区域 → 你的域名」,不要留「所有区域」。
  3. 点「继续以显示摘要」,再点「创建令牌」。
  4. 复制页面上显示的令牌,粘贴到 m-ui 证书页的 Cloudflare API Token。令牌只显示这一次,离开页面就看不到了,丢了只能重新创建。
链接打不开、或页面和上面说的不一样时,手动创建Cloudflare 控制台右上角头像 → 我的个人资料 → API 令牌 → 创建令牌 → 用「编辑区域 DNS」模板 → 区域资源选「包括 → 特定区域 → 你的域名」→ 继续以显示摘要 → 创建令牌。签发时如果报找不到区域(zone),给这个令牌再加一条权限「区域 → 区域 → 读取」。
常见坑
  • 权限最小化:只要上面两项权限,区域只选要用的域名。不要用「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) 和 页面标题 时,客户端里显示的订阅名就是备注(备注也空就用用户名),不想让用户看到的内容别写进备注。
发卡、试用填 首次连接后 N 天到期(0 = 不用):用户第一次产生流量时才开始计时,不用管到期日。

流量、到期、设备数怎么算

超量或到期会自动停用并踢下线;续费、重置流量后自动恢复。

  • 流量:上传 + 下载合计;配额可以写小数(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。
  • 本周期用量:自动(立即替换和折算清零,叠加保留)、保留(接着算)、清零(从新周期开始)。
  • 对话框下方实时预览 变更前 和 变更后,标出 升级 还是 降级。到期提前、马上超量这类会让用户吃亏的影响标红,要勾 我已确认上面标红的影响,仍然执行 才能 确认换套餐。
  • 只选一个用户时,续费… 和 换套餐… 的对话框每次打开都带一个防重复的编号:双击、网络重试都只会执行一次。勾了多个用户再批量 套用套餐 时没有这层保护:中途报错,已经续上的人不会撤回;重试前先看列表里的到期日(或者详情里的 套餐记录),把已经续上的人去掉再选。
  • 详情里的 套餐记录 能看到最近的续费和换套餐。
接商城续费、换套餐也能用外部 API 做,而且可以先预览再执行(见 外部 API)。

套餐

套餐是额度的模板,建号、续费、批量操作都能直接套用。

  1. 套餐 页 → 新增套餐:填 名称(如 100G/月)、说明、流量(GB)、时长(天)、设备数和上下行限速。
  2. 按月清零的勾 周期重置流量;发卡、礼品卡勾 从首次连接开始计时。
  3. 线路:套用时把用户的线路换成这些;留空 = 套用时不改动用户已有的线路。
  4. 限速规则:勾上的规则对这个套餐的用户(现有的和以后套用的)都生效。
  5. 参考价(可选):只在换套餐用"按价值折算"时用,不给用户看;两个套餐填同样的价就是同价互换。
  • 套餐页显示每个套餐有多少用户。
  • 改套餐不会自动改已经套用过的用户;要让他们按新额度走,就给他们续费或换套餐。
  • 代理只看得到、也只能用自己建的套餐。

批量操作

勾选多个用户后,顶部出现批量操作条(表头的全选只勾当前这一页)。

  • 启用、停用、延期、套用套餐、重置流量、删除。
  • 批量生成:按 用户名前缀 一次建 数量 个,命名方式 选 前缀 + 随机 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,上下行合计),就限速 限速时长(分钟);到时自动解除,再次达到再次限速。

新建规则

  1. 规则 页 → 新增规则:起个名字,选 类型,填条件。
  2. 填 上行 Mbps / 下行 Mbps,0 = 这个方向不改。
  3. 不超过用户自己的限速:开着(默认)时结果不会高于用户自己的限速,只会更严;关掉就直接用规则的值,可以用来在某个时段放宽。
  4. 目标 可以叠加:全部用户(含以后新建的)、某个套餐的用户、某个代理名下的全部用户、逐个勾选。
  5. 保存。
按套餐限速也可以在编辑套餐时勾 限速规则,让这个套餐的用户都跟着规则走。

生效与查看

  • 多条规则同时命中同一个用户时,取最严的一条。
  • 规则列表的 生效中 一列点 查看,看现在谁被限速、还剩多久;用户列表也会标 限速中。
  • 改动对在线连接立即生效,不用等重连;规则由主机每 10 秒判定一次,自动同步到副机。停用规则后,它造成的限速马上解除。
  • 规则限速不显示在用户的落地页上。突发限速触发时想收到通知:设置 → 通知 → 突发限速触发时通知。

代理(分销)面板

代理是帮你卖号的人:你给他线路和额度,他在自己的代理面板里建用户;他只看得到自己名下的用户和自己建的套餐。

代理面板只管你名下的用户:站长给你线路和额度,你在这里建号、续费、看用量。

开通一个代理

  1. 代理 页 → 新增代理:名称 就是代理的登录名。
  2. 勾 可用线路:代理只能把这些线路分给他的用户;可以只授权某台服务器上的入口。
  3. 填额度:流量额度 GB、用户数上限、设备池、带宽池 · 上行 Mbps / 带宽池 · 下行 Mbps、到期日(留空=不限);0 = 不限。
  4. 保存后把代理面板地址发给他:代理列表下方写着,新建成功的提示里也有(默认端口 2054、路径 /dl/)。
  • 新代理没有密码:24 小时内他用名称登录、密码留空直接点登录,进去后先设密码。过期没认领、或者忘了密码:更多 → 重置密码(会一并清掉他的两步验证和外部 API 令牌,再开 24 小时)。
  • 取消勾选某条线路,他名下的用户马上就不能用这条线路了。
  • 重置流量:把他名下所有用户的已用流量清零。
  • 代理的用户不出现在主面板的用户页里;要看就点这个代理的 详情。
  • 代理面板的端口、路径、证书在 设置 → 代理面板 里改,用不上可以关掉 启用代理面板;记得在防火墙放行 2054/tcp。

额度怎么算

  • 流量额度:按名下所有用户的全部用量算,代理自己重置流量、续费、删号都抵不掉;只有主面板的"重置流量"能清零。
  • 设备池:名下所有用户同时在线的设备总数上限(所有服务器合计)。池满只拒绝新设备,已连着的不受影响。
  • 带宽池:名下所有用户合计的速率上限,每台服务器各一份。
  • 给单个用户填多少都行,但总量受这几个池限制。
  • 到期、被停用、流量超额,任何一条踩线,名下全部用户立刻停用、订阅打不开。

第一次登录与设密码

  1. 打开站长给的代理面板地址(默认 http(s)://服务器地址:2054/dl/)。
  2. 用户名填代理名;第一次登录密码留空,直接点 登录。
  3. 按提示 设置登录密码(至少 8 位),以后用新密码登录。
常见坑新代理只有 24 小时认领时间。过期或者忘了密码,要找站长在主面板重置密码,重开 24 小时。登录后建议在 账号 页打开两步验证。

代理面板里能做什么

  • 概览:已用额度、账号到期、用户数、在线用户和设备;额度、到期、设备池快到头时 需要处理 会提醒;即将到期 和 流量快用完 列出该续费的用户。
  • 用户:新增、编辑、续费、延期、重置流量、踢线、重置订阅链接、批量操作、看用量曲线和在线设备。建号只填名称,订阅地址是随机令牌。
  • 套餐:只看得到、也只能用自己建的套餐。
  • 账号:额度、密码、两步验证、自己的订阅页文案、外部 API。
  • 只能分配站长授权的线路(授权可能只到某台服务器)。

账号页

代理面板的 账号 页管登录安全、额度,以及你的用户看到的订阅页。

  • 我的额度:已用流量、设备池(在线 / 上限,以及已分配给用户的总数)、带宽、到期、用户数。设备池满时这里会写最近拒绝了几台新设备。
  • 登录密码:改密码。
  • 两步验证(2FA):见 账号与两步验证。
  • 订阅页:你名下用户看到的订阅页文案:订阅标题(Profile-Title)(客户端里显示的名字)、页面标题、页脚联系方式、选购 / 续费链接、公告(支持换行);留空就用主面板的。也能单独关掉订阅页或临时共享。
  • 落地页 logo:上传你自己的 logo,上传即生效;没设时用主面板的。
  • 外部 API:给你自己的商城、机器人用(见 外部 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。地址对不上任何用户时,浏览器显示"订阅地址无效"。

临时共享

用户可以在落地页生成一条临时地址给别人用,随时收回。

  • 每人一条;对方拿到的是同一批节点、另一套凭据。流量、设备数、限速、到期都算在本人头上。
  • 取消或重新生成后,旧的共享地址立刻失效,借用的人被断开。
  • 共享地址用浏览器打开是精简版落地页,看不到本人的用量和到期。
  • 允许用户生成临时共享地址(默认开)可以整体关掉:主面板在 设置 → 订阅页,代理在 账号 → 订阅页(主面板关了,代理这边也不生效)。
  • 在用户详情里能看到他的共享地址,点 收回 立即作废。

备份与迁移

一个 zip 就是整个面板:数据库(线路、用户、流量、设置)加证书,设置和证书库里引用的数据目录外的证书文件(比如 certbot 签的)也在里面。备份好它,换机、重装都能把数据原样恢复。

备份

  • 备份 页 → 立即备份:下载 到本地,或者 保存到服务器(在 服务器上的备份 列表里)。
  • 定时备份:每天几点(-1 关闭)(按面板时区,见 设置 → 面板 → 时区)、保留份数;可以勾 同时推送到 Telegram(先配好 Telegram 通知)。
  • 命令行:m-ui backup -db /etc/m-ui/m-ui.db -out 备份.zip,或者 m-ui 菜单 9。
常见坑备份里有全部用户凭据和证书私钥,不要发到公开的地方。

还原

  1. 备份 页 → 还原:选备份文件(zip 或 .db),点 还原。
  2. 确认后 m-ui 自动重启,替换数据库和证书。设置和证书库里引用的数据目录外的证书文件(比如 已有证书、从旧面板导入的证书路径)不往原路径写:这台机器原路径上的证书能接着用(现在有效、包含备份里那张的全部域名、和私钥配得上,而且不比备份里的旧或者还剩两周以上)就接着用它;不能用才把备份里那份放进 /etc/m-ui/cert/restored/,并把设置和证书库改指过去。还原结果在页面顶部提示一次。面板、订阅和代理面板的证书文件万一还是缺了,先用临时自签证书启动(仍走 HTTPS)并告警,不会起不来。
  3. 原来的库保留为 .bak-* 文件,只留最近两份:连着还原几次,最早那份会被删掉。拿不准该用哪份备份时,先点 立即备份 把当前的库下载下来再试。
  • 新机器可以在安装时一步装好并还原(命令见下面的 换服务器)。
  • 服务停着时也能用命令行还原:m-ui restore -db /etc/m-ui/m-ui.db -from 备份.zip。
常见坑
  • 放进 /etc/m-ui/cert/restored/ 的是备份那一刻的副本:原来由 certbot、宝塔等工具续期的,以后没人再续它,证书库里标 还原的副本,没人续期。还原后就到证书页重新签发,或者在这台装好 certbot 后重新用 已有证书 添加,再换过去,别等剩 30 天的到期提醒。
  • 把主机的备份还原到另一台机器并启动,这台就成了主机:它以更高的纪元接管全部副机,原主机之后再起来会自动变为副机(没开过主机容灾也一样,见 备份、还原与换机)。只想看看备份里有什么,别在联网的机器上还原并启动它。
  • 顶着临时自签证书期间,客户端更新订阅会报证书错误,浏览器打开面板、代理面板也会提示不安全:照页面顶部的证书提醒把证书补上,或者换一张。

换服务器

备份 页的 换机向导 用备份分四步把整个面板搬到新服务器。订阅用的是域名时,端口、凭据、订阅地址都不变,把域名解析改到新机,用户就跟过来了。

旧主机还在运行时,优先用「设为主机」新机装好 m-ui、像副机一样接入(见 接入一台副机),同步上以后在 服务器 页对它点 设为主机:数据一次交接过去,不用备份、还原,旧主机自动变为副机(见 设为主机)。下面的四步留给旧主机已经不在、只能靠备份的时候。还原后启动,就等于把主机换到这台:旧主机之后若又被启动,会自动变为副机,不要了就在旧机上执行 systemctl disable --now m-ui(见 备份、还原与换机)。
  1. 把备份 zip 传到新机,执行 bash <(curl -fsSL https://raw.githubusercontent.com/Maoyangui/m-ui/main/deploy/install.sh) --restore /root/m-ui-20261111-030000.zip(换成你的文件路径;amd64、arm64 都是这一条,脚本先装最新版再还原,证书一起还原)。向导里也有这条命令。
  2. 用新机 IP 打开面板(端口和路径同旧机),确认线路在运行;有副机的话,新主机会自动重新连上它们。
  3. 到 DNS 服务商把域名解析改到新机 IP,用向导里的 检查解析 看主流解析器是否都已生效。
  4. 新机上用户都正常后,在旧机上执行 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 通知,别的都不要改;同时运行的时间越短越好。
只换副机更简单新副机装好后,在主机 服务器 页把那一行的 API 地址和令牌换成新的,主机会自动重新推送。

从旧面板迁移

  • 整机迁移(线路、上游、用户、设置都带过来):在新服务器上安装时加参数,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 通知

  1. 在 Telegram 里找 @BotFather 创建一个机器人,拿到 Token(形如 123456:ABC-DEF…)。
  2. 给 @userinfobot 发条消息,拿到你的 Chat ID(群和频道的 ID 是负数)。再给你自己的机器人发一条消息,它才能主动给你发。
  3. 设置 → 通知:勾 启用 Telegram 通知,填 Bot Token 和 Chat ID,点 保存。
  4. 点 发送测试消息,手机收到就好了。
常见坑服务器连不上 Telegram(比如国内机器)时,在 代理(可选) 填一个代理;装了 WARP 就填 socks5://127.0.0.1:40000。

发哪些通知

在 通知 这一组里逐项勾选;Telegram 和 Webhook 共用这些开关。

  • 面板登录 / 连续登录失败
  • 用户被自动禁用(到期/超量)、用户即将到期(提前天数在 到期前几天提醒)、用户流量告急(比例在 用量达到百分比时提醒)
  • 突发限速触发时通知
  • 上游故障 / 恢复、数据面停止 / 恢复
  • 大陆连通异常 / 恢复
  • 证书签发 / 续期 / 到期提醒(副机证书的也由主机发)
  • 每日报告,几点发在 每日报告时间(小时,0–23,按面板时区)
  • 主机容灾:备用发现主机失联、等你回复确认码接任、接任完成、设为主机做完或没做成、原主机回来变为副机时,也会发通知(见 设为主机与主机容灾);这些通知不受 数据面停止 / 恢复 开关管。

Telegram 机器人

勾上 Telegram 机器人 后,可以直接在手机上给 Bot 发命令管用户。

命令作用
/status概况
/find 关键词找用户
/user 名字用户详情和订阅地址
/extend 名字 天数延长到期
/reset 名字重置流量
/enable 名字、/disable 名字启用 / 停用(停用会同时断开连接)
/kick 名字断开连接
/backup发一份备份
/help看全部命令
常见坑机器人只听设置里那个 Chat ID;填的是群组 ID 时,群里所有人都能操作。机器人只在主服务器上运行,不用开端口;它做的操作记入操作审计,操作人显示为 telegram。

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 一般用不着(副机的面板端口、证书例外,见下面的问答)。

角色与面板

  • 角色:作为副服务器运行(见 接入一台副机)。
  • 面板:域名(订阅与节点用的域名,也是 TLS 的 SNI)、时区(面板里所有时间按它显示)、监听地址、端口、路径、证书文件 / 私钥文件(一般在证书页勾选,自动写入)、受信任的反向代理(见面板地址与端口)、功德箱与在线设备数。
  • 改面板路径保存就生效,浏览器自动跳到新地址;改端口、监听地址、证书要重启。
  • 端口设成 443(HTTPS)或 80(HTTP)时,地址里不用写端口;面板和订阅不能用同一个端口。

订阅、订阅页与代理面板

  • 订阅、订阅格式与模板:见 订阅设置。
  • 订阅页:落地页的文案、选购链接、临时共享开关,见 落地页。
  • 代理面板:启用代理面板、监听地址、端口(默认 2054)、路径(默认 /dl/)、证书(留空和面板共用一张)。

通知、巡检与数据面

  • 通知:见 通知(Telegram)。
  • 上游巡检:巡检间隔(分钟)(0 = 关闭)、连续失败几次判定故障。
  • 大陆连通检测:自动巡检、巡检间隔(分钟)、Globalping 令牌(可选)。
  • 数据面:数据面证书、上游测试地址、统计粒度(秒)、流量记录保留(天)、允许用户访问内网 / 本机地址(默认关)、屏蔽 BT 下载。后两项改了数据面会重启一次并同步到副机。
  • 关于:版本号、面板地址和订阅地址的样子。

外部 API

给商城、计费系统、机器人用:凭一个令牌就能建号、续费、换套餐、启停、取订阅地址,不用登录面板。

开启与令牌

  1. 管理员 页 → 外部 API:打开卡片右上角的开关(鼠标停上去写着 开启 / 关闭外部 API),复制 接口前缀 和 令牌。
  2. 账号 页 → 外部 API:打开卡片右上角的开关(鼠标停上去写着 开启外部 API),复制 接口前缀 和 令牌。
  3. 每个请求带上令牌:请求头 Authorization: Bearer 令牌(或 X-API-Key: 令牌),请求体用 JSON。
  4. 开启后令牌下面有 接口一览(每个接口的说明)和 示例(curl)(已经填好你的接口前缀和令牌),可以直接照抄;没开时接口一览折叠着,也能先看。
常见坑
  • 令牌等于你在面板里的全部权限,只放在服务端程序里,不要写进网页或客户端。泄露了就点 重新生成,旧令牌立刻失效。
  • 接口只在主服务器上调用;副机上的写操作会被拒绝。
  • 代理的令牌只能动你名下的用户、你自己的套餐和站长授权给你的线路;代理被停用、到期或被重置密码后,令牌立刻失效。

多把密钥、权限与来源 IP 白名单

  1. 上面那一把是 默认密钥,全部权限,升级以后照旧可用。开着外部 API 时卡片里还有 附加密钥:点 新建密钥,起个名字(比如「商城」「TG 机器人」),只勾它需要的权限。
  2. 七项权限:查看用户、创建用户、修改用户(改字段、启停、清零用量、踢线、重置订阅链接)、删除用户、续费与换套餐、查看套餐、面板信息(概况、服务器、线路、在线用户)。没勾的接口调了返回 403,并写明缺哪项。
  3. 每把可以单独 编辑、重新生成(旧令牌立刻失效)、删除,列表里能看到最近一次是什么时候、从哪个 IP 用的。总开关关着时所有密钥都不能用。
  4. 来源 IP 白名单:默认关闭;打开后只有名单里的 IP 或网段能调用(默认密钥和附加密钥都算),一行一个,页面上会显示你当前的来源 IP,点 加进名单 就行。主面板和每个代理各有一份,互不影响。
推荐商城用一把「查看用户 + 创建用户 + 续费与换套餐 + 查看套餐」,Telegram 机器人用一把只读的「查看用户 + 面板信息」;商城服务器 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、订阅地址先打码再发。