服务器部署

包含两个服务:社区版IM服务(简称IM服务) 和 Demo应用服务(简称应用服务)

服务器需要部署社区版IM服务和Demo应用服务。IM服务负责发送消息等IM业务;应用服务是模拟客户的应用服务,提供登录等功能。

1. 环境需求

  1. 系统要求

    Windows/Linux/MacOS都可以,需要网络环境。如果没有公网IP,也可以在局域网内体验。需要开通1883808888端口的入防防火墙权限。

  2. 软件要求

    JRE:1.8

2. 野火IM服务器的部署

2.0.1. 准备软件版本

IM服务可以直接下载我们发布的最新版本,也可以从Github或者码云下载源码编译。得到软件包后解压。

这里有个限制IM服务要使用80端口,因为客户端强制绑定的是80端口。在云服务器上运行必须经过备案才能和域名一起使用80端口。另外还需要使用1883端口,请确保80/1883 TCP端口畅通。

如果您下载的是源码,请按照说明编译出软件包来运行。

2.0.2. 运行

解压软件包后,有个bin目录,进入到bin目录

mac/linux系统
  1. 命令行到解压目录

  2. 使用root用户,执行sh ./wildfirechat.sh

    后台执行可以使用命令nohup sh ./wildfirechat.sh 2>&1 &,确保退出终端时程序能够继续运行

windows系统
  1. 使用命令行窗口执行wildfirechat.bat(双击执行不可用,必须命令行)。

在windows下编辑过,可能会保存为windows格式,在放到linux上执行时,有可能会出现错误,处理方法请参考FAQ

执行相应系统的启动命令之后,等待10秒钟后,在浏览器中输入http://${服务器的IP}/api/version,查看版本信息。

2.0.3. 停止

当需要重启时,关掉sh ./wildfirechat.sh的进程并不能关掉服务,linux用户请用下面命令找到服务的PID,然后用kill命令停掉服务.

ps -ef | grep wildfirechat

windows用户可以用任务管理器找到wildfirechat进程,并杀掉它。 kill命令不要用-9,因为关闭时有些数据是要回写到数据库的,-9会导致丢消息

3. 应用服务器的部署

3.0.1. 下载软件

应用服务软件可以直接下载我们发布的最新版本,也可以从Github或者码云下载源码编译。下载的软件包解压后得到一个jar包和一个config文件,如果是自己编译,需要把源码中的config文件拷贝到jar包的同目录下。

3.0.2. 运行

执行java -jar app-0.xx.jar

后台执行可以使用命令nohup java -jar app-0.xx.jar 2>&1 &,确保退出终端时程序能够继续运行

3.0.3. 检查程序可用性

等待10秒钟,在浏览器中输入http://${服务器的IP}:8888/,查看是否返回OK。

4. 问题排查

如果部署后客户端无法连接,请按照这里说明来排查。

5. 更多

快速开始只是为了让客户更快更方便地体验到野火IM地功能,上线前需要仔细阅读整个文档(全部读下来只需要2~4个小时,但会有很大地帮助,强烈建议全部读一遍),然后按照上线检查事项,核对每一条是否完成。

2018 © wildfirechat.net 京ICP备18060403号-1 all right reserved,powered by Gitbook该文件修订时间: 2024-10-01 07:37:49

results matching ""

    No results matching ""