VS2019/2022 Docker-Compose项目{ServicePort}原理配置及绑定Nginx方法

一、{ServicePort}的工作机制 #

{ServicePort}是Visual Studio为Docker Compose项目预设的端口占位符变量，用于统一管理服务对外暴露的宿主机端口。VS启动Docker Compose项目时，会自动将编排文件里的${ServicePort}占位符替换为预设的实际端口值，同时自动处理本地端口冲突检测、调试端口关联等逻辑，不需要手动硬编码端口，支持多项目并行调试时的端口自动分配。

二、基础配置方法 #

配置只需要修改两处文件即可：

• 打开Docker Compose项目下Properties/launchSettings.json文件，找到Docker Compose配置节点，新增servicePort字段指定固定端口，示例如下：

{
  "profiles": {
    "Docker Compose": {
      "commandName": "DockerCompose",
      "servicePort": 8080, // 自定义对外暴露的端口
      "commandVersion": "1.0"
    }
  }
}

• 在docker-compose.yml或docker-compose.override.yml的端口映射配置中引用占位符，示例："${ServicePort}:80"，VS启动时会自动替换为你配置的实际端口。
  如果没有手动配置servicePort，VS会默认从5000端口开始自动分配可用端口

三、多服务与{ServicePort}的配对关联 #

同一个{ServicePort}只能绑定到一个服务的宿主机端口映射，其他内部服务不需要绑定该端口，直接通过Docker内部网络通信即可：

• 所有服务加入同一个自定义内部网桥网络，服务之间可以直接通过服务名互相访问，不需要走宿主机端口。
• 仅将{ServicePort}绑定到需要对外暴露的入口服务上，其他服务不需要配置ports字段，避免端口冲突。

四、仅对外暴露Nginx服务的配置方案 #

按以下步骤配置即可实现所有流量走Nginx入口，其他内部服务不对外暴露：

1. 按上述基础配置方法，在launchSettings.json中将servicePort设为你需要对外暴露的端口（比如80、8080）。
2. 编辑docker-compose.yml，仅给Nginx服务配置{ServicePort}端口映射，其他服务不配置宿主机端口映射，示例配置：

version: '3.4'

services:
  # 唯一对外暴露的Nginx入口服务
  nginx:
    image: nginx:alpine
    build:
      context: ./Nginx
      dockerfile: Dockerfile
    ports:
      - "${ServicePort}:80" # 将ServicePort绑定到Nginx的80端口
    networks:
      - app-network
    restart: always

  # 内部后端API服务，仅内网可访问
  backend:
    image: ${DOCKER_REGISTRY-}backend
    build:
      context: .
      dockerfile: Backend/Dockerfile
    networks:
      - app-network
    # 无ports配置，外部无法直接访问

  # 内部数据库服务，仅内网可访问
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: yourpassword
    volumes:
      - mysql-data:/var/lib/mysql
    networks:
      - app-network
    # 无ports配置，外部无法直接访问

volumes:
  mysql-data:

networks:
  app-network:
    driver: bridge

3. 配置Nginx的反向代理规则，将对应路径的请求转发到内部服务即可，比如/api路径的请求转发到http://backend:80，所有外部请求只能通过Nginx入口访问内部服务。

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