genal-chat

用 TypeScript 一把梭，快速搭建全栈实时聊天室

开源 🏷️完全免费 ⚠️ 链接可跳转，访问体验不确定对话助手 🍴 复刻 387 🐛 待处理 44 👀 关注 21

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1988

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，官网可访问，提供在线聊天室服务，完全免费。

项目预览

项目数据

分类对话助手

开发团队genalhuang

官网地址https://www.genal.fun

GitHubhttps://github.com/genalhuang/genal-chat

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，官网可访问，提供在线聊天室服务，完全免费。

访问状态⚠️ 链接可跳转，访问体验不确定

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型chatbot,chatroom,javascript,nestjs,nodejs,socket-io,typeorm,typescript,vue,vuex

GitHub 星标★ 1988

上线时间2020-06-24 00:00:00

代码更新2023-01-24

仓库体积32.6 MB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数5

项目介绍

genal-chat 是一个基于 NestJS + Vue 的全栈聊天室项目，采用 TypeScript 编写，前后端分离架构。它解决了开发者快速搭建实时聊天应用的需求，提供完整的聊天室功能，包括用户认证、消息收发、群组管理、好友系统等。核心能力在于使用 Socket.IO 实现实时双向通信，通过 TypeORM 管理数据持久化，并利用 Vuex 管理前端状态。项目结构清晰，代码规范，适合作为学习全栈 TypeScript 开发的范例，也可作为生产环境的起点。它涵盖了从后端 API 设计到前端组件开发的完整流程，帮助开发者理解前后端交互、实时通信、数据库设计等关键知识点。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1988

技术标签

chatbot javascript nestjs nodejs typescript

使用教程

难度：入门约 15 分钟部署方式：本地安装 5 步

环境要求

Node.js（README 标注版本 node v10.16.3）
MySQL 数据库，并新建一个名为 chat 的数据库
chat 数据库字符集必须为 utf8mb4
已安装 npm，用于前后端依赖安装

安装与启动步骤

1克隆项目代码

把仓库拉到本地，得到前后端两个子目录 genal-chat-client 和 genal-chat-server。
```
git clone https://github.com/genalhuang/genal-chat.git
cd genal-chat
```
2创建 MySQL 数据库

README 说明数据库没有 SQL 脚本，只需新建一个 chat 数据库，注意字符集为 utf8mb4。
```
mysql -u root -p -e "CREATE DATABASE chat DEFAULT CHARACTER SET utf8mb4;"
```
3修改数据库配置

打开后端 app.module.ts，直接把里面的数据库密码改成你自己的 MySQL 密码，库名保持 chat。
4安装并启动后端

进入后端目录安装依赖并启动开发服务，启动后有编译报错需先解决再继续。
```
cd genal-chat-server
npm i
npm run start:dev
```
5安装并启动前端

另开一个终端进入前端目录，安装依赖并启动开发服务器，按提示打开本地地址访问。
```
cd genal-chat-client
npm i
npm run serve
```

关键配置

配置项	必填	说明	示例
`数据库密码(app.module.ts)`	是	后端连接 MySQL 使用的密码，需改成你自己的	`'your_mysql_password'`
`数据库名`	是	README 要求新建并使用的数据库名	`chat`
`数据库字符集`	是	建库时指定的字符集，README 强调必须为 utf8mb4	`utf8mb4`