> 面向完全小白：从「刚买云服务器」到「Dify 知识库可上传 50 GB 大文件」只需 10 分钟，全程一条命令都不用背。
---
## 0 前提说明
- 系统：Ubuntu 20.04/22.04、Debian 11/12、CentOS 7/8 均可
- 权限：拥有 `sudo` 权限的普通用户（root 也可）
- 网络：无需科学上网，全程国内镜像加速
---
## 1 一键安装 Docker（自带国内源·不卡 443）
把下面整段复制到终端，回车即可：
```bash
# 1. 先给 Docker 准备国内源（安装前就配好，后面不再 reset）
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": [
"https://docker.1panel.live",
"https://hub.gitmirror.com",
"https://dockerproxy.com",
"https://docker.m.daocloud.io"
]
}
EOF
# 2. 官方一键安装脚本（自动检测系统）
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
# 3. 把当前用户加入 docker 组（免 sudo）
sudo usermod -aG docker $USER
newgrp docker
# 4. 启动并设置开机自启
sudo systemctl enable --now docker
```
**验证**
```bash
docker run hello-world
```
看到 `Hello from Docker!` 即成功。
---
## 2 创建项目目录（后来所有操作都在这里）
```bash
mkdir -p ~/dify && cd ~/dify
```
> 提示：后续任何步骤请先 `cd ~/dify`，再执行命令！
---
## 3 下载 Dify 源码（GitHub 镜像加速）
```bash
git clone --depth=1 https://hub.gitmirror.com/https://github.com/langgenius/dify.git
cd dify/docker
```
如果镜像失效，把 `hub.gitmirror.com` 换成
`
https://ghproxy.com/https://github.com/langgenius/dify.git` 即可。
---
## 4 启动 Dify（官方 compose 一键跑）
1. 复制环境模板
```bash
cp .env.example .env
```
2. 启动（首次会拉镜像，2-5 分钟）
```bash
docker compose up -d
```
3. 看日志无报错
```bash
docker compose logs -f
```
出现 `api exited with code 0` 且没有 ERROR 即可。
4. 浏览器访问
`http://<你的服务器IP>` → 设置管理员账号 → 进入主界面，部署完成！
---
## 5 解除上传大小限制（>15 MB 必做）
默认 15 MB，改成 **50 GB**（50000 MB）小白够用：
```bash
# 在 ~/dify/docker 下执行
sed -i 's/^UPLOAD_FILE_SIZE_LIMIT=.*/UPLOAD_FILE_SIZE_LIMIT=50000/' .env
sed -i 's/^NGINX_CLIENT_MAX_BODY_SIZE=.*/NGINX_CLIENT_MAX_BODY_SIZE=50000M/' .env
docker compose down
docker compose up -d
```
改完即可上传 **单个 50 GB** 超大文件，前端不再提示「文件过大」。
---
## 6 平滑升级脚本（后续一键更新）
把下面内容保存为 `~/dify/upgrade.sh`：
```bash
#!/bin/bash
set -e
cd ~/dify/docker
echo "备份配置与数据"
cp .env .env.bak.$(date +%s)
tar -czf volumes-$(date +%s).tgz volumes 2>/dev/null || true
echo "更新源码"
git remote set-url origin https://hub.gitmirror.com/https://github.com/langgenius/dify.git
git fetch --depth=1 origin main
git reset --hard origin/main
echo "拉取最新镜像"
docker compose pull
echo "重启并清理旧镜像"
docker compose down
docker compose up -d
docker image prune -f
echo "Dify 已升级到最新版！"
```
赋权 & 运行：
```bash
chmod +x ~/dify/upgrade.sh
~/dify/upgrade.sh
```
后来升级只需执行最后一条命令，**数据无损，2 分钟搞定**。
---
## 7 常见问题速查
| 现象 | 一键修复 |
|------|----------|
| `connection reset by peer` | 本文第 1 步已配镜像源，若仍报错再执行一次 `sudo systemctl restart docker` |
| 上传提示「>0 MB 禁止」 | 把 `UPLOAD_FILE_SIZE_LIMIT=0` 改成 `50000`（已修正） |
| 页面 502 | 等 30 秒再刷新，或 `docker compose logs` 看是否镜像还在拉 |
| 忘记管理员密码 | `docker exec -it docker-api-1 flask reset-password` 按提示重置 |
---
## 8 完全卸载（想重来也不怕）
```bash
cd ~/dify/docker
docker compose down
docker volume prune -f
cd ~
rm -rf ~/dify
```
---
## 9 结语
按本文走完，你已拥有：
✅ 国内加速 Docker 环境
✅ Dify 最新版可访问
✅ 50 GB 大文件知识库上传
✅ 一键升级脚本
**全程复制粘贴，零编译，零科学上网。**
把文章收藏或转给同事，下次 10 分钟就能再搭一套！祝使用愉快～
