Skip to content

控制面板 ​

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 使用会访问网络,必须按不可信输入处理。

相关 ​

页面历史

开发者设计、代码地图和验证记录保留在仓库 manual/。