注意事项

。以下每一步都必不可少，完成安装流程后，才能获得完整体验

。IM基于 Swoole 扩展运行，不支持Windows系统，请确保服务器系统为Linux、MacOs等支持Swoole的系统。IM插件的安装比普通插件多了swoole服务的调通，稍微复杂一点，但并不难，若调不通请先耐心阅读文档PHP 版本建议为 7.3 或 7.4， 7.2 会报错 swoole 的常量不存在， 8+ 则是未测试

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

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

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

若末能自动部署，请您按以下步骤检查，已经自动部署的请忽略此条.

站点首页不会自动部署，若需在首页部署IM系统，建议在安装流程结束后，再点我查看如何配置

您未开启调试模式: 安装完插件后，请于后台->常规管理-》系统配置-》修改基础配中的版本号>清理缓存并刷新后台。重点

您的JS文件已配置为从CDN对象存储中加载: 请更新public/assets/is/addons.js文件，到您的CDN/对象存储中，再执行上面的第1点。

四、安装swoole扩展

可使用任何可能的方式安装 swoole 4 扩展

宝塔面板可直接在软件商店找到对应的php版本->设置>安装广展->找到 Swoole 4 安装成功后即可跳到第五步非宝塔可参考:swoole官方安装文档，该安装文档分为 快速安装 、 进阶完整编示例、 PECL，使用三种方式的任意一种均可，在该页面底部，也有视频安装教程

五启动swoole服务

打开终端，执行命令 php think fastim start 调试启动swoole服务.

安装流程完成后，请在终按下 ctrl+c 结束服务，再执行 php think fastim start -d 正式启动服务(守护进程模式)

六、对外开放 2888 端口

。端口号 2088 可在后台运行配置中修改，此处假设您要开启的端口是默认的 2088 端

若您使用了宝塔管理面板，请登录面板->安全->放行端口 2088 重点

若您的服务器购买于阿里云，首先登录到阿里云控制台->找到云服务器管理控制台->找到服务器实例对应的安全组->添加入方向规则放行 2088 号端口。

若您的服务器购买于腾讯云或其他任何主机服务商，均需先在服务商方面放行端口。 重点

若有使用cdn、负载均衡等产品服务，且该服务有防火墙功能，还需要前往对应服务的面板开放 2088 端口

检查端口是否已经开放成功，最简单可行的办法是端口扫描，请自行某度查找自己喜欢的·端口扫描工具，对 2088 端口进行扫描，扫描结果为开放，则端口已准备好!

七、注意事项

。htps下，必须创建Wss服务，才能正常连接网络，可先行通过http访问网站，安装流程完成后，再参考创建wss服务，若您的站点未创建wss服务，请确定: IM插件配置->运行配置->wss协议链接是 关闭 状态。

lm的网络无法连接，90%是因为端口末开放，无法连接请务必进行端口扫描，不要只关注你刚设置的开放端口规则。 重点安装插件清理缓存后，请刷新后台后，再执行启动服务命令，否则会报错 runtime 目录的某个文件不能访问，因为使用了root用户建立站点缓存

八、测试

。刷新后台，检查Im网络连接状态

确定网络可以正常连接后，请回到终按下 ctrl+c 结束服务，再执行 php think fastim start -d 正式启动服务若网络任然无法连接，请检查终端是否有报错显示出来