Dify 私有化部署教程:搭建专属 AI 知识库平台
本文适配 Dify 1.13.0+ 最新社区版,全程可复现。覆盖国内服务器加速部署、外接已有 MySQL/Redis(关键避坑)、云服务器 DNS 解析、Nginx 反向代理+HTTPS、API 对外提供全流程。
前言
Dify 是一款开源的大语言模型应用开发平台,凭借可视化编排、企业级 RAG 知识库、全链路 LLMOps 能力,让个人开发者和中小企业都能快速搭建专属 AI 应用、知识库问答系统,还能封装成 API 对外提供服务。
本文基于国内云服务器环境(Ubuntu 22.04),全程使用国内加速源,重点解决了外接 MySQL/Redis 时的依赖报错、服务名解析失败等核心问题,最终实现生产级可用的私有化 Dify 平台。
部署目标
- 完成 Dify 私有化部署,适配国内服务器环境
- 复用服务器已有 MySQL/Redis,不启动冗余容器
- 配置云服务器域名 DNS 解析+Nginx 反向代理+HTTPS 证书
- 生产环境安全配置、数据备份、API 对外提供方案
一、前置准备
1.1 硬件与系统要求
| 配置类型 | 最低配置(测试用) | 推荐配置(生产用) |
|---|---|---|
| 云服务器 | 2 核 4G,系统盘 40G | 4 核 8G,系统盘 100G |
| 操作系统 | Ubuntu 20.04/22.04 | Ubuntu 22.04 LTS |
| 网络环境 | 公网 IP,带宽 1M 以上 | 公网 IP,带宽 5M 以上 |
注:CentOS 系统仅需将
apt命令替换为yum,其余步骤基本一致。
1.2 必备资源提前准备
- 域名:用于后续配置 HTTPS 访问,建议提前注册好(本文以
dify.yourdomain.com为例) - 大模型 API Key:如 OpenAI、通义千问、DeepSeek、月之暗面等,用于 Dify 模型调用
- 服务器已部署环境:MySQL 8.0+、Redis 6.0+(本文核心:复用已有服务,不用容器自带的)
二、服务器环境初始化
2.1 基础工具安装
# 更新系统包
sudo apt update && sudo apt upgrade -y
# 安装 Git、Vim、Curl 等基础工具
sudo apt install -y git vim curl wget
2.2 安装 Docker 与 Docker Compose
Dify 基于 Docker Compose 部署,这是唯一的依赖环境,一键安装命令:
# 官方一键安装 Docker 脚本
curl -fsSL https://get.docker.com | bash -s docker
# 验证安装
docker --version
docker compose version

