Dify 升级到最新版本操作指南

第一步：停止服务并备份

备份检查清单：

• • 数据库数据
• • 应用存储文件
• • 环境配置文件
• • 自定义配置

第二步：拉取最新代码

如果出现本地文件与远程文件冲突的提示，建议先备份本地修改，然后再强制覆盖为最新远程版本：

如涉及较多冲突，可多次执行上述步骤，确保所有冲突文件都已按需处理。

第三步：更新存储目录权限（关键步骤）

将storage目录设置成非root权限

验证权限设置：

预期输出：

权限说明：

• • 1001:1001 不是"权限"，而是用户ID(UID)和组ID(GID)
• • 即使系统中不存在名为 1001 的用户，这个命令也是有效的
• • Docker 容器内的进程以 UID 1001 运行，需要匹配主机权限

第四步：更新环境配置

重要配置项：

配置对比：

第五步：启动服务

常见启动问题：

如果看到类似错误：

解决方案：

第六步：验证升级

健康检查：

• • 所有容器状态为 Up
• • 没有 Permission Denied 错误
• • API 服务正常响应
• • Web 界面可以访问

第七步：功能验证

1. 1. 访问 Web 界面
   • • 打开 http://localhost 或配置的域名
   • • 检查登录是否正常
2. 2. 验证应用运行
   • • 测试已有应用是否正常工作
   • • 检查知识库是否可以访问
   • • 尝试创建新的对话
3. 3. 插件系统验证
   • • 点击右上角 "Plugins" 按钮
   • • 验证插件是否正确安装
   • • 检查内置工具是否已迁移到插件

方案二：源码部署

未经过实践尝试

第一步：停止服务

第二步：更新代码

第三步：更新依赖

第四步：数据库迁移

迁移注意事项：

• • 确保数据库连接正常
• • 建议在迁移前备份数据库
• • 迁移过程可能需要几分钟

第五步：重启服务

常见问题解决

问题 1: 权限错误

错误信息：

解决方案：

问题 2: 系统没有 UID 1001 用户

理解：

• • 1001:1001 是用户ID和组ID，不是用户名
• • Linux 可以使用纯数字 ID，无需实际用户存在

可选方案：创建用户

问题 3: SELinux 阻止访问

检查 SELinux：

问题 4: 数据库连接失败

错误信息：

解决方案：

问题 5: 插件无法访问

检查清单：

• • 确保可以访问 https://marketplace.dify.ai
• • 检查防火墙规则
• • 验证网络代理配置

测试连接：

问题 6: Weaviate 版本不兼容

错误信息：

解决方案：

回滚方案

如果升级后遇到严重问题，可以回滚到旧版本：

Docker Compose 回滚

源码部署回滚

升级后优化建议

1. 1. 性能监控

1. 2. 备份策略

建议设置定期备份：

设置定时任务：

1. 3. 日志管理

配置日志轮转：

1. 4. 安全加固

相关资源

浏览量: 1