基于 Ubuntu 22.04 环境，详解 Dify 私有化部署流程。内容包括基础工具安装、Docker 与 Compose 配置、国内镜像源加速设置，以及外接已有 MySQL 和 Redis 服务的注意事项。旨在解决部署中的依赖报错与网络解析问题，为搭建企业级 AI 知识库提供生产级方案。
Dify 是一款开源的大语言模型应用开发平台，凭借可视化编排、企业级 RAG 知识库、全链路 LLMOps 能力，让个人开发者和中小企业都能快速搭建专属 AI 应用、知识库问答系统，还能封装成 API 对外提供服务。
本文基于国内云服务器环境（Ubuntu 22.04），全程使用国内加速源，重点解决了外接 MySQL/Redis 时的依赖报错、服务名解析失败等核心问题，最终实现生产级可用的私有化 Dify 平台。
| 配置类型 | 最低配置（测试用） | 推荐配置（生产用） |
|---|---|---|
| 云服务器 | 2 核 4G，系统盘 40G | 4 核 8G，系统盘 100G |
| 操作系统 | Ubuntu 20.04/22.04 | Ubuntu 22.04 LTS |
| 网络环境 | 公网 IP，带宽 1M 以上 | 公网 IP，带宽 5M 以上 |
注：CentOS 系统仅需将
apt命令替换为yum，其余步骤基本一致。
dify.yourdomain.com 为例）# 更新系统包
sudo apt update && sudo apt upgrade -y
# 安装 Git、Vim、Curl 等基础工具
sudo apt install -y git vim curl wget
Dify 基于 Docker Compose 部署，这是唯一的依赖环境，一键安装命令：
# 官方一键安装 Docker 脚本
curl -fsSL https://get.docker.com | bash -s docker
# 验证安装
docker --version
docker compose version
国内服务器拉取 Docker 官方镜像大概率超时，提前配置国内加速器：
# 创建 Docker 配置目录
sudo mkdir -p /etc/docker
# 写入镜像源配置
sudo tee /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 -A 10 "Registry Mirrors"
-- 登录 MySQL
mysql -u root -p
-- 创建 dify 专用数据库，字符集必须为 utf8mb4，否则 emoji 会报错
CREATE DATABASE dify;
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online