Dify：面向生产级大模型应用的开源可视化工作流平台

一、 Dify 架构全景与核心优势

Dify 是当前全球开源社区认可度最高的大模型应用编排引擎。它将复杂的 LLM 流程封装在现代化的可视化画布中，解决开发者从原型验证到生产级上线的全流程痛点：

• 多模型统一接入：原生支持 50+ 顶级商业与开源模型（DeepSeek、Claude、OpenAI、本地 Ollama）；
• 工业级 RAG 检索管线：内置 PDF/Markdown 混合分段、BM25 + 向量检索与重排（Rerank）多路召回；
• 一键发布 API & WebApp：工作流编排完成后，可一键发布为免代码网页挂件或标准化 REST API 接口。

二、 硬件配置与前置要求

• 生产配置建议：2 核 CPU、4GB 内存、20GB SSD（Docker & Docker Compose 运行环境）；
• 外部依赖项：已安装 Docker 24.0+ 与 Docker Compose v2.0+；
• 网络端口：确保服务器 80、443 端口未被其他服务独占（或使用反向代理转发宿主机 80 端口）。

三、 Docker Compose 一键生产部署

1. 拉取官方源码并配置环境变量：

   # 克隆官方最新代码仓库
   git clone https://github.com/langgenius/dify.git /opt/dify
   cd /opt/dify/docker
   
   # 复制生产环境变量配置文件
   cp .env.example .env
   

2. 启动全部容器集群并检查运行状态：

   # 一键构建并启动核心中间件 (PostgreSQL / Redis / Weaviate / Sandbox / API / Web)
   docker compose up -d
   
   # 检查所有微服务容器健康状态
   docker compose ps
   

3. 初始化管理员账号：在浏览器中访问 http://your-server-ip，按照首屏引导设定管理员邮箱与强密码，进入工作台。

四、 对接本地 Ollama / DeepSeek 实战

在设置面板中选择“模型供应商” ➔ “Ollama”：

• 模型类型：选择 LLM；
• 模型名称：填写本地拉取的模型名（如 deepseek-r1:14b）；
• 基础 URL：在 Docker 容器网络下填写 http://host.docker.internal:11434 即可打通本地无损内网通信。

五、 高频故障排查

• 问题 1：Docker Compose 启动报错 connection refused on db ➔ PostgreSQL 容器初始化需要约 15~30 秒，等待健康检查通过后会自动恢复正常连接。
• 问题 2：向量检索无响应或报错 ➔ 检查 .env 文件中 VECTOR_STORE 配置，默认建议使用预置的 weaviate 或 pgvector。