【Dify】无网络环境下的Dify部署指南：从在线到离线的无缝迁移

1. 为什么需要离线部署Dify在企业级应用场景中数据安全和网络隔离是刚需。很多金融、政务、医疗机构的服务器都部署在内网环境完全与互联网物理隔离。这时候如果想使用Dify这样的AI应用开发平台常规的在线安装方式就完全行不通了。我去年给某三甲医院部署内部知识管理系统时就遇到过这种情况。他们的服务器机房连DNS解析都关闭了更别说访问GitHub或Docker Hub。当时我们摸索出的解决方案就是先在测试环境完成所有资源准备再通过安全审计流程将安装包导入生产环境。整个过程虽然繁琐但确实解决了核心问题。离线安装的核心难点在于依赖完整性。Dify作为现代化应用依赖包括Docker基础镜像超过2GBPython第三方库数百个依赖项前端node_modules数千个文件模型权重文件可能达数十GB2. 准备离线安装环境2.1 搭建在线预处理环境找一台能访问互联网的跳板机配置建议4核CPU/8GB内存/100GB磁盘这是整个离线安装的资源采集站。我推荐使用Ubuntu 22.04 LTS对Docker的兼容性最好。# 安装基础工具 sudo apt update sudo apt install -y git curl python3-pip # 安装Docker如果尚未安装 curl -fsSL https://get.docker.com | sudo sh sudo usermod -aG docker $USER newgrp docker注意这台机器最终不会用于生产环境仅用于打包离线资源。完成资源收集后可以销毁。2.2 下载Dify核心组件使用官方仓库的最新稳定版本避免开发版的兼容性问题git clone -b main https://github.com/langgenius/dify.git cd dify # 锁定版本示例用v0.3.5请替换为最新版本号 git checkout v0.3.5重要文件说明docker-compose.yml容器编排定义requirements.txtPython依赖清单web/package.json前端依赖清单3. 构建离线资源包3.1 下载Docker镜像Dify依赖的镜像包括langgenius/dify-apiAPI服务langgenius/dify-web前端界面postgres数据库redis缓存# 拉取所有镜像 docker compose pull # 保存镜像为tar包约3.5GB docker save -o dify-images.tar \ langgenius/dify-api:latest \ langgenius/dify-web:latest \ postgres:13 \ redis:63.2 打包Python依赖创建虚拟环境避免污染系统python3 -m venv .venv source .venv/bin/activate # 安装所有依赖 pip install -r requirements.txt # 打包依赖约500MB pip download -r requirements.txt -d python-packages3.3 前端资源处理cd web npm install --legacy-peer-deps # 打包node_modules约300MB tar czvf ../node_modules.tar.gz node_modules4. 离线环境部署实战4.1 传输资源到目标服务器将以下文件通过安全方式如内网FTP传输到目标服务器dify-images.tarDocker镜像包python-packages/Python依赖node_modules.tar.gz前端依赖原始代码目录4.2 加载Docker镜像# 加载所有镜像约5分钟 docker load -i dify-images.tar # 验证镜像 docker images | grep -E langgenius|postgres|redis4.3 恢复Python环境python3 -m venv .venv source .venv/bin/activate # 离线安装依赖 pip install --no-index --find-linkspython-packages -r requirements.txt4.4 启动服务修改.env文件关键配置# 数据库配置 POSTGRES_PASSWORDyour_strong_password REDIS_PASSWORDyour_strong_password # 关闭自动更新检查 AUTO_UPDATE_CHECKfalse启动服务docker compose up -d5. 常见问题排查5.1 端口冲突处理如果80端口被占用修改docker-compose.ymlservices: web: ports: - 8080:80 # 改为其他端口5.2 磁盘空间不足Dify运行需要至少20GB空闲空间。如果遇到空间问题# 清理旧镜像 docker system prune -f # 扩展Docker存储目录 sudo service docker stop sudo rsync -a /var/lib/docker /new/location sudo vim /etc/docker/daemon.json # 添加 data-root: /new/location/docker sudo service docker start5.3 浏览器兼容性问题离线环境通常使用老旧浏览器建议在web/src/polyfills.js中添加兼容代码降级前端依赖版本使用Firefox ESR等企业级浏览器6. 后续维护建议离线环境下的更新需要特殊流程在测试环境验证新版本兼容性按相同流程制作新版本资源包通过变更管理流程部署更新回滚方案保留旧版镜像包我在某制造企业的实施案例中为他们建立了专门的版本管理仓库每个版本都包含完整镜像包依赖库哈希校验文件版本变更说明书回滚操作手册