下面给你一份**「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