【新手教程】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为例）
# 更新系统包
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 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_networkCreated
✔ 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
页:
[1]