Skip to content

Dify 应用低版本迁移帮助

在宝塔面板(BT Panel)Docker 环境中将 Dify 从 1.1.0 升级迁移至 1.1.3 的完整步骤与注意事项,含数据备份、环境变量处理与迁移验证。

更新于 查看 Markdown

Docker 应用 Dify 低版本迁移帮助

本文整理自宝塔论坛教程贴: 【教程贴】Docker应用-Dify低版本迁移帮助

本文以从 Dify 1.1.0 升级至 1.1.3 为例,介绍如何在保留数据卷的前提下完成迁移。

版本说明示意

前置说明

  • 迁移前请先备份旧版本容器及其数据卷,避免误操作导致数据丢失。
  • 安装新版本时注意端口不要冲突,保持与旧版本不同的暴露端口。
  • 安装完成后先不要访问 Web 界面,确保容器日志正常且无报错。

迁移步骤

  1. 操作前先备份旧版本容器(建议在面板内或命令行执行备份)。

  2. 从商店中拉取新版本 Dify(示例:从 1.1.0 升级至 1.1.3)。

    应用商店拉取示意1

    应用商店拉取示意2

    注意端口不要冲突,安装完成日志没有报错就行。

    端口冲突示意1

    端口冲突示意2

    不要访问 Web 界面,日志正常容器正常就行。

  3. 手动停止新版本 Dify 容器(保证复制时目标容器未占用数据卷)。

    停止新版本容器

    停止新版本 Dify 应用示意

    旧版本 Dify 应用示意

  4. 手动升级:停止掉新版本 Dify 应用后,进入终端执行数据迁移命令。

  5. 复制旧版本的 volumes 目录到新版本的 volumes 目录:

# 命令格式为
# \cp -r 旧版本 Dify 目录/volumes  新版本 Dify 目录/
# 要替换成你自己的命令,注意命令前的 \ 不能少
\cp -r /www/dk_project/dk_app/dify_v190/dify_v190_HGHK/volumes \
      /www/dk_project/dk_app/dify_v1100/dify_v1100_DFTk/
  • 验证复制结果:比较两个 volumes 目录的文件数与大小是否一致;如遇权限异常,尝试 \cp -a 或 rsync -a 重新复制。
  1. 复制完成后,启动新版本 Dify 容器。

    启动新版本容器

  2. 访问新版本预设端口,确认迁移成功(数据与配置应与旧版本一致)。

    访问预设端口示意1

    访问预设端口示意2

常见问题

  • 安装或拉取镜像失败:可尝试配置镜像加速站。
  • 新版本容器启动后不要立即访问 Web,先观察日志是否正常。
  • 如果是云服务器,务必在安全组开放对应端口(勾选“允许外部访问”仅穿过系统防火墙,仍需放行安全组)。

原帖链接

Navigation

Type to search…

↑↓ navigate↵ selectEsc close