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:菜单顶上那一行就是面板地址,选「重置管理员密码」换密码。面板打不开又不知道卡在哪,执行 m-ui doctor(一键体检)。

五步开始用

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

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

代理:三步开始用

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

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

界面导览

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

  • 左侧导航依次是:概览、线路、上游、外部节点、用户、代理、套餐、规则、服务器、证书、备份、运维、日志、管理员、设置。
  • 左下角:主题切换(◐ 跟随系统、☀ 浅色、☾ 深色)、语言、退出登录。版本号旁出现箭头表示有新版本,点它就能更新(见 更新)。
  • 右上角:帮助说明(就是本页)和 建议 / 支持(联系作者、反馈问题)。
  • 顶部的提醒:数据面重载失败、服务器离线或没同步、证书要处理、大陆连通异常、上游故障、定时备份失败等,每类一个小条排成一行,按轻重排,点小条里的链接去处理;没有要处理的事时这一行不出现。证书和大陆连通可以点 知道了,情况有变化会再出现。
  • 24 小时流量 那一格可以点:打开 流量明细,选 24 小时、7 天或 30 天,看这段时间的流量是哪些用户用的、走了哪些线路、落在哪些服务器上(三栏是同一个合计的三种分法,都按服务器倍率计)。线路那一栏要临时向各副机问,离线或版本旧的副机问不到,它们的流量记在 没归到线路 里并写明是哪几台。
  • 顶部提醒条:在概览以外的页面,默认密码没改、证书要处理、大陆连通异常、数据面重载失败等会在页面顶部提醒,按提示处理。
  • 副服务器的面板里,线路、用户这些页面是只读的,要到主机面板改。
  • 快捷键:/ 跳到当前页的搜索框,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 的 TCP 线路的端口:先用大陆有 IPv6 的家宽测点(每台约多用 4 个测点次);大陆测点都连不上、或这次没有大陆的 IPv6 测点时,再用境外测点(约 4 个)分清原因。结果是 服务器 页 大陆连通 一列里的 v6 小格,点格子看明细:v6 ✓ 大陆测点连得上;大陆✕ 境外能连、大陆连不上(这个 IPv6 被墙,或运营商的 IPv6 到不了,换回 IPv4 或换一个 IPv6 地址);v6 ✕ 大陆和境外都连不上,多半是安全组没放行 ::/0 或者本机防火墙拦了 IPv6;境外✓ 这次没有大陆的 IPv6 测点,只知道境外能连。每台只测一个端口,别的端口要各自放行;UDP 线路(hysteria2、tuic)测不了,只能在服务器上抓包确认。
IPv6 常见坑
  • 云服务器的 IPv6 要在安全组里给 ::/0 单独放行(TCP、UDP 分开加);系统里的 ip6tables / ufw 也要放行,只清空 iptables 不会放开 IPv6。
  • WARP、NAT 这类只能出站的 IPv6 不能给用户连。
  • 纯 IPv6 的机器:检查更新前要先装 WARP(见 WARP);直连出口打不开只有 IPv4 的网站,线路上游选 warp 才能访问全网。

流量倍率

给贵的服务器多扣流量:经过这台服务器的流量按倍率计入用户用量。

  • 编辑服务器 → 流量倍率:2 就是双倍扣量,节点名会带 x2 标记;1 是原样。主机自己也能设。
  • 用户的已用量、详情里的流量图、落地页上的数字都是折算后的,账对得上;线路、上游的统计是实际流量。

服务器的流量额度与到期

给按流量计费、按月租的服务器设一个总流量和到期时间:用完或到期后这台自己停下来,不再多跑流量。

  • 入口:服务器 页那一行的 更多 → 流量额度与到期,或者点 编辑,在 流量额度与到期 一段里填。设过之后,服务器名字下面多一条用量条,点它也能打开。
  • 总流量(GB):按这台服务器上真实的上行 + 下行算(经它中转的也算),不乘流量倍率,和机房账单是一个算法。0 是不限。
  • 重置周期:每月 的某一天(对上机房的账期),或者 按天数;到点用量清零。也可以随时点 重置用量。
  • 到期时间:比如这台服务器的租期,过了那一天生效。
  • 用完或到期后自动停用这台服务器 默认开着:用完或到期时整台停用 —— 断开所有连接、不再接新连接,主机不再向它同步,订阅里不再给出它的节点;到了重置周期、调高额度或续期后,自动重新启用。
  • 关掉这个开关:服务器保持启用,只停掉它上面的代理服务(同样断开连接、拒绝新连接),行里标 已停止服务。注意主机仍会向它推送配置、拉取状态,服务器之间的同步本身还会消耗少量流量和带宽。
  • 主机自己那台不能停用:用完或到期后只停本机的代理服务,面板照常运行。
常见坑
  • 用量从这台服务器升级到 0.8.0 之后开始记,只算经过代理的流量(面板同步、系统更新这些不算),和机房后台的数字不会完全一样:额度留一点余量。
  • 副机要升级到 0.8.0 以上才会上报流量;没升级的那台用量一直是 0,额度不生效(编辑框里会提示)。到期时间不受影响。
  • 被额度自动停用的服务器,手动打开 启用 会被拦下并说明原因。要让它继续跑,就调高额度、填 0(不限)、重置用量或延长到期时间;关掉自动停用的开关只是不停用整台,代理服务照样停着。
  • 服务器被停下来时,概览 顶部会提醒一次,点 知道了 就收起;开了 Telegram 通知的,停下和恢复时各发一条。

大陆连通检测

