默往IM即时通讯源码说明及搭建教程

一、系统概述

二、核心功能与多端特性

（一）核心电商功能

• 即时通讯核心：支持单人聊天、多人群组聊天，消息实时推送，包含文本、图片、文件等多种消息格式，支持消息已读未读状态标记、消息撤回与删除。
• 用户管理：支持用户注册、登录、信息编辑、密码重置，支持角色权限划分（管理员、普通用户等），可对用户账号进行启用/禁用管控。
• 通讯录管理：支持好友添加、删除、分组，支持部门架构创建与管理，适配企业内部组织架构展示与人员查找。
• 后台管控：提供可视化后台管理界面，支持消息日志查询、用户数据统计、系统参数配置（如消息推送频率、文件上传大小限制等）。
• 系统稳定性：具备完善的异常处理机制，支持高并发消息处理，数据传输采用加密方式，保障通讯安全与数据隐私。

（二）多端适配特性

• Web端适配：支持通过浏览器访问使用，适配各类电脑、平板设备，无需额外安装客户端，便捷性强。
• PC客户端适配：支持打包生成Windows、MacOS客户端，提供更稳定的本地运行体验，支持后台运行与消息托盘提醒。
• 移动端适配：支持对接移动端应用（iOS/Android），可通过API接口实现移动端与Web端、PC端消息同步，满足多终端使用需求。

三、测试与运行环境要求

• Web服务器：Nginx 1.22
• 编程语言：PHP 7.4
• 数据库：MySQL 5.7
• 缓存组件：Redis 7.0
• 运行环境：Linux（推荐CentOS 7及以上版本）、Windows Server 2016及以上版本；需安装Node.js 14.17
• 开发工具：推荐PHPStorm、VS Code；Node.js相关依赖需通过npm安装
• 依赖组件：需安装PHP相关扩展（如PDO、GD、Redis扩展等）、MySQL驱动、Node.js相关依赖包（根据源码说明文档安装）

四、详细搭建教程

（一）前期环境准备

1. 安装Nginx

1. 安装yum-utils工具：yum -y install yum-utils
2. 配置Nginx 1.22 yum源：创建/etc/yum.repos.d/nginx.repo文件，写入以下内容：[nginx-stable]name=nginx stable repobaseurl=http://nginx.org/packages/centos/$releasever/$basearch/gpgcheck=1enabled=1gpgkey=https://nginx.org/keys/nginx_signing.keymodule_hotfixes=true[nginx-mainline]name=nginx mainline repobaseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/gpgcheck=1enabled=0gpgkey=https://nginx.org/keys/nginx_signing.keymodule_hotfixes=true
3. 安装Nginx 1.22：yum -y install nginx-1.22.0（指定版本确保适配）
4. 启动Nginx并设置开机自启：systemctl start nginx、systemctl enable nginx
5. 验证安装：浏览器输入服务器IP，若出现Nginx默认页面则安装成功。

2. 安装MySQL 5.7

1. 安装依赖包：yum -y install libaio libncurses*
2. 创建MySQL用户组及用户：groupadd mysql、useradd -r -g mysql -s /bin/false mysql
3. 下载并解压MySQL 5.7安装包：mkdir /mysqlwget https://downloads.mysql.com/archives/get/p/23/file/mysql-5.7.33-linux-glibc2.12-x86_64.tar.gztar -zxvf mysql-5.7.33-linux-glibc2.12-x86_64.tar.gzmv mysql-5.7.33-linux-glibc2.12-x86_64 mysqlmv mysql /
4. 创建mysql-files目录并授权：mkdir /mysql/mysql-files、chown mysql:mysql /mysql/mysql-files、chmod 750 /mysql/mysql-files
5. 初始化MySQL：/mysql/bin/mysqld --initialize --user=mysql --basedir=/mysql（记录初始化生成的临时密码）
6. 配置MySQL服务：修改/mysql/support-files/mysql.server，设置basedir=/mysql、datadir=/mysql/data，然后将服务添加到系统：cp /mysql/support-files/mysql.server /etc/init.d/mysqld
7. 启动MySQL并设置开机自启：systemctl start mysqld、systemctl enable mysqld
8. 修改初始密码：登录MySQL（/mysql/bin/mysql -u root -p），执行以下命令：SET PASSWORD = PASSWORD('新密码');ALTER USER 'root'@'localhost' PASSWORD EXPIRE NEVER;flush privileges;

3. 安装PHP 8.2

