# 1.3 升级指南

此为创业版、旗舰版 1.3.0 升级指南，使用开源版本请忽略。

1.3.0 版主要是功能新增，也对一些优化进行了重构优化，如果您的项目已经投入了业务使用，那么可以根据下面的内容点来调整您的项目。如果您是一个新的项目，按照文档重新安装即可。

# 功能更新概要

【新增功能】超管后台：新增超管平台、含租户管理、套餐管理、代理管理、订单管理、系统设置、OEM设置(部份功能为旗舰版特有)
【新增功能】配置管理：带有引导教程的企业接入模式
【代码优化】公共底层：优化部份接口为公共权限无需单独增加权限
【代码优化】公共底层：优化部份模块使用base64上传图片导致保存失败问题
【代码优化】会话存档：同步企业微信消息更改为秒级实时同步
【Bug修复】客户消息群发：修复非文本类型失败问题
【Bug修复】批量加好友：修复添加后状态未变化问题
【Bug修复】批量加好友：修复应用提醒页面状态显示为数字问题
【Bug修复】批量加好友：修复数据统计页面中“待添加客户数”统计不正确
【Bug修复】批量加好友：修复导入记录页面中点击【提醒】没有发送请求
【Bug修复】批量加好友：修复客户被员工添加后，导入记录中成功添加数量仍然是0问题
【Bug修复】批量加好友：修复导入表格备注为空时报SQL错误问题
【Bug修复】侧边栏：修复添加多个待办时报错问题
【Bug修复】侧边栏：修复跟进记录员工名称不存在问题
【Bug修复】互动雷达：修复雷达链接在企业微信中无法打开问题
【Bug修复】互动雷达：修复创建PDF互动雷达成功后，跳转到的页面是互动雷达链接页面，而不是PDF列表页面问题
【Bug修复】互动雷达：修复编辑页面链接封面图片没有显示问题
【Bug修复】互动雷达：创建渠道时选择员工了，但列表中没有展示是哪个员工问题
【Bug修复】互动雷达：修复互动雷达应用提醒通知查看客户详情链接无法打开问题
【Bug修复】侧边栏：修复跟进记录员工名称不存在问题
【Bug修复】标签拉群：修复数组索引名称错误问题
【Bug修复】标签拉群：修复选中【全部客户】时候，查看预计送达人数，提示请设置添加时间问题
【Bug修复】会话存档：修复聊天记录人员过多时样式溢出且分页无效问题
【Bug修复】任务宝：修复转发话术设置关闭，保存后还是显示已经开启问题
【Bug修复】任务宝：修复创建活动失败后，一直在完成loading,无法再次提交，只能重头开始填问题
【Bug修复】任务宝：修复修改设置推送消息报500问题
【Bug修复】抽奖活动：修复最下面两个添加不上兑奖方式问题
【Bug修复】抽奖活动：修复创建活动-选择两个标签，然后创建一个标签组，选择后创建页面标签重复显示问题
【Bug修复】群裂变：修复创建多次点击会重复创建问题
【Bug修复】群裂变：修复创建页面中必填项不填也可以进行下一步问题
【Bug修复】门店活码：修复扫码加入门店群、扫码加入城市群设置页面无效问题
【Bug修复】门店活码：修复加载群二维码失败，需要在其他地方 load 之后才能看到问题
【Bug修复】门店活码：修复扫码添加店主的地址和扫码添加门店地址会相同时会提示地址重复无法添加问题
【Bug修复】门店活码：修复打开扫码加入门店群的投放链接后，打开的页面提示“页面未设置”
【Bug修复】渠道活码：修复创建页面中客户标签的子标签需要点击两次才能被选中问题
【Bug修复】渠道活码：修复新建页面在“选择素材”弹窗中选择不了分组
【Bug修复】渠道活码：修复新建活码时，员工添加上限设置为1时，生成的活码没有二维码问题
【Bug修复】用户管理：修复用户修改密码限制无法输入带特殊符号的原密码问题
【Bug修复】敏感词监控：修复按照当日日期查询不返回结果问题
【Bug修复】引流链接：修复客户将企业微信联系人删除后，引流链接详情页面报500问题
【Bug修复】客户群管理：修复客户群列表列表无法选择群主问题
【Bug修复】客户管理：修复客户详情直接显示代码问题
【Bug修复】客户待办：修复应用提醒通知查看客户详情链接无法打开问题

