OpenIM的部署涉及多个组件，并支持多种方式，包括源码、Docker和Kubernetes等。这要求在确保不同部署方式之间的兼容性同时，还需有效管理各版本之间的差异。确实，这些都是复杂的问题，涉及到深入的技术细节和精准的系统配置。我们的目标是简化部署流程，同时保持系统的灵活性和稳定性，以适应不同用户的需求。目前3.5版本已经简化了部署流程，而且这个版本会长期维护，欢迎大家使用。
- 环境及组件要求
环境要求
注意事项
详细说明
操作系统
Linux 系统
硬件资源
至少 4G 可用内存
Golang
v1.19 或更高
Docker
v24.0.5 或更高
Git
v2.17.1 或更高
存储组件要求
存储组件
建议版本
MongoDB
v6.0.2 或更高
Redis
v7.0.0 或更高
Zookeeper
v3.8
Kafka
v3.5.1
MySQL
v5.7 或更高
MinIO
最新版本
- 部署 OpenIM Server (IM)
2.1 设置 OPENIM_IP如果服务器有外网IP
export OPENIM_IP="外网IP"如果仅提供内网服务
export OPENIM_IP="内网IP"
复制
2.2 ️ 部署组件 (mongodb/redis/zookeeper/kafka/MinIO等)
git clone https://github.com/OpenIMSDK/open-im-server && cd open-im-server建议切换到release-v3.5及以后的release分支
make init && docker compose up -d
复制
2.3 ️ 编译
make build
复制
2.4 启动/停止/检测启动
make start停止
make stop检测
make check
复制 - 部署 App Server (Chat)
3.1 ️ 部署组件（mysql）返回上一级目录
cd ..克隆仓库 建议切换到release-v1.5及以后的release分支
git clone https://github.com/OpenIMSDK/chat chat && cd chat部署mysql
docker run -d --name mysql2 -p 13306:3306 -p 33306:33060 -v "$(pwd)/components/mysql/data:/var/lib/mysql" -v "/etc/localtime:/etc/localtime" -e MYSQL_ROOT_PASSWORD="openIM123" --restart always mysql:5.7
复制
3.2 ️ 编译
make init
make build
复制
3.3 启动/停止/检测启动
make start停止
make stop检测
make check
复制 - 快速验证
开放端口
IM 端口
TCP 端口
说明
操作
TCP:10001
ws 协议，消息端口，用于客户端 SDK
端口放行
TCP:10002
api 端口，如用户、好友、群组、消息等接口
端口放行
TCP:10005
选择 MinIO 存储时需要（OpenIM 默认使用 MinIO 存储）
端口放行
Chat 端口
TCP 端口
说明
操作
TCP:10008
业务系统，如注册、登录等
端口放行
TCP:10009
管理后台，如统计、封号等
端口放行
PC Web 及管理后台前端资源端口
TCP 端口
说明
操作
TCP:11001
PC Web 前端资源
端口放行
TCP:11002
管理后台前端资源
端口放行
Grafana 端口
TCP 端口
说明
操作
TCP:13000
grafana端口
端口放行
三、验证
PC Web 验证
提示: 在浏览器中输入 http://ip:11001 来访问 PC Web。此 IP 应为服务端 OPENIM_IP，确保浏览器能访问。首次使用请通过手机号注册，验证码默认为 666666。
图：PC Web 接口示例
App 验证
扫描以下二维码或点击 这里 进行下载。
图：App 下载二维码
提示: 双击 OpenIM 后修改 IP 为服务端 OPENIM_IP 再重启 App。请确保开放相关端口，并在修改后重启 App。首次使用请先通过手机号注册，验证码默认为 666666。
图：服务器地址修改 - 步骤 1
图：服务器地址修改 - 步骤 2
管理后台验证
在浏览器中输入 http://ip:11002 来访问管理后台。此 IP 应为服务端 OPENIM_IP，确保您的浏览器能访问。默认账号和密码均为 chatAdmin。
图：管理后台界面
- 配置项修改
5.1 ️ 共用配置项的修改
配置项
需要修改的文件
操作
mongo/kafka/minio 相关
.env, openim-server/config/config.yaml
需重启组件和 IM
redis/zookeeper 相关
.env, openim-server/config/config.yaml, chat/config/config.yaml
需重启组件、IM 和 Chat
SECRET
openim-server/config/config.yaml, chat/config/config.yaml
需重启 IM 和 Chat
5.2 特殊配置项的修改
特殊配置项: API_OPENIM_PORT/MINIO_PORT/OPENIM_IP/GRAFANA_PORT
修改 .env 文件中的特殊配置项
在 openim-server/config/config.yaml 中按照规则修改配置
在 chat/config/config.yaml 中按照规则修改配置
重启 IM 和 Chat
5.3 ️ 其他配置项的修改
对于 .env、chat/config/config.yaml 和 openim-server/config/config.yaml 中的其他配置项，可以单独修改相应文件中的这些配置项。
5.4 端口的修改
特别注意，对于IM相关任何端口的修改，都需要同步修改 open-im-server/scripts/install/environment.sh 中的端口。
- 常见问题
6.1 日志查看
运行时日志：logs/OpenIM.log.all.
启动日志：output/logs/openim.log
6.2 启动顺序
启动顺序如下：
IM 依赖的组件：mongo/redis/kafka/zookeeper/minio等
IM
Chat 依赖的组件：mysql
Chat
6.3 Docker 版本
新版 Docker 已经整合了 docker-compose.
老版本的 Docker 可能不支持 gateway 功能。建议升级到较新的版本，如 23.0.1。
- 关于OpenIM
得益于广泛的开发者支持，OpenIM在开源即时通讯（IM）领域保持着领先地位，在Github上的星标数量已经超过12,000。在当前对数据和隐私安全日益重视的背景下，IM私有部署的需求不断增长，这与中国软件产业的快速发展趋势相契合。特别是在政府和企业领域，随着信息技术的飞速发展和创新产业的广泛应用，对IM解决方案的需求急剧上升。进一步来看，协同办公软件市场的持续扩张使得“安全可控”成为了一个关键属性。
仓库地址：https://github.com/openimsdk
