老唐笔记
Dify (Dify.AI) 是目前开源界最强大的 LLM 应用开发平台，它集成了 RAG（检索增强生成）、Agent（智能体）、Workflow（工作流编排） 和 LLM Ops。与 n8n 相比，Dify 更像是一个“AI 操作系统”，因此它对 VPS 的性能要求更高，部署架构也更复杂（包含 9-10 个 Docker 容器）。
以下是在 搬瓦工 (BandwagonHost) VPS 上部署最新版 Dify 的完整教程。
相关文章：《搬瓦工 VPS 部署 n8n：打造你的专属 AI 自动化智能体》。
一、搬瓦工 VPS 部署 Dify 推荐配置
由于 Dify 是由多个微服务（后端 API、前端、PostgreSQL 数据库、Redis 缓存、Weaviate 向量库、Sandbox 沙箱等）组成的，资源消耗较大。
| 配置项 | 最低勉强运行 (个人测试/学习) | 推荐配置 (生产环境/团队使用) | 搬瓦工套餐建议 |
|---|---|---|---|
| CPU | 2 vCPU | 2 vCPU 或以上 | CPU 一般不是瓶颈 |
| 内存 | 2 GB (必须加 4GB Swap) | 4 GB 或以上 | 内存是核心瓶颈。2GB 必须开 Swap 否则数据库会挂。 |
| 硬盘 | 30 GB SSD | 50 GB SSD | Dify 镜像很大，加上向量数据，需要较大空间。 |
| 系统 | Ubuntu 22.04 LTS | Ubuntu 22.04 LTS | 推荐最新 Ubuntu，Docker 兼容性最好。 |
💡 避坑指南： 如果你的搬瓦工 VPS 只有 1GB 内存，请不要尝试部署 Dify，体验会极其卡顿且频繁崩溃。 如果你有 2GB 内存（如 The Plan 套餐），必须按照下文教程开启虚拟内存 (Swap)。
参考配置：
搬瓦工 CN2 GIA-E 套餐：
| 方案 | 内存 | CPU | 硬盘 | 流量/月 | 带宽 | 机房 | 价格 | 购买 |
|---|---|---|---|---|---|---|---|---|
| CN2 GIA-E | 1GB | 2核 | 20GB | 1TB | 2.5Gbps | DC6 CN2 GIA-E DC9 CN2 GIA 日本软银 JPOS_1 联通荷兰 EUNL_9 圣何塞 CN2 GIA 加拿大 CN2 GIA DC3 CN2 DC8 ZNET DC2 QNET DC4 MCOM 美国弗里蒙特 美国新泽西 美国纽约 荷兰阿姆斯特丹 | $49.99/季度 $169.99/年 | 购买 |
| CN2 GIA-E | 2GB | 3核 | 40GB | 2TB | 2.5Gbps | $89.99/季度 $299.99/年 | 购买 | |
| CN2 GIA-E | 4GB | 4核 | 80GB | 3TB | 2.5Gbps | $56.99/月 $549.99/年 | 购买 | |
| CN2 GIA-E | 8GB | 6核 | 160GB | 5TB | 5Gbps | $86.99/月 $879.99/年 | 购买 | |
| CN2 GIA-E | 16GB | 8核 | 320GB | 8TB | 5Gbps | $159.99/月 $1599.99/年 | 购买 | |
| CN2 GIA-E | 32GB | 10核 | 640GB | 10TB | 10Gbps | $289.99/月 $2759.99/年 | 购买 | |
| CN2 GIA-E | 64GB | 12核 | 1280GB | 12TB | 10Gbps | $549.99/月 $5399.99/年 | 购买 |
搬瓦工 Ultra 系列套餐：
| 方案 | 内存 | CPU | 硬盘 | 流量/月 | 带宽 | 机房 | 价格 | 购买 |
|---|---|---|---|---|---|---|---|---|
| HK | 2GB | 2核 | 40GB | 0.5TB | 1Gbps | 香港 CN2 GIA 东京 CN2 GIA 大阪 CN2 GIA 新加坡 CN2 GIA | $89.99/月 $899.99/年 | 购买 |
| HK | 4GB | 4核 | 80GB | 1TB | 1Gbps | $155.99/月 $1559.99/年 | 购买 | |
| HK | 8GB | 6核 | 160GB | 2TB | 1Gbps | $299.99/月 $2999.99/年 | 购买 | |
| HK | 16GB | 8核 | 320GB | 4TB | 1Gbps | $589.99/月 $5899.99/年 | 购买 | |
| HK | 32GB | 10核 | 640GB | 6TB | 1Gbps | $989.99/月 $9989.99/年 | 购买 | |
| HK | 64GB | 12核 | 1280GB | 8TB | 1Gbps | $1889.99/月 $18989.99/年 | 购买 |
更多套餐参考：《2026 搬瓦工最新套餐分类：Basic VPS 基础套餐/E-Commerce 电子商务/Ultra 高端套餐》。
二、搬瓦工 VPS 环境准备
SSH 登录 VPS 后，按顺序执行。
1. 更新系统并安装 Docker
sudo -s
apt update && apt upgrade -y
# 安装 Docker 和 Docker Compose
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
# 验证安装
docker compose version
2. 配置 Swap 虚拟内存（2GB/4GB 内存用户必做）
Dify 启动瞬间内存峰值较高，Swap 可以防止进程被系统 OOM Kill。
# 创建 4GB 的 Swap 文件
fallocate -l 4G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
# 设置开机自动挂载
echo '/swapfile none swap sw 0 0' >> /etc/fstab
# 验证是否生效
free -h
三、搬瓦工 VPS 部署最新版 Dify
Dify 官方提供了标准化的 Docker Compose 部署方式。
1. 克隆官方仓库
# 下载 Dify 源代码
git clone https://github.com/langgenius/dify.git
# 进入部署目录
cd dify/docker
2. 配置环境变量
Dify 依靠 .env 文件管理配置。我们需要基于示例文件创建一个。
cp .env.example .env
（可选）修改端口或域名： 默认情况下 Dify 运行在 80 端口。如果你想修改配置（例如配置外部域名），编辑它：
nano .env
- 找到
APP_WEB_URL，将其改为http://你的IP或https://你的域名（这影响邮件邀请链接等功能，不改也能跑）。 - 退出编辑器：
Ctrl+O->Enter->Ctrl+X。
3. 启动 Dify
这一步会自动拉取 Postgre, Redis, Weaviate, Nginx 等多个镜像，耗时约 3-10 分钟。
docker compose up -d
4. 检查运行状态
docker compose ps
你应该能看到约 9 个容器 处于 Up 状态（包括 docker-api-1, docker-worker-1, docker-web-1, docker-db-1 等）。
访问测试： 打开浏览器，访问 http://你的VPS_IP。
- 如果看到 Dify 的设置管理员密码界面，恭喜你，部署成功！
四、配置域名与 HTTPS (推荐)
直接用 IP 访问不安全，且无法使用语音输入等需要 HTTPS 的功能。我们使用 Caddy 来反向代理，自动申请 SSL 证书。
1. 安装 Caddy
不要修改 Dify 内部的 nginx，我们在宿主机再跑一个 Caddy。
# 安装 Caddy (Ubuntu)
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy
2. 配置域名解析
在你的域名服务商处，将域名（如 dify.example.com）解析到 VPS 的 IP 地址。
3. 配置 Caddyfile
nano /etc/caddy/Caddyfile
将内容替换为（请修改为你的真实域名）：
dify.example.com {
reverse_proxy localhost:80
}
4. 重启 Caddy
systemctl restart caddy
现在，你可以通过 https://dify.example.com 安全访问了。
五、如何升级 Dify 最新版
Dify 迭代速度极快（几乎每周都有更新），升级步骤如下：
cd /root/dify/docker
# 1. 停止当前服务
docker compose down
# 2. 拉取最新代码
git pull origin main
# 3. 拉取最新镜像
docker compose pull
# 4. (重要) 同步环境变量
# Dify 更新有时会增加新的环境变量，需要对比 .env.example 和 .env
# 如果嫌麻烦，可以备份旧 .env，复制新的 .env.example 再把旧配置填回去
# 5. 重新启动
docker compose up -d
六、常见问题排查
Q1: 安装完访问报错 “502 Bad Gateway”？
- 原因：Dify 启动较慢，特别是数据库初始化需要时间。
- 解决：等待 2 分钟再刷新。如果还不行，运行
docker compose logs -f api查看后端是否有报错（通常是数据库连接问题）。
Q2: 经常提示 “Network Error” 或页面卡死？
- 原因：内存不足，导致核心容器（如 api 或 worker）重启。
- 解决：检查 Swap 是否开启（
free -h）。如果是 2GB 内存机器，尝试减少并发。
Q3: 知识库上传文件一直 pending？
- 原因：向量数据库（Weaviate）或 Sandbox 服务未正常运行。
- 解决：
docker compose restart weaviate sandbox。
Q4: 如何使用 OpenAI/Claude？
- 搬瓦工的优势在于网络。进入 Dify 界面 -> 点击右上角头像 -> 设置 -> 模型供应商。
- 直接填入 API Key 即可，不需要配置代理地址（VPS 就在海外，直连速度最快）。
总结
在搬瓦工 VPS 上部署 Dify，你将获得一个完全私有、无内容审查、可连接任何 LLM 的超级智能体平台。
- 对于 2GB 内存用户：Swap 是救命稻草，且尽量不要同时运行大量的向量索引任务。
- 对于 4GB+ 内存用户：你可以放心使用 Dify 的所有功能，包括复杂的 Agent 编排和 RAG 检索。
