安装

服务器要求

MoChat 对系统环境有一些要求，仅可运行于 Linux 和 Mac 环境下，但由于 Docker 虚拟化技术的发展，在 Windows 下也可以通过 Docker for Windows 来作为运行环境，通常来说 Mac 环境下，我们更推荐本地环境部署，以避免 Docker 共享磁盘缓慢导致 MoChat 启动速度慢的问题。

提示

MoChat 基于 Docker-compose 方式的安装视频 https://www.bilibili.com/video/BV1Dy4y1n77N/安装 - 图1 (opens new window)

mochat-cloud\mochat-docker安装 - 图2 (opens new window) 项目内已经为您准备好了各种版本的 Dockerfile ，或直接基于已经构建好的 mochat\mochat安装 - 图3 (opens new window) 镜像来运行。

以上 Github 暂未提交，请暂时参考项目中的 api-server/Dockerfile

当您不想采用 Docker 来作为运行的环境基础时，您需要确保您的运行环境达到了以下的要求：

  • PHP >= 7.4 (推荐7.4版本)
  • MYSQL >= 5.7
  • Swoole PHP 扩展 >= 4.5，并关闭了 Short Name
  • OpenSSL PHP 扩展
  • JSON PHP 扩展
  • PDO PHP 扩展
  • Redis PHP 扩展
  • pcntl PHP 扩展
  • Composer
  • FFMpeg（会话存档功能需要）
  • wxwork_finance_sdk PHP 扩展 （会话存档功能需要）
  • Node.js >= 10

安装 MoChat

MoChat 使用 Composer安装 - 图4 (opens new window) 来管理项目的依赖，在使用 MoChat 之前，请确保你的运行环境已经安装好了 Composer。

  • 建议将 Composer 镜像设置为阿里云镜像，加速国内下载速度

视情况而定

  1. composer config -g repo.packagist composer https://mirrors.aliyun.com/composer

项目下载

  • 假设项目相关代码都放在 /data/www 目录
  1. cd /data/www
  2. git clone https://github.com/mochat-cloud/mochat.git

PHP接口环境安装

Shell 安装方式

  • 为了方便非 docker 用户，我们额外提供了一个install.sh CentOS 下的环境安装脚本，你可以直接在相应的系统上运行。
  1. # 安装linux软件如 php、swoole、FFMpeg、wxwork_finance_sdk等等(为避免软件冲突覆盖，本安装不会自动创建软链接，需要根据脚本提示手动创建，请放心执行)
  2. cd /usr/local/src
  3. wget https://mochatcloud.oss-cn-beijing.aliyuncs.com/deploy/CentOS-install.sh
  4. chmod o+x ./CentOS-install.sh
  5. sh ./CentOS-install.sh

如自行编译安装 PHP 相关环境，wxwork_finance_sdk 的安装可参考：https://github.com/oh-stone/wework-chatdata-sdk安装 - 图5 (opens new window)

确认相关环境正确安装
  1. # 查看 PHP 版本是否正确，需 >= 7.4
  2. php -v
  4. # 查看 Swoole 版本安装是否正确，并确定 `swoole.use_shortname` 参数值为 `Off` 
  5. php --ri swoole
  7. # 查看 Reids wxwork_finance_sdk 扩展是否正确安装
  8. php --ri redis
  9. php --ri wxwork_finance_sdk
  11. # FFMpeg
  12. ffmpeg -version
  14. # 确保内存大于 1024M
  15. php -i | grep memory_limit
  17. # 以下函数不能禁用
  18. # symlink,putenv,proc_open,pcntl系列函数
  1. # 安装PHP依赖(./api-server目录下)
  2. cd /data/www/mochat/api-server
  3. composer install
  5. # 初始化项目，执行项目初始化命令，设置MySQL、Redis、OSS、默认用户等信息
  6. cp .env.example .env
  7. php bin/hyperf.php mc:init
  9. # 运行项目 (推荐使用Supervisor后台守护，具体使用可参考 Hyperf 官方文档-Supervisor部署)
  10. php bin/hyperf.php start
  11. # 或后台启动
  12. php bin/hyperf.php server:start -d
  14. # 或开发环境也可以使用 watch 命令来进行热更新
  15. php bin/hyperf.php server:watch
  • 如果 mc:init 执行失败，可参考：
  1. # 1、将 .env 中的 DB REDIS OSS DOMAIN 配置完成
  2. # 2、将数据库文件导入初始化 api-server/storage/install/mochat.sql
  3. # 3、执行初始租户和账号信息 SQL ，请注意修改下面的手机号和服务器IP，以下用户密码是 13412347867和123456
  4. # 4、使用下面的命令生成新密码，然后用SQL替换到 user 表里的密码就可以。
  6. php -r "var_dump(password_hash(md5('具体密码' . ".env中的SIMPLE_JWT_SECRET"), PASSWORD_BCRYPT));"
  8. INSERT INTO `mc_user` (`phone`,`password`,`status`,`isSuperAdmin`) VALUES ('13412347867','这里填写生成的加密后的密码',1,1);
  10. INSERT INTO `mc_tenant` (`server_ips`) VALUES ('["182.92.11.11"]');

