野火IM 官方PC版v0.2.0

野火IM是开源通用即时通讯组件，通过它用户可以根据自己的需求来搭建IM通讯框架，从而使得用户可以自己搭建便宜有效的IM通讯能力。为用户提供了免费可控高效易用的IM组件，能够更加容易地赋予客户IM能力，使客户可以快速的在自有产品上添加聊天功能。软件分为社区版和专业版，社区办是完全免费的，大家可以根据自己的需求来选择。

软件特色

使用了微信Mars连接库，序列化使用protobuf，协议使用MQTT修改的私有协议，借鉴了微软ActiveSync的思路。

做到不丢消息，完美地支持多端。另外针对安全性做了仔细的设计，链路层全程加密，本地数据库加密。

提供了UI库，大大减少开发者的工作量。

野火IM可能是世界上内核最像微信的一个IM（使用了微信的连接库，使用了微信类似的协议）。

提供能力库和UI库，支持单聊、群聊、聊天室、频道（类似与微信的公众号)和机器人。

支持Server API。提供用户信息、好友关系和群组信息托管。支持常见消息类型和自定义消息。

提供音视频通话能力，支持音视频会议功能。支持国产化系统，支持全平台客户端。

社区版与专业版区别

•社区版是开源的，问题的修复需要客户自主解决或等待我们解决，但时间不能保障。专业版闭源，我们会快速修复问题。

•社区版是单机版，专业版支持集群。社区版虽然是单机，但性能也很高，使用高性能服务器，足够满足上百万用户；商业版除了通过集群部署能够支撑比社区版更多用户外，还能够提供高可靠性。

•社区版使用的数据库是mysql，我们已经做了分表处理，但还是需要按月删除旧消息。专业版使用了mysql+mongodb，消息能保存更久，场景搭配也更合理。

•专业版附带对象存储服务，可以支持纯私有化部署，所有的环节都经过加密处理。社区版依赖于七牛云存储，文件上传没有加密。

•专业版支持Web、小程序接入，社区版不支持Web、小程序接入。

•专业版特有消息送达报告和消息阅读报告功能，可以提高办公场景下的体验。

•专业版支持国产化系统，支持任意国产CPU+国产操作系统，支持达梦金仓等国产数据库。

•社区版仅支持mysql数据库，专业版还可以除了国产数据库外的更多数据库，比如sqlserver等。

•专业版进行了极致的性能优化，同样用户下所需要的硬件资源更少。

•专业版支持文件记录功能，可以查询/管理发送和接收到的文件，适用于办公环境。

•专业版可以支持最大4GB的大文件传输。

•专业版支持音视频高级版，可以提供更优质的音视频服务，并且可以支持会议模式。

•专业版支持双网环境，可以用在内外网同时使用的双网环境。

 专业版适用场景

如果有以下任意需求之一都可以考虑适用专业版：

•对安全性有较高要求。野火IM专业版对所有环节都有加密处理，安全无漏洞。

•用户规模较大，或者有较多千人以上的群聊，对性能需求较高的场景。野火IM专业版具有更高的单机性能，而且可以水平扩展，提供高可能能力。

•对数据信息保密性要求较高，需要存私有化部署。野火IM专业版可以做到除了推送以外，完全脱离对外网的依赖。可以对推送服务适用防火墙白名单或者改为拉取等方案，确保您对信息万无一失，适用于军工企业和保密单位。

•需要国产化系统或者特殊的数据库系统。

•需要支持Web或小程序时，只能选择专业版。

•想要更好的音视频通话体验，需要在线会议功能。

•办公场景下使用，文件管理和阅读报告能提高办公体验。

技术支持规范

野火IM团队没有对应的人力和财力进行无条件的技术支持服务，但又不能让客户被阻碍无法顺畅使用。因此我们必须折中找到一个平衡点，经归纳大概有以下三部分的技术支持，提供的技术支持情况如下：

