如何使用Docker容器部署开源网盘系统Cloudreve-Docker-PHP中文网

用docker部署cloudreve只需三步：拉取镜像、创建数据目录、运行容器；不依赖php或数据库，适合新手。需先安装docker，再执行docker pull、mkdir建目录、docker run启动，首次访问初始化设置管理员账号，可选nginx反代+https。

如何使用docker容器部署开源网盘系统cloudreve

用Docker部署Cloudreve非常直接，核心就三步：拉镜像、建目录、跑容器。整个过程不依赖PHP或数据库，也不用编译源码，适合新手快速上手。

准备基础环境

确保服务器已安装Docker（推荐Ubuntu 22.04或CentOS 7以上）。可通过命令验证：

docker --version 确认Docker可用
docker run hello-world 测试运行是否正常

若未安装，Ubuntu用户可执行：

sudo apt update && sudo apt install docker.io -y && sudo systemctl enable --now docker

CentOS用户建议使用Docker官方源安装，避免系统自带旧版本引发兼容问题。

拉取镜像并创建数据目录

Cloudreve官方镜像托管在Docker Hub，直接拉取最新版：

docker pull cloudreve/cloudreve

接着建立两个持久化目录，用于保存配置、上传文件和数据库（SQLite）：

Docker Image Puller

使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。

下载

/www/wwwroot/cloudreve/data —— 存放数据库、配置、日志
/www/wwwroot/cloudreve/uploads —— 存放用户上传的原始文件

执行命令创建：

mkdir -p /www/wwwroot/cloudreve/{data,uploads}

启动Cloudreve容器

运行以下命令启动服务（端口5212为默认管理端口）：

docker run -d \
  --name cloudreve \
  -p 5212:5212 \
  -v /www/wwwroot/cloudreve/data:/cloudreve/data \
  -v /www/wwwroot/cloudreve/uploads:/cloudreve/uploads \
  --restart unless-stopped \
  cloudreve/cloudreve

关键说明：

--restart unless-stopped 确保重启后自动恢复运行
挂载/data目录是必须的，否则每次重启都会丢失管理员账号和设置
首次访问http://服务器IP:5212会进入初始化向导，按提示设置管理员账户即可

域名访问与HTTPS（可选但推荐）

如果已有域名，建议配合Nginx反向代理+SSL证书使用：

在宝塔面板中添加站点，选择“纯静态”类型
站点设置 → 反向代理 → 添加，目标URL填http://127.0.0.1:5212
启用SSL，申请Let’s Encrypt证书，自动强制HTTPS

这样就能通过https://pan.yourdomain.com安全访问，且浏览器地址栏显示绿色锁标。