版本&升级说明

版本说明

从 4.14.11 开始，为了区分稳定版和快速迭代版，对版本命名进行了调整，未来将按以下方式进行版本命名：

1. 维护 2 个稳定版本。例如当前迭代功能处于 4.16.x 版本，则会维护 4.14.x 和 4.15.x 两个文档版本。
2. 稳定版本命名不带后缀，例如：4.14.11, 4.14.12, 4.15.0, 4.15.1。如果 4.14.11 有问题，会修复后发布 4.14.12，并同步修复到 4.15.x 的稳定版，以确保修复问题同时不引入新的功能。
3. 快速迭代版本命名带后缀，例如：4.16.0-beta.1, 4.16.0-beta.2, 4.16.0-beta.3。
4. 迭代版本约 2 个月发布一次稳定版，并且会提供一个聚合的升级脚本，用户只需要执行一次请求，即可完成所有迭代版本的升级。

总结来说，后续用户可以直接升级不带 beta 后缀的稳定版本，以确保稳定性，官方会单独发布修复版本并确保不会引入新功能。

升级说明

FastGPT 升级通常包括两个步骤：

1. 修改镜像名
2. 执行升级初始化脚本

镜像名

git版

• FastGPT 主镜像: ghcr.io/labring/fastgpt:latest
• Plugin 镜像: ghcr.io/labring/fastgpt-plugin
• 代码沙箱镜像: ghcr.io/labring/fastgpt-code-sandbox
• MCP SSE setver 镜像: ghcr.io/labring/fastgpt-mcp_server
• 商业版镜像: ghcr.io/c121914yu/fastgpt-pro:latest

阿里云

• FastGPT 主镜像: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt
• Plugin 镜像: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-plugin
• 代码沙箱镜像: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-code-sandbox
• MCP SSE setver 镜像: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-mcp_server
• 商业版镜像: ghcr:registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-pro

镜像由镜像名和Tag组成，例如: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.6.1 代表4.6.3版本镜像，具体可以看 docker hub, github 仓库。

Sealos 修改镜像

1. 打开 Sealos Cloud， 找到桌面上的应用管理

2. 选择对应的应用 - 点击右边三个点 - 变更

3. 修改镜像 - 确认变更

   如果要修改配置文件，可以拉到下面的配置文件进行修改。

Docker-Compose 修改镜像

直接修改yml文件中的image: 即可。随后执行:

docker-compose pull
docker-compose up -d

执行升级初始化脚本

镜像更新完后，可以查看文档中的版本介绍，通常需要执行升级脚本的版本都会标明包含升级脚本，打开对应的文档，参考说明执行升级脚本即可，大部分时候都是需要发送一个POST请求。

QA

为什么需要执行升级脚本

数据表出现大幅度变更，无法通过设置默认值，或复杂度较高时，会通过升级脚本来更新部分数据表字段。 严格按初始化步骤进行操作，不会造成旧数据丢失。但在初始化过程中，如果数据量大，需要初始化的时间较长，这段时间可能会造成服务无法正常使用。

{{host}} 是什么

{{}} 代表变量， {{host}}代表一个名为 host 的变量。指的是你服务器的域名或 IP。

Sealos 中，你可以在下图中找到你的域名：

如何获取 rootkey

从docker-compose.yml中的environment中获取，对应的是ROOT_KEY的值。

sealos 中可以从上图左侧的环境变量中获取。

如何跨版本升级！！

先进行数据备份！！！

可以升级至最新版本，然后将所有升级脚本的版本都执行一遍。不过为了稳定，建议逐一版本升级。例如，当前版本是4.4.7，需要升级到4.6。

1. 修改镜像到4.5，执行升级脚本
2. 修改镜像到4.5.1，执行升级脚本
3. 修改镜像到4.5.2，执行升级脚本
4. 修改镜像到4.6，执行升级脚本
5. .....

逐一升级