在 Ubuntu 22.04 上搭建 Dify 应用的完整指南

一、先说清楚 Dify 是什么、需要什么配置

Dify 是一套开源的大模型应用开发平台，把提示词编排、知识库检索、插件工具、API 输出这些都做成了可视化配置，不用从零写代码也能搭出一个能对话、能问答的 AI 应用。想在自己机器上跑起来，Ubuntu 22.04 是比较稳的选择。

项	最低配置	推荐配置
CPU	2 核	4 核
内存	4 GB	8 GB 及以上
磁盘	20 GB	40 GB 及以上
系统	Ubuntu 22.04 LTS

内存是最容易卡住的一档，向量数据库和模型服务都比较吃内存，8G 以下常见于「容器起来了但访问很慢」。

二、环境准备

更新系统并装好基础工具：

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git docker.io docker-compose

Docker 起服务并设成开机自启：

sudo systemctl enable --now docker
docker --version
docker compose version

注意 Ubuntu 22.04 自带的 docker-compose 是 v1，而项目文档用的是 v2 语法（docker compose）。如果 docker compose version 报错，装一下插件即可，不必退回 v1：

sudo apt install docker-compose-plugin

三、拉取源码并配置

git clone https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env

改 .env 里两个必填项：模型供应商的 API 密钥，以及数据库密码。密钥别提交到仓库，.env 本来就该在 .gitignore 里。

OPENAI_API_KEY=sk-your-api-key-here
DB_PASSWORD=dify_db_password

四、启动服务

sudo docker compose up -d

首次启动要拉约 2GB 镜像依赖，慢是正常的。起完查状态：

docker compose ps
docker compose logs -f api

全部容器状态为 Up（或 running），前端监听在默认端口 80，浏览器开 http://<你的IP> 就能看到登录页。

五、踩过的几个坑

• 端口被占：默认 80 和 443，机器上已有 Nginx 或宝塔会冲突。改 docker-compose.yaml 里 nginx 服务的端口映射，比如宿主改成 8080。
• 内存不足导致反复重启：看 docker stats 和 docker inspect 的 OOM 记录，加内存或把不需要的服务（比如 sandbox、web）先停掉。
• 拉不到境外镜像：配置 Docker 镜像加速地址，或把依赖镜像提前同步到内网仓库。
• 改了 .env 不生效：必须 docker compose up -d 重建容器，光 restart 不读新配置。
• 进不去后台：先看 docker compose logs，常见是数据库没起来导致 api 反复重启；另一类是密钥没配好，模型调用直接报错。
• 更新版本：先 git pull 拉新代码，再 docker compose down && docker compose up -d，数据库有迁移脚本会自动执行，动之前先备份数据卷。

六、用起来之后值得做的三件事

• 把数据源接上自己的知识库，问答质量比纯通用模型好得多，这也是 Dify 相比直接调 API 的价值。
• 应用导出成 API 或 Agent，接到内部业务系统里，别只当聊天界面用。
• 日志和用量都要盯：模型调用是按 token 计费的，不做限流和审计，账单会让你意外。

qidao123.com企服评测-应用市场 编辑提示

本文按 Ubuntu 22.04 环境整理 Dify 开源平台从环境准备、拉源码、配置密钥到容器启动的完整流程，并列出端口冲突、内存不足、镜像拉取、配置不生效等高频故障。生产部署建议提前规划数据卷备份与访问限流，模型密钥通过环境变量注入而非写死在文件里。企业内可把这套部署固化成脚本并同步私有镜像，减少每台机器的配置差异。