Lumen IM 即时聊天系统(前端)
项目介绍
Lumen IM 是一个网页版在线即时聊天项目，前端使用 Element-ui + Vue，后端采用了基于 Swoole 开发的 Hyperf 协程框架进行接口开发，并使用 WebSocket 服务进行消息实时推送。目前后端 WebSocket 已支持分布式集群部署。
目前该项目是在 旧版本 项目的基础上进行了后端重构，且前后端都有较大的改动。
功能模块
- 基于 Swoole WebSocket 服务做消息即时推送
- 支持私聊及群聊
- 支持多种聊天消息类型 例如:文本、代码块、图片及其它类型文件，并支持文件下载
- 支持聊天消息撤回、删除(批量删除)、转发消息(逐条转发、合并转发)
- 支持编写个人笔记、支持笔记分享(好友或群)
项目预览
- 地址： http://im.gzydong.club
- 账号： 18798272054 或 18798272055
- 密码： admin123
项目安装(部署)
设置 npm 镜像源
npm config set registry https://registry.npm.taobao.org
下载安装
## 克隆项目源码包
git clone git@github.com:gzydong/LumenIM.git
## 安装项目依赖扩展组件
npm install
# 启动本地开发环境
npm run serve
## 生产环境构建项目
npm run build
## 生产环境构建项目并查看构建报告
npm run build --report
修改 .env 配置信息
VUE_APP_API_BASE_URL=http://xxx.yourdomain.com
VUE_APP_WEB_SOCKET_URL=ws://xxx.yourdomain.com/socket.io
VUE_APP_WEBSITE_NAME="Lumen IM"
关于 Nginx 的一些配置
server {
listen 80;
server_name www.yourdomain.com;
root /project-path/dist;
index index.html;
## 解决 VueRouter History 模式下 页面刷新404问题
location / {
try_files $uri $uri/ /index.html;
}
location ~ .*\.(gif|jpg|jpeg|png|bmp|swf|flv|ico)$ {
expires 7d;
}
location ~ .*\.(js|css)?$ {
expires 7d;
}
}
注意：项目需要与后端一起使用，点击获取源码。
项目源码
| 代码仓库 | 前端源码 | 后端源码 |
|---|---|---|
| Github | https://github.com/gzydong/LumenIM | https://github.com/gzydong/hyperf-chat |
| 码云 | https://gitee.com/gzydong/LumenIM |
联系方式
QQ : 837215079
如果你觉得还不错，请 Star , Fork 给作者鼓励一下。
环境变量配置
本项目使用Vue CLI的环境变量配置功能，可以在不同环境下使用不同的配置。
配置文件
.env- 所有环境的默认配置.env.development- 开发环境配置.env.test- 测试环境配置.env.production- 生产环境配置
环境变量
项目中使用的主要环境变量：
VUE_APP_WEBSITE_NAME- 网站名称VUE_APP_API_BASE_URL- API基础URLVUE_APP_WWW_BASE_URL- 前端网站URLVUE_APP_WEB_SOCKET_URL- WebSocket URL
使用方法
在代码中可以通过以下方式访问环境变量：
// 直接访问
console.log(process.env.VUE_APP_API_BASE_URL)
// 通过配置文件访问
import config from '@/config/config'
console.log(config.BASE_API_URL)
运行与构建
开发环境：
# 使用开发环境配置运行
npm run serve:dev
# 使用开发环境配置构建
npm run build:dev
测试环境：
# 使用测试环境配置运行
npm run serve:test
# 使用测试环境配置构建
npm run build:test
生产环境：
# 使用生产环境配置运行
npm run serve:prod
# 使用生产环境配置构建
npm run build:prod
项目设置
# 安装依赖
npm install
# 启动开发服务器
npm run serve
# 构建生产版本
npm run build
# 代码检查
npm run lint