---
url: /manual/dashboard.md
description: 打开 Clash 兼容控制 API、面板和运行中管理入口
---

# 控制面板

mayami 提供 mihomo/Clash 兼容的控制 API，供 zashboard、metacubexd 和 `mayami api` 使用。面板是查看连接、切换模式/组、检查延迟和管理配置的入口，不替代配置文件本身。

## 完整配置

```yaml check
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](/configuration/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 使用会访问网络，必须按不可信输入处理。

## 相关

* [api](/configuration/api)
* [mode](/configuration/mode)
* [持久化](/manual/persistence)
* [TLS](/manual/tls)