2734 字
14 分钟
Cloudreve:私人云盘部署与存储策略
2026-11-15

先说主线:为什么要自建网盘,又为什么选 Cloudreve#

公共网盘的问题人人都遇到过:限速、和谐、会员年年涨价,更麻烦的是重要文件放在别人服务器上,心里总不踏实。把网盘建在自己的 VPS 上,空间、速度、规则全都自己说了算,这也是整个自建服务里最能立刻提升幸福感的一类应用。

同类产品里,Cloudreve 是国内开发者维护的开源网盘系统,特点很对自建用户的胃口:

  • 界面是熟悉的网盘式操作:上传、下载、文件夹、在线预览、分享链接,和公共网盘几乎无缝衔接
  • 支持多种存储后端:本地磁盘、S3 兼容对象存储、OneDrive 等,可以按文件类型分流
  • 自带离线下载(通过 Aria2)、WebDAV、多用户与用户组、文件直链等功能
  • 单容器部署,数据目录结构简单,迁移和备份都方便

这一篇的主线是:先用 Docker 把 Cloudreve 跑起来,再把存储策略想清楚——哪些文件放本地盘、哪些放对象存储、备份怎么做。部署本身只需要十分钟,存储策略才是决定这个网盘能用多久、用得安不安心的关键。

部署前建议先看 Nginx Proxy Manager:所有自建服务的统一入口,把反向代理和 HTTPS 证书准备好,网盘这种要传文件的服务尤其需要稳定的 HTTPS 入口。

部署前准备#

项目建议说明
内存1 GB 以上Cloudreve 本体很轻,吃资源的是转码预览和缩略图
磁盘按需求规划本地存储策略下,网盘容量等于 VPS 磁盘容量
域名一个子域名,如 pan.example.com走 NPM 反代并签发证书
端口5212(默认)只绑定本机,经反代对外

先建好目录结构,把数据、配置和上传文件分开放:

Terminal window
mkdir -p /opt/cloudreve/{data,uploads,avatar,aria2}
cd /opt/cloudreve

目录规划的思路是:data 放数据库和配置,uploads 是本地存储策略下的文件本体,之后备份时这两个目录就是全部身家,路径固定才好写备份脚本。

Docker Compose 部署#

Cloudreve 官方镜像为 cloudreve/cloudreve,配合 Aria2 实现离线下载。一份完整的 Compose 如下:

services:
cloudreve:
image: cloudreve/cloudreve:latest
container_name: cloudreve
restart: unless-stopped
environment:
- TZ=Asia/Shanghai
ports:
- "127.0.0.1:5212:5212"
volumes:
- ./data:/cloudreve/data
- ./uploads:/cloudreve/uploads
- ./avatar:/cloudreve/avatar
depends_on:
- aria2
aria2:
image: p3terx/aria2-pro:latest
container_name: aria2
restart: unless-stopped
environment:
- TZ=Asia/Shanghai
- RPC_SECRET=改成你的RPC密钥
- RPC_PORT=6800
volumes:
- ./aria2:/config
- ./uploads:/downloads
ports:
- "127.0.0.1:6800:6800"

启动并查看初始管理员账号:

Terminal window
docker compose up -d
docker logs cloudreve | head -30

首次启动时日志会打印随机生成的管理员邮箱和密码,形如:

[Info] Admin user name: admin@cloudreve.org
[Info] Admin password: xxxxxxxx

务必第一时间登录并修改管理员密码,并把初始密码从日志里记下来后改掉——这组随机密码会一直留在容器日志里,谁能看日志谁就能进你的网盘。改完密码后到「管理面板 → 参数设置」里把站点地址改成你的正式域名,后面生成的分享链接才会正确。

WARNING

Aria2 的 RPC 端口 6800 千万不要直接暴露到公网。RPC 接口一旦被扫到,别人可以借你的服务器下载任意文件甚至写文件。上面的 Compose 已经只绑定 127.0.0.1,Cloudreve 与 Aria2 在同一台机器上通信走本机地址即可;RPC_SECRET 也要设成足够随机的字符串。

存储策略:这一篇的核心#

Cloudreve 的「存储策略」决定上传的文件最终落在哪里。一个用户组绑定一个默认策略,不同用户组可以走不同策略。常见三种打法:

策略文件落点优点缺点适合
本地存储VPS 磁盘速度最快、零额外成本容量受磁盘限制小文件、文档、常用资料
对象存储(S3 兼容)云厂商对象存储容量近乎无限、单价低上传下载多一跳、回源流量计费需看厂商大文件、影音、冷数据
从机/远程节点另一台服务器扩容灵活部署复杂多机玩家

本地存储策略配置#

管理面板 → 存储策略 → 新建,选择「本地存储」,物理路径填写容器内的上传目录:

/cloudreve/uploads

注意这里填的是容器内路径,和 Compose 里挂载的 ./uploads:/cloudreve/uploads 对应。文件名保存方式建议选「根据 ID 命名」或保留原名按日期分目录,避免同名覆盖和中文路径编码问题。

对象存储策略配置#

如果 VPS 磁盘只有几十 GB,又想存大量视频,可以把大文件策略指向 S3 兼容对象存储(各家云厂商都有,接口基本一致)。新建策略选「对象存储」,填入 Bucket、Endpoint、AccessKey、SecretKey,并打开「获取文件直链」相关选项。跨域(CORS)需要在存储桶侧放行你的网盘域名,否则浏览器直传会失败。

