Dify 私有化部署教程：搭建专属 AI 知识库平台
本文适配 Dify 1.13.0+ 最新社区版，覆盖国内服务器加速部署、外接已有 MySQL/Redis（关键避坑）、云服务器 DNS 解析、Nginx 反向代理+HTTPS、API 对外提供全流程，解决部署过程中的核心问题。
前言
Dify 是一款开源的大语言模型应用开发平台，凭借可视化编排、企业级 RAG 知识库、全链路 LLMOps 能力，让个人开发者和中小企业都能快速搭建专属 AI 应用、知识库问答系统，还能封装成 API 对外提供服务。
本文基于国内云服务器环境（Ubuntu 22.04），全程使用国内加速源，重点解决了外接 MySQL/Redis 时的依赖报错、服务名解析失败等核心问题，最终实现生产级可用的私有化 Dify 平台。
一、前置准备
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
2.3 配置 Docker 国内镜像源（必做！解决镜像拉取超时）
国内服务器拉取 Docker 官方镜像大概率超时，提前配置国内加速器：
# 创建 Docker 配置目录
sudo mkdir -p /etc/docker
# 写入镜像源配置
/etc/docker/daemon.json <<-
{
: [
,
,
]
}
EOF
systemctl daemon-reload
systemctl restart docker
docker info | grep -A 10
