更新升级指南

本指南将帮助您完成系统的更新升级操作，包括在线升级和手动升级两种方式，并提供常见问题的解决方案。

更新操作

重要提示：更新前请务必备份数据库和源码目录，防止更新失败！

方式 1：在线升级

适用条件

未进行二次开发或改变目录结构。

必须逐个版本升级。

操作步骤

关闭防跨站攻击：

登录宝塔面板，点击【网站列表】，选择项目网站【设置】->【网站目录】，临时去掉【防跨站攻击(open_basedir)】。

重启 Nginx：

点击【软件商店】，找到 Nginx，选择【设置】->【重启】。

重启 PHP：

点击【软件商店】，找到 PHP-8.0，选择【服务】->【重启】。

在线更新：

登录后台，点击【系统设置】->【系统维护】->【系统更新】，点击【一键更新】。

恢复防跨站攻击：

更新完成后，重新开启【防跨站攻击(open_basedir)】。

清理缓存：

登录后台，点击【系统设置】->【系统维护】->【系统缓存】->【清理缓存】。

重新发布小程序：

更新后，小程序需要重新发布。

方式 2：手动升级到最新版本

操作步骤

备份关键文件：

备份原项目的以下文件：

server/.env

server/config/install.lock

server/public/uploads

server/license/my.license

替换源码：

下载最新的源码包，删除原项目的 server 目录，替换为源码包中的 server 目录。

将备份的文件还原到对应的位置。

更新数据库结构：

如果正式上线的项目数据表前缀不是 ai_，需将 like.sql 中的前缀替换为实际前缀。

在本地或线上新建一个数据库，导入 like.sql。

使用工具（如 Navicat）同步新数据库的数据结构到线上项目。

更新常见问题

1. 在线升级提示未授权

① IP 未授权

联系客服获取授权文件证书上传文件到指定文件目录内

② 域名未授权

如果站点配置了多个域名，授权文件只支持单域名。删除未授权的域名即可。

2. 在线升级失败的其他原因

① 提示关闭跨域攻击

确保已关闭防跨站攻击，并重启 Nginx 和 PHP。

② 出现 500 错误

目录结构改变：二开或目录结构改变会导致无法升级。

目录权限不足：确保项目目录权限设置为 www 用户。

缺少 ZipArchive：确保 PHP 已安装 ZipArchive 扩展。

老版本必做

安装配置 Redis

安装 Redis：

在宝塔面板中安装 Redis 和 PHP 的 Redis 扩展。

配置 Redis：

打开 server/.env 文件，添加以下配置：

[QUEUE]
NAME = chatai
HOST = 127.0.0.1
PORT = 6379
PASSWORD =

版本更新注意事项

3.3.0 版本

确保已配置 Redis，未配置请参考上文。

3.4.0 版本

参考部署文档设置守护进程。

3.5.0 版本

执行数据迁移脚本：访问 https://(你的域名)/migration。

重新编译并提交小程序。

3.6.0 版本

Gemini 模型需设置反向代理。

SD 绘图需本地部署，并添加守护进程。

至此更新升级完成

通过以上步骤，您可以顺利完成系统的更新升级操作。如有任何问题，请参考相关文档或联系技术支持。

更新升级

更新升级指南#

更新操作#

方式 1：在线升级#

适用条件#

操作步骤#

方式 2：手动升级到最新版本#

操作步骤#

更新常见问题#

1. 在线升级提示未授权#

① IP 未授权#

② 域名未授权#

2. 在线升级失败的其他原因#

① 提示关闭跨域攻击#

② 出现 500 错误#

老版本必做#

安装配置 Redis#

版本更新注意事项#

3.3.0 版本#

3.4.0 版本#

3.5.0 版本#

3.6.0 版本#

至此更新升级完成#

更新升级指南

更新操作

方式 1：在线升级

适用条件

操作步骤

方式 2：手动升级到最新版本

操作步骤

更新常见问题

1. 在线升级提示未授权

① IP 未授权

② 域名未授权

2. 在线升级失败的其他原因

① 提示关闭跨域攻击

② 出现 500 错误

老版本必做

安装配置 Redis

版本更新注意事项

3.3.0 版本

3.4.0 版本

3.5.0 版本

3.6.0 版本

至此更新升级完成