服务器部署
服务器提供IM服务社区版和Demo应用服务软件。社区版是IM通讯服务器,负责发送消息等IM业务;Demo服务是模拟客户的应用服务,提供登录等功能。
1. 环境需求
系统要求
Windows/Linux/MacOS都可以,需要网络环境。如果没有公网IP,也可以在局域网内体验。需要开通
1883
、80
和8888
端口。- 软件要求 JRE:1.8 MySQL:5.7.27
2. 野火IM服务器的部署
2.0.1. 配置修改
IM服务社区版软件下载 (点这儿去下载编译好的软件包,如果想自行编译的话,请用git clone整个仓库下来,别打包下载zip压缩包,压缩包会编译错误!源码下载后不能直接运行,需要编译,编译方法参考源码中的README.md
,编译完成后按照readme的说明找到软件包) 解压后,修改/config/wildfirechat.conf
文件,修改server.ip
为服务器ip地址。注意一定要改成客户端可以访问的地址,不能用127.0.0.1、0.0.0.0或者localhost, 另外要注意是使用软件包,不是源码,如果您下载的是源码的话需要先编译。如果您是要运行在linux服务器上,最好是在linux服务器上修改配置文件,遇见过部分客户在windows下改动引入了linux无法识别的字符,导致启动失败。
这里有个限制IM服务要使用80端口,因为客户端强制绑定的是80端口。在云服务器上运行必须经过备案才能和域名一起使用80端口。另外还需要使用1883端口,请确保80/1883 TCP端口畅通。 需要注意软件包和源码的区别,这里操作的是软件包不是源码,如果您下载的源码可以按照说明编译出软件包来进行配置和运行。
2.0.2. 运行
注意一定要在bin
的同级目录下执行命令,不要到bin
内执行
mac/linux系统
命令行到解压目录
使用root用户,执行
sh ./bin/wildfirechat.sh
后台执行可以使用命令
nohup sh ./bin/wildfirechat.sh 2>&1 &
,确保退出终端时程序能够继续运行
windows系统
- 使用命令行窗口执行
bin\wildfirechat.bat
(双击执行不可用,必须命令行)。
在windows下编辑过,可能会保存为windows格式,在放到linux上执行时,有可能会出现错误,处理方法请参考FAQ
执行相应系统的启动命令之后,等待10秒钟后,在浏览器中输入http://${服务器的IP}/api/version
,查看版本信息。
2.0.3. 停止
当需要重启时,关掉sh ./bin/wildfirechat.sh
的进程并不能关掉服务,linux用户请用下面命令找到服务的PID,然后用kill
命令停掉服务.
ps -ef | grep wildfirechat
windows用户可以用任务管理器找到wildfirechat进程,并杀掉它。 kill命令不要用-9,因为关闭时有些数据是要回写到数据库的,-9会导致丢消息
3. Demo应用服务器的部署
3.0.1. 配置修改
Demo应用服务软件点这儿去下载,下载解压后,修改/config/application.properties
文件,设置superCode
为66666
发送短信需要购买短信服务,在没有短信服务的情况下,使用superCode作为验证码来登录。 下载地址在本文的最开头处,同样需要使用软件包,如果是源码需要先编译。
3.0.2. 运行
执行java -jar app-0.0.1-SNAPSHOT.jar
。
后台执行可以使用命令
nohup java -jar app-0.0.1-SNAPSHOT.jar 2>&1 &
,确保退出终端时程序能够继续运行
3.0.3. 检查程序可用性
等待10秒钟,在浏览器中输入http://${服务器的IP}:8888/
,查看是否返回OK。
4. 更多
快速开始只是为了让客户更快更方便地体验到野火IM地功能,上线前需要仔细阅读整个文档(全部读下来只需要2~4个小时,但会有很大地帮助,强烈建议全部读一遍),然后按照上线检查事项,核对每一条是否完成。