本文档详细介绍了将本地部署的 Dify 迁移至自有服务器的关键步骤。首先，需要做好迁移前的准备工作，包括环境检查和数据备份。接着，配置服务器环境，安装必要的依赖软件并设置防火墙。然后，在服务器上部署 Dify，包括获取部署文件、配置环境变量、启动服务并进行验证。完成部署后，需要恢复备份的数据库和知识库文件。为了实现域名访问，需要配置 Nginx 反向代理，并启用 HTTPS 以增强安全性。最后，文章还提供了系统优化、故障排查和升级维护的建议，帮助用户平稳完成 Dify 的迁移和后续的稳定运行。

📝 **迁移准备与环境配置**：在迁移 Dify 前，需确保服务器满足 Ubuntu 20.04+/CentOS 7+ 操作系统、至少 4GB 内存（推荐 8GB）和 50GB SSD 存储空间的要求，并开放 80, 443, 22 端口。同时，必须备份本地的数据库（`dify_db_backup.sql`）和知识库文件（`knowledgebase_backup.tar.gz`）。服务器环境配置包括安装 Docker、Docker Compose、Git 和 Nginx，并根据操作系统类型执行相应命令。防火墙需开放 22, 80, 443 端口并启用。

🚀 **Dify 服务器部署与数据恢复**：通过 `git clone` 获取 Dify 的 Docker 部署文件，并修改 `.env` 文件中的关键配置项，如 Nginx 端口、`APP_SECRET_KEY` 和 `DATABASE_URL`。随后，使用 `docker-compose up -d` 启动 Dify 服务，并通过 `docker ps -a` 和 `curl` 命令验证部署状态。数据恢复是将备份的数据库文件导入到 Dify 的 PostgreSQL 容器中，并将知识库文件解压到指定的存储卷。

🌐 **域名访问与 HTTPS 配置**：为了方便访问，需要配置 Nginx 实现域名反向代理。在 Nginx 中创建站点配置文件，将指定域名（如 `ai.yourdomain.com`）的请求代理到 Dify 的本地端口（默认为 3000）。启用该配置并重载 Nginx 服务。为确保数据传输安全，需使用 Certbot 安装并配置 Let's Encrypt 证书，实现 HTTPS 访问，并进行自动续期测试。

🛠️ **系统优化与故障排查**：为保障 Dify 的稳定运行，建议设置 Docker 和 Nginx 服务开机自启，并配置日志轮转机制以管理日志文件。文章还提供了常见的故障现象及解决方案，例如 502 Bad Gateway、数据库连接失败、知识库加载失败和 HTTPS 重定向循环等，帮助用户快速定位和解决问题。此外，建议使用 `watch -n 5 docker stats` 监控资源占用，并在重要更新前创建 Docker 镜像快照，以及设置每日自动备份数据库。

将本地 Docker 部署的 Dify 迁移到自己的服务器，需要完成以下关键步骤：

---

一、迁移前准备工作

环境检查

确保服务器满足：

OS: Ubuntu 20.04+/CentOS 7+内存: ≥4GB（推荐8GB）存储: ≥50GB SSD开放端口：80 (HTTP), 443 (HTTPS), 22 (SSH)

备份本地数据

bash

# 备份数据库docker exec -t dify-postgres pg_dumpall -c -U postgres > dify_db_backup.sql# 备份知识库文件tar czvf knowledgebase_backup.tar.gz ./volumes/storage

---

二、服务器环境配置

1. 安装基础依赖

bash

# Ubuntusudo apt update && sudo apt install -y docker.io docker-compose git nginx# CentOSsudo yum install -y docker git nginxsudo systemctl start dockersudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose

2. 配置防火墙

bash

sudo ufw allow 22sudo ufw allow 80sudo ufw allow 443sudo ufw enable

---

三、部署 Dify 到服务器

1. 获取部署文件

bash

git clone https://github.com/langgenius/dify.gitcd dify/docker

2. 配置环境变量

编辑 .env 文件：

env

# 关键配置项NGINX_HTTP_PORT=80NGINX_HTTPS_PORT=443APP_SECRET_KEY=your_strong_secret_key  # 生成命令：openssl rand -hex 32DATABASE_URL=postgresql://postgres:postgres@postgres:5432/dify

3. 启动服务

bash

docker-compose up -d

4. 验证部署

bash

docker ps -a  # 应看到3个容器：app, worker, nginxcurl http://localhost/api/system/status  # 返回{"status":"ok"}即成功

---

四、恢复数据

1. 恢复数据库

bash

# 将备份文件复制到容器docker cp dify_db_backup.sql dify-postgres:/tmp/# 执行恢复docker exec -it dify-postgres psql -U postgres -f /tmp/dify_db_backup.sql

2. 恢复知识库

bash

# 解压备份到存储卷tar xzvf knowledgebase_backup.tar.gz -C ./volumes/storage

---

五、配置域名访问（Nginx 反向代理）

1. 创建 Nginx 配置

/etc/nginx/sites-available/dify.conf：

nginx

server {    listen 80;    server_name ai.yourdomain.com;    location / {        proxy_pass http://127.0.0.1:3000;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;    }}

2. 启用配置

bash

sudo ln -s /etc/nginx/sites-available/dify.conf /etc/nginx/sites-enabled/sudo nginx -t && sudo systemctl reload nginx

---

六、启用 HTTPS（Let's Encrypt）

bash

# 安装 certbotsudo apt install certbot python3-certbot-nginx# 获取证书sudo certbot --nginx -d ai.yourdomain.com# 自动续期测试sudo certbot renew --dry-run

---

七、系统优化

1. 开机自启

bash

sudo systemctl enable docker nginx

2. 日志管理

bash

# 查看实时日志docker-compose logs -f app# 日志轮转（创建 /etc/logrotate.d/dify）/var/lib/docker/containers/*/*.log {  daily  rotate 7  compress  delaycompress  missingok  copytruncate}

---

八、故障排查指南

问题现象	解决方案
502 Bad Gateway	检查容器状态：docker-compose ps
数据库连接失败	验证 .env 中的 DATABASE_URL
知识库加载失败	检查存储卷权限：chmod -R 755 volumes
HTTPS 重定向循环	在 Nginx 配置中添加：proxy_set_header X-Forwarded-Proto $scheme;

---

九、升级维护

bash

# 更新代码cd dify/dockergit pull origin main# 重建服务docker-compose downdocker-compose up -d --build

💡 建议：

使用 watch -n 5 docker stats 监控资源占用

重要更新前创建快照：docker commit dify-app dify-backup-$(date +%F)

设置每日自动备份数据库（通过 crontab）

完成以上步骤后，您的 Dify 已稳定运行在自有服务器上。可通过 https://ai.yourdomain.com 访问智能客服系统。