看服务器在中国大陆是不是被墙了:从大陆移动、电信、联通的家庭宽带测点去连,香港测点作对照。

  • 服务器 页的 大陆连通 一列显示结果:点格子看明细,点 检测大陆连通 一次测全部。
  • 结果怎么看:正常;部分不通(某一家运营商连不上);疑似被墙;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 菜单里的「卸载 m-ui」。只关掉副机模式停不了服务:它会变成一台独立的主机,按最后一份配置继续给所有人用。
  • 离线原因:连接超时、连接被拒绝(端口没放行或面板没在运行)、域名解析失败、证书不受信任(勾上跳过证书校验)、令牌不匹配(重新复制配对令牌)、证书指纹变了(确实重签过副机证书,就在那一行的 更多 里点 重置指纹)。
  • 换一台副机:新副机装好后,在 服务器 页编辑原来那一行,换成新的 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 不动。用户的订阅地址仍指向原主机:原主机失联期间刷新订阅会失败(已连上的线路照常可用),它回来变成副机后照样提供订阅。订阅证书(含私钥)也不随副本带到备用。
  • 全量接管:订阅、面板、代理面板和外部 API 的地址全都跟到新主机。新主机换上原主机的订阅域名、端口、路径和证书,经 DNS 接口把订阅域名改指到新主机,用户的订阅地址不变。要订阅地址用域名,并填好 DNS 服务商 的接口;没满足时保存会直接说缺什么。面板用域名时,面板和代理面板的地址(外部 API 挂在面板上)也一起跟过去:新主机换上原主机面板的域名、端口、路径、证书和受信任的反向代理,面板域名也改指过来,对接外部 API 的商城、机器人和代理们都不用改;API 密钥、权限、白名单本来就在数据副本里。面板用 IP 时跟不过去,就绪检查会提醒给面板配域名。
  • 设为主机(计划内换主机)不受这个选项影响:订阅总是一起迁过去,订阅证书随整库数据带过去;配了 DNS 接口、订阅域名在名单里就自动改解析,否则确认框里写着该指向哪个 IP。
  • DNS 服务商可选 Cloudflare(API 令牌,见 Cloudflare API 令牌怎么创建)、阿里云云解析(只授权 AliyunDNSFullAccess 的 RAM 用户的 AccessKey)、腾讯云 DNSPod(只授权 QcloudDNSPodFullAccess 的子用户 API 密钥)。凭据单独存、不回显。点 测试 DNS 接口与记录 看哪些记录会被改;凭据不对、域名不在这个账号下时这里直接写出错误。
  • 订阅证书:订阅走 https 时,备用随加密副本带着主机的订阅证书,接任时能用就直接用,不重签;用不了(没带过来、过期、半个月内到期、不含订阅域名),新主机会用同一个 DNS 接口给订阅域名重签一张(DNS 验证不用等解析指过来),签好自动用于订阅、订阅服务原地重启,以后的续期也走这个接口。刚改完解析、验证记录还没生效时可能一次签不下来:它会隔一会儿自己再试(1 分钟、2 分钟、5 分钟……前后约两个半小时),每次的结果在证书页看得到。就绪检查里能看到订阅证书还剩几天。
  • 只改 跟着主机走的域名(订阅域名自动加上)里当前指向原主机 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 菜单里的「主机容灾 / 设为主机」也是它。

  • 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. 想自己配就点 新增线路:选 协议、填端口;上游 默认是 直连(从服务器直接出去)。
  • 新建时 分配给全部现有用户 默认开着(不含代理名下的用户);关掉的话,要到用户或套餐里勾上,新线路才会出现在他们的订阅里。
  • 端口会自动填一个空闲的五位数端口,可以改;和面板、订阅端口或本机其它程序撞了,保存时会直接报错。
  • 保存前整份配置先交给内核试跑,过不了就不生效,也不影响正在用的线路。改线路会让数据面重启一下,在线用户会自动重连。
常见坑端口要在安全组 / 防火墙放行,UDP 协议(Hysteria2、TUIC)记得放 UDP。

线路的流量与在线

  1. 在 线路 页点线路名或 详情:上面四格是所选时段这条线路的流量合计、部署的服务器台数、此刻在线的用户数和 IP 数。
  2. 流量 图默认是 全部服务器合计,可以切 24 小时 / 7 天 / 30 天;右上角下拉或点下面 各服务器 里的一行,只看那一台,再点一次回到合计。
  3. 在线用户与 IP 每 5 秒刷新,写明每个人在哪台服务器上、用哪些 IP 连着;人多时能搜,一次显示 40 个,点用户名去用户页。
  4. 想知道大陆连不连得上这条线路,点上面的 测大陆连通:主机从大陆移动、电信、联通的家庭宽带测点去连这条线路在订阅里的每个地址和端口(部署到的每台服务器一个,每个中转入口也一个),香港测点作对照,约半分钟出结果。一个地址一行:三家运营商各自的延迟或不通,最后是结论,鼠标停在结论上有解释。它测的是这条线路自己的端口,和服务器页定时做的大陆连通巡检是两回事:不记历史、不告警;两边共用测点额度,同一时间只跑一个。
  5. hysteria2、tuic 走 UDP,测点连不了 UDP 端口,只能 ping 地址,通的时候写 ping 通:看得出地址通不通,看不出端口有没有被封、QUIC 有没有被针对 —— 这种情况要让大陆的客户端实际连一次,在服务器上抓包确认。
常见坑
  • 副机的线路流量记在副机自己那里,打开详情时现取;联系不上、停用或版本太旧的服务器在表里标出来,不算进合计。
  • 线路流量是服务器上实际走过的字节数,不乘服务器的流量倍率,所以和用户用量加起来不一定相等。

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

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

  1. 编辑线路,展开下面的 中转入口,点「添加中转入口」;把入口删光再保存就是不用中转。
  2. 每一条是一句话:用户连 哪台中转 的端口 多少 → 转给 哪台出口(括号里是转到的地址和线路端口)。选你的另一台服务器当中转,转发它会自动做;端口自动挑一个那台空着的(先试线路自己的端口)。
  3. 用自己跑的 realm / iptables 或买的中转:选 别处的中转(填地址),填它的地址和端口(粘贴「地址:端口」会自动拆开);下面一行写着要在中转上把什么流量、哪个端口转到哪里。
  4. 第二行左边是 订阅节点 的名字(中转那一段可以改),右边是要做的事(在哪台的防火墙放行哪个端口)。端口撞了(那台的面板 / 订阅、部署在那台的线路、别的中转)当场标红,保存不了。
  5. 两台内网互通时,点括号里的地址改成内网地址;不想用了先勾 暂停。线路列表「服务器」一格里的「中转 N」是有几个中转入口,线路详情里逐个列出它们现在的状态(生效、端口被占、中转服务器离线……)。
  6. 中转服务器上那个端口已经被别的程序占着(比如你自己装的 realm、gost):填端口时面板会现问那台服务器并提示。如果那正是你给这条线路做的转发,把 谁来转 改成 这台上已有转发 —— 面板不去占这个端口,只把入口写进订阅;不是的话换一个端口。
  7. 订阅里默认直连节点和中转节点都给,客户端自己测速挑快的。只想给中转的,勾 订阅里只给中转入口,不给出口服务器的直连节点。
