跳到主要内容

Docker Compose(实验性功能)

  • **实验性功能:**CapRover 的 dashboard 可以导入部分 Docker Compose 配置,并创建由 CapRover 管理的应用。

  • 打开 Apps → Docker Compose,粘贴 YAML,检查生成的应用后再部署。

  • 部署后,逐一确认应用的 HTTP 端口、环境变量、持久化数据和对外开放的端口。

  • 当前解析器支持 image、environment、ports、volumes、depends_on、hostname、cap_add 和 command。

  • 其他 Compose 字段会被忽略。

  • 尤其需要注意:build、自定义 networks、secrets、configs、deploy、restart、container_name 等字段的行为不能直接按 docker compose 推断。

命名卷由生成的 CapRover 应用管理。如果需要 CapRover 暂不支持的 Compose 功能,可以单独运行 Compose,并仅在必要时将相关服务显式连接到 CapRover 的外部网络 captain-overlay-network。CapRover 不负责管理这些外部服务的应用生命周期或备份。详情见支持矩阵。

Docker Compose 支持矩阵​

CapRover 的 One-Click 模板支持 Docker Compose 服务配置的一个子集,不能完全替代 docker compose up。具体支持项由数据模型定义:

服务配置项支持的内容
image、command、hostname、cap_add镜像及部分容器参数。
volumes支持 source:target 字符串或包含 type(volume 或 bind)、source 和 target 的对象。短格式的 :ro 后缀会被忽略,长格式的 read_only: true 会被拒绝。
ports支持 HOST:CONTAINER, HOST:CONTAINER/tcp, HOST:CONTAINER/udp 字符串或包含 published、target、可选 protocol(tcp 或 udp)及可选 mode(ingress 或 host)的对象。省略协议时,CapRover 会同时发布 TCP 和 UDP 端口。
environment支持标量值映射或 KEY=value 字符串列表。没有值的键和 null 值会被忽略。
depends_on用于确定 One-Click 部署顺序的服务名数组。
caproverExtraCapRover 扩展配置,包括 dockerfileLines、containerHttpPort、notExposeAsWebApp 和 websocketSupport。
  • 部署逻辑根据这些配置创建 CapRover 应用,并将部分额外的 Compose 选项转换为 Docker service override。
  • 如需确认具体行为,请查看 OneClickAppDeploymentHelper.ts,并先在测试环境验证模板。
  • 模型中未定义的 Compose 字段不保证受支持。