一、Dify 是什么，为什么要自己部署

Dify 是一个开源的 LLM（大语言模型）应用开发平台，可以把大模型能力快速封装成可视化、可编排的应用，比如智能客服、知识库问答、AI 工作流等。它的界面友好，即使不太懂代码，也能通过拖拽和配置搭出一个 AI 应用。

把 Dify 部署在自己的服务器或电脑上，好处是数据完全掌握在自己手里，不受第三方平台的调用次数和隐私限制，也方便对接自己的模型服务。官方支持多种部署方式，其中 Docker Compose 一键部署是最简单、最推荐的方式——它把数据库、缓存、后端、前端等所有组件打包好，一条命令就能全部启动。

二、开始前的准备

在动手之前，请确认你的环境满足以下要求：

1. 操作系统：Linux、macOS 或 Windows（Windows 建议用 WSL2）都可以。

2. 硬件：建议至少 2 核 CPU、4GB 内存、10GB 以上磁盘空间。

3. 软件：需要安装 Docker 和 Docker Compose（Docker Desktop 或 Linux 下的 Docker Engine 均可）。

验证 Docker 是否安装成功，在终端里输入下面两条命令，能看到版本号就说明没问题：

docker --version

docker compose version

如果还没安装 Docker，可以去官网 docs.docker.com 按自己系统对应的说明安装，安装 Docker Desktop 时会自带 Compose，无需单独装。

三、获取 Dify 源码

Dify 的部署脚本都放在官方 GitHub 仓库里。用 git 把项目克隆到本地：

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

cd dify/docker

如果你电脑上没有 git，也可以直接在浏览器打开仓库页面，点 Code → Download ZIP 下载压缩包，解压后进入 docker 目录。

四、配置文件

进入 docker 目录后，会看到一个 .env.example 示例配置文件。我们把它复制成真正的 .env 文件：

cp .env.example .env

对大多数初学者来说，这个默认配置基本可以直接用，不需要改动。如果你需要修改端口、设置对外访问的 IP 或域名，可以稍后用文本编辑器打开 .env 调整。这里有个小提醒：Dify 前端默认跑在 80 端口，如果你的服务器上 80 端口已经被别的程序占用，可以在 .env 里把 EXPOSE_NGINX_PORT 改成 8080 之类没被占用的端口。

五、一条命令启动所有服务

配置就绪后，执行下面这条命令，Docker 会自动拉取镜像并启动全部服务：

docker compose up -d

命令里 -d 表示在后台运行。第一次执行时，因为要从网上下载镜像，可能需要等几分钟，具体取决于你的网速。看到一排容器显示 Started 或 Running，就说明启动成功了。

可以用这条命令查看当前所有容器的运行状态，确认它们都是 healthy 或 Up 状态：

docker compose ps

六、访问和使用 Dify

启动完成后，打开浏览器访问：

http://localhost

（如果部署在远程服务器上，把 localhost 换成服务器的公网 IP；如果改过端口，记得加上端口号，比如 http://服务器IP:8080）

第一次打开会进入初始化页面，让你设置管理员账号和密码。填写邮箱、用户名和密码，点击创建即可。之后用这个账号登录，就能进入 Dify 的控制台，开始创建应用、配置知识库、编排工作流了。

七、接入大模型

刚部署好的 Dify 还没有模型能力，需要你在控制台里配置一个模型服务商，比如 OpenAI、DeepSeek、通义千问，或者本地部署的模型。一般在「设置 → 模型供应商」里填入对应服务商的 API Key 就可以了。填好后，创建应用时就能选择这些模型。

八、日常运维：停止、重启与更新

停止所有服务：

docker compose down

重新启动：

docker compose up -d

更新到新版本：先 git pull 拉取最新代码，再执行 docker compose down 和 docker compose up -d 重新构建启动即可。

查看运行日志，遇到报错时特别有用：

docker compose logs -f

九、常见问题

1. 端口被占用无法启动：修改 .env 里的 EXPOSE_NGINX_PORT 和 EXPOSE_NGINX_SSL_PORT，换成正空闲的端口。

2. 启动后页面打不开：先用 docker compose ps 确认容器都在运行，再检查防火墙是否放行了对应端口，云服务器还要在安全组里放行。

3. 内存不足导致容器反复重启：可以给服务器增加内存，或适当减少并发。Dify 各组件对内存有一定要求，跑不起来时优先排查内存。

4. 镜像下载很慢：可以给 Docker 配置国内镜像加速器，能显著提升拉取速度。

十、小结

到这里，你已经用 Docker Compose 成功部署了一个属于自己的 Dify 平台。整套流程归纳起来其实就五步：装好 Docker、克隆代码、复制配置文件、docker compose up -d 启动、浏览器访问初始化。对想快速拥有私有 AI 应用平台的个人和小团队来说，这是性价比最高的入门方式。下一步就可以尽情探索知识库、工作流和各类 AI 应用的搭建了。

（本文为部署流程整理，实际操作请以 Dify 官方文档 docs.dify.ai 的最新说明为准。）