WuKongIM Docs

Manager 管理后台

跟着三张实图登录、检查节点和查看任务,按需展开权限与管理操作。

编辑此页报告文档问题

Manager 用来查看集群、任务和备份,并执行管理操作。先用只读账号完成这三步。

1. 登录管理账号

本机默认访问 http://127.0.0.1:5301。远程访问按 Linux 部署建立 SSH 转发,或走管理内网 / VPN 的 HTTPS 代理。账号来自 manager.users。

中文 Manager 登录表单,使用 docs-reader 测试账号,密码保持遮罩

① 输入配置中的管理账号和密码。② 点击「登录」。图中为隔离集群的只读测试账号。

认证与传输保护都要开启

生产环境开启 manager.auth_on,替换默认账号密码和 manager.jwt_secret;节点 5301 不向公网开放。manager.auth_on=false 不是只读模式,SSH / VPN / HTTPS 也不替代账号权限。

2. 检查节点

打开「节点」,先看存活数,再看健康栏中的就绪状态和数据新鲜度。状态过期时先刷新、排查,暂停管理操作。

中文 Manager 节点列表:单节点集群存活 1 个节点,节点健康栏显示就绪和新鲜数据

① 存活节点数。② 节点健康与就绪状态。这是本地单节点集群示例,多节点集群逐台检查。

3. 查看任务

打开「任务中心」,核对运行中、失败和已完成的任务。需要排查时,用类型、状态或 Slot ID 筛选,再查看任务时间线。

中文 Manager 任务中心:运行中 0、失败 0、已完成 8 个初始化任务

① 运行中。② 失败。③ 留存历史中的已完成任务。数量随集群运行变化,不是固定验收值。

其他页面看什么

页面重点
实时监控CPU、内存、磁盘、连接与队列;先确认遥测数据可用
槽位 / Slot逻辑 Slot 的 Leader、副本、ISR 与哈希槽范围
频道集群 / Channel消息运行单元的成员、Leader 和积压
备份存储测试、归档完整性和验证结果

Slot 列表展示逻辑 Slot,数量由 initial_slot_count 初始化;默认 256 个 Hash Slot 是另一层固定键空间。本例的 8 个逻辑 Slot 各承载 32 个 Hash Slot,详见 Slot 与 Hash Slot。

账号权限与访问链路
工作常用权限
查看节点和扩缩容状态cluster.node:r
加入、激活、排空或移除节点cluster.node:w
查看或操作 Slotcluster.slot:r / cluster.slot:w
查看或修改备份cluster.backup:r / cluster.backup:w
执行恢复单独授予 cluster.restore:w

分开只读查看、节点管理、备份管理和数据恢复权限,避免长期使用全量权限。

Manager 只监听回环或管理内网。代理到节点也保持在受控内网,防火墙仅允许管理代理和授权运维来源。

需要执行管理操作时
  1. 记录操作者、目标、当前状态和预期结果。
  2. 确认 /readyz 正常,且没有冲突的未结束任务。
  3. 先运行页面提供的计划或预览,阅读阻塞原因。
  4. 一次执行一步,等待任务结束后刷新权威状态。
  5. 验证消息发送、接收和重连,再继续。

Leader 是当前负责处理数据的节点,副本是数据副本,ISR 是跟得上进度的副本集合。刚开始运维时先检查状态,避免手工调整。

缩容与恢复

缩容只有在权威状态显示 safe_to_remove=true 后才能移除节点。恢复需要完整验证、密码重新认证和确认短语。状态缺失、过期或矛盾时停止。

Manager 管理 WuKongIM 集群;云主机关闭、Kubernetes 实例数量和启动配置更新需分别处理。继续阅读健康检查与监控。

本页内容