安装文档(必看)
企业IM客服系统(以下简称IM或FastIM)安装指南
注意事项
- 以下每一步都必不可少,完成安装流程后,才能获得完整体验
- IM基于
Swoole扩展运行,不支持Windows系统,请确保服务器系统为Linux、MacOs等支持Swoole的系统 - IM插件的安装比普通插件多了swoole服务的调通,稍微复杂一点,但并不难,若调不通请先耐心阅读文档。
PHP版本建议为7.3 - 8.0,7.2-会报错swoole的常量不存在,8.0+则是未测试
一、 安装 FastAdmin,已安装请忽略,安装参考快速后台开发框架安装
二、 登录到FastAdmin后台->插件管理->安装IM插件->清理缓存->刷新后台;
三、 检查后台与用户中心的IM悬浮按钮是否自动部署。
- 若未能自动部署,请您按以下步骤检查,已经自动部署的请忽略此条。
- 站点首页不会自动部署,若需在首页部署IM系统,建议在安装流程结束后,再点我查看如何配置
- 您未开启调试模式:安装完插件后,请于后台->常规管理-》系统配置-》修改基础配置中的版本号->清理缓存并刷新后台。
重点 - 您的JS文件已配置为从CDN/对象存储中加载:请更新public/assets/js/addons.js文件,到您的CDN/对象存储中,再执行上面的第1点。
四、安装swoole扩展
- 可使用任何可能的方式安装
Swoole 4/5扩展 - 宝塔面板可直接在软件商店找到对应的php版本->设置->安装扩展->找到
Swoole 4/5安装成功后即可跳到第五步 - 非宝塔可参考:swoole官方安装文档,该安装文档分为
快速安装、进阶完整编译示例、PECL,使用三种方式的任意一种均可,在该页面底部,也有视频安装教程
五、启动swoole服务
- 打开终端,执行命令
php think fastim start调试启动swoole服务 - 安装流程完成后,请在终端按下
ctrl+c结束服务,再执行php think fastim start -d正式启动服务(守护进程模式)
六、对外开放2088端口
- 端口号
2088可在后台运行配置中修改,此处假设您要开启的端口是默认的2088端口 - 若您使用了宝塔管理面板,请登录面板->安全->放行端口
2088重点 - 若您的服务器购买于阿里云,首先登录到阿里云控制台->找到云服务器管理控制台->找到服务器实例对应的安全组->添加入方向规则放行
2088号端口。 - 若您的服务器购买于腾讯云或其他任何主机服务商,均需先在服务商方面放行端口。
重点 - 若有使用cdn、负载均衡等产品服务,且该服务有防火墙功能,还需要前往对应服务的面板开放
2088端口 - 检查端口是否已经开放成功,最简单可行的办法是端口扫描,请自行某度查找自己喜欢的:端口扫描工具,对
2088端口进行扫描,扫描结果为开放,则端口已准备好!
七、注意事项
- https下,必须创建wss服务,才能正常连接网络,可先行通过http访问网站,安装流程完成后,再参考创建wss服务,若您的站点未创建wss服务,请确定:IM插件配置->运行配置->wss协议链接 是
关闭状态。 - Im的网络无法连接,90%是因为端口未开放,无法连接请务必进行端口扫描,不要只关注你刚设置的开放端口规则。
重点 - 安装插件清理缓存后,请刷新后台后,再执行启动服务命令,否则会报错
runtime目录的某个文件不能访问,因为使用了root用户建立站点缓存
八、测试
- 刷新后台,检查Im网络连接状态
- 确定网络可以正常连接后,请回到终端按下
ctrl+c结束服务,再执行php think fastim start -d正式启动服务 - 若网络任然无法连接,请检查终端是否有报错显示出来
文档最后更新时间:2024-12-20 14:17:49
著作权归应用插件开发者所有,未经许可,禁止转载、复制此文档的任何内容。
IM配置项解释 →
未解决你的问题?请到「问答社区」反馈你遇到的问题