阅读建议
先确认遇到的具体问题，再按顺序处理；需要安装、订阅或配置细节时，可继续查看相关教程。
先选运行方式
| 方式 | 适合场景 | 注意 |
|---|---|---|
| systemd | 普通 Linux 服务器 | 配置路径和用户权限 |
| Docker | NAS、容器化管理 | 端口映射、网络模式、TUN 权限 |
| 图形客户端 | 桌面 Linux | 优先看客户端教程 |
Docker Compose 示例
services:
mihomo:
image: metacubex/mihomo:latest
container_name: mihomo
restart: unless-stopped
network_mode: host
volumes:
- ./config.yaml:/root/.config/mihomo/config.yaml
- /dev/net/tun:/dev/net/tun
cap_add:
- NET_ADMINNAS 环境镜像名称、权限模型和 TUN 支持可能不同，先看系统是否允许容器访问虚拟网卡。
端口与面板
- mixed-port 负责本地 HTTP/SOCKS 代理。
- external-controller 负责 Dashboard 连接。
- 9090 等控制端口不要裸露公网，必须配置 secret 或限制访问。
日志怎么用
后台运行时不要只看面板状态。先看启动日志是否加载了配置，再看节点连接、DNS 查询和规则命中。配置每改一次，记录改动和结果，方便回滚。