•开放源码的问题和BUG，理论上所有问题归客户自己来解决，客户解决后可以给我们提PR。也可以给我们提issue，我们也会按照我们当前的人力情况来评估问题的轻重缓急并进行处理。社区版IM Server除外。

•闭源组件的问题和BUG，包括协议栈，音视频SDK，PCSDK和专业版等，都归我们来解决，问题提交给我们后，我们会无条件第一时间去解决。

•使用方法和其它咨询问题，客户需要自己来查阅文档，搜索BBS和查看源代码。如果无法找到对应问题描述，我们会第一时间负责补充说明。

•社区版IM Server强烈不建议客户自己修改。如果没有修改的情况下，如果发现问题可以报告给我们，我们会第一时间负责修复。如果修改了，我们就无法对您修改过的版本进行支持，购买过的SDK可能会有各种各样的问题，我们不会再提供技术支持。“私自拆开不再保修”是各行各业的普遍做法。

环境依赖

mac系统

1.最新版本的Xcode

2.nodejs 10.16.X

3.npm 6.9.0

4.python 2.7.X

5.git

6.npm install -g node-gyp

windows系统

1.nodejs v10.16.x

2.python 2.7.X

3.git

4.npm 6.9.0

5.npm install --global --vs2015 windows-build-tools

6.npm install -g node-gyp

第5步安装windows开发环境的安装内容较多，如果网络情况不好可能需要等较长时间，选择早上网络较好时安装是个好的选择

linux系统

1.nodejs10.16.X

2.python2.7X

3.git

常见问题

•如何调试？PC使用了Electron，内嵌Chrome浏览器，跟在浏览器上开发调试是一样的。快捷键Ctrl +g(MAC下是CMD+g)打开开发者模式。

•打包时，如果一直显示installing production dependencies platform=win32 arch=ia32 appDir=C:\<your path>\pc-chat\dist， 或者提示下载什么之类的，可将dep目录下对应平台的electron依赖，解压到对应的目录。

// windows

C:\Users\<你的用户名>\.electron-gyp

// mac/linux

~/.electron-gyp

•打包时，如果下载electron版本超时，可以使用我们下载好的electron放到缓存目录。

•windows上需要严格按照环境进行安装，mac上环境比较简单一些，安装node和node-gyp就可以了 另外如果还有问题，请试试命令npm cache clean --force ，然后删掉node_modules，再重新在非管理员权限下npm install

•有些杀毒软件会对electron打包的软件报病毒，详情请参考electron报病毒 。安装时可能被杀毒软件限制安装，这时候可以让用户使用绿色免安装版（打包后release目录下的unpacked目录）。如果运行时报错，请在杀毒软件里加上例外。另外有条件的公司可以考虑去360官方或其他杀软的官方提交检测。

•ubuntu下，启动时，若提示，A JavaScript error occurred in the main process Uncaught Exception:Error: Cannot open /opt/wildfirechat/resources/app.asar/marswrapper.node: Error: libdouble-conversion.so.1: cannot open shared object file: No such file or directory，可安装libdouble-conversion1解决

•win平台野火客户端依赖Visual C++ Redistributable Package runtime。如果用户PC上没有安装就需要安装之后才能运行，请从微软官方下载安装 https://www.microsoft.com/zh-CN/download/details.aspx?id=48145 。注意这个安装包是有32位/64位区分的，需要安装对应架构的版本。

•MAC应用截屏时只能截屏空白桌面，无法截图窗口内容。这是因为没有通过mac系统的安全许可，在设置-》安全与隐私-》切换到隐私那个标签-》屏幕录制-》在野火IM PC应用前打勾，并重启应用。

•使用cnpm后打包失败，在某些平台cnpm是会出现问题的，请使用npm。

•npm install 报Unexpected end of JSON input while parsing near...错误

如果常见问题4解决不了，可以尝试　 npm config set registry https://registry.npm.taobao.org/ ，然后在按常见问题4的步骤进行