Docker卷同步时如何保留容器/app目录预置内容？

AI 小北

2026-7-2

解决Docker主机卷与容器/app目录同步且保留预置内容的方法

问题核心

你遇到的问题是挂载初始为空的命名卷后，容器内/app的预置内容被意外删除，本质是当前rsync命令的逻辑未满足「仅同步卷内新增/修改文件、保留容器原有内容」的需求。

解决方案

1. 修正`rsync`同步命令

修改startup.sh中的同步逻辑，确保只新增或更新卷内文件到/app，不删除容器原有内容：

#!/bin/bash

# 同步host_volume内的文件到/app：仅新增目标不存在的文件，或更新比目标新的文件
rsync -a --update /host_volume/ /app/

# 保持容器运行
tail -f /dev/null

--update：仅当源文件修改时间晚于目标文件，或目标文件不存在时才同步，避免覆盖未修改的预置内容
若需强制覆盖同名文件（忽略修改时间），去掉--update即可，默认-a参数不会删除目标中不存在于源的文件

2. 验证卷挂载逻辑

你的容器运行命令逻辑正确，命名卷挂载到/host_volume不会直接影响/app的预置内容：

docker run -it --name llm_container -e OPENAI_API_KEY=%OPENAI_API_KEY% -v llm_volume:/host_volume llm_img

首次启动空命名卷时，rsync不会对/app执行删除操作，预置内容会完整保留。

3. 可选：首次启动初始化卷内容

如果希望首次启动时将容器/app的预置内容同步到卷中，后续基于卷内容同步，可以修改startup.sh：

#!/bin/bash

# 检测卷是否为空，为空则先同步/app预置内容到卷
if [ -z "$(ls -A /host_volume)" ]; then
  rsync -a /app/ /host_volume/
fi

# 同步卷内文件到/app，仅更新或新增
rsync -a --update /host_volume/ /app/

tail -f /dev/null

此逻辑会在首次启动时完成卷的初始化，后续启动仅同步卷的修改到容器。