1. 配置PHP 7.4 yum源：yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm、yum -y install https://rpms.remirepo.net/enterprise/remi-release-7.rpm
2. 启用PHP 7.4模块：yum-config-manager --enable remi-php74
3. 安装PHP 7.4及扩展：yum -y install php-7.4 php-fpm-7.4 php-mysqlnd php-gd php-redis php-mbstring php-xml php-json
4. 配置PHP-FPM：修改/etc/php-fpm.d/www.conf，将用户和组改为nginx：user = nginx、group = nginx
5. 启动PHP-FPM并设置开机自启：systemctl start php-fpm、systemctl enable php-fpm

3. 安装Redis 7.0

1. 配置Redis yum源：创建/etc/yum.repos.d/redis.repo文件，写入以下内容：[redis]name=Redis Repositorybaseurl=http://rpms.remirepo.net/enterprise/7/redis/x86_64/enabled=1gpgcheck=1gpgkey=http://rpms.remirepo.net/RPM-GPG-KEY-remi
2. 安装Redis 7.0：yum -y install redis-7.0.0
3. 配置Redis：修改/etc/redis.conf，根据需求调整绑定IP、端口、密码等参数（默认端口6379）
4. 启动Redis并设置开机自启：systemctl start redis、systemctl enable redis
5. 验证安装：执行redis-cli ping，若返回PONG则安装成功。

4. 安装Node.js 14.17

1. 下载Node.js 14.17安装包：wget https://nodejs.org/dist/v14.17.0/node-v14.17.0-linux-x64.tar.xz
2. 解压安装包：tar -xvf node-v14.17.0-linux-x64.tar.xz，并移动到指定目录：mv node-v14.17.0-linux-x64 /usr/local/nodejs
3. 配置环境变量：编辑/etc/profile文件，添加以下内容：export PATH=$PATH:/usr/local/nodejs/bin，执行source /etc/profile生效
4. 验证安装：执行node -v和npm -v，若显示对应版本号则安装成功。

（二）源码部署

1. 上传源码：将默往IM即时通讯源码通过FTP或SSH工具上传至服务器指定目录（如/usr/share/nginx/html/mowang-im），并设置目录权限：chown -R nginx:nginx /usr/share/nginx/html/mowang-im、chmod -R 755 /usr/share/nginx/html/mowang-im
2. 配置Nginx虚拟主机：创建/etc/nginx/conf.d/mowang-im.conf文件，写入以下配置（根据实际域名调整）：server {listen 80;server_name your-domain.com; # 替换为你的域名root /usr/share/nginx/html/mowang-im;index index.php index.html;location / {try_files $uri $uri/ /index.php?$query_string;}location ~ \.php$ {fastcgi_pass 127.0.0.1:9000;fastcgi_index index.php;fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;include fastcgi_params;}# 适配Node.js相关服务代理（根据源码需求配置）location /socket.io {proxy_pass http://127.0.0.1:3000; # 假设Node.js服务运行在3000端口proxy_http_version 1.1;proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade";proxy_set_header Host $host;}}
3. 重启Nginx：systemctl restart nginx
4. 导入数据库：登录MySQL，创建数据库（create database mowang_im charset utf8mb4;），然后导入源码中自带的SQL文件：source /usr/share/nginx/html/mowang-im/sql/mowang_im.sql;
5. 配置数据库连接：修改源码中数据库配置文件（如/usr/share/nginx/html/mowang-im/config/database.php），填写数据库地址、用户名、密码、数据库名；同时修改Redis配置文件（如/usr/share/nginx/html/mowang-im/config/redis.php），配置Redis连接信息。
6. 启动Node.js服务：进入源码Node.js服务目录（如/usr/share/nginx/html/mowang-im/node-server），执行npm install安装依赖，再执行node app.js启动服务（建议使用pm2管理进程：npm install -g pm2、pm2 start app.js）。
7. 访问验证：浏览器输入域名，若出现登录页面或系统首页，则源码部署成功。

（三）Uniapp小程序打包发布

1. 若源码包含PC/移动端客户端源码，需安装对应开发工具：PC端可使用VS Code，移动端可根据源码类型安装Android Studio（安卓）、Xcode（iOS）。
2. 导入客户端源码：打开对应开发工具，导入客户端源码目录，配置项目基础信息（如应用名称、图标、接口请求地址等）。
3. 接口对接配置：修改客户端源码中的接口请求地址，确保与服务器端部署的默往IM服务地址一致，实现客户端与服务器的数据交互。
4. 调试运行：在开发工具中启动调试模式，测试消息发送/接收、用户登录等核心功能，排查接口对接或功能异常问题。
5. 打包发布：调试完成后，根据需求打包生成PC客户端安装包、Android APK、iOS IPA文件，进行发布部署。

五、合规经营注意事项