2026最新 Dify 私有化部署完整教程：从0到1搭建专属AI知识库平台
2026最新 Dify 私有化部署完整教程：从0到1搭建专属AI知识库平台
本文适配 Dify 1.13.0+ 最新社区版，全程可复现，新手友好。覆盖国内服务器加速部署、外接已有MySQL/Redis（关键避坑）、云服务器DNS解析、Nginx反向代理+HTTPS、API对外提供全流程，解决部署过程中99%的坑。
前言
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 基础工具安装
# 更新系统包sudoapt update &&sudoapt upgrade -y# 安装Git、Vim、Curl等基础工具sudoaptinstall-ygitvimcurlwget2.2 安装Docker与Docker Compose
Dify基于Docker Compose部署，这是唯一的依赖环境，一键安装命令：
# 官方一键安装Docker脚本curl-fsSL https://get.docker.com |bash-sdocker# 验证安装docker--versiondocker compose version 2.3 配置Docker国内镜像源（必做！解决镜像拉取超时）
国内服务器拉取Docker官方镜像大概率超时，提前配置国内加速器：
# 创建Docker配置目录sudomkdir-p /etc/docker # 写入镜像源配置sudotee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": [ "https://docker.mirrors.ustc.edu.cn", "https://docker.1panel.live", "https://docker.1ms.run" ] } EOF# 重启Docker使配置生效sudo systemctl daemon-reload sudo systemctl restart docker# 验证配置是否生效docker info |grep-A10"Registry Mirrors"2.4 外接MySQL与Redis前置配置
2.4.1 MySQL配置（必做）
- 登录MySQL，创建Dify专用数据库与用户（避免用root账号）
-- 登录MySQL mysql -u root -p -- 创建dify专用数据库，字符集必须为utf8mb4，否则emoji会报错CREATEDATABASE dify 
