如何在Docker Compose中自动获取可用端口以避免固定端口冲突

Docker原生就支持自动分配可用端口的能力，你可以通过修改docker-compose.yml中的ports配置实现，无需每次手动修改固定端口：

方法1：完全自动分配随机端口 #

直接删掉ports配置中的宿主机固定端口，仅保留容器端口即可，Docker会自动从宿主机默认可用端口段（32768~61000）中选择未被占用的端口完成映射。
修改后的配置示例：

version: "3.2"

services:
  apache_service:
    build:
      context: './docker/apache/'
    links:
      - mysql_service:mysql_service
    depends_on:
      - mysql_service
    ports:
      - "80" # 仅保留容器端口，自动分配宿主机端口
    volumes:
      - ./:/var/www/

  mysql_service:
    build:
      context    : ./
      dockerfile : ./docker/mysql/Dockerfile
    command: [
      '--character-set-server=utf8mb4',
      '--collation-server=utf8mb4_unicode_ci',
      '--default-authentication-plugin=mysql_native_password',
    ]
    restart:
      always
    volumes:
      - ./docker/initdb:/docker-entrypoint-initdb.d
      - ./docker/mysql/logs:/var/log/mysql
    ports:
      - "3306" # 仅保留容器端口，自动分配宿主机端口
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
    container_name:
      mysql_service

方法2：指定端口范围的随机分配 #

如果你希望分配的端口在你指定的区间内，可按如下格式配置：

ports:
  - "8000-8999:80" # apache服务会在8000~8999区间查找可用端口绑定
  - "4000-4999:3306" # mysql服务会在4000~4999区间查找可用端口绑定

方法3：兼容固定端口+自动分配的灵活配置 #

如果你需要部分场景下用固定端口、部分场景自动分配，可结合环境变量实现：
将ports配置修改为：

ports:
  - "${APACHE_PORT:-}:80"
  - "${MYSQL_PORT:-}:3306"

如果项目根目录的.env文件中定义了APACHE_PORT=8080、MYSQL_PORT=4306，就会使用配置的固定端口，未定义时自动分配随机端口。

查看分配的端口 #

执行docker-compose up -d启动后，可通过以下命令查看对应服务的实际绑定端口：

• 查看所有服务端口映射：docker-compose ps
• 查看单个服务的指定端口映射：docker-compose port <服务名> <容器端口>，例如查询apache的端口执行docker-compose port apache_service 80

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