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 后台填入:
- • API Base:
https://api.deepseek.com/v1 - • API Key:
sk-xxxx
测试连接,转了半天,超时。
"不应该啊,我在本地用 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…