下面给你一份**「Dify 本地化部署（私有化部署）」完整指南**，适合 个人 / 企业内网 / 本地服务器 / 云服务器 使用，步骤尽量做到可直接照着执行。

一、Dify 是什么？为什么要本地化部署

Dify 是一个开源的 LLM 应用开发平台，支持：

  • 可视化 Prompt / Workflow
  • 多模型接入（OpenAI / Azure / 通义 / DeepSeek / Ollama 等）
  • RAG（知识库问答）
  • API 服务化

本地化部署适合：

  • 🔒 数据不能出公网（企业 / 内网）
  • 🧠 接私有模型（如 Ollama、私有 DeepSeek）
  • 💰 避免 SaaS 费用
  • 🔧 二次开发 & 定制

二、部署方式总览（推荐 Docker）

方式难度推荐度
Docker Compose⭐⭐✅ 强烈推荐
Kubernetes⭐⭐⭐⭐企业级
源码部署⭐⭐⭐⭐⭐不建议新手

👉 下面全部基于 Docker Compose

三、部署环境要求

1️⃣ 基础环境

# 操作系统
Linux / macOS / Windows (WSL2)

# 必须
Docker >= 20.10
Docker Compose >= v2

检查：

docker -v
docker compose version

四、拉取 Dify 官方仓库

git clone https://github.com/langgenius/dify.git
cd dify/docker

目录结构关键点：

docker/
├── docker-compose.yaml
├── .env.example
├── volumes/

五、配置 .env（非常重要）

cp .env.example .env

关键配置项（必看）

# Web 访问地址
CONSOLE_WEB_URL=http://localhost
APP_WEB_URL=http://localhost

# 安全密钥（必须改）
SECRET_KEY=your-random-secret-key

# 数据库
DB_USERNAME=dify
DB_PASSWORD=dify123456
DB_DATABASE=dify

# Redis
REDIS_PASSWORD=redis123

# 文件存储（本地即可）
STORAGE_TYPE=local

👉 生成安全密钥：

openssl rand -base64 42

六、启动 Dify

docker compose up -d

首次启动会拉取镜像，耐心等待 ⏳

查看运行状态

docker compose ps

正常会看到：

  • dify-api
  • dify-web
  • postgres
  • redis
  • weaviate

七、访问 Dify 控制台

浏览器打开：

http://localhost

首次进入：

  • 创建 管理员账号
  • 进入 Dify 控制台

八、模型配置（本地 / 私有模型）

示例 1：接 Ollama（本地大模型）

模型类型：OpenAI Compatible
API Base URL：http://host.docker.internal:11434/v1
API Key：随便填
模型名：llama3 / qwen2 / deepseek-r1

👉 Linux 需改为：

http://172.17.0.1:11434/v1

示例 2：接 DeepSeek / 通义 / OpenAI

在 设置 → 模型提供商 中配置即可。

九、数据持久化位置

docker/volumes/
├── postgres
├── redis
├── weaviate
├── app_storage

📌 删容器不删数据，数据安全

十、常见问题排雷

❌ 端口冲突

# 修改 docker-compose.yaml 中端口映射
80:80 → 8080:80

❌ 页面打不开

docker compose logs dify-web
docker compose logs dify-api

❌ 模型调用失败

  • API Base URL 写错
  • 容器访问不到宿主机
  • 模型名不匹配

十一、升级 Dify（不丢数据）

git pull
docker compose pull
docker compose up -d