和「把线路加为上游」的区别那种是在中转机上解密再转,中转机也要跑这个协议;中转入口只搬字节,少一半加解密,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、无

加密方式 决定节点怎么加密和伪装;Hysteria2、TUIC、AnyTLS 必须用 TLS。

  • 证书(TLS):用本机证书,客户端按域名校验。默认用每台服务器证书页设的默认证书,也可以在 证书 里给这条线路单独选一张。
  • Reality:不用证书,伪装成 握手目标(伪装域名) 那个网站的 TLS。点 检测 看能不能用,点 帮我挑 自动测一批常见大站、按延迟列出,点一下就填入。密钥和 Short ID 选到 Reality 时自动生成好了,收在下面那一行里;要换就展开,在 私钥 旁边点 生成密钥对,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 段匹配上,优先用域名规则。
  • 把 分流规则 里的规则都删掉再保存,就不再分流。

批量操作、排序与克隆

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

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

节点:逐个设倍率、限速和容量

订阅里的每个节点 —— 一条线路在一台服务器上的直连,或它的一个中转入口 —— 都列在 节点 页,可以单独设置。

  • 倍率:没设的写着 跟随服务器,用的是所在服务器的倍率(中转入口跟出口那台);单独设了就只对走这个节点的流量生效,同一台服务器上别的线路照旧。订阅里节点名后面的「x2」是这个节点实际生效的倍率。
  • 节点限速(Mbps) 是走这个节点的所有用户合计;每用户限速(Mbps) 和用户自己的限速同时生效,取更严的;用户容量 满了只拒新用户,已经在线的不受影响。
  • 输出到订阅 的开关点了就存:关掉后这个节点不再出现在任何人的订阅里,入站照开。
  • 只想让某些人拿不到某个节点,不用把整个节点关掉:在 用户(或 套餐)的线路选择里,线路下面除了各台服务器,它的中转入口(带 ⇄ 的)也能一个个勾,不勾的不进这个人的订阅。只勾中转入口、不勾那台服务器,这个人就只拿到中转节点。这只管订阅里发不发 —— 直连和经中转进来的是同一份凭据。
  • 在线 / 容量 一列前面的数是这个节点此刻在线的用户数(各服务器报上来的),到了容量上限会变色。
  • 线路多的时候用工具栏筛:按线路、按服务器(它上面的直连、经它中转的、转到它的入口都算)、按直连 / 中转,或只看 单独设置的、没输出的。
  • 要一次改很多个就勾选:行首勾一个,线路那一行勾整条线路,表头勾现在列出的全部(先筛再全选,就是「某台服务器上的全部节点」)。勾了以后上面出现批量条:输出到订阅、不输出、设倍率(留空 = 都改回跟随服务器)、设限速 / 容量(每项选「不改 / 设为 / 不限」)、恢复默认。
  • 中转入口是在出口服务器上按连接的来源 IP 认的。集群里的中转、地址是 IP 的中转面板自己认得出;经内网连出口、进出不是同一个 IP、地址是域名的,在 设置 里展开 出口认不出这个入口时 把来源 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,被占用会启用失败;端口就在卡片里 SOCKS5 端口 那一行改,改完点 重新启用。
  • 一键安装只支持 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 地址;国内中转入口香港不通属正常。
  • 添加为上游:勾选节点、各起一个名字,直接变成上游(重名会报错,不会自动改名)。
  • 这样加的上游记着自己是哪个订阅的哪个节点(上游页名字下面写着)。机场给这个节点换了端口或参数时:上游通着就不动;只有它在所有用它的服务器上都连续测不通,面板才把订阅重新抓一遍、找到这个节点现在的配置,校验通过后换上(上游的名字不变,用它的线路不用动),并在 Telegram 和操作审计里记一笔。订阅里对不上唯一的节点(删了、或者像的不止一个)就不改,在上游页写明,等你处理。点上游名字下面那一行来源,可以把 跟随订阅的变化 关掉:现在的配置原样留着,只是不再自动换,随时能再打开。手动改过这条上游的类型或参数,它也会自己停下(名字下面写着 已停止跟随);重新打开后,它再全部测不通时会换回订阅里的配置。

证书

证书让线路、面板、订阅走 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. 参考价(可选):只在换套餐用"按价值折算"时用,不给用户看;两个套餐填同样的价就是同价互换。
  • 套餐页显示每个套餐有多少用户。
  • 改套餐不会自动改已经套用过的用户;要让他们按新额度走,就给他们续费或换套餐。
  • 代理只看得到、也只能用自己建的套餐。

批量操作

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

  • 启用、停用、延期、套用套餐、重置流量、删除。
  • 批量生成(在列表右上角的 更多 菜单里,从旧面板导入 和 导出 CSV 也在这里):按 用户名前缀 一次建 数量 个,命名方式 选 前缀 + 随机 8 位 或 前缀 + 序号(001…,订阅地址用随机串);生成后列出每个人的订阅地址,可以整段复制。这里给的是 Clash 地址(带 ?format=clash),发给不用 Clash 的用户时,去掉末尾的 ?format=clash 就是通用地址。
  • 导出 CSV:导出用户列表,订阅那一列也是 Clash 地址。

