Docker Compose如何基于单个环境变量增量设置前后端服务端口

Docker Compose 内置的变量插值仅支持简单的变量读取、默认值设置、缺失值报错等基础操作，不支持 Shell 算术扩展语法，因此你直接写$((PORT + 1))会被识别为非法格式，触发报错。

方案一：启动前通过 Shell 预计算端口 #

这是最简便无额外依赖的方案：

1. 首先修改你的docker-compose.yml配置，将前端端口改为读取第二个环境变量：

version: "3"
services:
  backend:
    ...
    ports:
      - "${PORT}:3000"
  frontend:
    ...
    ports:
      - "${FRONTEND_PORT}:4200"

2. 启动时先通过 Shell 计算好前端端口再启动 Compose：

# 直接一行命令启动，PORT=3000可替换为你需要的端口
export PORT=3000 && export FRONTEND_PORT=$((PORT + 1)) && docker-compose up -d

如果嫌每次输入麻烦，可以写个一键启动脚本start.sh：

#!/bin/bash
# 不传参数默认使用3000作为后端端口
PORT=${1:-3000}
export PORT
export FRONTEND_PORT=$((PORT + 1))
docker-compose up -d

给脚本加执行权限后，直接运行./start.sh 4000就会自动使用4000作为后端端口、4001作为前端端口启动。

方案二：通过envsubst动态生成Compose配置 #

如果你不想额外维护第二个环境变量，可以用系统自带的envsubst工具提前解析算术表达式，生成最终的 Compose 配置文件：

1. 先创建配置模板docker-compose.template.yml，内容和你原来的写法一致：

version: "3"
services:
  backend:
    ...
    ports:
      - "${PORT}:3000"
  frontend:
    ...
    ports:
      - "$((PORT + 1)):4200"

2. 启动时用envsubst处理模板生成正式配置，再启动 Compose：

PORT=3000 envsubst < docker-compose.template.yml > docker-compose.yml && docker-compose up -d

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