Dify docker镜像下载

简介

Dify 是一个大语言模型应用开发平台，集成了 Backend as a Service（BaaS），可用于构建聊天机器人、知识库等应用。Docker 镜像把 Dify 运行所需的操作系统、Python 环境及其他依赖一次性封装进容器，避免逐项编译和本机环境冲突，适合希望在本地电脑或自有服务器上做私有化部署的开发者、运维与教学人员。它的核心优势是环境标准化、启动命令统一、数据与日志可持久化保存，换一台机器用同一套镜像即可复现相同运行状态。

核心功能

• 镜像交付环境：把操作系统、Python 运行时和依赖打包进镜像，一条拉取命令即可获得完整运行环境，省去逐个安装依赖的步骤。
• Compose 编排多服务：用一份 compose 配置同时拉起 Web 前端、后端接口、沙箱等多个容器，服务之间按配置文件定义的网络互通。
• Volume 持久化数据：数据库、上传文件等存放在 volume 中，容器删除重建后数据仍然保留，避免重启即清空。
• 日志辅助排障：通过容器日志与 compose 日志查看启动失败、连接数据库超时等报错，定位是镜像、网络还是配置问题。
• 沙箱镜像隔离执行：docker.io/langgenius/dify-ee-sandbox 是 Dify 企业版的沙箱环境镜像，为 AI 应用提供受控的代码执行环境，运行自定义函数或代码。
• 镜像源加速：在 Docker Desktop 的设置中写入镜像代理配置，可设置 "defaultKeepStorage": "20GB"、enabled 为 true，并多配置几个源备用。
• 离线导入能力：Linux 服务器无外网时，可用 load-dify-default-1_7_1-images.sh 这类脚本把离线镜像包导入本地 Docker 后再启动。

使用场景

• 本地开发调试：在 Windows 或 macOS 上用 Docker Desktop 起一套 Dify，验证提示词、知识库与应用流程，改完配置重建容器即可生效。
• 企业内网私有化：镜像与数据全部留在内网，由运维在内网 registry 分发镜像，满足数据不出网的合规要求。
• 云服务器快速搭建：在云主机上装好 Docker 与 Compose，拉取镜像后一键启动，几分钟内即可得到可访问的平台界面。
• 离线机房部署：先在有外网的机器上下载并导出镜像，再上传到无外网服务器导入，解决机房无法访问镜像仓库的问题。
• 教学与排障练习：用 volume、日志、compose 三个概念串起容器基础，适合演示镜像怎么交付环境、容器怎么运行服务。
• 多环境一致性保障：开发、测试、生产使用同一套镜像与配置文件，减少“在我机器上能跑”的环境差异问题。

安装与获取步骤

1. 准备运行环境：安装 Docker Desktop（含 Docker Compose 2.24.0 或更高版本）；macOS 需 10.14 或更高版本，Docker 虚拟机至少配置 2 个虚拟 CPU 和 8 GiB 内存。
2. 获取 compose 配置：官方文档地址为 https://docs.dify.ai/zh/self-host/deploy/quick-start/docker-compose ，也可参考社区整理的配置仓库 https://github.com/jiaxudonggit/dify-deployment 。
3. 配置镜像源：Windows 用户点击 Docker Desktop 的设置图标进入 Docker Engine，写入镜像代理配置并保存重启，建议同时准备多个镜像源以便失效时切换。
4. 拉取镜像并启动：在存放 compose 配置的目录执行 compose 拉起命令，观察各容器日志，直到 Web 服务可访问。
5. 离线方式：把 dify-1_7_1 离线镜像包上传到 Linux 服务器，解压后执行 load-dify-default-1_7_1-images.sh 完成镜像导入，再用 compose 启动全部服务。
6. 验证结果：浏览器访问本地地址确认界面正常；无法打开时查看容器状态与日志，确认是网络、镜像还是资源配置问题。

与同类方案的区别

常见的三条路径差异主要在环境依赖与网络条件上，选择时先看机器能否访问公网、是否有 Docker 运行时。

• 本地 Docker 与云服务：本地 Docker 把数据留在自己机器上、可离线使用，但需要自己准备 2 核 8 GiB 以上的资源；云服务开通即用，数据存放在云端，具体规格与费用以官方页面为准。
• 手动 compose 与一键离线安装包：手动方式可控性强、便于排障；一键工具解决的是镜像下载和启动流程复杂的问题，不替代 Docker，电脑上仍需安装并启动 Docker Desktop。
• 全家桶 compose 与单独的 DIFY-WEB 镜像：DIFY-WEB 是 Dify.AI 的前端应用镜像，单独运行只覆盖界面部分，后端与配套服务仍需按 compose 配置一起拉起。
• 开源镜像与 dify-ee-sandbox：后者是企业版沙箱镜像，用于在受控环境中执行代码，按应用是否需要运行自定义函数决定是否引入。

参数与版本速查

• 操作系统：macOS 10.14 或更高版本；Windows、Linux 亦有对应部署教程。
• 必需软件：Docker Desktop，内置 Docker Compose 2.24.0 及以上。
• 资源下限：Docker 虚拟机 2 个虚拟 CPU、8 GiB 内存。
• 镜像缓存上限示例：defaultKeepStorage 设为 20GB（来自社区 Docker Engine 配置示例）。
• 平台规模：Dify 已支持超过 10 万款应用的构建。
• 其余镜像标签、文件体积与校验值以官方页面为准。

注意事项

• 镜像拉取超时多为镜像源不可用，应在 Docker Desktop 设置中更换镜像源，并同时配置多个备用源。
• Docker 虚拟机低于 2 个虚拟 CPU、8 GiB 内存时，多个容器同时运行容易出现启动缓慢或被系统杀掉，先调大虚拟机资源。
• Docker Compose 低于 2.24.0 可能无法识别 compose 子命令，升级 Docker Desktop 后用 docker compose version 核对版本。
• 重建容器前先确认数据库与上传目录已挂到 volume 并完成备份，未挂载的数据会随容器删除一并消失。
• 离线镜像包的版本需与 compose 配置中的镜像标签对应，标签不一致会导致部分服务起不来。
• langgenius 命名空间下既有开源镜像也有 dify-ee-sandbox 企业版镜像，按需求选择，具体以官方页面为准。
• 日志可用于排障，但其中可能包含请求内容与密钥，对外提供日志片段前先做脱敏处理。