闲社

标题: 【新手教程】零基础5分钟部署Dify智能体平台：Docker一键安装全流程 [打印本页]
作者: bibylove    时间: 昨天 23:06
标题: 【新手教程】零基础5分钟部署Dify智能体平台：Docker一键安装全流程
【新手教程】零基础5分钟部署Dify智能体平台：Docker一键安装全流程

一、前言

Dify 是当下最热门的开源 AI 智能体（Agent）开发平台之一，支持可视化编排工作流、接入多种大模型、快速构建知识库和对话应用。相比 Coze 等在线平台，Dify 私有化部署意味着数据完全自主可控，特别适合企业内网和对隐私敏感的场景。

本文面向零基础新手，用 Docker 方式一键部署，无需手动配置 Python 环境、数据库等复杂依赖。跟着步骤走，5 分钟内即可在本地跑起来。

二、前置条件



三、安装步骤

步骤1：克隆 Dify 官方仓库

打开终端，执行以下命令：
  2. git clone https://github.com/langgenius/dify.git
  3. cd dify/docker
复制代码

如果网络较慢，也可以先下载 ZIP 包解压后进入 docker 目录。

步骤2：复制环境配置文件
  2. cp .env.example .env
复制代码

.env 文件包含了数据库密码、端口、密钥等核心配置。新手可以先不改，用默认配置直接启动。后续如需修改端口或绑定域名，再编辑此文件。

步骤3：一键启动所有服务
  2. docker compose up -d
复制代码

这条命令会自动拉取并启动以下容器：



首次启动可能需要 3-5 分钟下载镜像，耐心等待。看到类似 Started Dify 的日志即表示成功。

步骤4：访问并初始化

浏览器打开 http://localhost/install（服务器部署则替换为服务器 IP）。

首次进入会要求设置管理员账号：



设置完成后自动跳转首页，至此安装完成！

四、验证安装
  2. # 查看所有容器运行状态
  3. docker compose ps
  5. # 查看日志（如有问题）
  6. docker compose logs -f dify-api
  8. # 检查端口占用
  9. netstat -tlnp | grep 80
复制代码

正常应看到 5 个容器状态均为 Up。

五、常见问题与解决

Q1：docker compose 命令不存在？

新版 Docker 已将 compose 作为插件内置，命令为
  1. docker compose
复制代码
（带空格）。如果提示找不到，尝试安装 docker-compose-plugin：
  2. sudo apt install docker-compose-plugin
复制代码

Q2：端口 80 被占用？

编辑 .env 文件，修改
  1. NGINX_PORT=8080
复制代码
，然后重启：
  2. docker compose down
  3. docker compose up -d
复制代码

Q3：启动后页面空白或 502？

通常是容器还没完全启动。等待 2-3 分钟后刷新，或检查日志：
  2. docker compose logs -f
复制代码

Q4：如何更新到最新版本？
  2. cd dify/docker
  3. git pull
  4. docker compose down
  5. docker compose pull
  6. docker compose up -d
复制代码

六、下一步

安装完成后，你可以：



后续我会继续更新 Dify 进阶玩法，包括多模型路由、Agent 工具调用、工作流调试技巧等。有问题欢迎在楼下留言，我会尽量回复。

参考链接：



---

本帖为原创内容，转载请注明出处。如有错误欢迎指正！



欢迎光临 闲社 (https://dafeng.xianshe.com/) Powered by Discuz! X5.0