> 文档：[https://3m-ui.top/docs/](https://3m-ui.top/docs/) · 官网：[https://3m-ui.top/](https://3m-ui.top/)
---
## 特性
| 类别 | 能力 |
|------|------|
| **节点** | 协议注册表驱动的 Listener：VLESS / VMess / Trojan / Shadowsocks / Hysteria2 / TUIC / AnyTLS / Snell / ShadowQUIC 等；Reality、TLS 自签、一键批量证书、**流量倍率**、传输层字段互斥校验 |
| **用户** | **一键创建**（随机用户名/密码/UUID，可选绑定全部节点）、绑定节点、流量限额、**按节点分别计量**（计费 = 实际 × 节点倍率）、到期、IP/订阅拉取限制、首次使用起算、周期续期/重置、分组标签、外部订阅合并、批量操作、订阅 Token |
| **订阅** | UA 自动识别 Clash/Mihomo YAML、v2ray Base64（`?target=v2ray` 始终 Base64）、sing-box JSON；可选 `?target=`；HTML 订阅页；TUIC/HY2 分享链含 SNI/`allow_insecure` 等客户端参数 |
| **配置** | 生成 → 校验 → 应用 分离；失败回滚上一份 `config.yaml` |
| **Telegram** | 告警与管理命令（需 Token + Chat ID） |
| **多机** | 登记远程面板、健康检查、同步节点镜像、合并订阅；**按名称选择本机节点推送**到远程（默认禁用，可改名/端口） |
| **安全** | JWT、首登改密、TOTP 两步验证、可选 **GitHub OAuth**、web_path 路径前缀、凭据加密、CORS |
| **运维** | 核心启停/更新、Geo、面板 SSL/ACME（含 DNS-01 通配符）、备份、**Cloudflare WARP** 一键注册（WireGuard/MASQUE YAML） |
### 补充说明（用户限制 / 证书 / 订阅）
- [用户限制：IP · 订阅拉取](https://3m-ui.top/guide/users-limits)
- [按节点流量与倍率](https://3m-ui.top/guide/node-traffic)
- [面板 SSL / ACME（HTTP-01、DNS-01 通配符）](https://3m-ui.top/guide/ssl-cert)
- [批量应用节点证书](https://3m-ui.top/guide/batch-certificate)
- [订阅格式与 target](https://3m-ui.top/guide/subscription-formats)
- [多机节点 / 推送](https://3m-ui.top/guide/cluster)
- [路由（客户端订阅 + 服务端出站）](https://3m-ui.top/guide/routing)
- [Cloudflare WARP](https://3m-ui.top/guide/warp)
前端：**React + Ant Design + Lucide Icons**（`frontend/`），构建后嵌入单一 Go 二进制。
发布产物：**纯静态链接**（`CGO_ENABLED=0` + modernc SQLite），无需系统 `libsqlite3`，兼容 glibc / musl。
完整安装包 / Docker：`linux/amd64` · `arm64`。高级独立面板二进制另外支持 `armv7` · `armv6` · `386` · `riscv64` · `loong64` · `ppc64le` · `s390x`，需要自行准备兼容内核。
---
## 快速安装
```bash
curl -fsSL https://raw.githubusercontent.com/kazeyukiro/3m-ui/main/scripts/install.sh | sudo sh
```
完整安装支持 Linux amd64 / arm64，自动安装面板、配套 Mihomo 和系统服务。首次配置和管理员密码由程序统一生成；配置已存在时保持原值。其他架构可使用独立二进制和自行准备的内核，见 [详细安装说明](https://3m-ui.top/guide/install)。
安装完成后：
```text
面板地址 http://SERVER_IP:8080/
默认账号 admin
初始密码 安装时随机生成并显示一次，首次登录必须修改
管理命令 3m-ui
```
更新：
```bash
# 推荐（已安装后）
sudo 3m-ui update
# 指定版本: sudo 3m-ui update v1.0.6
# 从旧安装脚本迁移时，先重新执行上面的最新安装命令，配置和账号会保留。
```
卸载：
```bash
sudo 3m-ui uninstall
```
### AI 提示词安装
把提示词复制到 ChatGPT / Claude / Cursor 等助手，并说明你的系统（如 Ubuntu 22.04）与是否已有 root SSH。助手应只协助执行官方脚本，不要改写成不明来源命令。完整提示词及使用说明见 [AI 提示词安装文档](docs/ai-install-prompt.md)。
无需手动复制大段文本，用 `curl` 直接把纯文本提示词加载到剪贴板再粘贴：
```bash
curl -fsSL https://raw.githubusercontent.com/kazeyukiro/3m-ui/main/docs/ai-install-prompt.zh.txt | pbcopy # macOS
curl -fsSL https://raw.githubusercontent.com/kazeyukiro/3m-ui/main/docs/ai-install-prompt.zh.txt | xclip -sel clip # Linux X11
curl -fsSL https://raw.githubusercontent.com/kazeyukiro/3m-ui/main/docs/ai-install-prompt.zh.txt | wl-copy # Linux Wayland
```
提示词只引导使用下方官方一键脚本，所有下载均校验 `SHA256SUMS`：
```bash
curl -fsSL https://raw.githubusercontent.com/kazeyukiro/3m-ui/main/scripts/install.sh | sudo sh
```
测试 / 预发布通道（可选，非默认）见 [安装文档](docs/installation.md#ai-提示词安装)。
---
## Docker 安装
Linux VPS 下载发布版本中的 `docker-compose.yml`，在同一目录执行：
```bash
docker compose up -d
docker compose logs 3m-ui
```
镜像为 `ghcr.io/kazeyukiro/3m-ui:latest`，包含面板及固定版本的 Mihomo；`latest` 只跟随稳定版。配置、随机密钥和管理员会自动初始化，首次密码只在首次启动输出一次。默认 host 网络，新增节点后放行实际使用的 TCP/UDP 端口。另提供 `docker-compose.bridge.yml`，以及版本固定、证书配置和持久化恢复说明，见 [安装文档](https://3m-ui.top/guide/install)。
---
## 从源码构建
```bash
# 前端
cd frontend && npm install && npm run build
# 嵌入并编译后端（示例 amd64）
rm -rf backend/cmd/server/web/dist
cp -r frontend/dist backend/cmd/server/web/dist
cd backend
CGO_ENABLED=0 go build -tags sqlite_modernc -trimpath -ldflags='-s -w' -o ../3m-ui ./cmd/server
```
需要本机已安装兼容的 **Mihomo** 二进制，并在配置中指向其路径。
---
## 配置要点
默认数据与配置大致位于：
| 路径 | 用途 |
|------|------|
| `/etc/3m-ui/config.yaml` | 面板配置 |
| `/var/lib/3m-ui/3m-ui.db` | SQLite |
| `/var/lib/3m-ui/listener-certs/` | 节点自签证书（**请与数据库一并备份**） |
| `/var/lib/3m-ui/mihomo/` | Mihomo 工作目录与 `config.yaml` |
JWT / 凭据密钥请使用独立随机值（≥ 32 字节），不要使用文档示例。
自定义面板端口：`3m-ui config port