Dify安装部署实战：Docker Compose环境准备到Ollama模型接入全指南

1. 安装Dify前，先把这几个问题想清楚

动手装Dify之前，我建议你先别急着敲命令。Dify目前是全球使用量很大的开源LLM应用开发平台，把模型接入、知识库检索、工作流编排、Agent、API发布这些东西都整合在一个可视化的界面里。它的部署本质是一套Docker Compose编排的多容器应用，所以与其说是“安装Dify”，不如说是“在你自己的服务器或电脑上，把一套完整的大模型应用后端跑起来”。

我见过太多人卡在最开始的环境选择上，装了删、删了装，折腾几个小时最后还是起不来。核心原因就一个：Dify对机器配置和Docker环境有隐性的要求，文档里写得不痛不痒，但实际跑起来就差很多。

先说硬性配置。官方给的最低要求是2核4G，这个数字你听听就好——如果你不是在纯测试环境，而是真打算往里传文档、跑知识库、调工作流，8G内存是起步，16G才算舒服。我自己实测过，4G内存跑Dify 1.x版本，光PostgreSQL、Redis、Weaviate这三个基础组件就已经吃掉将近1.5G，再算上API服务和Worker进程，内存经常在90%以上顶着，系统会频繁触发OOM Killer，表现就是容器时不时崩一下，日志里出现Killed字样。

然后是操作系统。Dify官方最推荐的是Ubuntu 22.04这样的Linux服务器环境，原因很简单：Docker在Linux上的性能损耗最小，资源管理更透明，故障排查的思路也更干净。但如果你手里只有一台Windows电脑（尤其是不带WSL2的旧Windows 10），也不是不能装，只是要接受额外的网络层转发和文件系统I/O损耗。Windows本地部署Dify目前最靠谱的路径还是Docker Desktop配WSL2，装Hyper-V再加Linux镜像，整套下来比在Linux裸机上跑要多吃一截资源，启动速度也会慢一些。

最后是你对Docker的熟悉程度。Dify的安装本质上就是两个动作：拉镜像、起容器。但前提是你对Docker的基本概念有概念——镜像和容器的关系、端口映射是怎么回事、数据卷挂载到哪去了、日志去哪里看。如果你连docker ps和docker logs都还没用过，我建议你先花半小时把Docker的基础命令过一遍，再来动Dify。这不是装门槛，而是Dify一旦出问题，90%的排查动作都发生在这几个命令里。

另外一个很实际的问题：网络环境。Dify的镜像托管在Docker Hub和GitHub上，拉取镜像时如果速度极为缓慢，你会看到docker compose up进度条几乎不走。这不是Dify的问题，而是你的网络到境外节点的问题。解决办法有很多，区间从配置镜像加速器到改用代理都有，但具体怎么做我不展开——你只需要知道，如果首次启动花了超过半小时还在拉镜像，大概率是网络这块需要先处理，别傻等。

把上面这些都想清楚了，再往下走。安装本身不难，难的是在两个小时内别因为环境问题心态崩掉。

2. Docker环境准备：最容易踩坑的环节往往在这里

Dify官方提供了两种安装方式：一种是Docker Compose一键部署，这是绝大多数场景下的首选；另一种是本地源码运行，适合要改代码、做二次开发的人。如果你是第一次接触Dify，或者只是想快速把平台用起来，老老实实走Docker Compose这一条路，不要想着源码跑，源码部署的坑比Docker部署多一个数量级。

在正式拉取Dify项目之前，先把Docker环境调到可用的状态。

2.1 Linux环境下的Docker安装核对清单

如果你用的是Ubuntu这类Linux发行版，先确认Docker和Docker Compose插件都装好了。用下面三组命令验证：

bash复制# 查看Docker版本与运行状态
docker --version
docker ps

# 查看Docker Compose版本（注意：新版Docker使用compose子命令）
docker compose version

docker ps能正常列出容器列表且不报权限错误，说明守护进程在跑。如果提示Cannot connect to the Docker daemon，先检查服务状态：

bash复制sudo systemctl status docker
sudo systemctl start docker
sudo systemctl enable docker

这里有一个新手高频失误：在Li