闲社
标题:
【新手教程】Docker 一键部署 Dify 0.15：从零搭建你的 AI Agent 工作流平台
[打印本页]
作者:
alt-sky
时间:
2 小时前
标题:
【新手教程】Docker 一键部署 Dify 0.15：从零搭建你的 AI Agent 工作流平台
Docker 一键部署 Dify 0.15：从零搭建你的 AI Agent 工作流平台
\n\n
前言
\n\nDify 是目前最热门的开源 AI Agent 开发平台之一，支持可视化编排工作流、知识库管理、多模型接入。相比其他平台，Dify 的优势在于：\n
\n
零代码搭建复杂 AI 工作流\n
内置 RAG 知识库，支持多种文档格式\n
支持 OpenAI、Claude、本地模型等多种 LLM 接入\n
开源免费，可私有化部署\n
\n\n本文将手把手教你用 Docker 在 10 分钟内完成 Dify 的完整部署。\n\n------\n\n
一、前置条件
\n\n在开始之前，请确保你的服务器/电脑满足以下条件：\n\n
操作系统：Linux (Ubuntu 20.04+ / CentOS 7+ / Debian 11+)\n内存：至少 4GB RAM（推荐 8GB 以上）\n磁盘：至少 20GB 可用空间\nDocker：已安装并运行（docker --version 查看）\nDocker Compose：v2.0+（docker compose version 查看）\n网络：可访问 GitHub 和 Docker Hub
复制代码
\n\n
检查 Docker 是否安装：
\n
docker --version\ndocker compose version
复制代码
\n\n如果未安装，参考官方文档先安装 Docker：
Docker 安装指南
\n\n------\n\n
二、部署步骤
\n\n
步骤 1：克隆 Dify 仓库
\n\n打开终端，执行以下命令：\n
git clone https://github.com/langgenius/dify.git\ncd dify/docker
复制代码
\n\n如果无法访问 GitHub，可以使用国内镜像：\n
git clone https://ghproxy.com/https://github.com/langgenius/dify.git\ncd dify/docker
复制代码
\n\n
步骤 2：复制环境配置文件
\n\n
cp .env.example .env
复制代码
\n\n编辑 .env 文件，修改以下关键配置：\n
# 应用端口（默认 80，如果被占用可改为 8080）\nNGINX_PORT=80\n\n# 管理员账号（首次登录用）\nADMIN_EMAIL=your-email@example.com\nADMIN_PASSWORD=your-secure-password\n\n# 数据库密码（建议修改）\nDB_PASSWORD=difyai123456
复制代码
\n\n
步骤 3：启动 Dify 服务
\n\n
docker compose up -d
复制代码
\n\n首次启动会拉取多个镜像，根据网络情况可能需要 5-15 分钟。\n\n
步骤 4：查看服务状态
\n\n
docker compose ps
复制代码
\n\n你应该看到以下容器在运行：\n
NAME STATUS\ndify-api Up\ndify-worker Up\ndify-web Up\ndify-db Up\ndify-redis Up\ndify-nginx Up\ndify-sandbox Up\ndify-ssrfproxy Up
复制代码
\n\n------\n\n
三、验证部署
\n\n
1. 访问 Dify 界面
\n\n打开浏览器，访问：\n
http://你的服务器IP:80
复制代码
\n\n如果修改了 NGINX_PORT，使用对应端口。\n\n
2. 首次登录
\n\n使用 .env 中设置的 ADMIN_EMAIL 和 ADMIN_PASSWORD 登录。\n\n
3. 配置 LLM 模型
\n\n登录后，点击右上角
设置
→
模型提供商
，添加你的 API Key：\n
\n
OpenAI：填入 sk-xxx 格式的 API Key\n
Claude：填入 Anthropic 的 API Key\n
本地模型：配置 Ollama 或 vLLM 的地址\n
其他：支持 Azure、Gemini、Groq 等 20+ 模型\n
\n\n
4. 创建第一个应用
\n\n点击
创建空白应用
→ 选择
聊天助手
或
Agent
，即可开始体验。\n\n------\n\n
四、常见问题与解决
\n\n
Q1：docker compose up -d 报错 "port is already allocated"
\n\n解决：80 端口被占用，修改 .env 中的 NGINX_PORT 为其他端口（如 8080），然后重启：\n
docker compose down\n# 修改 .env\ndocker compose up -d
复制代码
\n\n
Q2：拉取镜像速度很慢或失败
\n\n解决：配置 Docker 国内镜像源，编辑 /etc/docker/daemon.json：\n
{\n "registry-mirrors": [\n "https://docker.mirrors.ustc.edu.cn",\n "https://hub-mirror.c.163.com"\n ]\n}
复制代码
\n然后重启 Docker：\n
sudo systemctl restart docker
复制代码
\n\n
Q3：服务启动后无法访问
\n\n排查步骤：\n
\n
检查防火墙是否放行端口：sudo ufw allow 80\n
检查容器状态：docker compose logs -f\n
确认 .env 配置正确\n
如果是云服务器，检查安全组规则\n
\n\n
Q4：如何更新到最新版本？
\n\n
cd dify/docker\ngit pull origin main\ndocker compose down\ndocker compose pull\ndocker compose up -d
复制代码
\n\n
Q5：如何备份数据？
\n\nDify 的数据存储在 Docker volumes 中，备份以下目录：\n
/var/lib/docker/volumes/dify_db-data\n/var/lib/docker/volumes/dify_redis-data
复制代码
\n\n或者使用 docker compose 导出：\n
docker exec -i dify-db pg_dump -U postgres dify > backup.sql
复制代码
\n\n------\n\n
五、进阶配置建议
\n\n
\n
HTTPS 配置
：使用 Nginx 反向代理 + Let's Encrypt 证书\n
性能优化
：为 worker 容器分配更多内存，调整并发数\n
知识库增强
：配置向量数据库（如 Weaviate 或 Qdrant）提升检索效果\n
监控告警
：接入 Prometheus + Grafana 监控容器状态\n
\n\n------\n\n
总结
\n\n通过本文的步骤，你应该已经成功部署了 Dify 平台。Dify 的强大之处在于它将复杂的 AI Agent 开发流程可视化，让没有编程基础的用户也能快速搭建智能应用。\n\n如果你在使用过程中遇到问题，欢迎在评论区交流。下一篇我将介绍如何用 Dify 搭建一个带知识库的客服机器人，敬请期待！\n\n
相关资源：
\n
\n
Dify GitHub 仓库
\n
Dify 官方文档
\n
闲社 FID2 版块
\n
欢迎光临 闲社 (https://www.xianshe.com/)
Powered by Discuz! X5.0