【亲测免费】 MoChat 开源项目常见问题解决方案

1. 项目基础介绍及主要编程语言

MoChat 是一个基于企业微信的开源 SCRM 应用开发框架和引擎，同时也是一套通用的企业私域流量管理系统。它提供了丰富的功能，如引流获取、客户转化、客户管理、客户群管理、聊天侧边栏和企业风控等，旨在帮助企业在电商、金融、零售、餐饮服装等服务行业更好地利用企业微信与客户建立强联系。

主要编程语言：

• 前端技术栈：Vue、Vuex、Vant、Ant Design of Vue
• 后端技术栈：PHP、MySQL、Redis、Swoole、Hyperf

2. 新手常见问题及解决步骤

问题一：如何安装和运行 MoChat 项目？

解决步骤：

1. 确保安装了以下环境：

   • PHP >= 7.4（推荐 7.4 版本）
   • Swoole >= 4.5
   • Wxwork_finance_sdk (SO扩展)
   • pcntl 扩展
   • Composer
   • MySQL >= 5.7
   • Redis
   • FFmpeg
   • Node.js >= 10

2. 克隆项目代码：

   git clone https://github.com/mochat-cloud/mochat.git
   cd /path/to/mochat/api-server
   

3. 安装依赖：

   composer install
   

4. 运行 PHP 服务：

   php bin/hyperf.php start
   

问题二：如何配置前端环境？

解决步骤：

1. 进入前端项目目录：

   cd /path/to/mochat/dashboard
   

2. 安装依赖：

   yarn install
   

3. 编译生成 dist 文件夹：

   yarn run build
   

4. 修改 env 中的配置，设置接口地址：

   VUE_APP_API_BASE_URL=你的接口地址
   

问题三：项目部署时遇到问题怎么办？

解决步骤：

1. 后端部署：

   • 使用 Docker：推荐根据 api-server/Dockerfile 使用 K8S 部署。
   • 使用 Shell：运行 linux-install.sh 脚本安装必要依赖。

   cd /usr/local/src && wget https://urlthink-mochat-cloud-oss-cn-beijing.aliyuncs.com/deploy/CentOS-install.sh && /CentOS-install.sh Nginx
   

2. 前端部署：

   • 当项目开发完毕，运行以下命令打包应用：

     yarn run build
     

   • 打包成功后，会在根目录生成 dist 文件夹，里面包含了构建打包好的文件（通常是 js、css、index.html 等静态文件）。
   • 将 dist 文件夹的静态文件发布到你的 Nginx 或静态服务器即可。

以上是针对新手在使用 MoChat 项目时可能遇到的三个常见问题及其详细解决步骤。希望对您有所帮助！