最近朋友圈里聊本地部署、自托管的人越来越多了。我也是从虚拟机一路折腾过来的今天这篇就是把“私人云盘”这件事从零到能用的全过程记录下来照着抄就能跑通。你不需要专门买设备旧电脑、迷你主机、树莓派都行也不需要懂多少Linux命令我踩过的坑提前帮你扫干净。这篇文章要做的就是把一份数据攥在自己手里解决商业网盘限速、担心隐私、多设备同步麻烦这几个最扎心的问题适合想给家里搭一个文件中心、又不愿意花冤枉钱的普通人。1. 部署之前先把“私人云盘”这四个字想明白1.1 它到底解决了什么问题很多人以为私人云盘就是“自己搭一个百度网盘”其实差别挺大的。商业网盘的核心是“托管”你把文件交给服务商换来的是随时随地的访问而私人云盘的核心是“拥有”文件存在你自己的硬盘上上传下载速度由你的网络和硬盘决定不会因为某个会员套餐到期就限速。我自己的场景就很典型家里两台电脑、一部手机、一台旧平板想把证件扫描件、电子发票、设备说明书、照片视频这类东西统一存起来。放微信里怕过期放U盘里怕丢放商业网盘里又觉得重要的东西不踏实。私人云盘把这些问题一次性解决了还能给家人开独立账号各存各的互不干扰。另外一个价值是“格式自由”。商业网盘有时会限制某些文件类型或者对压缩包做特殊处理私人云盘完全没有这些约束。你存什么、怎么组织目录全是自己说了算。对于做视频剪辑、写稿、摄影的人来说这点尤其重要。1.2 主流开源方案怎么选决定走私有化这条路之后第一个要过的坎就是选型。目前社区里讨论最多的三个是 Cloudreve、Nextcloud、Seafile我把它们的定位理一理。方案上手难度资源占用核心优势适合谁Cloudreve低低界面贴近普通网盘单容器部署支持多种对象存储个人、家庭、轻量团队Nextcloud中中高全套办公协作自带文档、日历、通讯录需要全套协作工具的小团队Seafile中中文件同步性能强块级同步省流量对同步效率要求高的团队我最终选的是 Cloudreve原因有三个。第一它是个单体应用Docker 一条命令就能跑起来没有数据库、缓存、队列这些额外的关联依赖对新手友好得多。第二它的界面逻辑和主流网盘几乎一致上传下载、新建文件夹、分享链接家人拿到手不需要培训。第三它的存储策略设计得很干净底层硬盘不够了可以平滑挂载对象存储不用推翻重来。如果你特别需要“文件实时同步”比如电脑上的工作文件夹想自动同步到服务器那 Nextcloud 客户端体验会更完整。但如果你只是需要一个“集中存放照片和文件的网盘”Cloudreve 绝对够用而且省心。提示选型这件事别贪多。先定核心需求再选方案。我自己见过太多人折腾一周装 Nextcloud最后只用来传照片白白浪费了时间和精力。2. 环境准备吃灰设备就能当服务器2.1 硬件配置怎么规划私人云盘对硬件要求很低别一上来就想着买服务器。初代树莓派跑不动 Nextcloud但是跑 Cloudreve 这种轻量应用完全没问题。硬件类型最低要求推荐配置适合场景吃灰旧笔记本双核CPU、2GB内存4GB内存、升级固态家庭主力兼顾下载机迷你主机N100/J4125级别8GB内存、大容量硬盘低功耗长期开机树莓派4B1GB内存2GB以上、USB硬盘极客玩具、轻量存储云服务器1核1G2核2G以上、独立数据盘有公网IP随时访问我自己的主力部署在一台旧笔记本上加了一根 4GB 内存条总共 8GB挂了两块硬盘一块跑系统一块专门放云盘数据。常年开着功耗和噪音都在可接受范围。硬盘选择上有两个方向数据量大选机械盘噪音和速度都一般但便宜追求体验选固态盘上传下载响应快但容量贵。折中方案是系统盘用固态数据盘用机械日常管理程序响应快文件存储空间足。2.2 操作系统和Docker安装系统建议用 Ubuntu Server LTS 或者 Debian这两个系统的资料最多遇到问题搜一下就有答案。桌面版也能用但 Server 版更干净不用浪费资源跑图形界面。装好系统之后第一件事就是装 Docker。新手直接用官方脚本最省心curl -fsSL https://get.docker.com | sh如果你那边网络拉取官方源比较慢也可以用系统自带源apt update apt install -y docker.io docker-compose-plugin装完检查一下版本docker --version docker compose version两个命令都有输出了说明环境就绪。如果只有 docker 没有 compose可以补装一个 compose 插件。现在的部署我都推荐用 compose 方式别再用裸docker run原因后面会讲到。把当前用户加进 docker 组省得每次敲sudo dockerusermod -aG docker $USER newgrp docker2.3 目录结构一次性规划好这一步最容易被跳过但是影响深远。很多人的数据惨案都源于目录规划混乱今天挂载这里明天挂载那里最后容器一升级数据找不到了。我建议先建一个统一的根目录mkdir -p /srv/cloudreve/backup后面 Cloudreve 的所有数据都挂载到/srv/cloudreve这个目录下backup 用来放备份压缩包。这样做的好处是以后不管容器怎么删、怎么重建只要/srv/cloudreve目录还在数据就安然无恙。备份也只需要打包这一个目录就够了不会漏东西。注意千万别把数据挂载到容器家目录也就是说/root、/home/user这类路径尽量避免。一旦系统重装这些目录可能被清掉放在/srv或/data下语义清晰、风险小。3. 拿得出手的核心实操用Docker Compose跑起Cloudreve3.1 编写docker-compose.yml进入工作目录创建配置文件mkdir -p /srv/cloudreve cd /srv/cloudreve然后创建docker-compose.ymlservices: cloudreve: image: cloudreve/cloudreve:latest container_name: cloudreve restart: unless-stopped ports: - 5212:5212 volumes: - /srv/cloudreve:/cloudreve environment: - TZAsia/Shanghai这里我故意把所有数据挂载到根目录/cloudreve而不是分别挂载子目录。Cloudreve 的配置文件、数据库、上传文件都在这个工作目录里一揽子挂载最简单也不容易出现“数据库持久化了上传目录忘了挂”这种半吊子状态。restart: unless-stopped这个参数必加。不加的话一旦宿主机重启容器不会自动起来。除非你手动停了容器否则只要 Docker 服务运行它就保持运行状态。提示如果你习惯用终端操作而不是编辑文件可以用nano docker-compose.yml或者vim docker-compose.yml打开编辑。粘完配置之后按 CtrlX 退出按 Y 保存回车确认。3.2 启动容器并完成初始化启动服务docker compose up -d第一次启动要拉取镜像耗时取决于网络。看到Started或者Running的状态就说明容器已经起来了。用下面的命令看实时日志docker logs -f cloudreve看到类似 “Startup complete” 的日志就放心了按 CtrlC 退出日志查看。然后打开浏览器访问http://你的服务器IP:5212。第一次访问会进入初始化界面让你创建管理员账号和密码。这一步没有默认密码也不会把密码打印到日志里完全由你自己设置相对安全。设置好账号密码后登录在右上角头像处进入管理面板。管理面板里能看到存储策略、用户管理、站点设置这些入口先不用动往下看。3.3 确认本地存储策略Cloudreve 初始化好后后台一般会自带一个本机存储策略。你只需要确认两件事存储路径指向的是容器内/cloudreve/uploads目录并且该策略被设为默认。因为我们已经把/srv/cloudreve挂载成了容器的/cloudreve所以容器内/cloudreve/uploads在上层对应宿主机就是/srv/cloudreve/uploads。以后你上传的所有文件都会真实地落在宿主机的这个目录里。从管理面板进入“存储策略”看到本机存储策略确认路径是uploads就行不用改任何东西。以后如果硬盘满了可以新增一条 S3/OSS 存储策略建新的存储目录或者迁移历史数据这是后话。3.4 日常操作命令速查部署只是开始后面还要经常和容器打交道。我常用的命令就这几条docker compose ps # 查看运行状态 docker compose logs -f --tail200 # 实时日志定位问题 docker restart cloudreve # 重启容器 docker compose down # 停止并删除容器数据还在 docker compose up -d # 重新启动 docker compose pull # 拉取新版本镜像只要不执行docker compose down -v数据卷就不会被删除所有文件安全。-v参数会把匿名卷也删掉新手阶段建议永远不要加这个参数。4. 部署完别急着用先把这三件事做了4.1 安全配置把后门关好Cloudreve 默认允许用户注册如果你部署在公网上不管初始页面再好看第一件事就是把开放注册关掉。管理面板里有“站点设置”相关入口找到“允许注册”的开关关掉。这样除了你手工创建的用户之外任何人都注册不了账号。家人要用也是你在后台添加账号设置独立密码各自的空间互不干扰。再设置一个强密码。别用生日、“123456”这种基础口令管理员账号一旦被攻破等于把整个硬盘交了出去。密码至少 12 位混合字母数字和符号。如果防火墙开着注意放行端口。Ubuntu 上默认 ufw 如果启用了ufw allow 5212/tcp ufw status只暴露需要用到的端口其他不必要的端口不要开放。4.2 域名访问与HTTPS配置这一步不是必须的但如果想在公网访问我强烈建议做不然数据裸奔在公网上。先说架构思路Cloudreve 容器监听本机 5212 端口前置一层反向代理负责 HTTPS 证书和域名转发。Caddy 是目前配置最简单、能自动申请证书的方案对新手极为友好。本机装好 Caddy 后写一个Caddyfilecloud.example.com { reverse_proxy 127.0.0.1:5212 }把cloud.example.com换成你自己的域名。只要域名 DNS 解析到了这台服务器的公网 IPCaddy 启动后会自动申请并续期证书整个人类互联网的最佳实践就这样被一行配置搞定了。如果是家庭宽带场景没有固定公网 IP常规做法是在路由器上做端口映射把公网端口转发到内网服务器的 5212 端口同时用动态域名解析服务DDNS绑定域名。这个过程各个路由器品牌界面不同思路都一样找“端口映射”或“虚拟服务器”填内网 IP 和端口提交。4.3 定时备份数据安全最后的防线配置再多安全项都防不住硬盘突然挂掉备份才是真正让你睡得着觉的东西。我写了一个足够简单的备份脚本放在/srv/cloudreve/backup_backup.sh#!/bin/bash BACKUP_DIR/srv/cloudreve/backup SOURCE_DIR/srv/cloudreve STAMP$(date %Y%m%d%H%M) tar czf $BACKUP_DIR/cloudreve-$STAMP.tar.gz -C $SOURCE_DIR . find $BACKUP_DIR -name cloudreve-*.tar.gz -mtime 7 -delete脚本的逻辑是把整个/srv/cloudreve目录连同上传文件和数据库一起打成压缩包文件名带时间戳只保留最近 7 天的备份。给脚本执行权限然后加进 crontabchmod x /srv/cloudreve/backup.sh crontab -e加入一行0 2 * * * /srv/cloudreve/backup.sh每天凌晨两点自动打包。这里建议你再做一个动作把 backup 目录同步到另一块硬盘或者至少定期拷贝到移动硬盘。备份如果和源数据在同一块盘硬盘整体损坏时备份也没了那就失去了意义。注意恢复备份的操作是解压 tar 包到干净目录调整目录权限然后重新docker compose up -d。建议部署完就做一次恢复演练确认备份可用再放心使用这个习惯能救命。5. 实战避坑记录部署和使用中遇到的常见问题5.1 访问不了服务首先查这两件事这是出现频率最高的问题“我明明启动了容器为什么浏览器打不开”先确认容器状态docker compose ps如果 Status 显示 Exited 或 Restarting用日志看具体原因docker logs --tail 50 cloudreve最常见的原因是端口被占用。5212 不是常见端口但难免有特殊情况。改端口的话把docker-compose.yml里的端口映射改成5213:5212然后docker compose up -d重新创建容器。如果容器状态是 Up那就是防火墙问题。按 4.1 节执行ufw allow 5212/tcp再从外部用telnet IP 5212测试连通性。5.2 上传大文件失败或者进度条卡住Cloudreve 默认配置可能对单文件大小有上限加上如果你前置了 Nginx 或 Caddy反向代理默认也会限制请求体大小。两边都要改。Cloudreve 后台的上传设置里可以调大单文件限制我调到 5GB 或 10GB 都行取决于你实际使用场景。Nginx 来说要加一条client_max_body_size 10g;Caddy 一般不需要显式配置但如果遇到过不了的情况可以在站点块里加request_body { max_size 10GB }还有一个被忽略的因素上传大文件时浏览器会占用不少内存。如果服务器只有 2GB 内存最大支持的单文件大小也别设得太夸张否则传一半内存吃紧整个容器都可能被系统杀掉。5.3 容器重启后数据还在吗这是对“容器”概念最容易产生的误解。容器本身是“用完即弃”的但数据卷是独立于容器生命周期之外的。你用docker compose down停掉服务只要不删挂载目录所有数据从头到尾都在原地。所以习惯上我会告诉你改配置、升级版本时随便重建容器只要/srv/cloudreve目录没有动数据就不会丢。这点恰恰是 Docker 部署相比直接装二进制包最大的优势——升级、回滚、迁移都极其干净。5.4 换机器迁移比想象中简单从旧机器迁到新机器步骤就是新机器装好 Docker建立同样的/srv/cloudreve目录把旧机器整个目录打包拷过去解压到新目录再执行docker compose up -d因为镜像版本和挂载路径一致容器起来之后数据和配置原封不动。不需要重新初始化不需要导出数据库这就是一开始“目录规划统一”带来的红利。我建议你在迁完之后确认一下目录属主。如果解压后文件的属主对不上容器内运行用户可能会权限报错最简单处理chown -R 1000:1000 /srv/cloudreve多数场景下这个用户 ID 是安全的具体以你实际环境为准。5.5 升级镜像的稳妥姿势镜像升级本身很简单docker compose pull docker compose up -d但升级有风险新版可能改动配置文件格式或数据库结构。我自己的习惯是升级前先手动跑一次备份脚本确认备份文件生成再执行升级。升级后如果一切正常备份就留着如果出现问题一条命令回滚到旧镜像docker compose down # 把 image 改成旧版本号再 up -d这个习惯看起来多余但在某次 Cloudreve 大版本升级时真的帮我省了一晚上找数据的功夫。写在最后这台私人云盘我已经跑了很久最直观的感受是那些“一时想不起来用”的证件扫描件、电子发票、说明书随手扔进去后真的再也不怕找不到了。折腾部署的过程本身也很有意思你会慢慢理解端口、数据卷、备份这些概念以后再玩 Nextcloud、GitLab 或者其他自托管服务思路都是一样的。最后分享一个小技巧部署完成之后先别急着大量存文件建一个“测试上传”文件夹手机传一批照片、电脑传几个大文件确认上传速度、分享链接、下载功能都正常再决定正式搬家。稳定运行的私人云盘不是配出来的是用出来的遇到问题再慢慢调这个过程本身就是最大的收获。
零门槛搭建私人云盘：Docker 部署 Cloudreve 完整教程
最近朋友圈里聊本地部署、自托管的人越来越多了。我也是从虚拟机一路折腾过来的今天这篇就是把“私人云盘”这件事从零到能用的全过程记录下来照着抄就能跑通。你不需要专门买设备旧电脑、迷你主机、树莓派都行也不需要懂多少Linux命令我踩过的坑提前帮你扫干净。这篇文章要做的就是把一份数据攥在自己手里解决商业网盘限速、担心隐私、多设备同步麻烦这几个最扎心的问题适合想给家里搭一个文件中心、又不愿意花冤枉钱的普通人。1. 部署之前先把“私人云盘”这四个字想明白1.1 它到底解决了什么问题很多人以为私人云盘就是“自己搭一个百度网盘”其实差别挺大的。商业网盘的核心是“托管”你把文件交给服务商换来的是随时随地的访问而私人云盘的核心是“拥有”文件存在你自己的硬盘上上传下载速度由你的网络和硬盘决定不会因为某个会员套餐到期就限速。我自己的场景就很典型家里两台电脑、一部手机、一台旧平板想把证件扫描件、电子发票、设备说明书、照片视频这类东西统一存起来。放微信里怕过期放U盘里怕丢放商业网盘里又觉得重要的东西不踏实。私人云盘把这些问题一次性解决了还能给家人开独立账号各存各的互不干扰。另外一个价值是“格式自由”。商业网盘有时会限制某些文件类型或者对压缩包做特殊处理私人云盘完全没有这些约束。你存什么、怎么组织目录全是自己说了算。对于做视频剪辑、写稿、摄影的人来说这点尤其重要。1.2 主流开源方案怎么选决定走私有化这条路之后第一个要过的坎就是选型。目前社区里讨论最多的三个是 Cloudreve、Nextcloud、Seafile我把它们的定位理一理。方案上手难度资源占用核心优势适合谁Cloudreve低低界面贴近普通网盘单容器部署支持多种对象存储个人、家庭、轻量团队Nextcloud中中高全套办公协作自带文档、日历、通讯录需要全套协作工具的小团队Seafile中中文件同步性能强块级同步省流量对同步效率要求高的团队我最终选的是 Cloudreve原因有三个。第一它是个单体应用Docker 一条命令就能跑起来没有数据库、缓存、队列这些额外的关联依赖对新手友好得多。第二它的界面逻辑和主流网盘几乎一致上传下载、新建文件夹、分享链接家人拿到手不需要培训。第三它的存储策略设计得很干净底层硬盘不够了可以平滑挂载对象存储不用推翻重来。如果你特别需要“文件实时同步”比如电脑上的工作文件夹想自动同步到服务器那 Nextcloud 客户端体验会更完整。但如果你只是需要一个“集中存放照片和文件的网盘”Cloudreve 绝对够用而且省心。提示选型这件事别贪多。先定核心需求再选方案。我自己见过太多人折腾一周装 Nextcloud最后只用来传照片白白浪费了时间和精力。2. 环境准备吃灰设备就能当服务器2.1 硬件配置怎么规划私人云盘对硬件要求很低别一上来就想着买服务器。初代树莓派跑不动 Nextcloud但是跑 Cloudreve 这种轻量应用完全没问题。硬件类型最低要求推荐配置适合场景吃灰旧笔记本双核CPU、2GB内存4GB内存、升级固态家庭主力兼顾下载机迷你主机N100/J4125级别8GB内存、大容量硬盘低功耗长期开机树莓派4B1GB内存2GB以上、USB硬盘极客玩具、轻量存储云服务器1核1G2核2G以上、独立数据盘有公网IP随时访问我自己的主力部署在一台旧笔记本上加了一根 4GB 内存条总共 8GB挂了两块硬盘一块跑系统一块专门放云盘数据。常年开着功耗和噪音都在可接受范围。硬盘选择上有两个方向数据量大选机械盘噪音和速度都一般但便宜追求体验选固态盘上传下载响应快但容量贵。折中方案是系统盘用固态数据盘用机械日常管理程序响应快文件存储空间足。2.2 操作系统和Docker安装系统建议用 Ubuntu Server LTS 或者 Debian这两个系统的资料最多遇到问题搜一下就有答案。桌面版也能用但 Server 版更干净不用浪费资源跑图形界面。装好系统之后第一件事就是装 Docker。新手直接用官方脚本最省心curl -fsSL https://get.docker.com | sh如果你那边网络拉取官方源比较慢也可以用系统自带源apt update apt install -y docker.io docker-compose-plugin装完检查一下版本docker --version docker compose version两个命令都有输出了说明环境就绪。如果只有 docker 没有 compose可以补装一个 compose 插件。现在的部署我都推荐用 compose 方式别再用裸docker run原因后面会讲到。把当前用户加进 docker 组省得每次敲sudo dockerusermod -aG docker $USER newgrp docker2.3 目录结构一次性规划好这一步最容易被跳过但是影响深远。很多人的数据惨案都源于目录规划混乱今天挂载这里明天挂载那里最后容器一升级数据找不到了。我建议先建一个统一的根目录mkdir -p /srv/cloudreve/backup后面 Cloudreve 的所有数据都挂载到/srv/cloudreve这个目录下backup 用来放备份压缩包。这样做的好处是以后不管容器怎么删、怎么重建只要/srv/cloudreve目录还在数据就安然无恙。备份也只需要打包这一个目录就够了不会漏东西。注意千万别把数据挂载到容器家目录也就是说/root、/home/user这类路径尽量避免。一旦系统重装这些目录可能被清掉放在/srv或/data下语义清晰、风险小。3. 拿得出手的核心实操用Docker Compose跑起Cloudreve3.1 编写docker-compose.yml进入工作目录创建配置文件mkdir -p /srv/cloudreve cd /srv/cloudreve然后创建docker-compose.ymlservices: cloudreve: image: cloudreve/cloudreve:latest container_name: cloudreve restart: unless-stopped ports: - 5212:5212 volumes: - /srv/cloudreve:/cloudreve environment: - TZAsia/Shanghai这里我故意把所有数据挂载到根目录/cloudreve而不是分别挂载子目录。Cloudreve 的配置文件、数据库、上传文件都在这个工作目录里一揽子挂载最简单也不容易出现“数据库持久化了上传目录忘了挂”这种半吊子状态。restart: unless-stopped这个参数必加。不加的话一旦宿主机重启容器不会自动起来。除非你手动停了容器否则只要 Docker 服务运行它就保持运行状态。提示如果你习惯用终端操作而不是编辑文件可以用nano docker-compose.yml或者vim docker-compose.yml打开编辑。粘完配置之后按 CtrlX 退出按 Y 保存回车确认。3.2 启动容器并完成初始化启动服务docker compose up -d第一次启动要拉取镜像耗时取决于网络。看到Started或者Running的状态就说明容器已经起来了。用下面的命令看实时日志docker logs -f cloudreve看到类似 “Startup complete” 的日志就放心了按 CtrlC 退出日志查看。然后打开浏览器访问http://你的服务器IP:5212。第一次访问会进入初始化界面让你创建管理员账号和密码。这一步没有默认密码也不会把密码打印到日志里完全由你自己设置相对安全。设置好账号密码后登录在右上角头像处进入管理面板。管理面板里能看到存储策略、用户管理、站点设置这些入口先不用动往下看。3.3 确认本地存储策略Cloudreve 初始化好后后台一般会自带一个本机存储策略。你只需要确认两件事存储路径指向的是容器内/cloudreve/uploads目录并且该策略被设为默认。因为我们已经把/srv/cloudreve挂载成了容器的/cloudreve所以容器内/cloudreve/uploads在上层对应宿主机就是/srv/cloudreve/uploads。以后你上传的所有文件都会真实地落在宿主机的这个目录里。从管理面板进入“存储策略”看到本机存储策略确认路径是uploads就行不用改任何东西。以后如果硬盘满了可以新增一条 S3/OSS 存储策略建新的存储目录或者迁移历史数据这是后话。3.4 日常操作命令速查部署只是开始后面还要经常和容器打交道。我常用的命令就这几条docker compose ps # 查看运行状态 docker compose logs -f --tail200 # 实时日志定位问题 docker restart cloudreve # 重启容器 docker compose down # 停止并删除容器数据还在 docker compose up -d # 重新启动 docker compose pull # 拉取新版本镜像只要不执行docker compose down -v数据卷就不会被删除所有文件安全。-v参数会把匿名卷也删掉新手阶段建议永远不要加这个参数。4. 部署完别急着用先把这三件事做了4.1 安全配置把后门关好Cloudreve 默认允许用户注册如果你部署在公网上不管初始页面再好看第一件事就是把开放注册关掉。管理面板里有“站点设置”相关入口找到“允许注册”的开关关掉。这样除了你手工创建的用户之外任何人都注册不了账号。家人要用也是你在后台添加账号设置独立密码各自的空间互不干扰。再设置一个强密码。别用生日、“123456”这种基础口令管理员账号一旦被攻破等于把整个硬盘交了出去。密码至少 12 位混合字母数字和符号。如果防火墙开着注意放行端口。Ubuntu 上默认 ufw 如果启用了ufw allow 5212/tcp ufw status只暴露需要用到的端口其他不必要的端口不要开放。4.2 域名访问与HTTPS配置这一步不是必须的但如果想在公网访问我强烈建议做不然数据裸奔在公网上。先说架构思路Cloudreve 容器监听本机 5212 端口前置一层反向代理负责 HTTPS 证书和域名转发。Caddy 是目前配置最简单、能自动申请证书的方案对新手极为友好。本机装好 Caddy 后写一个Caddyfilecloud.example.com { reverse_proxy 127.0.0.1:5212 }把cloud.example.com换成你自己的域名。只要域名 DNS 解析到了这台服务器的公网 IPCaddy 启动后会自动申请并续期证书整个人类互联网的最佳实践就这样被一行配置搞定了。如果是家庭宽带场景没有固定公网 IP常规做法是在路由器上做端口映射把公网端口转发到内网服务器的 5212 端口同时用动态域名解析服务DDNS绑定域名。这个过程各个路由器品牌界面不同思路都一样找“端口映射”或“虚拟服务器”填内网 IP 和端口提交。4.3 定时备份数据安全最后的防线配置再多安全项都防不住硬盘突然挂掉备份才是真正让你睡得着觉的东西。我写了一个足够简单的备份脚本放在/srv/cloudreve/backup_backup.sh#!/bin/bash BACKUP_DIR/srv/cloudreve/backup SOURCE_DIR/srv/cloudreve STAMP$(date %Y%m%d%H%M) tar czf $BACKUP_DIR/cloudreve-$STAMP.tar.gz -C $SOURCE_DIR . find $BACKUP_DIR -name cloudreve-*.tar.gz -mtime 7 -delete脚本的逻辑是把整个/srv/cloudreve目录连同上传文件和数据库一起打成压缩包文件名带时间戳只保留最近 7 天的备份。给脚本执行权限然后加进 crontabchmod x /srv/cloudreve/backup.sh crontab -e加入一行0 2 * * * /srv/cloudreve/backup.sh每天凌晨两点自动打包。这里建议你再做一个动作把 backup 目录同步到另一块硬盘或者至少定期拷贝到移动硬盘。备份如果和源数据在同一块盘硬盘整体损坏时备份也没了那就失去了意义。注意恢复备份的操作是解压 tar 包到干净目录调整目录权限然后重新docker compose up -d。建议部署完就做一次恢复演练确认备份可用再放心使用这个习惯能救命。5. 实战避坑记录部署和使用中遇到的常见问题5.1 访问不了服务首先查这两件事这是出现频率最高的问题“我明明启动了容器为什么浏览器打不开”先确认容器状态docker compose ps如果 Status 显示 Exited 或 Restarting用日志看具体原因docker logs --tail 50 cloudreve最常见的原因是端口被占用。5212 不是常见端口但难免有特殊情况。改端口的话把docker-compose.yml里的端口映射改成5213:5212然后docker compose up -d重新创建容器。如果容器状态是 Up那就是防火墙问题。按 4.1 节执行ufw allow 5212/tcp再从外部用telnet IP 5212测试连通性。5.2 上传大文件失败或者进度条卡住Cloudreve 默认配置可能对单文件大小有上限加上如果你前置了 Nginx 或 Caddy反向代理默认也会限制请求体大小。两边都要改。Cloudreve 后台的上传设置里可以调大单文件限制我调到 5GB 或 10GB 都行取决于你实际使用场景。Nginx 来说要加一条client_max_body_size 10g;Caddy 一般不需要显式配置但如果遇到过不了的情况可以在站点块里加request_body { max_size 10GB }还有一个被忽略的因素上传大文件时浏览器会占用不少内存。如果服务器只有 2GB 内存最大支持的单文件大小也别设得太夸张否则传一半内存吃紧整个容器都可能被系统杀掉。5.3 容器重启后数据还在吗这是对“容器”概念最容易产生的误解。容器本身是“用完即弃”的但数据卷是独立于容器生命周期之外的。你用docker compose down停掉服务只要不删挂载目录所有数据从头到尾都在原地。所以习惯上我会告诉你改配置、升级版本时随便重建容器只要/srv/cloudreve目录没有动数据就不会丢。这点恰恰是 Docker 部署相比直接装二进制包最大的优势——升级、回滚、迁移都极其干净。5.4 换机器迁移比想象中简单从旧机器迁到新机器步骤就是新机器装好 Docker建立同样的/srv/cloudreve目录把旧机器整个目录打包拷过去解压到新目录再执行docker compose up -d因为镜像版本和挂载路径一致容器起来之后数据和配置原封不动。不需要重新初始化不需要导出数据库这就是一开始“目录规划统一”带来的红利。我建议你在迁完之后确认一下目录属主。如果解压后文件的属主对不上容器内运行用户可能会权限报错最简单处理chown -R 1000:1000 /srv/cloudreve多数场景下这个用户 ID 是安全的具体以你实际环境为准。5.5 升级镜像的稳妥姿势镜像升级本身很简单docker compose pull docker compose up -d但升级有风险新版可能改动配置文件格式或数据库结构。我自己的习惯是升级前先手动跑一次备份脚本确认备份文件生成再执行升级。升级后如果一切正常备份就留着如果出现问题一条命令回滚到旧镜像docker compose down # 把 image 改成旧版本号再 up -d这个习惯看起来多余但在某次 Cloudreve 大版本升级时真的帮我省了一晚上找数据的功夫。写在最后这台私人云盘我已经跑了很久最直观的感受是那些“一时想不起来用”的证件扫描件、电子发票、说明书随手扔进去后真的再也不怕找不到了。折腾部署的过程本身也很有意思你会慢慢理解端口、数据卷、备份这些概念以后再玩 Nextcloud、GitLab 或者其他自托管服务思路都是一样的。最后分享一个小技巧部署完成之后先别急着大量存文件建一个“测试上传”文件夹手机传一批照片、电脑传几个大文件确认上传速度、分享链接、下载功能都正常再决定正式搬家。稳定运行的私人云盘不是配出来的是用出来的遇到问题再慢慢调这个过程本身就是最大的收获。
