AWS Emulator:AWS 官方的本地 AWS API 模拟器
AWS 11 月 11 日开源的本地 AWS API 模拟器:Rust 单进程跑在 127.0.0.1:9297,436 个服务 crate,CC0-1.0。
项目资料
GitHub Ecosystem- 许可证
- CC0-1.0
- 主语言
- Rust
- 星标
- 8,855
- 核查时间
- 2026-11-17
以上快照资料以核查当日为准,可能随版本或运营策略变化。
本地开发要连 AWS,过去只有两条路:拿真实账号跑集成测试,或者装一个第三方模拟器。AWS 在 2026-11-11 给出了第三条:AWS Emulator,一个跑在本机、只提供 AWS API 的模拟器。它用 Rust 写成,启动后在本机 127.0.0.1:9297 上提供 HTTPS 端点,AWS CLI 和各家 SDK 改几个环境变量就能指过来,不需要 AWS 账号。截至 2026-11-17,仓库 aws/aws-emulator 有 8,855 星。

要点
- 归属与许可:仓库在 AWS 官方组织下(owner 类型为 Organization),2026-09-11 建库、2026-11-11 公开宣布;主体代码 CC0-1.0,
vendor/目录单独按 Apache-2.0 授权。 - 覆盖方式:
services/下 436 个以service-开头的 crate,一个服务一个,请求与响应由目录里的 Smithy 模型驱动;没实现的操作返回 HTTP 501 与NotImplemented,不会假装成功。 - 保真数据:多数 release 附带
scores.json.gz。我下载 v1.0.481 那份做了统计:43,548 条用例中 30,570 条通过,约 70.2%;按类型拆开,wire 级 50.1%,behavioral 级 76.8%。
| 项目 | 值(2026-11-17 核对) |
|---|---|
| 星标 / 分叉 | 8,855 / 391 |
| 端点 | HTTPS 127.0.0.1:9297,自签证书 |
| 空闲内存 | 约 160 MiB(官方文档) |
| release | 32 个,最新 v1.0.481 发布于 11 月 16 日 22:13 UTC |
核心功能
- 单进程挂全部服务:核心路由器 crate 把所有服务挂到同一个 HTTPS 端点。端口被占用时用
-p换一个,-p 0交给系统分配;启动日志里的endpoint_url就是脚本该读的地址。 - 错误也对齐:合法调用返回与 AWS 相同的结果,非法调用返回相同的错误码和文案。官方文档的例子是 DynamoDB 表名短于 3 个字符会被拒,模拟器给出和线上一致的
ValidationException。 - 嵌入式模式:Rust 测试把
aws-emulator-embedded加进 dev-dependencies,模拟器编进测试二进制,每个实例一套独立状态、可并行,不需要端点、证书或环境变量。 - 状态在内存、按端口隔离:资源只存在内存里,进程文件写在
~/.aws/emulator/<port>/,Ctrl+C 退出即清空;同时起多个实例互不干扰。 - 给 Agent 的 skill:
aws agent-toolkit add-skill --skill-name aws-emulator --region us-east-1装一个技能,让编码 agent 自己安装、启动、连接,并检查项目能否在模拟器上跑通。
模拟边界
README 和文档把「不做什么」写得很直白,这一点比多数开源模拟器诚实。
- 不求值 IAM 策略:模拟器不按 AWS 的方式评估身份与资源策略,官方明确说不要拿它测安全。
- 一套区域与账号:Region 与 Account ID 都接受,但资源不按区域或账号隔离;行为只在
us-west-2对齐过(全球服务用us-east-1),要测多区域就多起几个进程。 - 控制面强于数据面:控制面 API 吻合度最高;数据面,以及 CloudFormation、Terraform、CDK 的支持,按服务而异。
- 按测试用,不按长驻用:官方说别用于生产,也没做长时间运行和压测;用完就停,或用
--idle-timeout让它自己退出。 - 平台限制:Linux 用 RPM 或 Debian 包;macOS 与 Windows 只能跑 Docker;源码构建只支持 Linux x86_64 与 aarch64,
target/要留 100 GB。
谁在写代码
这是争议最大的部分,值得把能核实和不能核实的分开写。README 的原话是「We don’t accept pull requests: AI agents keep the emulator up to date with AWS, with regular updates.」;文档站口径一致,还写明「updates many times a day」。速度对得上:11 月 14 日到 16 日之间发了 11 个 release,仅 11 月 14 日就有 9 个。
提交记录能佐证,但没到「证明每一行」的程度。最近 100 次提交里,62 次署名 IssueFixerAgent,37 次 IssueFinderAgent,1 次 Scaffolder,没有人类账号;贡献者统计是 0,封面的仓库卡片上就写着 0 Contributors。Amazon 在 aboutamazon.com 的发布文章把话说满:「AWS Emulator is a local emulator of AWS services, 100% written by autonomous AI agents」,同一篇写「Our team hasn’t written or reviewed any of the code」,初版 SQS 用 15 分钟跑出来、其余在周末完成,共 438 个 API 模型。
TechRadar 在 11 月 16 日把这些串成报道,称代码 100% 由 Kiro 自主 agent 编写、未经 AWS 团队人工审阅,15 分钟出可用版本,周末实验后周一团队就能用;同一篇也引了另一半说法,「Turning that into a robust product took more than a weekend」。Werner Vogels 在 11 月 11 日(发布当天)写「All of AWS Emulator’s code was written and tested by agents」,把工程师的位置放在写规格、写测试、设计护栏上。
结论分两层:仓库归属、README 与文档的「agent 维护」表述、提交署名与 0 contributors,都能独立核实;「100% 由 agent 编写」本身是 AWS 的陈述,外部只能确认「没有人类署名,官方也这么说」。TechRadar 的 Kiro 细节与「周一到岗」时间线来自 AWS 对媒体的说明,仓库里没有对应记录。11 月 11 日的 Hacker News 讨论拿到 992 分、266 条评论,质疑集中在保真度与维护承诺;一位自称参与该项目的评论者在下面回「It’s a real product that we plan to maintain.」
典型使用场景
- CI 里的集成测试:流水线不用配 AWS 账号和临时资源,测试直接打本机端点;Rust 项目用嵌入式模式,每个测试一套独立状态,可以并行。
- Agent 自测闭环:编码 agent 写完代码自己跑一遍,失败就地改。官方把「Prototyping with AI coding agents」列为用例,这也是 Vogels 那篇的论点:把测试环境塞进 agent 的循环里。
- 离线与演示:飞机上、内网里照样联调 SDK 调用链;讲 S3、SQS 的调用形状时不必担心账单,关掉进程就干净了。
快速上手
Debian 或 Ubuntu(amd64)的安装命令来自官方文档:
curl -fsSLo aws-emulator.deb \
https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator_amd64.deb
sudo apt-get install -y ./aws-emulator.deb
aws-emulator # 默认 HTTPS 127.0.0.1:9297,前台运行
aws-emulator -v # 确认版本
RPM 系统把第一行换成 sudo dnf install -y https://downloads.aws.com/.../aws-emulator-x86_64.rpm;macOS 与 Windows 按文档走 Docker;源码运行就是 cargo run -p aws-emulator-router。另开一个终端,把 SDK 的环境变量指到模拟器:
export AWS_CONFIG_FILE=~/.aws/emulator/9297/config
export AWS_SHARED_CREDENTIALS_FILE=~/.aws/emulator/9297/emulator_credentials
aws s3api create-bucket --bucket amzn-s3-demo-bucket
接进 CI 之前,先用官方的 check-project 流程过一遍自己的项目:它按你实际调用的服务和操作对照保真数据,比等红灯再排查省事。
小结
AWS Emulator 适合要在本机或 CI 里跑 AWS 调用、又不想碰账号与账单的团队。它不适合需要 IAM 策略语义、跨区域隔离,或者要长驻和压测的环境——后两者官方明说没测。短板是保真度还在爬坡:v1.0.481 那批用例整体约 70% 通过,wire 级只有一半,控制面比数据面可靠;遥测默认开启,得手动关。
许可与语言:CC0-1.0(vendor/ 为 Apache-2.0),Rust 编写,2026-11-17 为 8,855 星、32 个 release。站内写过的 floci 是另一条路线:MIT、Java、一条 docker compose up 起在 4566,还能直接替换 LocalStack;AWS Emulator 的长处是官方模型与错误对齐、按天更新,代价是平台与保真度都还没补齐。要操作真实账号而不是本地测试,站内的 AWS MCP Server 是另一个方向,别把两者混用。