安装文档(必看)

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

注意事项

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

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

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

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

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

四、安装swoole扩展

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

五、启动swoole服务

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

六、对外开放2088端口

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

七、注意事项

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

八、测试

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