自建 Dify 大模型应用平台:多服务架构、知识库 RAG 与内网模型网关对接
在自己的 Linux 服务器上用 Zenavo 部署 Dify(含 PostgreSQL、Redis/Valkey 与代码沙箱),通过 .zenavo.internal 内网对接 LiteLLM、New API 与 SearXNG,把知识库与工作流留在自有主机上。
本文亦提供 English、繁體中文、日本語、Español 和 Bahasa Indonesia。
搭建企业内部知识库问答或复杂的多步 AI 工作流,往往要把提示词编排、文档切片、向量检索、工具调用和调用日志串成一套系统。Dify 把这些能力整合成了可视化的工作流编排器与后端 API。把它部署在自己的 VPS 上,上传的文档、向量索引和执行日志都留在自己的磁盘里,也没有云端按席位或知识库容量的限制。
这篇文章介绍 Dify 在 Zenavo 上的多服务拆分与配置要点、如何通过 .zenavo.internal 内网串接模型网关与搜索引擎,以及上线后的常见排障点。服务器费用与 Zenavo 平台费用分开结算。
1. 服务器规格与服务架构
Dify 不是单一容器,而是一组协同工作的服务。为了保证文档解析、向量写入和并发工作流顺畅运行,建议在 Zenavo 中连接一台至少 4 GB 内存的 Linux 服务器(如果同机还要跑独立向量库,建议 8 GB 起步)。
把所有服务放进同一个 Zenavo 项目后,彼此直接通过项目私有网络通信,数据库与沙箱无需暴露到公网:
| 组件 | 作用 | 持久化与配置要点 |
|---|---|---|
postgresql |
核心关系数据库(若启用 pgvector,同时承担向量存储) |
挂载持久化卷 /var/lib/postgresql/data,在 备份与恢复 中开启定期备份 |
redis / valkey |
Celery 异步任务队列、缓存与限流状态 | 可按需挂载数据卷,确保重启不丢队列 |
dify-api 与 dify-worker |
langgenius/dify-api(分别以 MODE=api 和 MODE=worker 启动) |
共享同一份 SECRET_KEY、数据库地址、Redis 地址与 /app/api/storage 上传存储卷 |
dify-web |
langgenius/dify-web Next.js 控制台前端 |
将 CONSOLE_API_URL 与 APP_API_URL 指向你的 HTTPS 域名 |
dify-sandbox |
langgenius/dify-sandbox 工作流代码节点隔离沙箱 |
仅允许 dify-api / dify-worker 通过 .zenavo.internal 访问 |
nginx(反向代理) |
将 /console/api、/api、/v1、/files 转发至 dify-api:5001,/ 转发至 dify-web:3000 |
全栈唯一需要绑定公网域名与 HTTPS 的入口服务(端口 80) |
你可以先到 Zenavo 应用模板库 查看现成的 AI 栈,或在同一个 Zenavo 项目中按上述结构编排各服务。
2. 最容易踩坑的环境变量
Dify 首次部署时,登录报错或接口跨域绝大多数都是下面几项没对齐:
SECRET_KEY:生成一串高强度随机字符串,并在dify-api和dify-worker上填完全一致的值。Dify 用它加解密数据库里保存的模型商 API Key 与工作区凭证。- 公开域名变量:在反向代理服务的 域名与 HTTPS 页绑定自定义域名(例如
dify.example.com)后,把CONSOLE_API_URL、CONSOLE_WEB_URL、SERVICE_API_URL、APP_API_URL与APP_WEB_URL统一设为https://dify.example.com。 - 内网数据库与 Redis:
DB_HOST填postgresql.zenavo.internal,REDIS_HOST填redis.zenavo.internal(或valkey.zenavo.internal),无需打开公网端口。 - 向量库选择:如果使用
VECTOR_STORE=pgvector,关系数据与向量索引都在同一个 PostgreSQL 服务里,后续做整库快照和恢复(见备份与恢复文档)会省心很多。
务必备份
SECRET_KEY:建议第一时间把SECRET_KEY存进密码管理器(如自建的 Vaultwarden)。后续一旦改动SECRET_KEY,数据库里已保存的模型密钥将无法解密。
3. 内网对接模型网关与联网搜索
如果服务器里已经跑了模型网关或搜索引擎,在同一个 Zenavo 项目里直接走 .zenavo.internal 内网互通即可,既零延迟又不用把内部接口暴露到公网:
- 对接模型网关(LiteLLM / New API / Magpie):在 Dify 后台打开 设置 → 模型供应商 → OpenAI-API-compatible,API Endpoint 填
http://litellm.zenavo.internal:4000/v1(或对应的 New API / Magpie 内网地址),填入虚拟密钥或令牌。这样所有应用的预算上限、限流和调用审计都能在网关层统一管控。 - 接入私有联网搜索(SearXNG):在 SearXNG 开启 JSON 输出后,将 Dify 内置 SearXNG 工具的地址设为
http://searxng.zenavo.internal:8080,即可让 Agent 免费、无配额限制地检索实时网页。 - 联动通用自动化(n8n):让 Dify 专注提示词编排、RAG 检索与效果评估,再通过 Webhook 把结果交给 n8n 同步飞书/Slack、写入表格或执行定时任务。
4. 初始化管理员与验证队列
- 等所有服务状态变为
Running后,访问https://dify.example.com/install创建初始管理员账号。 - 新建一个测试应用并在 知识库 上传一份小体积的 Markdown 或 PDF 文档,确认状态能顺利从
排队中变为可用。 - 如果文档长期卡在
索引中,可以直接呼出控制台右侧的 Zenavo Agent 帮你查看dify-worker和redis的实时日志,或者在本地终端用 Claude Code 配合zenavo-mcp排查。
常见问题
绑定域名后页面空白,或登录后接口报 401 / CORS 错误?
检查 dify-web 与 dify-api 上的 CONSOLE_API_URL、APP_API_URL 是否都填了带 https:// 且不带末尾斜杠的完整域名,并确认反向代理正确把 /console/api 和 /api 转发给了 dify-api 的 5001 端口。
知识库上传文件后一直卡在 排队中 或 索引中?
通常是 dify-worker 未正常运行、dify-worker 连接的 Redis 与 dify-api 不一致,或者两个服务没有挂载共享的 /app/api/storage 存储卷导致 worker 读不到上传文件。
Dify 和 n8n 应该怎么选?
如果你的核心需求是提示词版本管理、RAG 知识库、多模型效果对比以及对外发布对话/工作流 API,选 Dify;如果偏重 400+ SaaS 应用连接、定时批处理和跨系统 Webhook 胶水逻辑,选 n8n——两者放在同一个 Zenavo 项目里通过 .zenavo.internal 配合效果最好。
能把 Zeabur 上的 Dify 项目迁移到 Zenavo 吗?
可以。在 Zeabur 导出项目模板 YAML 后直接导入 Zenavo(详见从 Zeabur 迁移),通过 备份与恢复 上传并还原原有的 PostgreSQL 备份(详见迁移 Zeabur PostgreSQL 数据库),并保留原来的 SECRET_KEY 即可。
现在就添加一台 Linux 服务器或浏览 Zenavo 应用模板库,把 Dify 工作流与知识库部署到完全属于你的基础设施上。
这是 coding agent 读到的内容,地址是 https://zenavo.app/zh-CN/blog/self-host-dify.md。
无法加载 Markdown,请直接打开: https://zenavo.app/zh-CN/blog/self-host-dify.md