使用 Docker Compose 部署 Dify：面向生产的完整指南

你将部署什么

Dify 是用于构建 AI 应用、工作流、智能体和检索增强生成服务的开源平台。本教程遵循官方 Docker Compose 安装路径，并补充公网发布前必须完成的检查。

开始前准备

• 使用受支持的 Linux 发行版，并确保当前用户可以运行 Docker。
• 配置 HTTPS 前，先将域名解析到服务器。
• 模型服务商 API 密钥不要提交到代码仓库。
• Dify 官方给出的最低要求为 2 核 CPU 和 4 GiB 内存。由于完整系统包含多个服务，真实业务通常需要更多内存余量。

部署思路

官方仓库的 docker 目录包含 Compose 配置。复制示例环境文件，检查密钥和暴露端口，启动服务后，再通过安装页面完成初始化。

生产环境检查

• 不要让首次安装页面长期暴露在无人管理的公网 IP 上。
• 使用 Caddy 或其他反向代理，并启用 HTTPS。
• 定期备份数据库、上传文件和环境配置。
• 添加用户前先监控磁盘空间和容器健康状态。
• 从小规模测试开始，根据实际内存占用再扩容。

资料来源与下一步

请在执行前查看 Dify 官方仓库 的最新命令和版本说明，并在部署前比较合适的 AI 应用服务器方案。

环境与配置要求

• 操作系统：64 位 Linux，安装 Docker 与 Docker Compose
• CPU：最低 2 核，建议 4 核
• 内存：最低 4 GiB，小团队建议 8 GiB
• 存储：至少 40 GiB SSD，并预留备份空间
• 网络：域名、HTTPS 与模型 API 出站访问

第 1 步：安装 Docker 并验证 Compose

按照 Docker 官方文档为当前发行版安装 Docker，并确认 Docker 引擎和 Compose 插件都可使用。

docker --version
docker compose version

预期结果： 命令无错误完成，并且本步骤描述的服务或文件已经可用。

第 2 步：克隆 Dify 官方仓库

克隆官方仓库并进入 Docker 部署目录。正式上线前，应确认准备长期运行的版本或标签。

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

预期结果： 命令无错误完成，并且本步骤描述的服务或文件已经可用。

第 3 步：创建并检查环境配置

复制官方示例文件，替换默认密钥并确认访问地址。生成的环境文件不得进入公开仓库。

cp .env.example .env
chmod 600 .env

预期结果： 命令无错误完成，并且本步骤描述的服务或文件已经可用。

第 4 步：启动应用服务

以后台方式启动服务，并在打开初始化页面前检查容器状态和近期日志。

docker compose up -d
docker compose ps
docker compose logs --tail=100

预期结果： 命令无错误完成，并且本步骤描述的服务或文件已经可用。

第 5 步：完成初始化并配置 HTTPS

访问官方说明中的安装路径，创建首个管理员，然后通过 Caddy 反向代理服务，并限制外部直接访问内部端口。

# Example Caddy target
# dify.example.com {
#   reverse_proxy 127.0.0.1:80
# }

预期结果： 命令无错误完成，并且本步骤描述的服务或文件已经可用。