停用原因与踢线

列表的状态一列写明为什么停用,也就决定了怎么恢复。

  • 停用、启用一个人:行末 更多 菜单(用户详情右上角的 更多 里也有)。启用着的这一项是 停用,停用着的是 启用,点一下就换;停用后他的连接立刻断开、订阅拿不到节点。到期、超量被停的人手动启用后,系统下一轮检查还会再停掉他,要恢复使用得续费或重置流量。一次停用 / 启用很多人用列表上方的批量操作。
  • 超量、到期:续费、重置流量或延长到期后自动恢复。
  • 手动:手动停用的不会因为重置流量、延长到期或周期重置而自动恢复。但用套餐续费或延期(续费、批量 套用套餐)和 换套餐 是明确的开通动作,会把他一并启用:续费、批量套用套餐和换套餐的对话框里会先提示里面有手动停用的人、做完会被启用,批量时列出是谁,不想启用的先取消勾选。外部 API 的续费、换套餐也一样会启用。
  • 限速中:正被规则临时限速(见 规则)。
  • 踢下线:断开这个用户在所有服务器上的连接(hysteria2、TUIC、AnyTLS 整条会话一起关)。没停用的话客户端会马上重连,想彻底断就先停用。
  • 列表上方可以按 全部、在线、启用、停用、即将到期、已过期、超量 筛选,也可以只看某个套餐。即将到期 是现在还能正常用、但几天内就要到期或者流量快用完的人(几天、百分之多少,跟通知里的 到期前几天提醒、用量达到百分比时提醒 是同一组设置,没填就是 3 天 / 80%);概览不为这些人提醒 —— 用户不续费,管理员也没什么可处理的,想看就在这里筛。在当前页全选后(手机上勾任意一个后),批量条上可以一键选中全部筛选结果,一起操作;这一下会换掉之前勾的人,只留当前的筛选结果。换筛选、换搜索之前勾的人会一直留着,批量操作时其中有当前列表里看不到的,会先问一句再处理。

从旧面板导入用户

线路已经在 m-ui 上建好、只想把老用户搬过来时用。

  • 用户 页右上角 更多 → 从旧面板导入,上传旧面板的 .db 文件,点 开始导入。
  • 同名用户会被旧库的值覆盖用量、配额、到期、启停、周期重置,以及旧库里不空的备注和说明;其余的新建,沿用旧面板的用户凭据。可以勾 给新建的用户分配全部现有线路。
  • 只导入用户时,线路、入站端口、订阅端口和路径都还是 m-ui 自己的:用户要用 m-ui 的新订阅地址重新导入,停掉旧面板之前先把新地址发给大家。
  • 连线路、上游、设置一起搬,见 从旧面板迁移。

规则(临时限速)

规则给用户加临时限速:比如晚高峰全员限到 30 Mbps,或者 10 分钟内跑了 1 GB 的人限速 20 分钟。

两种规则

  • 时段限速:每周指定几天的某个时间段内限速,走出时段自动恢复。按面板时区算,结束早于开始表示跨午夜;星期 全不勾等于每天。
  • 突发限速:最近 统计窗口(分钟) 内上下行合计达到 触发流量(GB,上下行合计),就限速 限速时长(分钟);到时自动解除,再次达到再次限速。

新建规则

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

生效与查看

  • 多条规则同时命中同一个用户时,取最严的一条。
  • 规则卡片上写着「N 人正在被限速」时点它,看现在谁被限速、还剩多久;用户列表也会标 限速中。
  • 改动对在线连接立即生效,不用等重连;规则由主机每 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 签的)也在里面。备份好它,换机、重装都能把数据原样恢复。

备份

  • 备份 页下面的 备份 卡列出这台服务器上存着的备份,每一行可以下载、还原、删除;卡的右上角 下载备份 现做一份直接存到你的电脑上,保存到服务器 现做一份存进备份目录(目录和总大小写在表格下面)。
  • 页面最上面左边的 定时备份 卡默认没有开:打开标题右边的开关,在「每天 … 自动备份,保留最近 … 份」那句话里选几点做(按面板时区,见 设置 → 面板 → 时区)、留几份(默认 7;升级前自动留的备份另算,只留最近两份);还可以打开 同时推送到 Telegram(先配好 Telegram 通知)。这几项改了当场保存,不用另点保存。定时备份失败时这张卡用红字写明原因,概览的「需要处理」也会提醒。
  • 命令行:m-ui backup -db /etc/m-ui/m-ui.db -out 备份.zip,或者 m-ui 菜单里的「立即备份」(存进这台的备份目录,上面的列表里也看得到);「还原备份」在它旁边。
常见坑备份里有全部用户凭据和证书私钥,不要发到公开的地方。

