Harness 与 Agent 工程 · AI研发与测试工程 · 2025-11-20

Dify 自建部署完全指南:从上手到放弃到真香

从"放弃"到"真香":揭秘Dify自建部署的曲折历程与终极解决方案。

核心内容:

  1. 企业自建AI平台的痛点与需求分析
  2. Dify部署过程中的典型踩坑实录
  3. 最终实现私有化部署的关键技巧

dify 自建部署完全指南

从上手到放弃到真香

故事的开始: 就想要个听话的 AI 应用平台

几个月前,老板突然找到我:"那个谁啊,咱们也得搞个 AI 应用平台,要能接入各种模型,数据必须在自己手里,最好下周就能用上。"

我心想,这不是 Coze 吗?打开浏览器准备注册账号,突然想起上次数据合规会议上有张严肃的脸..."所有业务数据不得上传至第三方平台"。

好吧,扣子 pass。(当然,当时 Coze Studio 还没开源)

接下来的一周,我像个 AI 应用平台评测博主,把市面上能找到的都试了个遍:

Coze(字节跳动) —— "哇,这 UI 真香!插件真多!" → "等等,数据要上传?告辞。"

FastGPT —— "知识库功能不错" → "工作流怎么这么简陋?"

LangFlow —— "节点拖拽很酷" → "为啥总是莫名其妙报错?"

最后,看到了 Dify。

特性 状态
开源? 是
私有化? 是
支持各种模型? 是
工作流强大? 是
Star 数 45k+? 是

"就是你了!"我信心满满地对老板说:"给我两天时间,保证搞定!"

然后,我用了整整两周...

这篇文章,就是这两周血泪史的完整记录。如果你也准备自建 Dify,建议先泡杯茶,因为这趟旅程,有点长。


第一天:看着文档信心满满

拿到任务后的第一件事,当然是看官方文档。Dify 的文档写得还挺详细,甚至贴心地提供了 docker-compose.yaml。

我脑海里已经规划好了整个架构:

理想中的架构DeepSeek_0" data-points="W3sieCI6ODQ1LjY1NDc0NzU5NjE1MzgsInkiOjI4MC41NTM4NDgyNjY2MDE1Nn0seyJ4Ijo4OTUuMDMxMjUsInkiOjI1NS41NTM4NDgyNjY2MDE1Nn0seyJ4Ijo5MzIuNTMxMjUsInkiOjI1NS41NTM4NDgyNjY2MDE1Nn1d" marker-end="url(#mermaid-1763444343194_flowchart-v2-pointEnd)">HTTPS用户Nginx反向代理Dify前端Dify APIPostgreSQLRedis模型服务OpenAIDeepSeek自建模型

"Docker Compose 一把梭,两小时搞定!"我甚至已经开始想象老板赞许的眼神了。

然后我 clone 了代码:

git clone https://github.com/langgenius/dify.gitcd difydocker-compose up -d

5分钟后,我的屏幕上满是红色的报错信息...


第二天到第五天:PostgreSQL,你到底要我怎样?

Day 2:数据库启动失败的早晨

早上8点,泡好了一杯中年男人专属的大补茶,准备解决昨天的报错。看了下日志:

FATAL: role "postgres" does not existdb init failed, retrying...db init failed, retrying...db init failed, retrying...

"postgres 角色不存在?"我挠了挠头,这不是 PostgreSQL 的默认超级用户吗?

接下来的4个小时,我尝试了:

中午吃饭的时候,突然灵光一闪:"不会是之前的容器残留数据吧?"

果然!docker volume ls 一看,一堆 dify 相关的 volumes 躺在那里。原来 Docker 的 Volume 是持久化的,即使容器删了,数据还在。而 PostgreSQL 有个特性:如果数据目录非空,就不会重新初始化。

## 终极大招docker-compose down -v # 连 volume 一起删docker volume prune -f # 再补一刀rm -rf ./volumes/db/* # 物理删除,以防万一

再次启动,终于看到了期待已久的:

PostgreSQL Database directory appears to contain a databasedb_1 | PostgreSQL init process complete; ready for start up.

那一刻,我差点热泪盈眶。

Day 3:77 张表的灵异事件

数据库起来了,心情大好。打开 pgAdmin 连上去看看,准备欣赏一下空荡荡的数据库。

结果...77 张表整整齐齐地摆在那里。

"我还没初始化呢,哪来的表?" 我开始怀疑是不是撞鬼了。

仔细一看表名:migrations、users、apps...这不是 Dify 的表吗?可是我明明刚删除了所有数据啊?

花了一下午排查,终于发现真相。原来我在调试过程中,多次使用 git restore docker-compose.yaml 还原配置文件,每次都会生成不同的 volume 名称。而 PostgreSQL 每次都会找到某个旧的 volume 并加载。

这就像是,你以为自己住进了新房子,结果发现上一任租客的家具都还在。

教训:不只是要删 volume,还要确保 volume 名称一致,或者干脆用绝对路径挂载。

Day 4:前端白屏的下午茶时光

数据库搞定了,服务也都起来了。下午3点,泡了杯茶,准备欣赏自己的劳动成果。

打开浏览器,输入 http://localhost:3000

白屏。

F12 打开控制台:

GET http://localhost:3000/static/js/main.chunk.js 404GET http://localhost:3000/static/css/main.css 404Uncaught ReferenceError: React is not defined

"静态资源 404?" 我进到容器里一看,文件明明都在 /app/web/dist 目录下。

又是两个小时的排查,发现是 Nginx 配置的问题。Dify 的前端容器已经自带了一个 Node 服务器,不需要 Nginx 直接代理静态文件,而是要代理到这个 Node 服务器。

正确的配置应该是:

location / { proxy_pass http://web:3000; # 注意是 3000 端口,不是 80 proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";}

改完配置,nginx -s reload,页面终于出来了!

那个熟悉的 Dify Logo 出现在屏幕上时,我感觉就像见到了老朋友。

Day 5:DeepSeek 不按套路出牌

基础环境搞定,开始接入模型。OpenAI 的接入很顺利,毕竟是行业标准。但到了 DeepSeek...

在 Dify 后台填入:

测试连接,转了半天,超时。

"不应该啊,我在本地用 curl 测试是正常的。"

## 本地测试 OKcurl https://api.deepseek.com/v1/chat/completions \ -H "Authorization: Bearer sk-xxx" \ -H "Content-Type: application/json" \ -d '{"model": "deepseek-chat", "messages": [{"role": "user", "content": "Hi"}]}'

进到 Dify API 容器里再测试,也 OK。但从 Dify 界面就是不行。

抓包,看日志,翻源码...晚上11点,终于发现问题:DeepSeek 的 API 在处理 HTTP/2 请求时有些特殊,而 Dify 使用的 Python requests 库在某些情况下会强制使用 HTTP/2。

解决方案很魔幻:用 Nginx 做个中转,强制降级到 HTTP/1.1。

## deepseek 专用转发location /deepseek-proxy/ { proxy_pass https://api.deepseek.com/; proxy_http_version 1.1; # 关键是这行 proxy_ssl_server_name on; proxy_set_header Host a…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/dify/2025112051427.html