【新手教程】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

1. 操作系统：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

1. docker --version\ndocker compose version

复制代码

\n\n如果未安装，参考官方文档先安装 Docker：Docker 安装指南\n\n------\n\n二、部署步骤\n\n步骤 1：克隆 Dify 仓库\n\n打开终端，执行以下命令：\n

1. git clone https://github.com/langgenius/dify.git\ncd dify/docker

复制代码

\n\n如果无法访问 GitHub，可以使用国内镜像：\n

1. git clone https://ghproxy.com/https://github.com/langgenius/dify.git\ncd dify/docker

复制代码

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

1. cp .env.example .env

复制代码

\n\n编辑 .env 文件，修改以下关键配置：\n

1. # 应用端口（默认 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

1. docker compose up -d

复制代码

\n\n首次启动会拉取多个镜像，根据网络情况可能需要 5-15 分钟。\n\n步骤 4：查看服务状态\n\n

1. docker compose ps

复制代码

\n\n你应该看到以下容器在运行：\n

1. 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\n1. 访问 Dify 界面\n\n打开浏览器，访问：\n

1. http://你的服务器IP:80

复制代码

\n\n如果修改了 NGINX_PORT，使用对应端口。\n\n2. 首次登录\n\n使用 .env 中设置的 ADMIN_EMAIL 和 ADMIN_PASSWORD 登录。\n\n3. 配置 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\n4. 创建第一个应用\n\n点击 创建空白应用 → 选择 聊天助手 或 Agent，即可开始体验。\n\n------\n\n四、常见问题与解决\n\nQ1：docker compose up -d 报错 "port is already allocated"\n\n解决：80 端口被占用，修改 .env 中的 NGINX_PORT 为其他端口（如 8080），然后重启：\n

1. docker compose down\n# 修改 .env\ndocker compose up -d

复制代码

\n\nQ2：拉取镜像速度很慢或失败\n\n解决：配置 Docker 国内镜像源，编辑 /etc/docker/daemon.json：\n

1. {\n  "registry-mirrors": [\n    "https://docker.mirrors.ustc.edu.cn",\n    "https://hub-mirror.c.163.com"\n  ]\n}

复制代码

\n然后重启 Docker：\n

1. sudo systemctl restart docker

复制代码

\n\nQ3：服务启动后无法访问\n\n排查步骤：\n

\n
• 检查防火墙是否放行端口：sudo ufw allow 80\n
• 检查容器状态：docker compose logs -f\n
• 确认 .env 配置正确\n
• 如果是云服务器，检查安全组规则\n

\n\nQ4：如何更新到最新版本？\n\n

1. cd dify/docker\ngit pull origin main\ndocker compose down\ndocker compose pull\ndocker compose up -d

复制代码

\n\nQ5：如何备份数据？\n\nDify 的数据存储在 Docker volumes 中，备份以下目录：\n

1. /var/lib/docker/volumes/dify_db-data\n/var/lib/docker/volumes/dify_redis-data

复制代码

\n\n或者使用 docker compose 导出：\n

1. 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