【新手教程】零基础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 官方仓库
打开终端，执行以下命令：
git clone https://github.com/langgenius/dify.git
cd dify/docker
如果网络较慢，也可以先下载 ZIP 包解压后进入 docker 目录。
步骤2：复制环境配置文件
cp .env.example .env
.env 文件包含了数据库密码、端口、密钥等核心配置。新手可以先不改，用默认配置直接启动。后续如需修改端口或绑定域名，再编辑此文件。
步骤3：一键启动所有服务
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
设置完成后自动跳转首页，至此安装完成！
四、验证安装
# 查看所有容器运行状态
docker compose ps
# 查看日志（如有问题）
docker compose logs -f dify-api
# 检查端口占用
netstat -tlnp | grep 80
正常应看到 5 个容器状态均为 Up。
五、常见问题与解决
Q1：docker compose 命令不存在？
新版 Docker 已将 compose 作为插件内置，命令为 docker compose（带空格）。如果提示找不到，尝试安装 docker-compose-plugin：
sudo apt install docker-compose-plugin
Q2：端口 80 被占用？
编辑 .env 文件，修改 NGINX_PORT=8080，然后重启：
docker compose down
docker compose up -d
Q3：启动后页面空白或 502？
通常是容器还没完全启动。等待 2-3 分钟后刷新，或检查日志：
docker compose logs -f
Q4：如何更新到最新版本？
cd dify/docker
git pull
docker compose down
docker compose pull
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/
---
本帖为原创内容，转载请注明出处。如有错误欢迎指正！
页:
[1]