如何在AWS CloudFormation的ECS任务定义中配置UDP与TCP端口映射

你的配置思路其实是对的——确实需要在PortMappings数组里分别添加TCP和UDP的条目，但可能有几个容易忽略的点导致配置没生效，我帮你梳理一下：

• 先确认环境兼容性：

  • 如果用Fargate启动类型，必须使用平台版本1.4.0及以上，更早的版本不支持同一个端口同时映射TCP和UDP协议。
  • 如果用EC2启动类型，要确保ECS容器代理的版本足够新（至少是1.29.0以上），旧版本可能无法正确处理双协议端口映射。

• 检查网络模式的配置细节：

  • 若使用awsvpc网络模式：HostPort可以直接和ContainerPort设为相同值（就像你写的那样），这种模式下AWS会自动处理双协议的端口转发，但要注意任务对应的安全组必须同时开放8500端口的TCP和UDP入站规则。
  • 若使用bridge网络模式：要确保EC2主机上的8500端口没有被其他进程占用，同时容器代理有足够权限创建双协议的端口转发规则。

• 正确的配置示例：
  你的配置本身没问题，这里再贴一遍标准写法方便参考：

  "PortMappings": [
    {
      "ContainerPort": 8500,
      "HostPort": 8500,
      "Protocol": "TCP"
    },
    {
      "ContainerPort": 8500,
      "HostPort": 8500,
      "Protocol": "UDP"
    }
  ]
  

• 排查问题的小技巧：

  • 查看ECS容器代理的日志（EC2实例上路径是/var/log/ecs/ecs-agent.log），里面会记录端口映射失败的具体原因，比如端口冲突、权限问题等。
  • 进入容器内部，用ss -tulpn命令确认你的服务确实在监听8500端口的TCP和UDP协议，避免是容器内服务本身没配置对。
  • 如果是Fargate任务，还要检查对应的NACL规则是否放行8500端口的TCP和UDP流量，安全组和NACL缺一不可。

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