在本地跑通 AWS Emulator 的 S3:一次 Boto3 实测
本机安装 AWS Emulator 1.0.485 后,隔离云凭据并指向本地端点,用 Boto3 完成 S3 建桶、上传、下载与正文比对;附流程、实测输出和边界说明。
2026 年 11 月 11 日,AWS 发布 AWS Emulator。发布文章《AWS Emulator and the engineer’s job when agents write the code》的作者是 Swaminathan Sivasubramanian,新闻入口在这里,项目仓库是 https://github.com/aws/aws-emulator 。本篇记录 2026 年 11 月 17 日在本机的一次 S3 实测:安装并启动模拟器、隔离测试进程的 AWS 配置、用 Boto3 调用本地端点,核对请求状态和下载正文。

发布文章中的说法与代码许可
原文作者回顾了约二十年前与 Amazon 早期工程师 Al Vermeulen 开发分布式锁服务 Alf 的经历:团队在 JVM 中模拟服务及网络环境,主动排列事件顺序、注入丢包等故障,并用 TLA+ 等形式化方法检查问题。原文称,这些手段帮助团队在真实服务器部署前发现了大部分并发错误,但真实环境仍会暴露模拟覆盖不到的问题。
原文称,如今 AWS 服务已超过 200 项,手工为每个服务造测试环境不再现实;项目方案是让智能体依据公开 API 模型(Smithy 格式)编写模拟器,并用在真实 AWS 上验证过的保真测试来检查结果。按原文的官方陈述,AWS Emulator 由 400 多个 API 模型构建,覆盖 200 多项 AWS 服务,可在本机免费离线运行;改动需经过包含安全智能体对抗审查的合并门禁。上述数字和功能描述来自原文与官方文档,本篇没有逐项验证。
许可要分开看:仓库主项目采用 CC0-1.0,vendor/ 目录内的代码是 Apache-2.0,不能把整个仓库统称为 CC0。安装与安全说明见官方 Linux 安装文档、SDK 指向模拟器的文档和安全文档。
流程
flowchart TD
A[下载安装包并校验签名] --> B[安装并以 telemetry off 启动]
B --> C[隔离凭据与配置,指向本地端点]
C --> D[Boto3 调用本地 S3]
D --> E[建桶、上传、下载、比对正文]
E --> F[清理测试对象与桶]
安装与启动
本次按官方包路径下载 .deb、签名文件和公钥,导入后验签,再安装。安装日志中的校验和安装结果如下:
+ curl -fsSLo aws-emulator_amd64.deb.sig https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator_amd64.deb.sig+ curl -fsSLo aws-publishing.asc https://downloads.aws.com/keys/gpg/current.asc+ gpg --import aws-publishing.ascgpg: key 2E5BF49BD940F624: public key "SSM Publishing <ssm-publishing@amazon.com>" imported+ gpg --fingerprint ssm-publishing@amazon.compub rsa4096 2026-07-20 [SC] 98BC F336 A3BE 53B7 34E9 67C5 2E5B F49B D940 F624uid [ unknown] SSM Publishing <ssm-publishing@amazon.com>+ gpg --verify aws-emulator_amd64.deb.sig aws-emulator.debgpg: Signature made Tue Nov 17 12:12:46 2026 CSTgpg: using RSA key 98BCF336A3BE53B734E967C52E5BF49BD940F624gpg: Good signature from "SSM Publishing <ssm-publishing@amazon.com>" [unknown]Primary key fingerprint: 98BC F336 A3BE 53B7 34E9 67C5 2E5B F49B D940 F624+ sudo apt-get install -y ./aws-emulator.debThe following NEW packages will be installed: aws-emulatorSelecting previously unselected package aws-emulator.Setting up aws-emulator (1.0.485-1) ...安装后核对版本,本机以 aws-emulator --telemetry off 启动,端点为 https://127.0.0.1:9297。实际日志和版本输出:
Version: 1.0.485Release date: 2026.11.17Commit: a2568e8a8db45f44e1a9fea808f13b22373aab60python 3.13.5 boto3 1.44.4 botocore 1.44.4{"timestamp":"2026-11-17T05:02:56.271997Z","level":"INFO","fields":{"message":"aws-emulator emulator starting"},"target":"aws_emulator"}This emulator collects usage and error telemetry: disabled (via the embedding configuration); to turn it back on, remove every opt-out setting and restart{"timestamp":"2026-11-17T05:02:56.387961Z","level":"INFO","fields":{"message":"request authentication enabled","credentials_file":"/home/box/.aws/emulator/9297/emulator_credentials"},"target":"aws_emulator_server"}{"timestamp":"2026-11-17T05:02:56.388028Z","level":"INFO","fields":{"message":"emulator server information","endpoint_url":"https://127.0.0.1:9297","health_check_url":"https://127.0.0.1:9297/__admin/health","config_file":"/home/box/.aws/emulator/9297/config","ca_file":"/home/box/.aws/emulator/9297/ca.pem","java_truststore_file":"/home/box/.aws/emulator/9297/truststore.p12"},"target":"aws_emulator_server"}遥测默认是开启的;要在本机离线跑,启动时显式关闭。日志中的提示写明:想重新开启,需要移除所有退出设置并重启。请求认证使用模拟器生成的凭据文件,健康检查地址是 __admin/health。
隔离凭据并指向本地端点
测试脚本先清掉调用进程里所有 AWS 凭据与端点变量,再只设置模拟器自己的文件位置和本地地址。示例只展示变量名和文件路径,不展示真实云密钥,也不展示凭据文件内容:
unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE \ AWS_SHARED_CREDENTIALS_FILE AWS_CONFIG_FILE AWS_ENDPOINT_URL AWS_CA_BUNDLE \ AWS_REGION AWS_DEFAULT_REGION AWS_EC2_METADATA_DISABLED AWS_DISABLE_HOST_PREFIX_INJECTION \ AWS_WEB_IDENTITY_TOKEN_FILE AWS_ROLE_ARN AWS_CONTAINER_CREDENTIALS_RELATIVE_URI \ AWS_CONTAINER_CREDENTIALS_FULL_URI AWS_CONTAINER_AUTHORIZATION_TOKEN
PORT=9297EMUDIR="$HOME/.aws/emulator/$PORT"export AWS_ENDPOINT_URL="https://127.0.0.1:$PORT"export AWS_SHARED_CREDENTIALS_FILE="$EMUDIR/emulator_credentials"export AWS_CONFIG_FILE="$EMUDIR/config"export AWS_CA_BUNDLE="$EMUDIR/ca.pem"export AWS_EC2_METADATA_DISABLED=trueexport AWS_DISABLE_HOST_PREFIX_INJECTION=trueexport AWS_REGION=us-east-1export AWS_DEFAULT_REGION=us-east-1
用 Boto3 调用 S3
客户端显式指定本地端点、us-east-1 区域和 path 风格寻址;脚本先取桶列表,再建桶、上传、下载并比对字节,最后删除测试对象与测试桶:
from botocore.config import Configimport boto3
s3 = boto3.client( "s3", endpoint_url="https://127.0.0.1:9297", region_name="us-east-1", config=Config(s3={"addressing_style": "path"}, inject_host_prefix=False),)
r = s3.list_buckets()print("list_buckets HTTP:", r["ResponseMetadata"]["HTTPStatusCode"])print("list_buckets Buckets:", r["Buckets"])
bucket = "blog-emulator-demo-20261117"key = "notes/demo.txt"payload = b"local S3 emulator test, 2026-11-17\n"
s3.create_bucket(Bucket=bucket)s3.put_object(Bucket=bucket, Key=key, Body=payload, ContentType="text/plain")r = s3.get_object(Bucket=bucket, Key=key)data = r["Body"].read()print("get_object body:", repr(data))print("content identical:", data == payload)实测输出如下。新实例的桶列表为空;建桶、上传、下载的 HTTP 状态均为 200,ETag 一致,下载正文与上传内容相同:
--- health check ---ok--- versions ---Version: 1.0.485Release date: 2026.11.17Commit: a2568e8a8db45f44e1a9fea808f13b22373aab60python 3.13.5 boto3 1.44.4 botocore 1.44.4--- boto3 S3 calls ---list_buckets HTTP: 200list_buckets Buckets: []list_buckets RequestId: 0000000000000000create_bucket HTTP: 200put_object HTTP: 200 ETag: "c73a07f11a398416a5569e4d2257bfe6"get_object HTTP: 200 ETag: "c73a07f11a398416a5569e4d2257bfe6"get_object body: b'local S3 emulator test, 2026-11-17\n'content identical: Truelist_objects_v2 keys: ['notes/demo.txt']cleanup: deleted test object and bucket边界
本次结果只说明本机模拟器的 S3 接口按上述步骤返回了这些响应。模拟器状态保存在内存中,进程退出即丢失;默认遥测开启,需要显式关闭。它不能验证真实 AWS 的 IAM 身份、资源策略或账号权限,也不能证明与真实 AWS 完全等价;官方仓库保留了记录行为差异的目录。本篇只调用 S3,没有运行函数代码。