如何在AWS Fargate Docker容器中获取公网IP并传入Node.js应用

核心原理 #

AWS Fargate会自动向运行中的容器注入任务元数据接口的访问地址，公网IP作为任务运行时的动态属性，存储在元数据中，应用启动后主动调用接口即可获取，不需要提前预置环境变量。

具体操作步骤 #

1. 前置环境检查 #

• 确保Fargate使用平台版本1.4.0及以上，该版本默认启用元数据端点v4，无需额外配置
• 确保任务定义中网络模式为awsvpc，且任务启动时开启了分配公网IP选项，只有公网可达的Fargate任务才会分配公网IP
• 任务关联的IAM策略不需要额外授权，元数据接口是容器内本地可访问的，不需要IAM权限验证

2. Node.js应用内实现IP获取逻辑 #

你可以在应用初始化阶段调用元数据接口，拿到公网IP后再初始化路由、重定向相关逻辑，示例代码如下：

// 可以使用Node.js内置的https模块，无需安装第三方依赖
const https = require('https');
const ECS_META_ENV = 'ECS_CONTAINER_METADATA_URI_V4';

async function getPublicIp() {
  // 本地开发环境没有元数据环境变量，直接返回本地调试地址
  if (!process.env[ECS_META_ENV]) return '127.0.0.1:3000';

  const metaUrl = `${process.env[ECS_META_ENV]}/task`;
  return new Promise((resolve, reject) => {
    https.get(metaUrl, (res) => {
      let rawData = '';
      res.on('data', (chunk) => rawData += chunk);
      res.on('end', () => {
        try {
          const taskMeta = JSON.parse(rawData);
          // 提取弹性网卡附件中的公网IP
          const eni = taskMeta.Attachments.find(att => att.Type === 'ElasticNetworkInterface');
          const publicIp = eni.Details.find(d => d.name === 'publicIPv4Address').value;
          // 可根据你的应用端口拼接完整访问地址，例如端口是80的话直接返回IP
          resolve(`${publicIp}`);
        } catch (e) {
          reject(e);
        }
      });
    }).on('error', (e) => reject(e));
  });
}

// 应用启动时先获取IP再启动服务
let APP_PUBLIC_URL;
async function bootstrap() {
  const publicIp = await getPublicIp();
  APP_PUBLIC_URL = `http://${publicIp}`;
  // 后续重定向逻辑直接使用APP_PUBLIC_URL拼接路径即可
  // 例如重定向到回调页：return res.redirect(`${APP_PUBLIC_URL}/oauth/callback`)
  
  // 启动Express/Koa等服务的逻辑写在这里
  console.log(`应用公网地址：${APP_PUBLIC_URL}`);
}
bootstrap();

官方参考资料 #

你可以在AWS官方文档中搜索以下主题获取更详细的说明：

• Amazon ECS 任务元数据端点v4
• AWS Fargate 平台版本功能说明
• Amazon ECS awsvpc网络模式配置指南

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