Dify AI 智能体部署与使用指南

• 更新系统软件包列表：sudo apt update
• 安装 Docker 的依赖包：sudo apt install apt-transport-https ca-certificates curl software-properties-common
• 安装 Docker CE：sudo apt install docker-ce docker-ce-cli containerd.io
• 启动 Docker 服务：sudo systemctl start docker
• 设置开机自启：sudo systemctl enable docker

添加 Docker 官方 GPG 密钥：

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

2. 安装 Docker Compose：

验证安装：docker-compose --version

下载 Docker Compose 二进制文件：

curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

添加可执行权限：

sudo chmod +x /usr/local/bin/docker-compose

四、Dify 的部署流程详解

（一）获取 Dify 项目

1. 访问 GitHub 仓库：https://github.com/langgenius/dify
2. 克隆项目：

git clone https://github.com/langgenius/dify.git

（二）配置环境变量

1. 设置 API 密钥：在 .env 文件中设置相应的 API 密钥，如 OPENAI_API_KEY。
2. 配置其他参数：修改 .env 文件中的 NGINX_SERVER_NAME、UPLOAD_FILE_SIZE_LIMIT 等。
3. 创建 .env 文件：复制 .env.example 为 .env。

（三）启动 Dify

进入 Dify 项目的 docker 目录下，执行命令：

docker compose up -d

检查服务状态：

docker compose ps

通过浏览器访问 Dify 的前端地址（默认为 http://localhost:3000）。

五、大模型 API KEY 配置

（一）支持的模型供应商

Dify 支持 Anthropic、Hugging Face Hub、Replicate、阿里云通义千问、百度文心一言、OpenAI 等主流模型供应商。

（二）以豆包为例配置 API KEY

1. 获取豆包模型 API KEY：访问字节跳动云服务平台，注册账号并在控制台创建 API KEY。
2. 在 Dify 中配置 API KEY：
   • 进入设置页面，找到'模型供应商'板块。
   • 点击'豆包模型'选项，填写 API KEY。
   • 保存配置。
3. 注意事项：
   • 密钥安全：妥善保存 KEY，避免泄露。
   • 权限管理：只授予必要的权限。
   • 配置准确性：仔细核对输入内容。

六、Dify 使用操作指南

（一）创建知识库

1. 同步自在线平台：支持从 Notion 同步数据。
2. 添加文件：支持上传 .pdf、.docx、.xlsx 等格式。
3. 导入文本：直接粘贴文本或上传 .txt、.md 文件。

（二）构建智能体工作流

1. 进入工作流编排界面：在'工作室'中点击'创建空白应用'，选择'工作流'类型。
2. 添加节点：如开始节点、LLM 节点、代码执行节点、结束节点等。
3. 设置节点参数：配置模型供应商、提示词、知识库关联等。

（三）创建图片生成应用

1. 配置模型供应商：添加 StableDiffusion 等模型。
2. 构建 Agent：添加 LLM 节点和图片生成工具节点。

（四）创建聊天机器人

1. 设置开场白和音色：配置欢迎语和语音属性。
2. 创建多轮对话工作流：选择'Chatflow'类型，添加记忆节点以保持上下文连贯性。

七、常见问题与解决方案

（一）部署过程中的问题

1. docker 镜像库问题：国内访问不稳定时，可通过修改 /etc/docker/daemon.json 替换为国内镜像源。

{
  "registry-mirrors": [
    "https://docker.registry.cyou",
    "https://mirror.aliyuncs.com"
  ]
}

重启 Docker 服务：

sudo systemctl daemon-reload
sudo systemctl restart docker

2. 服务启动失败：
   • 端口冲突：修改 .env 中的 EXPOSE_NGINX_PORT。
   • 环境变量配置错误：检查 .env 文件。
   • 依赖服务未启动：使用 docker compose ps 检查容器状态。
   • 资源不足：检查服务器 CPU 和内存使用情况。

（二）使用过程中的问题

1. 模型加载失败：

   • API 密钥错误：检查 .env 中的密钥。
   • 网络连接问题：确保能访问模型供应商服务器。
   • 模型不兼容：查阅官方文档确认支持列表。

2. 工作流运行错误：

   • 节点配置错误：检查各节点参数。
   • 变量传递问题：检查变量命名和作用域。
   • 代码执行错误：调试代码逻辑。

八、总结

本文介绍了 Dify 的核心功能、部署流程及使用方法。通过 Docker 部署可以快速搭建 AI 应用开发环境，配合可视化工具和多种模型支持，能够满足企业知识管理、智能客服等多种场景需求。遇到常见问题时，可根据上述排查思路解决。