一个实用的组合是:默认用户组走本地盘保证速度,给自己单独建一个「大文件」用户组走对象存储。Cloudreve 支持上传时按策略分流的程度有限,更稳妥的做法是按用户组区分,或者干脆全量走对象存储、本地盘只作缓存。到底怎么选,结论很简单:

VPS 磁盘 ≥ 200 GB 就全本地,简单可靠;磁盘小又要存大文件,就本地放小文件、对象存储放大文件。

缩略图与预览#

图片缩略图、视频封面会占用额外空间并吃 CPU。低配 VPS 可以在参数设置里调低缩略图质量,或者关闭视频封面生成。Office 文档预览依赖外部服务,自建场景下建议关掉在线编辑类功能,只保留图片、音视频和文本预览,稳定压倒一切。

离线下载与 WebDAV#

离线下载#

在管理面板的参数设置里启用 Aria2,RPC 地址填 http://aria2:6800/jsonrpc(同一 Compose 网络内用容器名互访),密钥与 Aria2 容器的 RPC_SECRET 一致。启用后在网盘界面新建离线下载任务,粘贴 HTTP 或磁力链接即可,下载完成的文件会出现在网盘里。磁力链接需要 Aria2 容器能访问公网 UDP/TCP,家宽或受限网络下成功率会打折,这是协议本身的限制,不是配置错误。

WebDAV#

Cloudreve 自带 WebDAV,在个人设置的「连接与应用」或管理面板中开启后,用网盘账号即可挂载:

地址:https://pan.example.com/dav
账号:你的网盘邮箱
密码:账号密码(或应用密码,视版本设置)

挂载到本地当网络驱动器用,配合 文件同步实战:Syncthing 点对点同步与备份 可以组成「网盘归档 + 设备同步」的组合:重要资料丢进网盘长期保存,工作文件用 Syncthing 在设备间实时同步,各司其职。

分享、直链与多用户#

  • 分享链接:可设密码、有效期和下载次数限制。给外人的链接一律设有效期,避免链接被转发后长期有效
  • 文件直链:适合给图片、文档生成可直接访问的 URL,当图床用也未尝不可,但流量走你自己的 VPS,注意带宽
  • 多用户:用户组可以分别限制容量、存储策略和功能权限。给家人朋友开账号时单独建组、限好容量,免得一个人把盘塞满

如果网盘要挂在公网长期开放注册,务必关闭自由注册或开启邮箱验证,自建服务的安全总原则在 自建服务安全加固:最小暴露与访问控制 里有系统讲法,这里只强调一点:网盘类应用一旦被陌生人注册利用,存违规文件、跑流量的锅全在服务器所有者身上。

备份:网盘的命门#

网盘里存的是文件本体,丢了没有任何服务商帮你找回。备份至少要覆盖三部分:

内容位置备份方式
数据库与配置./data打包 + 异地保存
本地文件本体./uploads、./avatarrsync 增量同步
Compose 与说明/opt/cloudreve随配置一起打包

用对象存储策略的文件不在本地,备份压力小很多,但要注意对象存储侧也要开启版本控制或跨区复制,别把鸡蛋换个篮子继续只放一处。完整的备份节奏和迁移方法在 自建服务备份与迁移实战 里统一讲,Cloudreve 按那套流程走即可:

Terminal window
# 每日增量同步文件本体到备份机
rsync -az --delete /opt/cloudreve/uploads/ backup@备份机:/backup/cloudreve/uploads/
# 每周打包一次配置与数据库
tar czf /backup/cloudreve-data-$(date +%F).tar.gz -C /opt/cloudreve data

常见问题与排障#

上传大文件失败或超时 多半卡在反向代理的请求体大小限制。NPM 里对应站点的 Advanced 配置加上 client_max_body_size 0; 并调大超时;同时检查 Cloudreve 用户组里的单文件大小上限。

分享链接打开是内网地址 站点地址没改。管理面板参数设置里的站点 URL 必须是外网域名,改完后旧链接需要重新生成。

离线下载一直等待 按顺序查:Aria2 容器是否运行、RPC 密钥两边是否一致、Cloudreve 里填的 RPC 地址是否可达。docker logs aria2 里能看到连接记录;磁力任务长时间没速度则多半是资源本身没做种者,换直链或种子文件。

图片没有缩略图 检查 data 目录权限和缩略图生成开关;容器重建后第一次打开目录会现生成,稍等即可。若日志报内存不足,调低缩略图尺寸。

升级后打不开 先看日志确认是否在做数据库迁移,老版本跨度太大时不要一步升到最新,中间隔一个大版本逐级升;升级前务必先备份 data 目录,数据库迁移失败又没备份,是自建网盘最惨烈的事故,没有之一。

小结#

Cloudreve 的部署只是十分钟的事,真正要花心思的是存储策略和备份:本地盘胜在速度和简单,对象存储胜在容量,两者按文件大小分工是最稳妥的组合;Aria2 和数据库备份是两个最容易被忽略、又最容易出大事的点,按上文收好。搭完这一篇,你的自建服务里就有了「家」——后面 Alist 聚合外部网盘、影音类服务找本地文件,都会和这个网盘打交道。

Cloudreve:私人云盘部署与存储策略
https://www.anexns.cloudns.org/posts/selfhost-cloudreve/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0