#### 注意事项
* 以下每一步都必不可少，完成安装流程后，才能获得完整体验
* IM基于`Swoole`扩展运行，不支持Windows系统，请**确保服务器系统为Linux、MacOs等支持Swoole的系统**
* IM插件的安装比普通插件多了swoole服务的调通，稍微复杂一点，但并不难，若调不通请先耐心阅读文档。
**一、 安装 FastAdmin，已安装请忽略，安装参考[快速后台开发框架安装](https://doc.fastadmin.net/docs/install.html)**
4To8AGKZP9yRw6ZJUJh0HA==
**二、 登录到FastAdmin后台->插件管理->安装IM插件->清理缓存->刷新后台；**
dLKx7E/s51eXr1oaLMwLAQ==
**三、 检查后台与用户中心的IM悬浮按钮是否自动部署。**
+hb+4xCWifDzajhmRwhY3g==
* 若未能自动部署，请您按以下步骤检查，已经自动部署的请忽略此条。
1. 站点首页不会自动部署，若需在首页部署IM系统，建议在安装流程结束后，再点我查看如何配置
2. 您未开启调试模式：安装完插件后，请于后台->常规管理-》系统配置-》修改基础配置中的版本号->清理缓存并刷新后台。**`重点`**
3. 您的JS文件已配置为从CDN/对象存储中加载：请更新public/assets/js/addons.js文件，到您的CDN/对象存储中，再执行上面的第1点。
**四、安装swoole扩展**
yjvEuxv+i4FJGz+A7uSDew==
* **可使用任何可能的方式安装`Swoole 4`扩展**
* 宝塔面板可直接在软件商店找到对应的php版本->设置->安装扩展->找到`Swoole 4`安装成功后即可跳到第五步
* 非宝塔可参考：[swoole官方安装文档](https://wiki.swoole.com/#/environment)，该安装文档分为`快速安装`、`进阶完整编译示例`、`PECL`，使用三种方式的任意一种均可，在该页面底部，也有视频安装教程
**五、启动swoole服务**
Ep7Y9XIXxWzVY3fJ7wBXhQ==
* 打开终端，执行命令`php think fastim start`调试启动swoole服务
* 安装流程完成后，请在终端按下`ctrl+c`结束服务，再执行`php think fastim start -d`正式启动服务(守护进程模式)
**六、对外开放`2088`端口**
1AnbCR7+YdGhsI5xLK7/8A==
* 端口号`2088`可在后台运行配置中修改，此处假设您要开启的端口是默认的`2088`端口
* 若您使用了宝塔管理面板，请登录面板->安全->放行端口`2088`**`重点`**
* 若您的服务器购买于阿里云，首先登录到阿里云控制台->找到云服务器管理控制台->找到服务器实例对应的安全组->添加入方向规则放行`2088`号端口。
* 若您的服务器购买于腾讯云或其他任何主机服务商，均需先在服务商方面放行端口。**`重点`**
* 若有使用cdn、负载均衡等产品服务，且该服务有防火墙功能，还需要前往对应服务的面板开放`2088`端口
* 检查端口是否已经开放成功，最简单可行的办法是**端口扫描**，请自行某度查找自己喜欢的:端口扫描工具，对`2088`端口进行扫描，扫描结果为开放，则端口已准备好！
**七、注意事项**
RNIBAE0sGrDNfu5HkrALyA==
* https下，必须创建wss服务，才能正常连接网络，可先行通过http访问网站，安装流程完成后，再参考[创建wss服务](https://doc.fastadmin.net/fastim/1032.html)，若您的站点未创建wss服务，请确定：IM插件配置->运行配置->wss协议链接 是`关闭`状态。
* Im的网络无法连接，90%是因为端口未开放，无法连接请务必进行端口扫描，不要只关注你刚设置的开放端口规则。**`重点`**
* 安装插件清理缓存后，请刷新后台后，再执行启动服务命令，否则会报错`runtime`目录的某个文件不能访问，因为使用了root用户建立站点缓存
**八、测试**
n0BioemHCoTz0cD/wBLnGA==
* 刷新后台，检查Im网络连接状态
* 确定网络可以正常连接后，请回到终端按下`ctrl+c`结束服务，再执行`php think fastim start -d`正式启动服务
* 若网络任然无法连接，请检查终端是否有报错显示出来
