先说主线:为什么要自建网盘,又为什么选 Cloudreve
公共网盘的问题人人都遇到过:限速、和谐、会员年年涨价,更麻烦的是重要文件放在别人服务器上,心里总不踏实。把网盘建在自己的 VPS 上,空间、速度、规则全都自己说了算,这也是整个自建服务里最能立刻提升幸福感的一类应用。
同类产品里,Cloudreve 是国内开发者维护的开源网盘系统,特点很对自建用户的胃口:
- 界面是熟悉的网盘式操作:上传、下载、文件夹、在线预览、分享链接,和公共网盘几乎无缝衔接
- 支持多种存储后端:本地磁盘、S3 兼容对象存储、OneDrive 等,可以按文件类型分流
- 自带离线下载(通过 Aria2)、WebDAV、多用户与用户组、文件直链等功能
- 单容器部署,数据目录结构简单,迁移和备份都方便
这一篇的主线是:先用 Docker 把 Cloudreve 跑起来,再把存储策略想清楚——哪些文件放本地盘、哪些放对象存储、备份怎么做。部署本身只需要十分钟,存储策略才是决定这个网盘能用多久、用得安不安心的关键。
部署前建议先看 Nginx Proxy Manager:所有自建服务的统一入口,把反向代理和 HTTPS 证书准备好,网盘这种要传文件的服务尤其需要稳定的 HTTPS 入口。
部署前准备
| 项目 | 建议 | 说明 |
|---|---|---|
| 内存 | 1 GB 以上 | Cloudreve 本体很轻,吃资源的是转码预览和缩略图 |
| 磁盘 | 按需求规划 | 本地存储策略下,网盘容量等于 VPS 磁盘容量 |
| 域名 | 一个子域名,如 pan.example.com | 走 NPM 反代并签发证书 |
| 端口 | 5212(默认) | 只绑定本机,经反代对外 |
先建好目录结构,把数据、配置和上传文件分开放:
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"启动并查看初始管理员账号:
docker compose up -ddocker logs cloudreve | head -30首次启动时日志会打印随机生成的管理员邮箱和密码,形如:
[Info] Admin user name: admin@cloudreve.org[Info] Admin password: xxxxxxxx务必第一时间登录并修改管理员密码,并把初始密码从日志里记下来后改掉——这组随机密码会一直留在容器日志里,谁能看日志谁就能进你的网盘。改完密码后到「管理面板 → 参数设置」里把站点地址改成你的正式域名,后面生成的分享链接才会正确。
WARNINGAria2 的 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、./avatar | rsync 增量同步 |
| Compose 与说明 | /opt/cloudreve | 随配置一起打包 |
用对象存储策略的文件不在本地,备份压力小很多,但要注意对象存储侧也要开启版本控制或跨区复制,别把鸡蛋换个篮子继续只放一处。完整的备份节奏和迁移方法在 自建服务备份与迁移实战 里统一讲,Cloudreve 按那套流程走即可:
# 每日增量同步文件本体到备份机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 聚合外部网盘、影音类服务找本地文件,都会和这个网盘打交道。