控制台功能索引

控制台（/console/）是开发者与运营的日常操作入口：创建应用、管理用户/群组/聊天室、追踪消息与连接、处置封禁、处理内容审核、配置回调/推送/限流/告警，以及把只读视图嵌入客户后台。本组文档按 31 个模块拆分，每页给出概念、前置条件、操作步骤、真实 Admin API 参数表、可执行 curl、常见问题与相关链接。

概念​

• 控制台是纯静态 SPA（console/），所有数据来自 /api/admin/**；页面本身不持有业务状态。
• 鉴权有两种：根密钥 X-Admin-Secret，或子账号 X-Admin-Account + X-Admin-Token（RBAC，viewer 只读）。
• 应用级隔离：除 /api/admin/apps、/api/admin/accounts、/api/admin/stats*、/api/admin/api-metadata 外，接口都以 /api/admin/apps/{appkey}/… 开头。
• 写操作会记录操作日志；封禁、解散群、销毁聊天室等动作不可逆或需要二次确认。
• 自托管版没有购买/计费/套餐/发票流程；「服务开通」「配额」都只是配置，不是订单。

前置条件​

• 服务端已启动，curl -sS http://127.0.0.1:8080/health 返回 {"ok":true}。
• 浏览器可访问控制台；或直接用 curl 调 Admin API。
• 持有 IM_ADMIN_SECRET（未设置时为 dev-admin）。

步骤​

1. 打开控制台并填入密钥

   访问 http://127.0.0.1:8080/console/，在右上角密钥框填入 Admin Secret；密钥保存在本机 localStorage，不会上传到第三方。

2. 创建/选择应用

   首次使用先在「应用与密钥」创建应用（AppKey 1-64 字符）；创建响应里的 appSecret 只出现一次。

3. 进入模块页

   顶部 tab 切换模块；31 个模块的详细操作、参数与 curl 见上表对应文档页。没有独立 tab 的模块（如文件与图片、版本与发布）会在页面内说明入口。

4. 验证接口连通

   curl -sS -X GET "http://127.0.0.1:8080/api/admin/apps" \ -H 'X-Admin-Secret: dev-admin'

参数表​

示例​

列出应用（含软删除）​

curl -sS -X GET "http://127.0.0.1:8080/api/admin/apps" \
  -H 'X-Admin-Secret: dev-admin'

# 含已软删除应用
curl -sS -X GET "http://127.0.0.1:8080/api/admin/apps?includeDeleted=1" \
  -H 'X-Admin-Secret: dev-admin'

全局统计​

curl -sS -X GET "http://127.0.0.1:8080/api/admin/stats" \
  -H 'X-Admin-Secret: dev-admin'

curl -sS -X GET "http://127.0.0.1:8080/api/admin/stats/trend?days=7" \
  -H 'X-Admin-Secret: dev-admin'

常见问题​

控制台一直提示 401​

密钥与服务端 IM_ADMIN_SECRET 不一致；清掉 localStorage 中的 im.admin.secret 后重新输入。

应用列表为空​

服务端刚启动且数据目录为空；先在「应用与密钥」创建应用，或确认 IM_DATA_DIR 指向了正确的历史数据目录。

切应用后页面数据没变​

切换应用只改变后续请求的 {appkey}，已渲染页面需要刷新或重新进入 tab。

viewer 账号点按钮报 403​

RBAC 下 viewer 只读；写操作需要 operator/admin/owner 角色（或直接用根密钥）。

为什么没有“购买/升级套餐”入口？​

自托管版没有计费与套餐；能力由「服务开通」「功能配置」「配额」控制，不产生费用。

文档里的路径都能直接调吗？​

能。每页参数表都来自冻结的 Admin API 契约与运行时路由；标注“未实现”的能力不会给出假端点。

相关链接​

• 控制台指南
• 运营后台指南
• 概览仪表盘
• 控制台嵌入客户后台
• 内容审核指南
• 超级群场景指南
• 问题排查手册
• 功能与套餐开通对照表
• OpenAPI 与 Postman 调试