📦 简介

X-IM 是一款从零构建的即时通讯全栈系统，采用管理后台（admin）+ 移动端（app）+ API服务端（server）三端分离架构。涵盖用户认证、消息收发、好友管理、文件传输、群组管理、实时在线状态等IM核心功能，并提供Element Plus后台管理面板用于运营管控。
中英双语界面 · 完全开源无加密 · 支持二开多语言
亲测环境： Linux (MySQL 8.0.45) + Node.js 20+，测试日期：2026-06-22

⚡ 功能说明

  • 🚀 三端分离架构：Vue3管理后台 + UniApp移动端（H5/App/小程序）+ Node.js API服务，独立构建部署
  • 💬 即时消息系统：文本/图片/视频/语音消息收发，WebSocket实时推送，消息已读状态跟踪
  • 🔒 完整认证体系：JWT双Token机制（Access+Refresh），管理员与普通用户双层权限，bcrypt密码加密
  • 👥 好友社交关系：好友请求/接受/拒绝，好友列表管理，扫码添加好友，在线状态感知
  • 📁 文件与富媒体：图片/视频/语音消息发送，富文本编辑器（wangeditor），Excel导入导出
  • ⚙️ 管理后台运维：用户管理/封禁/密码重置，系统配置管理，动态主题换肤，多布局菜单

🎬 视频教程（10倍速版）压缩包内原速视频

🛠 源码信息

界面语言 中英双语 i18n（admin: vue-i18n / app: 自研i18n，均有zh与en两套完整语言包）
开源状态 完全开源（MIT License）
是否加密 无加密（所有源码均未混淆、未加密，可直接阅读修改）
二开多语言 完全支持（已有中英文语言文件，基于i18n架构，扩展新语言只需添加翻译文件）
数据库兼容 已修复（见下方数据库兼容性专题）

📋 技术栈

后端 Node.js + Express 4.21 + WebSocket (ws) + mysql2 3.22 + JWT + bcrypt
前端（管理后台） Vue 3.5 + TypeScript 5.6 + Vite 7 + Element Plus 2.11 + Pinia 3 + ECharts 6
移动端 UniApp 3.0 + Vue 3 + Framework7 9（一套代码输出H5/App/微信小程序）
数据库 MySQL 8.0 + InnoDB + utf8mb4（完整迁移脚本，6个SQL文件覆盖所有表结构）
环境 Node.js ≥ 16.9（server）/ ≥ 20.19（admin） / pnpm ≥ 8.8（admin）/ npm（app & server）

⚠️ 数据库兼容性重点说明

这是亲测过程中遇到的一个关键兼容性问题，特别说明：

  • 问题现象：项目在 Windows（MySQL 8.0.12）运行正常，部署到 Linux（MySQL 8.0.45）后，所有带 LIMIT/OFFSET 的分页查询报错 ER_WRONG_ARGUMENTS (1210)
  • 根因：MySQL 从 8.0.22 开始对预处理语句参数类型实施严格检查。LIMIT ? OFFSET ? 只接受整数类型，但 mysql2 的 execute() 对 JS number 按 DOUBLE 编码，被 MySQL 8.0.22+ 拒绝
  • 修复方案：将 db.js 中的 pool.execute() 替换为 pool.query()，文本协议不受参数类型检查限制，全版本兼容，已修复！
  • 参考链接：mysql2 Issue #1239 · mysql2 Issue #2793 · MySQL Bug #101284

💬 常见问题

Q：源码是什么界面语言？能扩展多语言吗？

A：中英双语。管理后台基于 vue-i18n，移动端有自研 i18n 模块，两端都已有完整的中文和英文语言文件（admin: zh.json + en.json / app: zh-CN.js + en-US.js）。支持扩展多语言，新增语言只需添加对应翻译文件即可。

Q：是否全开源？有无加密？

A：完全开源，无任何加密和混淆。源码可直接阅读、修改、审计。采用 MIT License 协议，可商用可二开。源码中未发现任何后门或加密远程调用。

Q：怎么部署？包技术支持吗？

A：项目分三端独立部署：
① server/：npm install && node src/index.js，需先导入 SQL 迁移脚本并配置 .env
② admin/：pnpm install && pnpm build，生成 dist 目录部署到 Web 服务器
③ app/：npm install && npm run build:h5（H5）/ build:app（App）/ build:mp-weixin（小程序）
✅ 数据库兼容已修复，MySQL 8.0 全版本（含 8.0.22+）均可正常运行。
不提供独立技术支持 内带视频搭建教程。

⚠️ 本源码仅供学习研究，请勿用于非法用途。
本站（k8code / K8源码网）更多亲测源码持续更新中

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。