把应用上传目录移到数据盘:保留原路径并防止写回系统盘
适用范围与迁移目标
本文面向Ubuntu 24.04,把一个应用的普通上传文件从/srv/app-a/uploads迁到已挂载的数据盘/data/app-a-uploads,通过绑定挂载保留原访问路径。示例服务名为app-a,运行用户也为app-a,请全部替换为实际值。本方法不用于正在运行的数据库目录、Docker数据根目录或共享存储。
先做独立备份,并确认新盘容量、文件系统及所有权支持。新目录必须是专门用于本次迁移的空目录;若里面已有数据,停止并先理清来源。源目录不能本身是挂载点或符号链接。复制前还要检查目录内部是否有子挂载或链接到外部数据;存在时先单独规划,不能把这些关系当普通文件一起照搬。已有数据盘挂载可参考Linux已有数据盘挂载与fstab配置。
一、确认数据盘真的挂载
findmnt --mountpoint /data
findmnt --mountpoint /srv/app-a/uploads
df -h /data /srv/app-a/uploads
sudo du -sh /srv/app-a/uploads
sudo ls -ld /srv/app-a/uploads /data
sudo install -d -m 0750 /data/app-a-uploads
第一条必须显示预期的数据盘设备和文件系统;只看到/data目录存在不算挂载成功。第二条对本例普通源目录应没有独立挂载结果。确认磁盘可用空间还留有业务增长余量,再继续。没有rsync时先安装系统仓库的rsync包。
二、停止所有写入,再复制并比对
安排维护窗口,暂停该应用的上传入口、队列、定时任务等写入者,然后停止本项目服务。只停止app-a,不能把同机所有服务一起停掉。后台上传和已有请求应结束后再复制。
sudo systemctl stop app-a
sudo rsync -aHAX --numeric-ids --dry-run --itemize-changes \
/srv/app-a/uploads/ /data/app-a-uploads/
sudo rsync -aHAX --numeric-ids \
/srv/app-a/uploads/ /data/app-a-uploads/
sudo rsync -aHAX --numeric-ids --checksum --dry-run --itemize-changes \
/srv/app-a/uploads/ /data/app-a-uploads/
末尾斜线表示复制目录内的内容,包括隐藏文件。所有命令必须成功;最后一次比对应没有待变更项目。出现权限、扩展属性或文件消失错误时先处理,不能把报错的复制当成可用副本。本例不加--delete,避免误删目标中的未知文件。
三、切换原路径并配置启动依赖
确认所有写入仍停止,且下面的备份目录不存在,再保留原目录、建立空挂载点。旧目录的保留路径不得通过网站或下载接口公开;若项目根目录会被直接提供下载,改用网站根目录之外的受限备份路径。属主和权限应按刚才实际记录填写。
sudo mv /srv/app-a/uploads /srv/app-a/uploads.before-move
sudo install -d -o app-a -g app-a -m 0750 /srv/app-a/uploads
sudo mount --bind /data/app-a-uploads /srv/app-a/uploads
findmnt --mountpoint /srv/app-a/uploads
备份/etc/fstab后,只加入本次绑定挂载的记录。/data本身须已用正确UUID配置开机挂载。
/data/app-a-uploads /srv/app-a/uploads none bind,x-systemd.requires-mounts-for=/data 0 0
运行sudo systemctl edit app-a添加以下内容,确保服务启动需要相应挂载,并检查原路径确实是挂载点。
[Unit]
RequiresMountsFor=/data /srv/app-a/uploads
AssertPathIsMountPoint=/srv/app-a/uploads
再执行sudo systemctl daemon-reload。这些依赖只保护该systemd服务;独立cron、其他服务或人工脚本也必须在写入前检查挂载,不能漏掉。
四、验证并保留回退空间
启动app-a,使用应用自己的界面上传一个测试文件,确认原路径和/data对应目录都能看到同一文件,旧文件也能读取。检查日志、属主和磁盘用量。在维护窗口安排一次重启,复核两个挂载与服务状态后再恢复全部定时写入。
验收前保留uploads.before-move。需要回退时先停止所有写入,保存迁移后新增文件,撤销本次挂载配置并卸载绑定目录,再恢复原目录;恢复前处理新增数据,不能直接用旧目录覆盖。回退操作应逐路径核对,不使用递归删除来清空挂载点。
如果源目录内部还有其他挂载点或指向外部数据的符号链接,把这些目标单独登记。普通目录复制不等于连同所有外部数据一起迁移,切换后要逐项确认应用仍能读取。