03_Dify 使用 Docker Compose 部署

腾飞开源2026-02-09 16:42

一、前提条件

在安装 Dify 之前，请确保您的设备符合以下最低系统要求：

克隆 Dify 源代码至本地环境。

bash 复制代码

# --branch 1.5.0：通常用于获取某个特定版本的代码，1.5.0 实际上是一个版本标签（tag），不是传统意义上的分支 
git clone https://github.com/langgenius/dify.git --branch 1.5.0

创建并切换到 dify-1.5.0

bash 复制代码

# 查看本地分支命令 
git branch 
 
# 创建并切换分支 
git switch -c dify-1.5.0

bash 复制代码

cd dify/docker/

bash 复制代码

cp .env.example .env

根据你系统上的 Docker Compose 版本，选择合适的命令来启动容器。你可以通过 $ docker compose version 命令检查版本，详细说明请参考 Docker 官方文档

bash 复制代码

docker compose up -d

如果版本是 Docker Compose V1，使用以下命令：

bash 复制代码

docker-compose up -d

构建完成效果

最后检查是否所有容器都正常运行：

bash 复制代码

docker compose ps

docker-desktop上查看容器运行情况：

进入 dify 源代码的 docker 目录，按顺序执行以下命令：

bash 复制代码

cd dify/docker
docker compose down
git pull origin main
docker compose pull
docker compose up -d

同步环境变量配置 (重要！)

如果 .env.example 文件有更新，请务必同步修改你本地的 .env 文件。
检查 .env 文件中的所有配置项，确保它们与你的实际运行环境相匹配。你可能需要将 .env.example 中的新变量添加到 .env 文件中，并更新已更改的任何值。

#本地环境

http://localhost/install

#服务器环境

http://your_server_ip/install

注册成功，进入登录页面：

登录成功：

#本地环境

http://localhost

#服务器环境

http://your_server_ip

跳转到登录页面：

编辑 .env 文件中的环境变量值。然后重新启动 Dify：

bash 复制代码

docker compose down 
docker compose up -d

完整的环境变量集合可以在 docker/.env.example 中找到。