【新手教程】Docker一键部署Dify：10分钟搭建你的AI工作流平台

【新手教程】Docker一键部署Dify：10分钟搭建你的AI工作流平台

前言

最近AI Agent和智能工作流的热度持续攀升，GitHub Trending上 activepieces（支持~400个MCP服务器的AI工作流自动化）和 n8n（带原生AI能力的公平代码工作流平台）等项目持续霸榜。而在国内，Dify 作为开源的LLM应用开发平台，凭借可视化编排、多模型支持和一键部署能力，已经成为众多开发者搭建AI应用的首选工具。

今天这篇教程，手把手教你用Docker在10分钟内完成Dify的本地部署，零代码基础也能轻松上手。

------

一、前置条件

• 一台Linux服务器或本地机器（推荐Ubuntu 20.04+/CentOS 7+）
  
• Docker 20.10+ 和 Docker Compose 2.0+
  
• 至少4GB内存（推荐8GB以上）
  
• 20GB以上磁盘空间
  

检查Docker版本：

1. docker --version
2. docker-compose --version

复制代码

如果未安装，参考官方文档一键安装：

1. curl -fsSL https://get.docker.com | sh

复制代码

------

二、部署步骤

步骤1：克隆Dify仓库

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

复制代码

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

1. cp .env.example .env

复制代码

步骤3：启动服务

1. docker compose up -d

复制代码

等待镜像拉取和容器启动完成（首次约3-5分钟，取决于网络速度）。

步骤4：访问Dify

浏览器打开 http://你的服务器IP:80

首次访问需要设置管理员账号，按提示完成即可。

------

三、验证部署

• 检查容器状态：
  1. docker compose ps

  复制代码
  应显示所有服务为 Up 状态
  
• 检查日志：
  1. docker compose logs -f api

  复制代码
  查看API服务是否正常运行
  
• 测试访问：浏览器打开 http://你的IP，应能看到Dify登录页
  

------

四、配置AI模型

Dify支持OpenAI、Anthropic、Azure、本地Ollama等多种模型。以配置OpenAI为例：

• 登录Dify后台 → 右上角头像 → 设置 → 模型提供商
  
• 选择OpenAI，填入你的API Key
  
• 点击保存，即可在应用中使用
  

如果使用本地模型（如Ollama），在模型提供商中选择Ollama，填入本地服务地址 http://host.docker.internal:11434 即可。

------

五、创建你的第一个AI应用

• 点击「创建空白应用」→ 选择「聊天助手」
  
• 在编排页面选择已配置的模型
  
• 在提示词区域输入系统提示（System Prompt）
  
• 点击「发布」→ 立即体验你的AI应用
  

Dify还支持工作流编排、知识库RAG、Agent模式等高级功能，后续可以逐步探索。

------

六、常见问题与解决

Q1：Docker拉取镜像超时？
A：配置国内镜像加速器，编辑 /etc/docker/daemon.json：

1. {
2.   "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
3. }

复制代码

然后重启Docker：

1. sudo systemctl restart docker

复制代码

Q2：端口80被占用？
A：修改 .env 文件中的 NGINX_PORT 为其他端口，如8080，然后重启。

Q3：容器启动后无法访问？
A：检查防火墙是否放行端口：

1. sudo ufw allow 80

复制代码

或

1. sudo firewall-cmd --add-port=80/tcp --permanent

复制代码

Q4：如何更新Dify到最新版？
A：进入dify/docker目录，执行：

1. git pull
2. docker compose down
3. docker compose pull
4. docker compose up -d

复制代码

------

七、进阶建议

• 生产环境建议配置HTTPS（使用Nginx反向代理+SSL证书）
  
• 定期备份 dify/docker/volumes 目录下的数据
  
• 关注Dify GitHub Releases获取最新功能更新
  
• 结合n8n或activepieces，可以搭建更复杂的自动化工作流
  

------

结语

Dify的Docker部署方案让AI应用开发门槛大幅降低。无论是想快速搭建一个ChatGPT镜像站，还是构建企业级知识库问答系统，Dify都能胜任。按照本教程，10分钟就能跑起来，剩下的就是发挥你的创意了。

如果在部署过程中遇到问题，欢迎在评论区留言交流！