还原

  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 菜单里的「卸载 m-ui」。只 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 菜单的「修改端口 / 路径 / 监听地址」里改回原来的。
    • 单独的订阅域名不会带过来:用 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 用默认值就行。

  • 页面最上面一排小卡是这台服务器现在的状况:主机名、已运行多久、内存、Swap 和磁盘用了多少。
  • 系统优化 是一张表,一行一项:前面打绿勾的是做过了的,现在 一列是当前的值,参数 一列可以改。点 一键优化 把前四项全做一遍,也可以逐项改参数后点那一行的 执行;任务输出实时显示在 任务输出 里。
  • 内核参数点 修改参数 在弹框里改(一行一项「名字=值」):确定只是记下这份,回到页面点那一行的 执行 才写进系统。
  • 同一页还能限制系统日志(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、用什么客户端拉了订阅。客户端 一列认得出的写成名字和版本(Clash Verge、Shadowrocket、佛跳墙……),悬停看完整的 User-Agent;结果 一列:成功、没找到(这个人没有可用的线路,或者要的格式拿不到)、出错、地址不对(订阅地址里的令牌对不上任何用户;同一个 IP 的合成一行并写明次数,次数很多说明有人在扫地址)。可以按用户名搜,点 只看失败 只留没成功的。
  • 核心日志:数据面和面板的运行日志。面板里这份只存在内存里(最多约 1 万条,重启就清);同样的内容也会写进系统日志(journalctl -u m-ui 能看到),清空 只清面板里这一份,系统日志的占用和保留天数在 运维 页限制。记录日志 可以关掉省资源。日志上面那一条里可以按关键字筛(用户名、IP、线路名……只影响眼前这一屏)、选只看哪个级别以上的,打开 自动刷新 就一直盯着最新的。
  • 记录级别:默认 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 update(或进 m-ui 菜单选「更新到最新版」)。它和面板的更新箭头一样,直连 GitHub 不通时会自动经本机的 WARP 再试,所以纯 IPv6 机器(连不上 GitHub)装好 WARP 就能更新。重新执行一键安装脚本也能更新,但脚本不会自己走 WARP:纯 IPv6 机器要先执行 export ALL_PROXY=socks5h://127.0.0.1:40000(端口按 WARP 的设置),或者手动上传安装包。

命令行与 SSH 菜单

面板打不开、忘了密码时,在服务器上执行 m-ui 进管理菜单;不知道卡在哪,先执行 m-ui doctor。

  • 菜单按来意分了组:排查(面板地址 / 账号、一键体检、日志)、服务(重启、停止、启动、更新到最新版)、登录(重置管理员密码、只关闭两步验证、防火墙与黑名单)、设置(修改端口 / 路径 / 监听地址、生成自签证书、重置全部设置)、数据(立即备份、还原备份)、多台(主机 / 副机与副机接入信息、主机容灾 / 设为主机)、卸载。菜单顶上那一行写着服务状态、角色和面板地址。
  • m-ui doctor(菜单里的「一键体检」):面板打不开、节点连不上时先跑它。逐项检查:服务在不在跑、有没有反复重启;面板 / 订阅 / 代理面板的端口是谁在监听(被别的程序占了会点名);面板在本机能不能打开、数据面有没有把线路都监听起来;这台和主机 / 副机多久没联系;证书还有几天到期;域名是不是解析到这台;系统防火墙和黑名单(你现在的 IP 被拉黑了会直接说);磁盘和系统时间。有问题的那一行下面写着怎么处理。只读,不改任何东西;输出里没有密码、令牌和订阅地址,可以整段贴给别人看。
  • m-ui status:一行状态。m-ui logs:看日志(-e 只看报错,-f 实时跟随)。m-ui restart / stop / start。m-ui update:更新到最新版。
  • 菜单里改端口和设置页是同一套校验(三个服务不能撞、不能占线路的端口、不能是别的程序占着的);「防火墙与黑名单」认得出你这次 SSH 是从哪个 IP 连进来的,被拉黑了直接回车就能移出;切成副机后会打印主机「服务器」页要填的 API 地址和令牌;卸载时把 m-ui 自己加的防火墙规则、替自己放行的端口一并收回。
  • m-ui info:打印面板地址、路径和账号状态。
  • m-ui passwd:重置管理员密码(同时关掉两步验证)。
  • m-ui set -db /etc/m-ui/m-ui.db 键=值:直接改设置,比如 webPort=3053。
  • m-ui render:打印并校验当前的 sing-box 配置。
  • 菜单里的「主机容灾 / 设为主机」和 m-ui ha status / takeover / set-master / pause / resume / reset:主机容灾与设为主机(见 命令行)。菜单里的升级、重启会先暂停接任。
  • 数据在 /etc/m-ui/:m-ui.db(数据库)、cert/(证书)、backups/(定时备份)。

防火墙

三件事在同一页:服务器自带的防火墙有没有挡住端口、自己定的放行 / 拉黑规则、面板和订阅的访问黑名单。

系统防火墙

云厂商控制台放行了端口、外面还是连不上,多半是服务器自带的防火墙在拦:ufw、firewalld,或者镜像里带的一份 iptables 规则(Oracle 的 Ubuntu 镜像就是)。

  • 防火墙 页第一张表一行一台服务器:它的系统防火墙是哪一种、在不在拦,m-ui 用到的端口在它那里放行了没有。点端口数展开,看这台用到哪些端口(面板、订阅、每条线路、中转入口)。
  • 在拦的那一行有 放开:ufw 是停用它,firewalld 是停掉服务,iptables 是在最前面加一条全放行(原有规则一条不动)。改之前的规则先备份在数据目录的 fw-backup-时间 里,随时点 撤销放开 恢复原样。放开以后真要挡端口,在云厂商的安全组里设,或者用下面的规则。
  • 不想放开也行:自动放行 m-ui 的端口 默认开着,系统防火墙留着的服务器上,m-ui 会把自己用到的端口在它那里放行,线路增删跟着变;它只增减自己加的,你原来的规则不动。关掉这个开关,它把加过的收回,这些端口由你自己管。
  • 自己手写 nftables 规则的服务器,面板不替你改:那一行会写 要自己放行,请在规则里放行展开后列出的端口。
  • 安装时也会问:全新安装检测到系统防火墙在拦,会问一句要不要放开 —— 直接回车或 y 放开,n 保留;没有终端可问(cloud-init、CI)按放开算。安装命令后面加 --keep-firewall 不问、保留,加 --open-firewall 不问、直接放开。升级不问也不动。
  • 副机的状况是它自己量了报给主机的;版本还没有防火墙功能的副机这一行写 没有上报,升级后就有。

规则

规则在主机上建,下发到选中的服务器,各台自己在系统内核里落实:主机暂时联系不上,副机上的规则照样生效、照样到期。

  • 三种做法:放行端口 —— 系统防火墙开着的服务器上,把这些端口对所有人放行(没开着的用不着);拉黑来源 —— 这些 IP 或网段连不进来,代理流量也一样,可以只挡几个端口;端口只给指定来源 —— 这些端口只让名单里的来源连,别人一律拒绝,比如 SSH 只给自己的 IP。
  • 应用到 可以选全部服务器(以后新加的也算)或其中几台;有效期 可以选一直有效,或者几小时、几天后自动撤掉。行里的开关点了就存:关掉是留着不生效。
  • 拉黑和「只给指定来源」落在 m-ui 自己的一张表里,排在系统防火墙前面,不改它原有的规则;同一个来源既被拉黑、又在某个端口的允许名单里时,以拉黑为准。
  • 不会把你自己关在门外:来源里包含你现在用的 IP 的拉黑规则,或者管到了 SSH、面板端口却没把你现在的 IP 算进去的「只给指定来源」,保存时会先拦下说明后果,确认了才存。
  • 集群里的服务器始终连得上彼此:主机和副机之间的同步、中转入口到出口,走的都是 m-ui 自己的端口,规则在这些端口上永远不挡集群里的服务器;集群里服务器的地址也不让拉黑。
  • 删掉一台服务器时,只管它一台的规则会一起删掉,不会变成「全部服务器」。
  • 哪台服务器上规则没落下去(比如那台没有 nft 也没有 iptables),概览顶部的提醒和 服务器 页那一行都会点出来。

黑白名单与自动拉黑

黑名单只管面板、代理面板、订阅和外部 API 的访问:名单里的来源一连上就被断开。代理流量不受影响,因为同一个出口 IP 后面可能还有正常用户。

  • 自动拉黑 默认是关着的,要自己打开。打开后只针对明显在扫的来源:10 分钟内登录失败 10 次、试了 8 个不同的不存在的订阅地址、或者试了 10 个不同的错 API 密钥,拉黑 1 小时;一天内第 3 次起拉黑 24 小时。都是临时的,到点自动解除。
  • 不会误伤的几类:登录成功过的来源 24 小时内不拉黑;成功拉到过订阅的来源门槛放宽到 5 倍(客户端还存着作废的旧订阅、反复刷新同一个地址只算一个);回环和内网地址、集群里的服务器、白名单里的来源永远不拉黑。
  • 名单里每一条写着原因和多久后解除。移出 立刻解除;更多 里可以 移到白名单(以后不再被自动拉黑),或者 连代理一起挡 —— 给它加一条「拉黑来源」的规则,这才连代理流量也挡住。
  • 手动拉黑 可以填一个 IP 或网段,选有效期;白名单 里放自己的办公网、监控探针这类来源。
  • 自动拉黑了谁会记进操作审计;开着登录告警通知的话,Telegram 也会收到一条。

命令行的退路

面板打不开时(被自己的规则挡住、被拉黑),从服务器的终端或云厂商的控制台进去,用下面这些命令。都要 root。

  • m-ui firewall status:这台的系统防火墙是哪种、在不在拦、放开过没有,面板规则和黑名单各有几条。
  • m-ui firewall pause:这台暂停面板规则(拉黑、只给指定来源都不再生效),立刻见效;到面板里把有问题的规则改掉后,m-ui firewall resume 恢复。暂停期间防火墙页这一台会写 已暂停。
  • m-ui firewall open / m-ui firewall undo:放开系统防火墙 / 撤销,和面板上那两个按钮是同一个动作,哪边做的都能在另一边撤销。
  • m-ui unban 1.2.3.4:把一个来源移出黑名单;m-ui unban --all 清空。30 秒内生效。
  • 管理菜单(直接执行 m-ui)里的「防火墙」一项是同样的几件事。

设置一览

设置 页改了任何一项(开关、输入框都一样),窗口底部会浮出保存条:写着有几处改动,点左边能展开清单,逐项看「原来 → 现在」、也可以单独 撤销 某一项;点 保存 一起生效,点 放弃 全部还原。没保存就离开这一页会先问一句。端口、监听地址和证书改了保存就生效:面板在原地换好监听,浏览器自动跳到新地址,订阅、代理面板也一样;页头的 重启 m-ui 一般用不着(副机的面板端口、证书例外,见下面的问答)。

角色与面板

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

订阅、订阅页与代理面板

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

通知、巡检与数据面

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

外部 API

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

开启与密钥

  1. 管理员 页 → 外部 API:打开卡片右上角的开关(鼠标停上去写着 开启 / 关闭外部 API)。第一次打开会自动生成一把 默认密钥。
  2. 账号 页 → 外部 API:打开卡片右上角的开关。第一次打开会自动生成一把 默认密钥。
  3. 复制 接口地址,再在下面 密钥 列表里点那一把后面的 复制 拿到密钥。
  4. 每个请求带上密钥:请求头 Authorization: Bearer 密钥(或 X-API-Key: 密钥),请求体用 JSON。
  5. 点 接口文档,右侧会滑出全部接口(每个接口需要哪项权限也写着)和 示例(curl);示例里已经填好你的接口地址,右上角可以选填哪一把密钥,整段复制就能跑。没开外部 API 时也能先看文档。
常见坑
  • 密钥只放在服务端程序里,不要写进网页或客户端。泄露了就在列表里点 更多 → 重新生成,旧的立刻失效。
  • 接口只在主服务器上调用;副机上的写操作会被拒绝。
  • 代理的密钥只能动你名下的用户、你自己的套餐和站长授权给你的线路;代理被停用、到期后密钥立刻不能用,被站长重置密码后全部密钥作废,要重新生成。

多把密钥:各自的权限与允许的来源

  1. 所有密钥在一张表里,默认密钥 也在其中,和别的一样能改。点 新建密钥,起个名字(比如「商城」「TG 机器人」),只勾它需要的权限。
  2. 七项权限:查看用户、创建用户、修改用户(改字段、启停、清零用量、踢线、重置订阅链接)、删除用户、续费与换套餐、查看套餐、面板信息(概况、服务器、线路、在线用户)。没勾的接口调了返回 403,并写明缺哪项。编辑框里有 全选 和 只读 两个快捷选法。
  3. 允许的来源:每把密钥单独设,默认 不限;选 只允许指定的 IP 后一行填一个 IP 或网段(IPv4 / IPv6 都行),名单外的来源用这把密钥一律 403。编辑框里会显示你当前的 IP,点 加进去 就行。
  4. 每一行右边的开关可以单独停用 / 启用这一把;编辑 里改名字、权限和来源;更多 里有 重新生成(旧的立刻失效)和 删除。列表里能看到每把最近一次是什么时候、从哪个 IP 用的。总开关关着时所有密钥都不能用。
推荐商城用一把「查看用户 + 创建用户 + 续费与换套餐 + 查看套餐」,Telegram 机器人用一把只读的「查看用户 + 面板信息」;商城服务器 IP 固定的话,顺手把那一把限成只允许它的 IP。
常见坑
  • 面板挂在反向代理(Nginx、Caddy 等)后面时,先在 设置 → 面板 填「受信任的反向代理」,来源限制才认得出真实来源;不然所有请求的来源都是反代自己。
  • 从旧版升级上来:原来那一把令牌就是现在的 默认密钥,不用改对接程序;原来「整个面板一份」的来源 IP 白名单会自动抄到每把已有的密钥上,之后各改各的。
  • 密钥只在主服务器上生效;开了主机容灾的,备用接任以后照常可用。

常用接口

路径都接在接口地址后面;{name} 可以是用户名,也可以是用户 id。

接口做什么
GET /ping连通性与版本
GET /plans套餐列表
GET /users用户列表:?q= 搜索,?state=expiring&days=3 取 3 天内到期的(还有 expired 已到期、exhausted 流量用完、disabled 停用),?planId=、?online=true,?limit= / ?offset= 分页(总数在响应头 X-Total-Count)
POST /users建号,可以带 plan 直接套用套餐。名字可以不给(自动起成「前缀-随机」,前缀用 prefix 指定);带 requestId(比如订单号)重试不会多建一个
POST /users/batch一次建一批(count 1–100),名字自动起,做卡密、批量发号用
POST /users/lookup按订阅地址找到是哪个用户(请求体 {"sub": "订阅地址"}):用户把自己的订阅地址发给机器人,机器人就知道他是谁。别人分享给他的临时共享地址不认
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}删除用户
GET /overview面板概况:用户数、在线、今天 / 本月 / 累计流量。代理的密钥另有 reseller:自己的额度还剩多少、此刻还能不能建号(canCreate),商城收款前先看一眼

