WuKongIM Docs

环境准备

准备 Docker、浏览器和本机端口,开始第一次消息体验。

编辑此页报告文档问题

在自己的电脑体验

  • 安装并启动 Docker;macOS、Windows 可使用 Docker Desktop。
  • 准备浏览器,能够打开两个独立会话。
  • 本机 5001、5100、5200、5301 端口未被其他程序占用。
docker version

输出中应同时包含 Client 和 Server。下一步:用 Docker 启动单节点集群。

端口用途

端口用途
5001HTTP API、就绪检查和 Chat Demo
5100客户端 TCP
5200客户端 WebSocket
5301Manager
7001节点内部通信,不需要映射到宿主机

API 和 Manager 的示例端口仅绑定本机。体验无需向公网开放管理端口;远程服务器使用 Docker 部署页中的 SSH 转发。

不使用 Docker:准备 Linux 主机

Linux 软件包支持 amd64 / x86_64,系统为 Ubuntu 24.04、Debian 13、Rocky Linux 9、AlmaLinux 9 或 RHEL 9。需要 sudo、curl,能够访问 packages.githubim.com;远程主机需要 SSH。

uname -m
. /etc/os-release && echo "$PRETTY_NAME"
curl --version
sudo -v

软件包创建 /etc/wukongim、/var/lib/wukongim 和 /var/log/wukongim。准备完成后,进入Linux 安装路径。

本页内容