7.8 KiB
Executable File
IM即时聊天
介绍
Raingad-IM是一个开源的即时通信demo,需要前后端配合使用,主要用于学习交流,为大家提供即时通讯的开发思路,许多功能需要自行开发,开发的初衷旨在快速建立企业内部通讯系统、内网交流、社区交流。
体验账号:13800000002 密码:123456
尾号2、3、4......18、19、20 都是
体验账号:13800000020 密码:123456
支持功能
-
支持单聊和群聊,支持发送表情、图片、语音、视频和文件消息
-
单聊支持消息已读未读的状态显示,在线状态显示
-
群聊创建、删除和群成员管理、群公告、群禁言等
-
支持置顶联系人,消息免打扰;支持设置新消息声音提醒,浏览器通知
-
支持一对一音视频通话(已打通web端和移动端)
-
支持文件、图片和绝大部分媒体文件在线预览
-
支持移动端(H5、APP和小程序,部分功能不兼容),支持简易后台管理
-
全新支持企业模式和社区模式,社区模式支持注册、添加好友功能
最新更新
v-3.0.0 (2023年9月4日) 不兼容之前的版本!!!
- 全新升级,不兼容之前版本.
- 修改登录方式,新增JWT token登录,不再服务器缓存登录信息,节约服务器资源。
- 新增聊天内容加密,聊天数据更安全,请仔细阅读
.example.env
里面的配置. - 消息推送服务可以自定义端口,已集成到环境配置文件中
.example.env
,仅支持linux,window请按照原来的方式操作。 - 新增websocket连接认证,未认证会被断开连接。
- 新增群二维码,移动端可以扫码加群。暂未实现聊天中长按图片识别二维码加群。
- 修复聊天记录重复加载的情况。
- 修复历史消息不会实时置为已读的情况。
- 优化若干样式和bug
v-2.8.25 (2023年8月25日)
- 优化移动端的websocket连接
- 移动端新增记住密码
- 优化消息接收的处理以及上下线状态
- 移动端完善用户资料修改,密码修改等
- 打通移动端和web端的音视频互通,有bug,但是可以忽略,已开源web端音视频源码
- 新增音视频通话消息类型
v-2.8.1 (2023年8月1日)
- 移动端新增消息撤回、复制,消息的发送状态,1对1消息已读、未读状态
- 移动端修复聊天页面中,消息不能滚动到底部的情况
- 移动端新增音视频通话引导用户获取音视频权限
- web端新增截屏功能,功能用的第三方插件,虽然有瑕疵,但是很强大
- 优化websocket掉线问题,增加客户端主动心跳
- 优化web端浏览器通知
- 移动端支持社区模式,加好友等功能
- 新增邮件加密方式选择
- 兼容php7.4
- 修复element-ui图标有时候加载乱码
v-2.7.14 (2023年7月14日)
- 支持简易后台管理
- 全新支持企业模式和社区模式,可自由切换
- 新增阿里云、七牛云、腾讯云等对象储存
- 新增群头像自动生成
- 新增人员资料查看
- 新增文件管理,可以快速发送到聊天。
- 新增移动端1对1音视频通话,不和web端互通
v-2.5.30 (2023年5月20日)
- 新增windows系统的支持,建议windows仅用于开发环境,正式环境请使用linux。
- 新增企业模式下全局发送消息的演示页面。
v-1.10.30 (2022年10月30日)
- 升级vue-cli2到vue-cli3
- 优化发送按键和换行键
- 新增语音消息、视频消息
- 新增支持音视频通话(peerjs)
- 使用sass依赖替代node-sass(这东西太坑了)
v-0.1.0 (2021年04月24日)
- 项目建立,只是有项目需要,才开发了这个应用
软件架构
后端技术栈:thinkphp6+workerman+redis
前端技术栈:vue2+Lemon-IMUI+element-UI
安装教程
源码下载
- 克隆代码到本地:
git clone https://gitee.com/raingad/im-instant-chat.git
- 进入项目目录,执行:
composer install
或者
- 下载完整源码放到自己的服务器上。请注意看gitee项目主页顶部
右侧的发行版
,请在发行版中下载最新发布的版本。
开始安装
- 开启伪静态,下面只展示nginx的,Apache的已内置
location ~* (runtime|application)/{
return 403;
}
location / {
if (!-e $request_filename){
rewrite ^(.*)$ /index.php?s=$1 last; break;
}
}
-
访问你的ip或者域名即可进入自定义安装向导。
-
先参考下一章“启动消息推送服务”,再来安装程序最佳。
ps:必须要取消禁用的函数 shell_exec
proc_open
pcntl_exec
。其它的根据调试情况来取消禁用
如果安装失败
-
进入
public\sql\database.sql
将数据库导入自己的数据库。 -
进入项目根目录,修改
example.env
为.env
,并修改数据库相应的参数,请仔细阅读env中的配置说明。
PS:如需开启聊天文件存入oss,需要在后台中进行配置,配置后不要再对环境配置文件进行修改。
启动消息推送服务
因为是聊天软件需要用到websockt,所以我们需要启动workerman,系统已经内置了相应的服务,可以在后台管理首页进行运行服务,但是首次使用需要先进行调试。
-
进入项目根目录 运行
php think worker:gateway start -d
,或者运行php start.php start -d
即可运行消息服务,测试时不要-d
。windows下请直接运行根目录下的start_for_win.bat
文件,由于Workerman在Windows下有诸多使用限制,所以正式环境建议用Linux系统,windows系统仅建议用于开发环境。 -
消息服务需要放行 8282 端口,如需修改,请修改环境噢配置文件中
WORKEER
板块的相应参数。windows用户请修改 [app\worker\start_gateway.php
] 中的 8282 端口。端口号根据情况需改,如果修改了端口号,需要将前端的程序修改并重新打包上传到项目的public目录下。 -
系统采用直接用域名作为websocket服务的地址,所以监听端口需要在网站的nginx中配置代理并监听8282端口。
location /wss
{
proxy_pass http://127.0.0.1:8282;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header X-Real-IP $remote_addr;
}
-
更多关于workerman的使用,请进入workerman官网官网进行查阅。
-
部署完成之后管理员账号密码为:
administrator
123456
,管理入口在聊天界面的左下角。
安装部署服务
服务器要求:
所需环境 | 版本 | 备注 |
---|---|---|
linux | >= 7.0 | 以下的版本未做测试 |
php | >= 7.1 | 不兼容8 |
mysql | >= 5.7 | 必须要5.7及以上 |
redis | >= 5.0 | |
workerman | >= 4.0 | 用于消息服务部署 |
作者提供本系统的安装服务,包括后端和前端部署到线上,保证项目的完美运行,200元/次,安装服务可赠送web端音视频通话源码,如有需要可以进群联系作者!
交流群
如果有什么问题,请留言,或者加入我们的QQ群!
创作不易,点个star吧