使用Docker Compose创建ZFS卷报错：找不到外部卷stagingc_postgres_16

为什么会出现这个错误？ #

错误里的stagingc_postgres_16是Docker Compose自动生成的卷名——Compose默认会给所有资源（卷、容器、网络）加上项目前缀，前缀默认是当前工作目录的名称（这里你的目录名应该是stagingc）。你手动创建的postgres_16和Compose要找的带前缀卷不是同一个，所以会报错。

而Compose没有自动创建这个带前缀卷的核心原因，是你修改的ZFS插件还没适配Compose的卷命名规则：你只适配了容器命名逻辑，但Compose生成的卷名是「项目前缀+卷名」的组合格式（比如stagingc_postgres_16），你的插件可能无法处理这种带前缀的卷名，导致创建失败，Compose进而误以为这是一个外部卷，找不到就抛出错误。

解决方案 #

方案1：强制Compose使用无前缀卷名

在docker-compose.yml的卷定义里添加name字段，指定卷的实际名称为你能正常创建的postgres_16，跳过Compose的前缀规则：

version: "3.9"

volumes:
  postgres_16:
    driver: zfs
    name: postgres_16  # 强制使用该名称，不添加项目前缀

services:
  postgres_16:
    image: postgres_develop
    container_name: postgres_16
    ports:
      - 5432:5432
    volumes:
      - "./configs/postgresql/postgresql.conf:/var/lib/postgresql/data/postgresql.conf"
      - "/etc/localtime:/etc/localtime"
      - "postgres_16:/var/lib/postgresql"

配置后，Compose会直接使用postgres_16卷，无需手动创建（如果没创建，Compose会调用插件自动生成该名称的卷，和你手动执行命令的效果一致）。

方案2：修复ZFS插件对带前缀卷名的支持

检查你修改的ZFS插件代码，确保它能处理包含下划线、多段式的卷名（比如stagingc_postgres_16）。Compose生成的卷名格式为[项目前缀]_[卷名]，插件需要能正确解析这种名称，并在ZFS文件系统上创建对应的数据集。

方案3：手动创建带前缀的卷（临时方案）

如果你不想修改配置或插件，可以手动创建Compose需要的带前缀卷：

docker volume create -d zfs stagingc_postgres_16

创建后Compose就能找到该卷，无需添加external: true。但这种方法需要每次更换项目目录都手动创建对应卷，不适合长期使用。

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