Dify 离线升级操作手册

🚀 Dify 离线环境升级终极指南 (v1.4.0+)

本指南旨在帮助企业在无互联网连接（Air-gapped）的内网环境中，安全、平滑地升级 Dify 平台。适用于对数据安全有严格要求的金融、政务及大型企业场景。

📋 一、准备工作清单

1.1 环境要求确认
外网机器：
操作系统：Linux (推荐 Ubuntu 20.04+/CentOS 7+) 或 Windows 10/11 + Docker Desktop。
Docker 版本：建议 20.10+ (需与内网版本兼容)。
磁盘空间：至少预留 20GB 用于存放镜像和代码包。
内网机器：
Docker & Docker Compose 已安装并运行正常。
当前 Dify 运行状态健康。
磁盘空间：确保 /var/lib/docker 及数据挂载目录有足够空间（建议预留 30GB+，以防旧镜像未清理或数据膨胀）。
传输介质：
大容量 U 盘/移动硬盘（建议格式化 exFAT 以支持 >4GB 单文件）。
或通过企业内部的 FTP/SFTP/NAS 共享路径传输。

1.2 信息收集与备份策略
在执行任何操作前，必须记录以下信息：
当前版本号：登录 Dify 前端查看，或执行 docker exec cat /app/version。
配置文件：找到 .env 文件位置（通常在 docker 目录下），务必备份。
自定义配置：检查 docker-compose.yaml 是否有端口映射、卷挂载的特殊修改。

⚠️ 核心原则：先备份，后操作！ 没有备份严禁开始升级。

🌐 二、外网机器操作步骤