compose ports 字段写法

端口映射的短语法与长语法：可为端口指定绑定 IP、协议与发布模式；与 docker run -p 的规则一致，写错则服务只在内网可达。

Docker 容器速查云更新于 2026-10-12

短语法	"8080:80" / "127.0.0.1:8080:80" / "53:53/udp"
长语法	target / published / protocol / host_ip
默认	监听 0.0.0.0

示例

services:
  web:
    image: nginx:1.27-alpine
    ports:
      - "8080:80"
      - "127.0.0.1:9000:9000"
      - target: 53
        published: "53"
        protocol: udp

短语法含冒号的值建议加引号，避免 YAML 把 8080:80 解析成六十进制数字（旧版 YAML 陷阱）。

易错点

端口冲突时 up 会在创建容器阶段失败，先看宿主哪个进程占用了端口
改了 ports 后只 restart 不生效，必须 up 触发容器重建

数据来源与参考

Docker 官方文档：Compose ports 参考（docs.docker.com/reference/compose-file/services）

继续搜索

常用关键词：3389 traceroute iptables 子网掩码 docker

‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