Docker Compose与Kubernetes服务名称匹配问题及本地配置适配需求

我完全懂你的痛点——本地开发和K8s生产环境的服务命名规则不一致，还要反复修改Nginx配置，太折腾人了！这里有几个直接落地的解决方案，帮你让Docker Compose的服务命名和K8s完全对齐，不用再改路由配置：

Docker Compose默认会给服务生成带文件夹前缀的网络别名，但你可以手动指定和K8s环境完全一致的别名，而且要符合K8s的命名规范（只用小写字母、数字、连字符，禁用下划线）。

在你的docker-compose.yml里给每个服务添加networks.aliases配置：

version: '3.8'
services:
  # 比如K8s里的服务名叫user-service，这里就用相同的名字
  user-service:
    image: your-user-service-image
    networks:
      default:
        aliases:
          - user-service  # 直接用K8s中的服务名
  order-service:
    image: your-order-service-image
    networks:
      default:
        aliases:
          - order-service
  nginx-proxy:
    image: nginx:alpine
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
    networks:
      - default
networks:
  default:
    name: app-network  # 可选：自定义网络名，避免默认的文件夹前缀

这样Nginx配置里的上游服务地址（比如http://user-service）就可以直接复用K8s的版本，完全不用修改。

Docker Compose默认用当前文件夹名作为项目前缀（也就是你提到的purplecloud），你可以通过两种方式修改：

• 启动时指定项目名参数：

  docker-compose --project-name my-app up -d
  

• 或者设置环境变量永久生效：

  export COMPOSE_PROJECT_NAME=my-app
  docker-compose up -d
  

如果不想看到容器名末尾的_1后缀，单容器场景下可以直接指定container_name（多实例部署不要用，会导致容器名冲突）：

services:
  user-service:
    image: your-user-service-image
    container_name: user-service  # 直接定义容器名，无后缀

K8s不允许服务名包含下划线，那在Docker Compose里定义服务时就直接用符合K8s规范的命名（比如user-service而不是user_service），再结合上面的别名或项目名设置，就能让本地和生产环境的服务命名逻辑完全统一，从根源避免适配成本。

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