Maintenance.zh_CN

English | 简体中文

管理命令

Linux 安装器将管理脚本放在 /usr/local/bin/m-ui。

m-ui                     打开交互式管理菜单
m-ui start               启动服务
m-ui stop                停止服务
m-ui restart             重启服务
m-ui status              查看服务状态
m-ui logs                查看近期日志
m-ui settings            打印 CLI 设置
m-ui configure           交互修改面板端口、路径和凭据
m-ui set-port PORT       修改面板端口
m-ui update              下载并安装最新 m-ui Release
m-ui update-menu         更新管理脚本
m-ui ssl                 打开 TLS 证书管理菜单
m-ui reset-credentials   设置或生成新凭据
m-ui reset-path          生成新的面板路径
m-ui clear-logs          清理 journal/OpenRC 日志
m-ui enable              启用开机自启
m-ui disable             关闭开机自启
m-ui uninstall           删除服务并选择是否删除数据
m-ui version             打印 m-ui 内嵌版本号

systemd

systemctl status m-ui
journalctl -u m-ui -e --no-pager
systemctl restart m-ui

服务默认以 /usr/local/m-ui 为工作目录，启动 /usr/local/m-ui/m-ui，失败后自动重启，并使用严格的 umask。

OpenRC

rc-service m-ui status
rc-service m-ui restart
tail -n 200 /var/log/m-ui.log

Mihomo 核心生命周期

面板和 Mihomo 是两个独立进程。使用仪表盘或核心操作启动、停止和重启 Mihomo。重启 m-ui 会重建面板监听器，但不会自动加载修改后的核心配置。

Mihomo 启动失败时：

1. 打开面板日志。
2. 点击 Test Current Config。
3. 检查生成的原始 YAML。
4. 确认核心路径可执行，并且全部端口没有冲突。
5. 修正后重启 Mihomo。

备份

使用仪表盘的备份功能下载包含面板状态和生成配置的 ZIP。备份可能包含 Client 凭据、UUID、密码、WARP 账户数据和证书相关设置，必须作为敏感文件保存。

备份特意不包含 multi-control.json。迁移 Peer 节点前请阅读 Multi-control。

恢复时应选择由 m-ui 生成的 ZIP。面板会校验 Settings、Inbounds、Outbounds、Routing Rules、WARP 数据、订阅路径和端口，再替换状态。成功恢复后应按需重启 m-ui 和 Mihomo。

Geofiles

核心维护窗口会更新：

GeoIP.dat
GeoSite.dat
geoip.metadb

m-ui 从 MetaCubeX 官方地址下载，并使用 jsDelivr 作为备用线路；替换文件期间会停止 Mihomo、保留旧文件备份，并在核心原本运行时重新启动。

更新 Mihomo 核心

打开核心版本窗口，选择稳定版本并确认。m-ui 会下载匹配当前架构的产物、校验可执行文件、保存旧核心备份、更新配置的核心路径，并在需要时重启 Mihomo。

面板不会自动选择 prerelease。切换后应使用 Test Current Config 并查看日志。

磁盘占用和日志

面板只在内存中保留 Log Buffer Size 指定的最近日志；Mihomo stdout/stderr 由服务管理器处理。磁盘增长时检查：

du -sh /usr/local/m-ui/data
journalctl --disk-usage

根据服务器策略轮换或压缩 systemd journal。m-ui clear-logs 清理 journal 保留内容或截断 OpenRC 日志文件，不会删除状态、YAML、Geofile 或备份。

安全更新流程

1. 从面板下载备份。
2. 记录当前 m-ui 和 Mihomo 版本。
3. 运行 m-ui update。
4. 检查 m-ui status 和面板日志。
5. 测试配置并重启 Mihomo。
6. 验证一个普通订阅和一个 Clash 订阅。
7. P2P 网络中的所有面板都应升级后再使用新增同步功能。