【新手教程】零基础5分钟部署Dify智能体平台：Docker一键安装全流程

【新手教程】零基础5分钟部署Dify智能体平台：Docker一键安装全流程

一、前言

Dify 是当下最热门的开源 AI 智能体（Agent）开发平台之一，支持可视化编排工作流、接入多种大模型、快速构建知识库和对话应用。相比 Coze 等在线平台，Dify 私有化部署意味着数据完全自主可控，特别适合企业内网和对隐私敏感的场景。

本文面向零基础新手，用 Docker 方式一键部署，无需手动配置 Python 环境、数据库等复杂依赖。跟着步骤走，5 分钟内即可在本地跑起来。

二、前置条件

• 一台 Linux 服务器或本地电脑（推荐 Ubuntu 22.04 / Debian 12 / macOS / Windows WSL2）
  
• 已安装 Docker 和 Docker Compose（版本 20.10+ 即可）
  
• 至少 4GB 内存、20GB 磁盘空间
  
• 可访问外网（拉取 Docker 镜像）
  

三、安装步骤

步骤1：克隆 Dify 官方仓库

打开终端，执行以下命令：

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

复制代码

如果网络较慢，也可以先下载 ZIP 包解压后进入 docker 目录。

步骤2：复制环境配置文件

2. cp .env.example .env

复制代码

.env 文件包含了数据库密码、端口、密钥等核心配置。新手可以先不改，用默认配置直接启动。后续如需修改端口或绑定域名，再编辑此文件。

步骤3：一键启动所有服务

2. docker compose up -d

复制代码

这条命令会自动拉取并启动以下容器：

• dify-api：核心后端 API 服务
  
• dify-web：前端 Web 界面
  
• postgres：PostgreSQL 数据库
  
• redis：缓存与消息队列
  
• weaviate：向量数据库（用于知识库检索）
  

首次启动可能需要 3-5 分钟下载镜像，耐心等待。看到类似 Started Dify 的日志即表示成功。

步骤4：访问并初始化

浏览器打开 http://localhost/install（服务器部署则替换为服务器 IP）。

首次进入会要求设置管理员账号：

• 邮箱：建议用真实邮箱，方便找回密码
  
• 密码：8 位以上，包含字母和数字
  
• 用户名：自定义，如 admin
  

设置完成后自动跳转首页，至此安装完成！

四、验证安装

2. # 查看所有容器运行状态
3. docker compose ps
5. # 查看日志（如有问题）
6. docker compose logs -f dify-api
8. # 检查端口占用
9. netstat -tlnp | grep 80

复制代码

正常应看到 5 个容器状态均为 Up。

五、常见问题与解决

Q1：docker compose 命令不存在？

新版 Docker 已将 compose 作为插件内置，命令为

1. docker compose

复制代码

（带空格）。如果提示找不到，尝试安装 docker-compose-plugin：

2. sudo apt install docker-compose-plugin

复制代码

Q2：端口 80 被占用？

编辑 .env 文件，修改

1. NGINX_PORT=8080

复制代码

，然后重启：

2. docker compose down
3. docker compose up -d

复制代码

Q3：启动后页面空白或 502？

通常是容器还没完全启动。等待 2-3 分钟后刷新，或检查日志：

2. docker compose logs -f

复制代码

Q4：如何更新到最新版本？

2. cd dify/docker
3. git pull
4. docker compose down
5. docker compose pull
6. docker compose up -d

复制代码

六、下一步

安装完成后，你可以：

• 接入 OpenAI / Claude / 本地 Ollama 等大模型
  
• 创建第一个对话应用，体验可视化编排
  
• 上传文档构建知识库，实现 RAG 检索增强
  
• 配置工作流，让 AI 自动调用外部 API
  

后续我会继续更新 Dify 进阶玩法，包括多模型路由、Agent 工具调用、工作流调试技巧等。有问题欢迎在楼下留言，我会尽量回复。

参考链接：

• Dify 官方文档：https://docs.dify.ai
  
• GitHub 仓库：https://github.com/langgenius/dify
  
• Docker 安装指南：https://docs.docker.com/get-docker/
  

---

本帖为原创内容，转载请注明出处。如有错误欢迎指正！