Docker 容器内文件↔本地双向复制备份

Docker 容器内文件复制（含容器内本地复制 +容器↔本地双向复制，贴合Label Studio场景）

Docker 中文件复制分两类核心场景：容器内部不同路径间的本地复制 （和Linux原生操作一致）、容器与本地服务器的双向跨环境复制 （核心命令docker cp，无需进入容器，运行中即可操作），以下是全场景可执行命令，均结合你的Label Studio容器+数据库文件做实操示例，直接复制可用。

一、场景1：容器内部复制文件/文件夹（Linux原生命令）

进入容器交互式终端后，文件复制和普通Linux系统完全一致，核心命令为 cp，无需额外学习，适配容器内所有文件操作。

核心命令格式

# 复制文件
cp [可选参数] 源文件路径 目标文件路径

# 复制文件夹（必须加 -r 递归参数）
cp -r [可选参数] 源文件夹路径 目标文件夹路径

常用可选参数

• -r：递归复制文件夹（复制目录必加，否则报错）；
• -p：保留文件的权限、修改时间、属主等属性（推荐，避免复制后权限异常）；
• -f：强制覆盖目标路径已存在的同名文件/文件夹（无需手动确认）。

贴合Label Studio的实操示例（容器内操作）

1. 先进入Label Studio容器（前提）：

   docker exec -it label-studio /bin/bash

2. 容器内复制数据库文件（示例）：

   # 复制数据库文件到容器内备份目录（创建备份，保留属性）
   mkdir -p /label-studio/backup && cp -p /label-studio/label_studio.sqlite3 /label-studio/backup/

3. 容器内复制标注文件夹（示例）：

   # 递归复制data标注目录到容器内tmp目录（保留所有子文件/子文件夹）
   cp -rp /label-studio/data /tmp/

4. 退出容器：exit（容器仍正常运行，复制的文件保留在容器内）。

二、场景2：容器 ↔ 本地服务器 双向复制（核心命令docker cp，推荐）

这是最常用的场景（如把容器内的数据库文件备份到本地、把本地的数据集导入容器），核心命令为 docker cp，无需进入容器 ，容器在运行中即可操作，跨环境复制无压力。

前置：获取Label Studio容器标识（名称/ID，二选一）

先执行命令获取容器名/ID（后续所有docker cp命令可用）：

docker ps | grep label-studio

输出示例：xxxxxxxxxxxx heartexlabs/label-studio:latest ... label-studio，记录容器名label-studio或 容器IDxxxxxxxxxxxx（前3-4位即可）。

2.1 容器 → 本地：把容器内的文件/文件夹复制到本地（高频：备份数据库）

核心命令格式

docker cp 容器名/ID:容器内文件/文件夹路径 本地服务器目标路径

贴合Label Studio的实操示例（直接复制）

# 示例1：把容器内核心数据库文件复制到本地mydata目录（备份数据库，最常用）
docker cp label-studio:/label-studio/label_studio.sqlite3 $(pwd)/mydata/

# 示例2：把容器内所有标注数据（data目录）递归复制到本地backup目录
docker cp -r label-studio:/label-studio/data $(pwd)/backup/

# 示例3：用容器ID复制（替换为你的实际容器ID）
# docker cp xxxxxxxx:/label-studio/label_studio.sqlite3 $(pwd)/mydata/

✅ 复制成功后，直接在本地对应路径查看即可，无任何额外操作。

2.2 本地 → 容器：把本地的文件/文件夹复制到容器内（高频：导入数据集）

核心命令格式

docker cp 本地服务器文件/文件夹路径 容器名/ID:容器内目标路径

贴合Label Studio的实操示例（直接复制）

# 示例1：把本地的标注数据集（如local_data目录）递归复制到容器内data目录
docker cp -r $(pwd)/local_data label-studio:/label-studio/data/

# 示例2：把本地的配置文件（如config.json）复制到容器内/label-studio目录
docker cp $(pwd)/config.json label-studio:/label-studio/

# 示例3：把本地的单个图片/CSV文件复制到容器内标注目录
docker cp $(pwd)/test.jpg label-studio:/label-studio/data/media/

✅ 复制成功后，进入容器即可在目标路径看到文件，Label Studio可直接识别容器内的导入文件。

三、docker cp 关键使用说明

1. 无需进入容器 ：直接在本地服务器终端执行，容器处于运行中/停止状态均可复制（运行中更常用）；
2. 文件夹复制必加-r ：和Linuxcp命令一致，复制目录时必须加-r递归参数，否则会报错；
3. 路径支持绝对/相对 ：$(pwd)表示本地当前终端目录 （推荐，无需写长绝对路径），也可直接写绝对路径（如/root/mydata/）；
4. 容器路径写法 ：容器内路径前必须加容器名/ID:（英文冒号），无空格，这是区分容器内/本地路径的关键；
5. 覆盖同名文件 ：docker cp会直接覆盖目标路径已存在的同名文件/文件夹，无需手动确认，若需避免覆盖，先检查目标路径。

四、Label Studio 高频复制场景汇总（直接复用）

# 1. 容器数据库 → 本地备份
docker cp label-studio:/label-studio/label_studio.sqlite3 $(pwd)/mydata/backup/

# 2. 容器标注数据 → 本地备份
docker cp -r label-studio:/label-studio/data $(pwd)/mydata/backup/

# 3. 本地CSV/图片数据集 → 容器标注目录
docker cp -r $(pwd)/my_dataset label-studio:/label-studio/data/

# 4. 本地备份的数据库 → 容器恢复（先停止容器，再复制，再启动）
docker stop label-studio && docker cp $(pwd)/backup/label_studio.sqlite3 label-studio:/label-studio/ && docker start label-studio

五、常见问题解决

1. 报错：No such container: path ：容器名/ID写错，重新执行docker ps | grep label-studio确认正确标识；
2. 报错：no such file or directory ：源路径/目标路径写错（如容器内无/test目录、本地无xxx.sqlite3文件），核对路径后重新执行；
3. 复制文件夹无内容 ：忘记加-r参数，重新执行并添加-r；
4. 本地复制后无权限 ：本地路径加sudo（如sudo docker cp ...），或给本地目录赋权chmod -R 777 本地路径。