Dify 本地与公网部署及 Docker 镜像切换指南

本地部署

1. 拉取代码

拉取 Dify 仓库速度更快，也可以拉取 GitHub 的仓库。

git clone https://gitee.com/dify_ai/dify.git

2. Docker 安装

2.1 安装 Docker 命令

先直接用 yum 或者 apt 安装 docker。

# CentOS
yum install -y docker
# Ubuntu
apt install -y docker

验证安装

docker --version # 例如输出 Docker version 29.1.5, build 0e6fee6

2.2 安装 Docker Compose

目前 dify 1.11 版本的 docker-compose.yaml 包含了 required 语法，v1 版本的 docker-compose（带横杠的版本）无法直接 up 起容器，需要安装或升级为 v2 版本的 docker compose（不带横杠的版本）。

可以直接使用命令拉取安装脚本去执行，但直接拉取有时网络访问外网会超时，建议手动安装。在 Release 页面手动下载对应版本的二进制文件，例如 docker-compose-linux-x86-64。

# 创建目标文件夹
mkdir -p ~/.docker/cli-plugins/
# 授权
chmod +x docker-compose-linux-x86-64
# 拷贝至目标路径，注意命名
cp ./docker-compose-linux-x86-64 ~/.docker/cli-plugins/docker-compose

验证安装

docker compose version # 例如输出 Docker Compose version v5.0.1

2.3 Docker 切换镜像源

推荐使用稳定且支持自动配置的脚本进行镜像源切换。

# 拉取配置脚本
curl -fsSL --connect-timeout 10 --retry 3 https://linuxmirrors.cn/docker.sh -o /tmp/docker.sh
# 执行
sudo bash /tmp/docker.sh \
  --source mirrors.tencent.com/docker-ce \
  --source-registry docker.1ms.run \
  --protocol https \
  --install-latested  \
  --close-firewall  \
  --ignore-backup-tips