bpholt/fake-ec2-metadata-service

Fake EC2 Metadata Service

镜像概述和主要用途

Fake EC2 Metadata Service是一个简单的Sinatra应用，用于模拟AWS EC2元数据服务（运行在[***] EC2环境。

核心功能和特性

• 模拟EC2元数据服务的基础功能，提供元数据访问端点
• 支持常见元数据查询，如本地IP、主机名、IAM安全凭证等
• 轻量级Sinatra应用，部署简单，资源占用低
• 兼容Linux和Mac系统的本地开发环境

使用场景和适用范围

适用于以下场景：

• 开发依赖EC2元数据服务的应用程序，需要在本地环境测试
• 应用需获取实例元数据（如IP、主机名）或IAM安全凭证才能正常运行
• 本地开发环境（Linux或Mac）中模拟AWS EC2运行环境

使用方法和配置说明

Linux系统设置

1. 创建环回接口

以root权限执行以下命令，创建绑定到169.254.169.254的环回接口：

bash
ifconfig lo:0 169.254.169.254 netmask 255.255.255.255 up

2. 运行容器

使用docker-compose启动服务：

bash
docker-compose up

Mac系统设置

由于Docker for Mac不支持Linux的部分网络功能，需通过pf规则进行流量重定向。

1. 创建pf规则文件

在/etc/pf.anchors/目录下创建fake-ec2-metadata-service文件，内容如下：

Packets = "proto tcp from any to 169.254.169.254 port 80"
rdr pass log on lo0 $Packets -> 127.0.0.1 port 8169
pass out log route-to lo0 inet $Packets keep state

2. 配置pf.conf

编辑/etc/pf.conf文件，按以下方式添加规则：

• 在第一个rdr-anchor "com.apple/*"后添加：rdr-anchor "fake-ec2-metadata-service"
• 在第一个anchor "com.apple/*"后添加：anchor "fake-ec2-metadata-service"
• 在文件末尾添加：load anchor "fake-ec2-metadata-service" from "/etc/pf.anchors/fake-ec2-metadata-service"

完整的pf.conf示例：

scrub-anchor "com.apple/*"
nat-anchor "com.apple/*"
rdr-anchor "com.apple/*"
rdr-anchor "fake-ec2-metadata-service"
dummynet-anchor "com.apple/*"
anchor "com.apple/*"
anchor "fake-ec2-metadata-service"
load anchor "com.apple" from "/etc/pf.anchors/com.apple"
load anchor "fake-ec2-metadata-service" from "/etc/pf.anchors/fake-ec2-metadata-service"

3. 加载并启用pf规则

bash
sudo pfctl -F all -f /etc/pf.conf
sudo pfctl -E

4. 运行容器

bash
docker-compose up

示例请求

服务启动后，可通过以下命令测试元数据访问：

bash
curl [***]
curl [***]
curl [***]
curl [***]