如何将Docker Btrfs存储层目录映射到对应镜像？

你遇到的问题是btrfs存储驱动下，Docker子卷目录名称和镜像层的SHA-256 ID不直接对应，以下是具体解决方法：

方法一：遍历所有镜像的层元数据关联子卷 #

使用docker image inspect结合jq工具，遍历所有镜像的层信息，匹配目标子卷：

# 遍历所有镜像ID
for img_id in $(docker images -q); do
  echo "=== 检查镜像: $img_id ==="
  # 提取该镜像的所有层ID，以及对应的btrfs子卷路径
  docker image inspect "$img_id" | jq -r '
    .[0] as $img |
    $img.RootFS.Layers[] as $layer |
    ($img.GraphDriver.Data.LowerDir // "") + ":" + ($img.GraphDriver.Data.UpperDir // "") |
    split(":")[] |
    select(contains("d6f300048f2777bf140c46e8d0775ad6f6fab9e952914f77a528c3be07b80827")) |
    "\($layer) 对应子卷: \(.)"
  '
done

如果输出结果中出现匹配项，对应的sha256:xxxx就是该子卷的镜像层ID，同时会显示所属的镜像ID。

方法二：查看子卷元数据并关联Docker层 #

先通过btrfs命令查看目标子卷的详细信息：

btrfs subvolume show /var/lib/docker/btrfs/subvolumes/d6f300048f2777bf140c46e8d0775ad6f6fab9e952914f77a528c3be07b80827

然后遍历Docker的btrfs层元数据文件，查找包含目标子卷的记录：

# 遍历所有层元数据文件，查找匹配项
for layer_file in /var/lib/docker/btrfs/layers/*; do
  if grep -q "d6f300048f2777bf140c46e8d0775ad6f6fab9e952914f77a528c3be07b80827" "$layer_file"; then
    echo "层ID: $(basename "$layer_file")"
    echo "对应子卷路径: $layer_file"
  fi
done

方法三：通过容器关联（如果子卷属于运行中容器） #

如果该子卷属于某个运行中的容器，直接查看容器的存储驱动数据：

# 遍历所有运行中容器
for container_id in $(docker ps -q); do
  docker inspect "$container_id" | jq -r '
    .[0] as $container |
    $container.GraphDriver.Data.Subvolume // $container.GraphDriver.Data.UpperDir |
    select(contains("d6f300048f2777bf140c46e8d0775ad6f6fab9e952914f77a528c3be07b80827")) |
    "容器ID: \($container.Id)\n所属镜像: \($container.Image)\n对应层信息: \(.)"
  '
done

内容的提问来源于stack exchange，提问作者Tom