Dify 安装与 Docker 镜像源配置笔记

本文档旨在指导用户如何在本地通过 Docker 安装 Dify，并针对中国大陆用户可能遇到的 Docker 镜像下载缓慢或失败问题提供解决方案。

0. 系统要求

在开始安装之前，请确保您的机器满足以下最低系统要求：

• CPU: >= 2 Core
• RAM: >= 4 GiB
• 已安装: Docker 和 Docker Compose

1. 下载并启动 Dify

以下步骤将指导您下载 Dify 的源代码并通过 Docker Compose 启动服务。

1. 克隆 Dify 仓库：
   打开终端，运行以下命令将 Dify 的代码下载到本地。

git clone https://github.com/langgenius/dify.git

2. 进入 Docker 配置目录并准备环境变量文件：

cd dify/docker
cp .env.example .env

（可选）你可以根据需要编辑 .env 文件中的配置。

3. 尝试启动 Dify 服务：

docker compose up -d

此命令会尝试从 Docker Hub 下载所需的镜像并启动所有服务。

注意：对于中国大陆用户，直接执行此步骤可能会因为网络问题导致镜像下载非常缓慢或失败（如遇到 context deadline exceeded 或 Client.Timeout 等错误）。如果遇到此类问题，请继续执行下面的“镜像源配置”步骤。

2. Docker 镜像源配置 (针对中国大陆用户)

如果步骤 1.3 中 docker compose up -d 下载镜像缓慢或失败，建议配置国内的 Docker 镜像加速器。

1. 创建 Docker 配置目录 (如果不存在)：

sudo mkdir -p /etc/docker

2. 编辑 Docker 配置文件 daemon.json：
   使用你熟悉的编辑器（如 vim 或 nano）打开或创建该文件。

sudo vim /etc/docker/daemon.json

3. 添加镜像加速器地址：
   在 daemon.json 文件中粘贴以下内容。这里以 https://docker.xuanyuan.me 为例，你也可以选择其他国内镜像源，如阿里云、网易蜂巢、中科大等提供的加速器地址。

{
  "registry-mirrors":[
    "https://docker.xuanyuan.me"
  ]
}

4. 重新加载 Docker 配置并重启 Docker 服务：

sudo systemctl daemon-reload
sudo systemctl restart docker

5. 验证配置 (可选但推荐)：
   可以运行 docker info 查看 Registry Mirrors 部分是否已包含你配置的地址。

3. 再次尝试启动 Dify 服务

在配置完镜像加速器并重启 Docker 后，回到 dify/docker 目录，再次执行启动命令：

docker compose up -d

此时，Docker 应该会通过配置的国内镜像源拉取镜像，速度会显著提升。

4. 访问 Dify 控制台

当所有 Docker 容器成功启动后（可以通过 docker compose ps 查看状态），你可以在浏览器中访问以下地址进入 Dify 控制台并开始初始化安装操作：

http://localhost/install