闲社

标题: 【新手教程】Docker零基础入门：手把手教你部署Dify AI智能体平台 [打印本页]

---

作者: bibylove    时间: 昨天 19:37
标题: 【新手教程】Docker零基础入门：手把手教你部署Dify AI智能体平台
【新手教程】Docker零基础入门：手把手教你部署Dify AI智能体平台

一、为什么选Dify？

Dify是目前最热门的开源AI应用开发平台之一，支持可视化编排AI工作流、搭建知识库、创建智能体Agent。相比Coze等闭源平台，Dify可以私有化部署，数据完全自主可控。2026年3月，Dify刚完成3000万美元Pre-A轮融资，产品迭代速度非常快。

二、前置条件

• 操作系统：Linux/macOS/Windows（WSL2）
  
• CPU：至少2核
  
• 内存：至少4GB（建议8GB以上）
  
• Docker：19.03+
  
• Docker Compose：2.24.0+
  

三、安装Docker（以Ubuntu为例）

2. # 更新系统包
3. sudo apt update && sudo apt upgrade -y
5. # 安装必要依赖
6. sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release -y
8. # 添加Docker官方GPG密钥
9. curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
11. # 添加Docker软件源
12. echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
14. # 安装Docker Engine
15. sudo apt update
16. sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y
18. # 验证安装
19. docker --version
20. docker compose version

复制代码

四、部署Dify

2. # 克隆Dify源码（自动获取最新版本）
3. git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git
5. # 进入docker目录
6. cd dify/docker
8. # 复制环境配置文件
9. cp .env.example .env
11. # 启动所有服务
12. docker compose up -d

复制代码

启动完成后，你会看到类似这样的输出：

2. [+] Running 13/13
3. ✔ Network docker_ssrf_proxy_network  Created
4. ✔ Network docker_default             Created
5. ✔ Container docker-sandbox-1         Started
6. ✔ Container docker-db_postgres-1     Healthy
7. ✔ Container docker-web-1             Started
8. ✔ Container docker-redis-1           Started
9. ✔ Container docker-api-1             Started
10. ✔ Container docker-nginx-1           Started

复制代码

五、验证部署

2. # 查看所有容器运行状态
3. docker compose ps
5. # 查看日志（排查问题用）
6. docker compose logs -f

复制代码

打开浏览器访问 http://你的服务器IP ，看到Dify初始化页面即表示部署成功。首次使用需要设置管理员账号。

六、常见问题与解决

• 问题1：端口被占用
  修改 .env 文件中的端口映射，比如将 80 改为 8080
  
  
• 问题2：内存不足导致启动失败
  增加服务器内存，或关闭不必要的服务。最低4GB内存，建议8GB
  
  
• 问题3：拉取镜像慢
  配置Docker国内镜像源，编辑 /etc/docker/daemon.json 添加加速器地址
  
  
• 问题4：无法连接外部API
  检查防火墙设置，确保容器能访问外网。Dify需要连接OpenAI、Claude等模型服务
  

七、进阶配置

• 配置反向代理（Nginx/Caddy）启用HTTPS
  
• 对接本地大模型（Ollama）实现完全离线运行
  
• 配置邮件服务用于邀请团队成员
  
• 接入外部向量数据库（如Milvus）替代默认Weaviate
  

八、总结

通过Docker Compose部署Dify，整个过程只需要几条命令，非常适合新手入门。Dify的插件生态和工作流编排能力，让它成为搭建AI智能体的首选平台之一。

如果你部署过程中遇到问题，欢迎在楼下留言，我会尽力帮忙解答。

---
本教程基于Dify官方文档整理， tested on Ubuntu 22.04 + Docker 26.0

---

欢迎光临 闲社 (https://www.xianshe.com/)

Powered by Discuz! X5.0