3m-ui 的节点实际对应 Mihomo Listener。完整流程是“核心运行 → 创建 Listener → 用户绑定 → 导出订阅”。页面显示保存成功之后，还要确认核心已经成功应用配置，才能判断节点是否可用。
资料核对：2026 年 9 月 30 日。下方配图为科学之家绘制的操作流程示意，具体菜单以所用版本为准。
01 · 准备与填写约定
准备一台具有管理员权限、能够访问项目发布源的 Linux 服务器，以及支持所选协议的客户端。记录公网地址和已占用端口；已有服务的主机先做快照。文中的 SERVER_IP、USER、示例密码和证书路径必须换成自己的值。
先确定一个测试目标：只创建一个入站或用户，导入一台客户端并验证。这能让安装、账号和连接三个阶段的问题分别定位。
02 · 安装与首次进入
在目标 Linux 服务器的 SSH 终端操作。先下载并查看官方脚本，再执行安装；安装命令不在日常使用的电脑上运行。
curl -fL https://raw.githubusercontent.com/kazeyukiro/3m-ui/main/scripts/install.sh -o 3m-ui-install.sh
less 3m-ui-install.sh
sudo bash 3m-ui-install.sh默认管理入口为服务器的 8080 端口，账号通常为 admin，安装输出一次性随机密码。按实际输出登录并完成首次改密；运行 sudo 3m-ui 可以打开管理菜单。
03 · 建立第一条可用连接
- 进入“核心管理”，检查 Mihomo 路径与状态。核心未运行时先看日志，不急于批量新建节点。
- 在“节点管理”使用新建或快速创建，先建立一个 Shadowsocks Listener；确认名称、协议、监听地址和端口。选择客户端支持的算法并使用生成的凭据。
- 如服务器有 NAT 或内部监听地址，填写 Public Host / Public Port 为外部可访问地址；本机监听端口与 NAT 外部映射要分别核对。
- 在“用户管理”新建用户，绑定刚才的 Listener，设置配额与到期时间。等待后台配置应用完成，再打开用户分享入口选择 Mihomo / Clash 订阅。
04 · 看图核对连接信息
| 设置或现象 | 填写方法与检查方向 |
|---|---|
| Listener | 服务器上的入站监听，必须实际启用。 |
| Public Host / Port | 写进分享链接的对外信息，不一定等于本机监听地址。 |
| 用户绑定 | 订阅只应包含该用户被允许使用的节点。 |
| 生成 / 校验 / 应用 | 配置预览不代表上线；确认应用成功和核心运行状态。 |
05 · 导入客户端并验证
将用户的 Mihomo / Clash 订阅导入 Clash Verge Rev 等兼容客户端，更新后选择刚建立的节点。逐项核对外部地址、端口与协议，再测试请求。需要 sing-box 客户端时，从同一用户分享入口选择相应 JSON 格式。
- 确认客户端拿到了节点，而不是网页、管理地址或错误提示。
- 重新建立连接，查看一次真实请求的结果；单独显示“已连接”不能替代访问测试。
- 对照同一时段的客户端日志和服务端日志 / 用量，确认测试用的是新配置。
06 · 常见问题
| 设置或现象 | 填写方法与检查方向 |
|---|---|
| 保存成功但连不上 | 保存先更新面板记录，核心应用可能稍后失败。看运行日志与配置校验结果，再决定是否修改。 |
| 订阅为空 | 检查用户是否绑定 Listener、节点是否启用以及用户状态是否正常。 |
| TLS 节点要求忽略证书 | 官方文档说明未提供证书时可能生成自签材料。长期使用应配置匹配域名的受信任证书；不要把关闭校验当作通用修复。 |
07 · 备份与后续维护
在“系统设置 → 安全与备份”下载备份，同时保留 /etc/3m-ui 和 /var/lib/3m-ui，包括 listener-certs 证书目录。仅恢复数据库可能丢失证书身份。恢复后重启服务，检查核心与用户连接。
每次只调整一类设置，并保留可恢复的旧配置。改端口、凭据或域名后重新生成分享信息；客户端也需要同步更新。
08 · 官方资料与下一步
文字与流程图由科学之家整理制作；安装来源和协议字段参见上述官方资料。本文未附带任何服务商套餐或推广链接。
