---
title: "自建 Dify 大模型应用平台：多服务架构、知识库 RAG 与内网模型网关对接"
description: "在自己的 Linux 服务器上用 Zenavo 部署 Dify（含 PostgreSQL、Redis/Valkey 与代码沙箱），通过 .zenavo.internal 内网对接 LiteLLM、New API 与 SearXNG，把知识库与工作流留在自有主机上。"
date: 2026-11-16
language: zh-CN
url: https://zenavo.app/zh-CN/blog/self-host-dify
---

# 自建 Dify 大模型应用平台：多服务架构、知识库 RAG 与内网模型网关对接

搭建企业内部知识库问答或复杂的多步 AI 工作流，往往要把提示词编排、文档切片、向量检索、工具调用和调用日志串成一套系统。[Dify](https://github.com/langgenius/dify) 把这些能力整合成了可视化的工作流编排器与后端 API。把它部署在自己的 VPS 上，上传的文档、向量索引和执行日志都留在自己的磁盘里，也没有云端按席位或知识库容量的限制。

这篇文章介绍 Dify 在 Zenavo 上的多服务拆分与配置要点、如何通过 `.zenavo.internal` 内网串接模型网关与搜索引擎，以及上线后的常见排障点。服务器费用与 Zenavo 平台费用分开结算。

## 1. 服务器规格与服务架构

Dify 不是单一容器，而是一组协同工作的服务。为了保证文档解析、向量写入和并发工作流顺畅运行，建议在 Zenavo 中[连接一台至少 4 GB 内存的 Linux 服务器](https://docs.zenavo.app/zh-CN/servers/add-a-server)（如果同机还要跑独立向量库，建议 8 GB 起步）。

把所有服务放进同一个 Zenavo 项目后，彼此直接通过[项目私有网络](https://docs.zenavo.app/zh-CN/networking/private)通信，数据库与沙箱无需暴露到公网：

| 组件 | 作用 | 持久化与配置要点 |
|---|---|---|
| `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 应用模板库](https://zenavo.app/zh-CN/templates) 查看现成的 AI 栈，或在同一个 Zenavo 项目中按上述结构编排各服务。

## 2. 最容易踩坑的环境变量

Dify 首次部署时，登录报错或接口跨域绝大多数都是下面几项没对齐：

1. **`SECRET_KEY`**：生成一串高强度随机字符串，并在 `dify-api` 和 `dify-worker` 上填**完全一致的值**。Dify 用它加解密数据库里保存的模型商 API Key 与工作区凭证。
2. **公开域名变量**：在反向代理服务的 [域名与 HTTPS](https://docs.zenavo.app/zh-CN/networking/domains) 页绑定自定义域名（例如 `dify.example.com`）后，把 `CONSOLE_API_URL`、`CONSOLE_WEB_URL`、`SERVICE_API_URL`、`APP_API_URL` 与 `APP_WEB_URL` 统一设为 `https://dify.example.com`。
3. **内网数据库与 Redis**：`DB_HOST` 填 `postgresql.zenavo.internal`，`REDIS_HOST` 填 `redis.zenavo.internal`（或 `valkey.zenavo.internal`），无需打开公网端口。
4. **向量库选择**：如果使用 `VECTOR_STORE=pgvector`，关系数据与向量索引都在同一个 PostgreSQL 服务里，后续做整库快照和恢复（见[备份与恢复文档](https://docs.zenavo.app/zh-CN/operations/backups)）会省心很多。

> **务必备份 `SECRET_KEY`**：建议第一时间把 `SECRET_KEY` 存进密码管理器（如自建的 [Vaultwarden](https://zenavo.app/zh-CN/blog/self-host-vaultwarden)）。后续一旦改动 `SECRET_KEY`，数据库里已保存的模型密钥将无法解密。

## 3. 内网对接模型网关与联网搜索

如果服务器里已经跑了模型网关或搜索引擎，在同一个 Zenavo 项目里直接走 `.zenavo.internal` 内网互通即可，既零延迟又不用把内部接口暴露到公网：

- **对接模型网关（[LiteLLM](https://zenavo.app/zh-CN/blog/self-host-litellm) / [New API](https://zenavo.app/zh-CN/blog/self-host-new-api) / [Magpie](https://zenavo.app/zh-CN/blog/self-host-magpie)）**：在 Dify 后台打开 **设置 → 模型供应商 → OpenAI-API-compatible**，API Endpoint 填 `http://litellm.zenavo.internal:4000/v1`（或对应的 New API / Magpie 内网地址），填入虚拟密钥或令牌。这样所有应用的预算上限、限流和调用审计都能在网关层统一管控。
- **接入私有联网搜索（[SearXNG](https://zenavo.app/zh-CN/blog/self-host-searxng)）**：在 SearXNG 开启 JSON 输出后，将 Dify 内置 SearXNG 工具的地址设为 `http://searxng.zenavo.internal:8080`，即可让 Agent 免费、无配额限制地检索实时网页。
- **联动通用自动化（[n8n](https://zenavo.app/zh-CN/blog/self-host-n8n)）**：让 Dify 专注提示词编排、RAG 检索与效果评估，再通过 Webhook 把结果交给 n8n 同步飞书/Slack、写入表格或执行定时任务。

## 4. 初始化管理员与验证队列

1. 等所有服务状态变为 `Running` 后，访问 `https://dify.example.com/install` 创建初始管理员账号。
2. 新建一个测试应用并在 **知识库** 上传一份小体积的 Markdown 或 PDF 文档，确认状态能顺利从 `排队中` 变为 `可用`。
3. 如果文档长期卡在 `索引中`，可以直接呼出控制台右侧的 [Zenavo Agent](https://docs.zenavo.app/zh-CN/zenavo-agent) 帮你查看 `dify-worker` 和 `redis` 的实时日志，或者在本地终端用 [Claude Code 配合 `zenavo-mcp`](https://zenavo.app/zh-CN/blog/claude-code-deploy-debug) 排查。

## 常见问题

**绑定域名后页面空白，或登录后接口报 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](https://zenavo.app/zh-CN/blog/self-host-n8n)**——两者放在同一个 Zenavo 项目里通过 `.zenavo.internal` 配合效果最好。

**能把 Zeabur 上的 Dify 项目迁移到 Zenavo 吗？**
可以。在 Zeabur 导出项目模板 YAML 后直接导入 Zenavo（详见[从 Zeabur 迁移](https://zenavo.app/zh-CN/blog/migrate-from-zeabur)），通过 **备份与恢复** 上传并还原原有的 PostgreSQL 备份（详见[迁移 Zeabur PostgreSQL 数据库](https://zenavo.app/zh-CN/blog/migrate-zeabur-postgresql)），并保留原来的 `SECRET_KEY` 即可。

现在就[添加一台 Linux 服务器](https://docs.zenavo.app/zh-CN/servers/add-a-server)或浏览 [Zenavo 应用模板库](https://zenavo.app/zh-CN/templates)，把 Dify 工作流与知识库部署到完全属于你的基础设施上。
