Dify 本地安装教程：用 Docker Compose 启动并核对容器状态

AI小管家 • 1小时前 • AI教程 • 阅读 0

Dify 本地安装最稳妥的入门路线，是使用官方维护的 Docker Compose 配置。你需要先确认机器、Docker 版本和端口条件，再启动容器；安装完成的标准也不是“网页能打开”，而是核心容器状态正常、初始化页可访问、实际应用能保存。

安装前先核对环境

官方当前给出的最低硬件条件是 2 核 CPU、4 GiB 内存。Linux 需要 Docker 19.03 及以上和 Docker Compose 2.24.0 及以上；Windows 建议启用 WSL 2，并把源码和挂载数据放在 Linux 文件系统中。生产环境还要另行规划域名、HTTPS、备份和访问控制，本文只完成可验证的首次安装。

docker --version
docker compose version
git --version

如果第二条命令不存在，先升级 Docker Compose，不要把旧的 docker-compose 命令与新版配置混用。服务器上还应确认 80、443 等准备使用的端口没有被其他服务占用。

按发布版本克隆并启动

打开 Dify Releases，记下准备安装的稳定版本号。生产环境应固定版本，不要直接跟随未审核的新提交。
克隆对应版本，然后进入 docker 目录。

git clone --branch <版本号> https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env
docker compose up -d

.env 包含部署参数。首次跑通前不要随意删服务；要改域名、存储或向量库时，先备份原文件并逐项修改。密钥不要放进截图、聊天记录或公开仓库。

用容器状态判定是否成功

docker compose ps
docker compose logs --tail=100 api
docker compose logs --tail=100 web

验证标准是：api、worker、web、数据库、Redis、向量库等长期服务显示 Up 或 healthy；一次性任务 init_permissions 完成后显示 Exited 属于预期。随后访问 http://localhost/install，远程服务器则使用服务器地址加 /install，创建管理员后再登录首页。

最后新建一个空白应用并保存一次。能登录但无法保存，通常说明 API、数据库或存储权限仍有问题，不能把安装判为通过。

三类常见失败怎么查

容器反复 Restarting：先看该容器日志，再检查内存、磁盘和 .env。不要只重复执行启动命令。
页面打不开：先在主机执行 curl -I http://localhost，本机成功而外网失败时再查防火墙、云安全组和反向代理。
升级后缺服务：按目标版本发布说明升级，并把新版本的 .env.example 与现有 .env 对比。官方提醒不要长期沿用旧版自定义 Compose 文件。