控制面板
mayami 提供 mihomo/Clash 兼容的控制 API,供 zashboard、metacubexd 和 mayami api 使用。面板是查看连接、切换模式/组、检查延迟和管理配置的入口,不替代配置文件本身。
完整配置
yaml
api:
listen: 127.0.0.1:9090
secret: change-me
ui: ui
ui_name: metacubexd
cors:
allow_origins: ["*"]
allow_private_network: true
outbounds:
direct:
type: direct
route:
final: direct
dns:
servers:
real: {type: udp, address: 1.1.1.1:53}
final: real字段见 api。
启动与访问
sh
mayami api status
mayami api connections
mayami api reload浏览器访问控制器的 /ui/;面板文件不存在时可按 ui_url 下载到数据目录。Unix socket 不要求 Bearer secret,TCP/HTTP 入口仍应设置 secret 并限制来源。
常用操作
- 查看实时连接、累计上下行和内存。
- 切换 Clash 模式、selector 成员和组延迟。
PATCH /configs/mayami api reload触发配置重读。- 清空 DNS/FakeIP 缓存和查看 provider 状态。
安全
默认只监听 127.0.0.1。暴露到网络时至少使用 secret、来源防火墙或 TLS;面板本身不提供多用户权限隔离。ui 下载与 API 使用会访问网络,必须按不可信输入处理。