由于 MoChat 是持久化的 CLI 框架，当您修改完您的代码后，通过 CTRL + C 终止当前启动的进程实例，并重新执行 php bin/hyperf.php start 启动命令即可。

Docker 方式安装

  • 为了节省复杂度，我们推荐您使用项目下已经编写好的 Dockerfile 环境
  • 开发、测试环境下，您可以使用docker-compose.sample.yml来直接运行容器
  • 线上正式环境，我们推荐使用K8S，使用滚动更新来应对系统的平滑重启
  1. # 需要您在服务器上安装`docker/docker-compose`，并且开启了`docker`
  2. cp docker-compose.sample.yml docker-compose.yml
  4. # 初始化项目
  5. docker-compose build
  7. # 运行容器服务(如果要初始化项目，可以将启动命令改为`php bin/hyperf.php mc:init`)
  8. docker-compose up

存在兼容性问题的扩展

由于 Hyperf 基于 Swoole 协程实现，而 Swoole 4 带来的协程功能是 PHP 前所未有的，所以与不少扩展都仍存在兼容性的问题。
以下扩展（包括但不限于）都会造成一定的兼容性问题，不能与之共用或共存：

  • xhprof
  • xdebug
  • blackfire
  • trace
  • uopz

前端项目编译

  • 项目安装前，需要安装 Node.js，目前已知 15.x 版本下项目编译会有问题。

  • 修改 .env 中的配置 VUE_APP_API_BASE_URL=接口地址，以下的4种都是正确的格工，请根据您的实际情况进行配置。

  1. # 1、HTTP协议方式
  2. VUE_APP_API_BASE_URL=http://api.mochat.com
  4. # 2、HTTPS协议方式
  5. VUE_APP_API_BASE_URL=https://api.mochat.com
  7. # 3、HTTP协议与HTTPS协议同时兼容方式
  8. VUE_APP_API_BASE_URL=//api.mochat.com
  10. # 4、子目录模式(需根据实际 Nginx 配置来确定是否 URL中是否需要加 api )
  11. VUE_APP_API_BASE_URL=http://scrm.mochat.com/api

H5侧边栏编译

  1. cd /data/www/mochat/sidebar
  2. cp .env.example .env
  3. # 修改.env中的接口地址
  4. vim .env
  5. yarn install
  6. yarn run build

商户管理后台编译

  1. cd /data/www/mochat/dashboard
  2. cp .env.example .env
  3. # 修改.env中的接口地址
  4. vim .env
  5. yarn install
  6. yarn run dll
  7. yarn run build

运营工具H5编译

  1. cd /data/www/mochat/operation
  2. cp .env.example .env
  3. # 修改.env中的接口地址
  4. vim .env
  5. yarn install
  6. yarn run build

Nginx 配置

在这里我们会用到三个域名

  • api.mochat.com 后端接口域名 api-server 对应的域名
  • scrm.mochat.com 商户后台域名 dashboard 对应的域名
  • sidebar.mochat.com 聊天侧边栏域名 sidebar 对应的域名
  • op.mochat.com 运营工具H5域名 operation 对应的域名

项目位置 /data/www/mochat

