安装文档(必看)

企业IM客服系统（以下简称IM或FastIM）安装指南

注意事项

• 以下每一步都必不可少，完成安装流程后，才能获得完整体验
atYwUnVKHLruTbXQ0F4s//0eN0NC/RHx3lBCQA==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• IM基于Swoole扩展运行，不支持Windows系统，请确保服务器系统为Linux、MacOs等支持Swoole的系统
rCKBWnNadPFIOcTZtBPZy+s5jdirDMiT/odlGA==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• IM插件的安装比普通插件多了swoole服务的调通，稍微复杂一点，但并不难，若调不通请先耐心阅读文档。
aosdESbCjqpIlxKLMOydpnWO2ngfCDFqYZ6sJw==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• PHP版本建议为7.3 - 8.0，7.2-会报错swoole的常量不存在，8.0+则是未测试
AKhWTDoMPqIpQFvbDk1OpWd9l7lcbvj0MptZZw==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。

一、 安装 FastAdmin，已安装请忽略，安装参考快速后台开发框架安装

二、 登录到FastAdmin后台->插件管理->安装IM插件->清理缓存->刷新后台；

三、 检查后台与用户中心的IM悬浮按钮是否自动部署。

• 若未能自动部署，请您按以下步骤检查，已经自动部署的请忽略此条。
qzIidVXoskZplebAyALR8/TAagSEfmnvO9oUhw==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 站点首页不会自动部署，若需在首页部署IM系统，建议在安装流程结束后，再点我查看如何配置
ZLrYTQUuMNbdwXCF2Vu1IhPgYo/DsVSJTzub2Q==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 您未开启调试模式：安装完插件后，请于后台->常规管理-》系统配置-》修改基础配置中的版本号->清理缓存并刷新后台。重点
JiRmCbGyMTcunplWuHp6FpNcpyAMO6spC5mKkg==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 您的JS文件已配置为从CDN/对象存储中加载：请更新public/assets/js/addons.js文件，到您的CDN/对象存储中，再执行上面的第1点。
nPDgScMoEtiQBusZKzxdVnjPjKVXsxyndSKsmQ==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。

四、安装swoole扩展

• 可使用任何可能的方式安装Swoole 4/5扩展
pGEeXlKQwIhTimJke4YV8gQAX3Roh+6RZRDuwg==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 宝塔面板可直接在软件商店找到对应的php版本->设置->安装扩展->找到Swoole 4/5安装成功后即可跳到第五步
uXLrptwfsPKWhDidU4cAsn2yuS8WtKTXBWmRrQ==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 非宝塔可参考：swoole官方安装文档，该安装文档分为快速安装、进阶完整编译示例、PECL，使用三种方式的任意一种均可，在该页面底部，也有视频安装教程
MiopCETsXcGANVKaPrlA2GWdLTcHPmUwk+znnA==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。

五、启动swoole服务

• 打开终端，执行命令php think fastim start调试启动swoole服务
efbJpEFvMjmilQuWPsSodLM41DTXs7OrmD/3MQ==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 安装流程完成后，请在终端按下ctrl+c结束服务，再执行php think fastim start -d正式启动服务(守护进程模式)
noRxSvEYXKFsQwuI2qRhfOf6puHit6O18N6OTw==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。

六、对外开放2088端口

• 端口号2088可在后台运行配置中修改，此处假设您要开启的端口是默认的2088端口
vuHeZjdblKnxABTQHBjsglpjXuf0lYBvhx5lCw==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 若您使用了宝塔管理面板，请登录面板->安全->放行端口2088重点
etGErZuWOdlvFbRkHYlELUCUL5fPA3BF2AQWAw==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 若您的服务器购买于阿里云，首先登录到阿里云控制台->找到云服务器管理控制台->找到服务器实例对应的安全组->添加入方向规则放行2088号端口。
UtJIPgYzTyNlHMxjevXFfUeHZyH8UsKxSEUYeg==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 若您的服务器购买于腾讯云或其他任何主机服务商，均需先在服务商方面放行端口。重点
VzohKQZGsLJTiypurvdf6++383dRzwwXZbSlEg==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 若有使用cdn、负载均衡等产品服务，且该服务有防火墙功能，还需要前往对应服务的面板开放2088端口
yDcXdNavFkZWCxftHb0Qwc7ZnSAkr7RjQmKWpA==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 检查端口是否已经开放成功，最简单可行的办法是端口扫描，请自行某度查找自己喜欢的:端口扫描工具，对2088端口进行扫描，扫描结果为开放，则端口已准备好！
cuJmfMgaHUnBDvGqmIED9wTsvNj0jNPo0OFjrA==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。

七、注意事项

• https下，必须创建wss服务，才能正常连接网络，可先行通过http访问网站，安装流程完成后，再参考创建wss服务，若您的站点未创建wss服务，请确定：IM插件配置->运行配置->wss协议链接 是关闭状态。
QzxWhAYKTpEgGrFHoxds5UCD1Wfxd3w8mLzeEw==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• Im的网络无法连接，90%是因为端口未开放，无法连接请务必进行端口扫描，不要只关注你刚设置的开放端口规则。重点
lrTyYHvEPZXUFdtLvCuKpLLaVPL46jSRSRvdQA==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 安装插件清理缓存后，请刷新后台后，再执行启动服务命令，否则会报错runtime目录的某个文件不能访问，因为使用了root用户建立站点缓存
voQNVzbniWdrLGHMQ7NvQp8zBEY4wPZGfrhx6A==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。

八、测试

• 刷新后台，检查Im网络连接状态
qrGuPNInTYvMQSxhoNXWTD/ZqmuQZlf/ndxtGQ==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 确定网络可以正常连接后，请回到终端按下ctrl+c结束服务，再执行php think fastim start -d正式启动服务
cuIwTbCVAZpPoyjhmioY6TXq8ML6trflUd5c2Q==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
• 若网络任然无法连接，请检查终端是否有报错显示出来
eaPmYyOXzBwiVLhRfAnnEgFDBpOvxrABYktHww==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。