下一步
根据接入、配置、部署和运维目标选择后续阅读路径。
如果就绪检查成功、两个测试 UID 都已连接,并且能够双向收发消息,你已经完成快速验证。
选择阅读路径
核心概念
理解频道顺序、消息提交、用户、设备、会话、节点和 Slot。
集成指南
划分业务职责,设计认证、消息收发和 Webhook。
场景教程
继续实现单聊、群聊和十万成员群路径。
部署
从拓扑和运行介质开始,完成配置、验证与生产门禁。
选择 SDK
从平台和接入方式出发,进入安装、能力、API 与升级学习路径。
API 与协议
查阅已发布接口、客户端协议核心和公共字典。
服务端参考
按需查阅配置、运维、工具和架构。
常见问题
单节点集群是不是独立模式?
不是。它是只有一个节点的集群,仍使用 Controller、Slot、Channel、路由和持久化路径。
可以把示例配置直接用于生产吗?
不可以。至少需要替换固定凭据,规划 TLS 和访问控制,把数据放在受管理的持久化存储上,并按真实负载验证容量、故障恢复和尾延迟。
为什么重启后还能看到数据?
Linux 软件包把节点数据保存在 /var/lib/wukongim。停止 systemd 服务不会删除这个目录。
如何修改端口?
修改 /etc/wukongim/wukongim.toml,执行 sudo wukongim config validate --config /etc/wukongim/wukongim.toml,再运行 sudo systemctl restart wukongim。
为什么生产客户端不能调用 /user/token?
这是演示身份接口。生产 Token 必须由受信任的业务后端在完成真实身份和权限校验后签发或更新。
三节点环境在哪里?
仓库根目录的 docker-compose.yml 提供三节点开发环境。它会暴露开发凭据和 Benchmark 能力,同样不能作为生产模板。