后端-接口配置

  1. server {
  2.     # 监听端口
  3.     listen 80; 
  4.     # 绑定的域名，填写您的域名
  5.     server_name api.mochat.com;
  7.     location / {
  8.         # 将客户端的 Host 和 IP 信息一并转发到对应节点  
  9.         proxy_set_header Host $http_host;
  10.         proxy_set_header X-Real-IP $remote_addr;
  11.         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  13.         # 转发Cookie，设置 SameSite
  14.         proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";
  16.         # 执行代理访问真实服务器
  17.         proxy_pass http://127.0.0.1:9501;
  18.     }
  19. }

前端-PC后台配置

  1. server {
  2.     listen 80;
  3.     server_name scrm.mochat.com;
  5.     access_log /var/log/nginx/scrm.mochat.com.log main;
  6.     error_log /var/log/nginx/scrm.mochat.com.log.err error;
  7.     fastcgi_intercept_errors off;
  8.     rewrite_log off;
  10.     location / {
  11.         root /data/www/mochat/dashboard/dist;
  12.         index index.html;
  13.         try_files $uri $uri/ /index.html;  
  14.     }
  16.     location /authRedirect {
  17.         proxy_set_header Host $http_host;
  18.         proxy_set_header X-Real-IP $remote_addr;
  19.         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  20.         # http时使用下面的配置
  21.         proxy_cookie_path / "/; HttpOnly; SameSite=strict";
  22.         # https时使用下面的配置
  23.         # proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";
  25.         proxy_pass http://127.0.0.1:9501/dashboard/officialAccount/authRedirect/;
  26.     }
  28.     location ~* \.(?:jpg|jpeg|png|gif|ico|css|js)$ {
  29.         # 缓存30天
  30.         expires 30d;
  31.     }
  33.     location = /favicon.ico {
  34.             log_not_found off;
  35.             access_log off;
  36.     }
  37. }

前端-H5侧边栏配置

  1. server {
  2.     listen 80;
  3.     server_name sidebar.mochat.com;
  5.     access_log /var/log/nginx/sidebar.mochat.com.log main;
  6.     error_log /var/log/nginx/sidebar.mochat.com.log.err error;
  7.     fastcgi_intercept_errors off;
  8.     rewrite_log off;
  10.     location / {
  11.         root /data/www/mochat/sidebar/dist;
  12.         index index.html;
  13.         try_files $uri $uri/ /index.html;
  14.     }
  16.     location ~* \.(?:jpg|jpeg|png|gif|ico|css|js)$ {
  17.         # 缓存30天
  18.         expires 30d;
  19.     }
  20.     location = /favicon.ico {
  21.             log_not_found off;
  22.             access_log off;
  23.     }
  25. }

前端-运营工具栏配置

  1. server {
  2.     listen 80;
  3.     server_name op.mochat.com;
  5.     access_log /var/log/nginx/op.mochat.com.log main;
  6.     error_log /var/log/nginx/op.mochat.com.log.err error;
  7.     fastcgi_intercept_errors off;
  8.     rewrite_log off;
  10.     location / {
  11.         root /data/www/mochat/operation/dist;
  12.         index index.html;
  13.         try_files $uri $uri/ /index.html;
  14.     }
  16.     location ^~ /auth/ {
  17.             proxy_set_header Host $http_host;
  18.             proxy_set_header X-Real-IP $remote_addr;
  19.             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  20.             # http时使用下面的配置
  21.             proxy_cookie_path / "/; HttpOnly; SameSite=strict";
  22.             # https时使用下面的配置
  23.             # proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";
  25.             proxy_pass http://127.0.0.1:9501/operation/auth/;
  26.        }
  28.    location ^~ /openUserInfo/ {
  29.         proxy_set_header Host $http_host;
  30.         proxy_set_header X-Real-IP $remote_addr;
  31.         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  32.         # http时使用下面的配置
  33.         proxy_cookie_path / "/; HttpOnly; SameSite=strict";
  34.         # https时使用下面的配置
  35.         # proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";
  37.         proxy_pass http://127.0.0.1:9501/operation/openUserInfo/;
  38.    }
  40.     location ~* \.(?:jpg|jpeg|png|gif|ico|css|js)$ {
  41.         # 缓存30天
  42.         expires 30d;
  43.     }
  44.     location = /favicon.ico {
  45.             log_not_found off;
  46.             access_log off;
  47.     }
  49. }

运行

登录