先预览、防重复、降级确认

续费和换套餐会动用户的钱和时间,接口提供了三道保险。

  • 预览:请求里带 "dryRun": true 只计算不执行,返回变更前后的对比,商城可以拿来报价。
  • 防重复(幂等):带 requestId(或请求头 Idempotency-Key,比如用订单号),同一个编号重试只执行一次,不会重复加时。建号也认:同一个编号只建一个用户,重试拿回的是第一次建的那个。
  • 降级确认:换套餐会让用户马上超量、或到期提前时,接口返回 409 和完整预览,确认后带 "force": true 再调一次才执行。
  • 面板的 接口文档 里标着 幂等、可预览 的接口支持这些。
  • 续费、换套餐是明确的开通动作:被手动停用的用户也会被启用,要先停掉的人别拿去续费。

安全

改掉默认密码、打开两步验证、藏好面板地址,就挡住了绝大多数风险。

账号与两步验证

  • 改密码、改用户名:管理员 页的 登录账号 卡片点 修改用户名 / 密码。卡片上还写着上次登录的时间和来源 IP。
  • 改密码:账号 页的 登录密码 卡片点 修改密码。
  • 两步验证(2FA):点 开启两步验证,用认证器 App(Google Authenticator、Microsoft Authenticator、Authy、1Password 等)扫弹框里的二维码,填 App 上的 6 位码,点 验证并开启。开启后登录要密码 + 6 位码。弹框中途关掉也不要紧,卡片上点 继续 接着扫同一个码。
  • 手机丢了进不去:SSH 执行 m-ui,选「只关闭两步验证」;「重置管理员密码」也会一起关掉。
  • 手机丢了或忘了密码:找站长在主面板重置密码(两步验证会一起清掉)。