# 升级前请查看当前系统版本号，执行以下命令

cd /www/wwwroot/mochat
php bin/hyperf.php mochat:version

# 记录下当前版本号，如果不是版本 1.2.1，后面需要注意升级多次

# 备份原有配置文件和数据库

备份以下配置文件：
- api-server/.env
- dashboard/.env
- sidebar/.env
- operation/.env
如果使用本地存储文件，刚备份文件上传目录
- api-server/storage/upload
备份 MySQL 数据库

# 将原代码目录改名

mv /www/wwwroot/mochat /www/wwwroot/mochat_old

# 下载新的代码并重新安装依赖

# cd /www/wwwroot
# 此步如果是商业版，请将以下地址改为 gitee 私有地址
# git clone https://github.com/mochat-cloud/mochat.git
# cd /www/wwwroot/mochat/api-server
# composer install

# 将备份的api-server/.env复制过来
# cp /www/wwwroot/mochat_old/api-server/.env .env

# 如果是本地存储文件，将上传文件复制过来
# cp -R /www/wwwroot/mochat_old/api-server/storage/upload ./storage/

# 执行升级脚本

# 未二次开发过可以直接执行
# 如果二次开发过，增加过菜单，改过 mc_rbac_menu 表的，请自行对照升级SQL改为自己的升级SQL。
# 如果当前版本号是 1.2.1 请直接执行下面的命令
# php bin/hyperf.php mochat:upgrade 1.3.0

# 如果当前版本号不是 1.2.1 请执行升级中间的版本
# php bin/hyperf.php mochat:upgrade 1.2.0
# php bin/hyperf.php mochat:upgrade 1.2.1
# php bin/hyperf.php mochat:upgrade 1.3.0

# 执行后按提示输入超管后台账号密码

# 启动服务

cd /www/wwwroot/mochat/api-server
cp /www/wwwroot/mochat_old/api-server/.env .env
# 如果旧版服务未停止，可以使用下面的命令停止旧的api-server
ps aux | grep mochat |  awk '{print $2}' | xargs kill -9
# 加-d表示守护进程方式启动
php bin/hyperf.php server:start -d

# 依次配置各前端

租户后台前端重新编译

# 复制备份的配置文件
cd /www/wwwroot/mochat/dashboard
cp /www/wwwroot/mochat_old/dashboard/.env .env
yarn install
yarn run dll
yarn build

侧边栏前端重新编译

# 复制备份的配置文件
cd /www/wwwroot/mochat/sidebar
cp /www/wwwroot/mochat_old/sidebar/.env .env
yarn install
yarn build

运营工具前端编译

# 复制备份的配置文件
cd /www/wwwroot/mochat/operation
cp /www/wwwroot/mochat_old/operation/.env .env
yarn install
yarn build

# 配置新增超管后台前端

超管后台前端增加nginx配置

server {
    listen 80;
    server_name admin.mochat.com;

    access_log /var/log/nginx/admin.mochat.com.log main;
    error_log /var/log/nginx/admin.mochat.com.log.err error;
    fastcgi_intercept_errors off;
    rewrite_log off;

    location / {
        root /data/www/mochat/admin/dist;
        index index.html;
        try_files $uri $uri/ /index.html;
    }

    location /api/ {
        client_max_body_size   20m;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";

        # 执行代理访问真实服务器
        proxy_pass http://127.0.0.1:9501/;
    }

    location = /favicon.ico {
            log_not_found off;
            access_log off;
    }
    
}

打开超管后台域名即可添加和管理租户

← 1.4 升级指南 1.1 升级指南 →