【新手教程】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为例）
- # 更新系统包
- sudo apt update && sudo apt upgrade -y
- # 安装必要依赖
- sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release -y
- # 添加Docker官方GPG密钥
- curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
- # 添加Docker软件源
- 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
- # 安装Docker Engine
- sudo apt update
- sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y
- # 验证安装
- docker --version
- docker compose version
四、部署Dify
- # 克隆Dify源码（自动获取最新版本）
- git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git
- # 进入docker目录
- cd dify/docker
- # 复制环境配置文件
- cp .env.example .env
- # 启动所有服务
- docker compose up -d
启动完成后，你会看到类似这样的输出：
- [+] Running 13/13
- ✔ Network docker_ssrf_proxy_network Created
- ✔ Network docker_default Created
- ✔ Container docker-sandbox-1 Started
- ✔ Container docker-db_postgres-1 Healthy
- ✔ Container docker-web-1 Started
- ✔ Container docker-redis-1 Started
- ✔ Container docker-api-1 Started
- ✔ Container docker-nginx-1 Started
五、验证部署
- # 查看所有容器运行状态
- docker compose ps
- # 查看日志（排查问题用）
- 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 |
喧嚣卡
千斤顶