面板地址与端口

  • 把默认的端口和路径改掉:设置 → 面板 → 端口 / 路径。只打开 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 下载一次空文件设置 → 面板 → 关掉 功德箱与在线设备数
GitHub、jsDelivr、登记服务(reward.godusevpn.org)流量奖励:打开活动页时读公开账本(最多十分钟一次);登记了领取地址之后,每半小时向登记服务上报一次累计流量;提交留名捐赠、等它到账时也连登记服务。没登记地址、也没提交过留名捐赠的面板只读账本,不连登记服务设置 → 流量奖励 → 关掉 参加流量奖励计划
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:菜单顶上那一行就是完整的面板地址。
面板打不开、节点连不上,不知道卡在哪?
SSH 执行 m-ui doctor:它逐项检查服务、端口、证书、域名解析、防火墙和黑名单,有问题的那一行下面写着怎么处理(见 命令行与 SSH 菜单)。都正常、外面还是连不上,多半是云厂商的安全组没放行端口。
忘记密码 / 手机丢了进不去?
SSH 执行 m-ui:选「重置管理员密码」(同时关闭两步验证),或者「只关闭两步验证」。
改了端口、监听地址、证书,页面没跳过去?
主面板保存后一两秒就在原地换好监听,浏览器等新地址能连上就跳过去。一直跳不过去,多半是防火墙(安全组)没放行新端口、证书不受信任,或者域名还没指向这台,页面上会给出新地址可以直接点。副机的面板端口、证书改了不会自动换(主机连它用的就是这个地址):先到主机服务器页改好 API 地址,再在副机设置页页头点 重启 m-ui,或 SSH 执行 m-ui restart。改路径保存就生效。
副机显示离线?
看服务器页写的原因,对照 离线排查。用自签证书的副机要打开 跳过证书校验;重签过副机证书要在 更多 里点 重置指纹。
证书续期失败?
看证书库 自动续期 一列的原因: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 的家宽测点不多,凑不齐三家运营商各几个,所以分运营商的结论只对 IPv4 下。IPv6 另有「IPv6 入站」一项:先用大陆有 IPv6 的测点,连不上再用境外测点分清是入站没放行还是大陆方向不通;这次没有大陆的 IPv6 测点时只用境外测点,并写明大陆方向没测到。见 大陆连通检测。

