Dify 部署教程：10 分钟搭建企业级 LLM 应用平台

Dify 部署教程：10 分钟搭建企业级 LLM 应用平台

Dify 是目前最活跃的开源 LLM 应用平台，支持从简单 Chatbot 到复杂 Workflow 的完整应用生命周期。本文带你完成生产级部署。

---

一、前置要求

硬件配置

用途	最低	推荐
开发测试	2C4G	4C8G
小团队生产	4C8G	8C16G
企业生产	8C16G +	16C32G +

软件依赖

# Docker 20.10+
docker --version

# Docker Compose 2.0+
docker compose version

# 确保端口未被占用
ss -tlnp | grep -E "80|443|3000|5001"

---

二、标准 Docker 部署

# 克隆仓库（使用最新稳定版）
git clone https://github.com/langgenius/dify.git
cd dify

# 进入 docker 目录
cd docker

# 复制环境变量
cp .env.example .env

关键环境变量配置

# 必须修改：密钥（32位随机字符串）
SECRET_KEY=your-secret-key-change-this-immediately

# 管理员初始密码
INIT_PASSWORD=your-admin-password

# 数据库密码
DB_PASSWORD=your-db-password

# Redis 密码
REDIS_PASSWORD=your-redis-password

# 向量数据库选择（默认 weaviate，也可选 qdrant/pgvector）
VECTOR_STORE=weaviate

# 存储方式（本地部署使用 local）
STORAGE_TYPE=local
STORAGE_LOCAL_PATH=./volumes/app/storage

# 部署域名
CONSOLE_WEB_URL=https://dify.your-company.com
APP_WEB_URL=https://dify.your-company.com

# 启动所有服务
docker compose up -d

# 查看启动状态（等待所有服务 healthy）
docker compose ps

# 预期看到的服务：
# api, worker, web, db, redis, weaviate, nginx, sandbox

---

三、向量数据库配置

Dify 支持多种向量数据库，默认使用 Weaviate。如果内存有限，推荐切换到 pgvector：

# .env 修改
VECTOR_STORE=pgvector
PGVECTOR_HOST=db
PGVECTOR_PORT=5432
PGVECTOR_USER=postgres
PGVECTOR_PASSWORD=${DB_PASSWORD}
PGVECTOR_DATABASE=dify

切换 pgvector 可以节省约 1GB 内存，适合资源有限的场景。

---

四、配置 HTTPS（Nginx + Let's Encrypt）

# 安装 certbot
sudo apt install certbot python3-certbot-nginx -y

# 申请证书
sudo certbot certonly --standalone -d dify.your-company.com

修改 Dify 的 Nginx 配置：

# docker/nginx/conf.d/default.conf
server {
    listen 443 ssl;
    server_name dify.your-company.com;

    ssl_certificate /etc/letsencrypt/live/dify.your-company.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/dify.your-company.com/privkey.pem;

    location / {
        proxy_pass http://web:3000;
    }

    location /api {
        proxy_pass http://api:5001;
        proxy_read_timeout 300s;
    }

    location /v1 {
        proxy_pass http://api:5001;
    }
}

# 挂载证书目录并重启
docker compose restart nginx

---

五、多租户与权限配置

Dify 支持工作空间（Workspace）隔离，适合多部门使用：

1. 访问 https://dify.your-company.com 完成初始化
2. 管理员登录 → 设置 → 成员管理
3. 按角色分配：管理员 / 编辑者 / 使用者
4. 每个工作空间可以设置独立的 LLM API Key

---

六、LLM 模型配置

在管理后台配置 LLM 提供商：

设置 → 模型供应商 → 添加模型

支持的模型（部分）：

• OpenAI（GPT-4, GPT-4o）
• Anthropic（Claude 系列）
• 阿里云百炼（Qwen 系列）
• DeepSeek
• 本地 Ollama（需配置 API 地址）

---

七、验证部署

# 检查 API 健康
curl https://dify.your-company.com/api/health
# 返回：{"status": "ok"}

# 检查各容器状态
docker compose ps --format "table {{.Name}}\t{{.Status}}"

所有服务显示 healthy 后，在浏览器访问控制台，创建一个测试 Chatbot，发送消息验证 LLM 连通性。

---

八、遇到问题？

Dify 的部署涉及多个组件，第一次配置容易卡在向量数据库或 SSL 环节。如果你的团队希望跳过这个学习曲线，LocalClaw（insman.cn） 上有专业的 Dify 服务商，可以提供包含定制化配置的交付服务。