流量奖励计划

线路上每跑满 1 TB 真实流量得 1 积分。到 m-ui 一周年(2027-09-03),奖池按各地址的积分比例,以 USDT 发到登记的 Solana 地址。入口是顶栏那枚硬币。

积分怎么算

  • 只算线路上的真实流量:上行加下行的原始字节,不乘服务器倍率;服务器上别的流量不算。有副机的,各台的流量随用量汇到主机,在主机上累计;主机容灾接任、换机、还原备份之后接着原来的数往上累计,不断也不重。
  • 顶栏的硬币就是进度:一开始是灰的,流量越多,金色从币底往上灌得越满;灌满 1 TB 得 1 积分,硬币回到灰色重新灌,角上的数字是已有的积分。
  • 点硬币打开活动页:上面是当前奖池、1 积分大约值多少、离发放还有多久;中间一条是 我的积分、真实流量和下一个积分的进度。
  • 刚装好、以及每满 1 TB 时,概览页的硬币旁边会冒一句提醒;点 以后再说 收起,到下一个 1 TB 之前不再冒。

登记领取地址

  • 不登记也照常累计,只是不上报,也就没有积分入账。在活动页点 绑定 Solana 地址,填地址,点 登记;之前在本机累计的流量一并登记。
  • 发放时就打到这个地址,填错无法追回。请填自己钱包的地址,不要填交易所的充值地址。
  • 换地址点地址旁边的 更换。换一次之后 7 天内不能再换;换之前的流量和积分留在原地址,之后新增的才算到新地址。
  • 几台面板可以登记同一个地址,积分合在一起算。

入账

  • 登记之后面板每半小时上报一次累计流量。每个地址每天最多入账 1 积分,而且当天要有它名下的面板在上报;挣到的比入账的多,多出来的顺延到后面的日子,不作废。活动页上会分开写已入账几个、待入账几个。
  • 入账的积分记在 m-ui 仓库的公开账本里:活动页 积分榜 右上角的 公开账本 就是它。榜上能按地址查,自己那一行钉在最上面。

奖池与捐赠

  • 奖池 = godusevpn 节点订阅每一笔已发放的订单金额 × 40% + 留名捐赠(全额)。到账之后又退款的订单不算:那一笔留在明细里标着 已撤销;付款金额和订单对不上、订阅站核对到账后确认的订单标着 人工确认,按实际到账的金额算。奖池明细 最上面就是这两项各是多少、加起来等于当前奖池;下面是逐笔入账:每一笔的金额、链、付款地址,都能点开到区块浏览器上核对。
  • 想给奖池添一笔:点 捐赠奖池,填留名和金额,点 下一步。页面给出一个带零头的金额和 60 分钟的倒计时,把这个数(小数一位都不能差)转到页面上的地址(Solana 链的 USDT),到账后计入奖池,名字自动出现在 捐赠榜 和逐笔入账里。
  • 只有这样捐的才计入奖池。奖池的地址上还有订单付款和别的资金流动,没先留名就直接转进去的钱对不上号,不算捐赠 —— 所以地址只在留名之后才给出。过了 60 分钟才到的也对不上号:请在倒计时内转完,来不及就重新提交一次、按新给的金额转。点了 不捐了 之后,钱要是还是在期限内按那个数转到了,照样算数、照样记名。
  • 给项目的打赏(功德箱)是另一回事,不进奖池。

剔除与恢复

作弊由系统按固定的规则自动识别,没有人工环节。判的是面板,不是地址:别人把你的地址填到他的面板上去作弊,被剔除的是他那台,你自己的照常算。

  • 一处来源只认一个地址。来源指服务器的公网 IPv4 地址(没有 IPv4 的机器按 IPv6 的 /48 算)。同一处来源上先上报的那个地址算数,后到的面板会被剔除。几户人共用一个出口地址的机器(NAT 机)上,只有最先登记的那个地址算。
  • 同一份流量只能登记一次:两台面板连续 7 天每天涨的流量都一样,后登记的那台剔除。
  • 每天涨的流量一模一样、连续 14 天的,剔除:真流量每天都不一样。
  • 被剔除期间,这台面板的流量不计入积分;活动页会写明原因。原因消失后连续 14 天没有再出现,自动恢复,剔除期间的流量不补记。靠造假入账的积分会作废。
  • 一个地址名下的面板全都被剔除着,积分榜上这个地址会标上 已剔除 并写明原因,这期间不参加分配;恢复之后照旧。

会上传什么、怎么关

  • 没登记地址:什么都不上传。打开活动页时面板只读一份公开账本(在 GitHub 上),不带任何标识。
  • 登记之后:只上报这台面板的一个随机标识、你填的地址、累计流量(取整到 GB)和时间。不上传域名、用户、线路或任何用户数据。
  • 登记服务会看到这台服务器的公网 IP(连任何服务都一样)。它只留一个加盐的哈希,用来判断「一处来源只认一个地址」;不留 IP 本身,也不公开。
  • 公开账本里只有地址、积分和名下的面板数;逐笔入账里是链上本来就公开的交易。
  • 不想参加:设置 → 流量奖励 → 关掉 参加流量奖励计划。关掉后硬币不显示,也不再为它联网;本机照常累计,重新打开不丢。

建议与支持 · 功德箱

面板右上角的 建议 / 支持:找作者、报问题、支持这个项目。

反馈问题

  • 页面里有作者的 Telegram、文档、报告 Bug 和讨论区的入口。报问题时带上版本号(页面上点一下就能复制)。
  • 日志里的令牌、UUID、订阅地址先打码再发。