本文へスキップ
株式会社オブライト
株式会社オブライト

AWS Emulatorとは

AWS公式が出したAWS APIのローカルエミュレータ、Rust製・無料・AWSアカウント不要の使い方【LocalStack・fakecloud・MiniStack・Motoとの違い】

2026/11/16に公開約14分で読めます

AWS Emulatorは、AWS自身が公開したAWS APIのローカルエミュレータだ。Rust製で追加料金なし、AWSアカウントも不要で、開発機やCIでAWS CLI・SDKの接続先を差し替えるだけで使える。導入方法、サービス別の忠実度スコア、LocalStack・fakecloud・MiniStack・Motoとの違い、注意点を一次情報で整理する。

AWS Emulatorは、AWS自身が公開した「AWS APIのローカルエミュレータ」だ。自分のPC・開発サーバー・CI上で動かし、AWS CLIやSDKの接続先をそこへ向けるだけで、AWSアカウントなし・追加料金なしでアプリのAWS連携をテストできる。GUIはなく、本番運用やセキュリティテストには使わないツールと位置づけられている。

AWS公式ブログでの告知は2026年11月11日(筆者はAWSのシニアスペシャリストソリューションアーキテクトDaniel Abib氏、11月12日更新)。GitHubリポジトリ(aws/aws-emulator)は2026年11月16日時点でスター約8,400、ライセンスはCC0-1.0(vendor/ 配下のみApache License 2.0)、実装言語はRust。Hacker Newsでは11月11日に投稿され991ポイントを集めた。

なぜ今注目されているか

最大の理由は「AWS本体が出した」ことだ。これまでAWSのローカルテストはLocalStackなどサードパーティが担ってきたが、公式が同じ目的のツールを無償で出した。公式ドキュメントによれば、AIエージェントがAWSの変更に追従してエミュレータを継続的に更新しており、リリースは1日に何度も出ている(GitHubのreleasesでは2026年11月14日だけでv1.0.351からv1.0.385までが並ぶ)。

背景にはLocalStackの方針転換もある。InfoQの2026年2月15日付の報道では、LocalStackはCommunity EditionとProを1つのイメージに統合し、登録が必要になる(有料プランは1ライセンス月額39ドルから)と伝えられた。同社のGitHubリポジトリは2026年3月23日にアーカイブ(読み取り専用)になっている。こうした「無料で使えるローカルAWS」の空白を埋める動きの1つが、fakecloudやMiniStackであり、今回はそこにAWS公式が加わった形だ。

何ができるか

機能内容
AWS APIのローカル再現1つのHTTPSエンドポイント(既定 https://127.0.0.1:9297)で、AWS API modelが公開されているサービスのAPIを受け付ける
同じエラーの再現DynamoDBのテーブル名が3文字未満なら、AWSと同じ ValidationException で拒否する(公式の例)
未実装操作の明示未実装の操作はHTTP 501・エラーコード NotImplemented を返し、テストがすぐ失敗する
サーバーモードLinux(RPM/deb)ではネイティブ、macOS/WindowsではDockerコンテナで常駐させる
組み込みモードRust製テストのプロセス内で起動。テストごとに独立した状態を持ち、並列実行できる
AIエージェント用スキルaws-emulator スキルがエミュレータの導入・起動・接続と、プロジェクトが動くかの確認を行う
忠実度スコアの公開サービスごとの合格テスト数をリリースごとに公開。テスト本体は aws-emulator-evaluation-suite リポジトリにある

対応サービスの一覧と忠実度は、リリースに添付される scores.json.gz(v1.0.385、2026年11月14日付、コミット 813af48)で確認できる。このファイルを筆者が集計したところ、43,548件のテスト単位のうち28,505件が合格(約65%)で、約350のサービス識別子が含まれていた。主要サービスの内訳は次のとおり(1つのテストが複数サービスにまたがる場合は各サービスに数えているため、公式が示す「サービスごとのk of n」とは数え方が少し異なる)。

サービス合格 / 総数合格率
Amazon S32,061 / 2,845約72%
Amazon DynamoDB1,542 / 2,142約72%
Amazon SQS1,190 / 1,536約77%
Amazon SNS557 / 641約87%
AWS Lambda1,912 / 3,021約63%
AWS IAM830 / 1,238約67%
AWS STS163 / 261約62%
AWS KMS423 / 510約83%
AWS Secrets Manager345 / 444約78%
Amazon CloudWatch Logs857 / 1,235約69%
Amazon API Gateway(REST)898 / 1,219約74%
AWS Step Functions772 / 987約78%
Amazon EC21,246 / 2,499約50%
AWS CloudFormation973 / 4,282約23%

公式によれば、エミュレータが最もよくAWSと一致するのはコントロールプレーン(作成・取得・更新・削除・一覧)のAPIで、データプレーンの忠実度やCloudFormation・Terraform・CDKといったIaCツールへの対応はサービスによってばらつく。上の表でもCloudFormationの合格率が低いのはそのためと読める。なお、スコアはテスト数が増えるたびに分母が変わる「スナップショット」であり、同じバージョンのテスト同士でしか比較できない。

インストールと料金

方法内容
料金追加のサービス料金なし。AWS上にデプロイしたリソースの料金だけがかかる
ライセンスCC0-1.0(vendor/ 配下はApache License 2.0)
LinuxRPM/debパッケージ(x86_64・aarch64)。aws-emulator コマンドが /usr/bin/ に入る
macOS/Windows既製イメージは公開されておらず、公式のDockerfileから自分でビルドする
組み込み(Rust)aws-emulator-embedded クレートを [dev-dependencies] にGit依存で追加(リリースのコミットを rev に固定)
AIエージェントAWS CLI 2.35.0以上で aws agent-toolkit add-skill --skill-name aws-emulator
ソースからビルドLinux x86_64/aarch64。target/ に100GB以上の空きと長いビルド時間が必要
# Debian系(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 -v

# 起動(既定は 127.0.0.1:9297 のHTTPS)
aws-emulator

使い方 — 最短手順

- エミュレータを起動する(Linuxなら aws-emulator、macOS/WindowsならビルドしたDockerイメージを -p 127.0.0.1:9297:9297 で起動)。起動のたびに新しいアクセスキーと自己署名証明書が作られ、~/.aws/emulator/9297/ に書き出される
- 別のシェルで環境変数を設定する。エンドポイントは AWS_ENDPOINT_URL、証明書は AWS_CA_BUNDLE、認証情報は AWS_SHARED_CREDENTIALS_FILE
- 本物のAWS認証情報が入る変数(AWS_ACCESS_KEY_ID など)を unset する。残っているとSDKがそれで署名し、エミュレータに拒否される
- aws sts get-caller-identity で接続先を確認する。エミュレータなら Account が 000000000000 になる
- 通常どおりSDKやCLIを実行する。コードにエンドポイントや認証情報を書く必要はない

export AWS_ENDPOINT_URL=https://127.0.0.1:9297
export AWS_SHARED_CREDENTIALS_FILE=~/.aws/emulator/9297/emulator_credentials
export AWS_CONFIG_FILE=~/.aws/emulator/9297/config
export AWS_CA_BUNDLE=~/.aws/emulator/9297/ca.pem
export AWS_EC2_METADATA_DISABLED=true
export AWS_DISABLE_HOST_PREFIX_INJECTION=true
export AWS_REGION=us-east-1
export AWS_DEFAULT_REGION=us-east-1
unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE

aws s3api create-bucket --bucket amzn-s3-demo-bucket
aws sts get-caller-identity
# Rustテストに組み込む場合(Cargo.toml)
[dev-dependencies]
aws-emulator-embedded = { git = "https://github.com/aws/aws-emulator", rev = "<commit>" }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

// テスト側: SDK設定にエミュレータのHTTPクライアントと認証情報を渡す
let emulator = AwsEmulatorEmbedded::new(EmbeddedOptions::default());
let config = aws_config::defaults(aws_config::BehaviorVersion::latest())
    .http_client(emulator.http_client())
    .region(aws_config::Region::new("us-east-1"))
    .credentials_provider(emulator.aws_credentials_provider())
    .load()
    .await;

既存ツールとの違い

項目AWS EmulatorLocalStackfakecloudMiniStackMoto
提供元AWS(公式)LocalStack社faiscadevministackorggetmoto
ライセンスCC0-1.0旧OSS版はApache-2.0(リポジトリは2026年3月23日にアーカイブ)AGPL-3.0MITApache-2.0
実装Rust公式ページで確認できずシングルバイナリPythonPython
対象範囲AWS API modelがあるサービス(数は公式に明記なし)公式ページで確認できず105サービス60以上公式ページで確認できず
既定ポート9297(HTTPS)456645664566(GATEWAY_PORT で変更)5000(サーバーモード)
アカウント・登録不要無償版は登録が必要になると報道(InfoQ)不要不要不要
認証既定でSigV4署名を要求(起動ごとの鍵)公式ページで確認できずトークン不要数字以外の任意のキーで可公式ページで確認できず
起動方法RPM/deb、Docker、Rust組み込みDocker単一バイナリpip、Dockerpip、Docker、デコレータ(モック)
忠実度の公開サービス別スコアをリリースごとに公開公式ページで確認できず公式ページで確認できず公式ページで確認できず公式ページで確認できず

使い分けの目安は次のとおり。AWS公式の挙動に近い検証をしたい、エラーメッセージまで一致させたい、Rustのテストにプロセス内で組み込みたいならAWS Emulator。すでに4566番ポートとLocalStack互換の設定で書かれた既存のテスト資産があるなら、同じ4566番ポートで動くfakecloudやMiniStackのほうが差し替えは軽い。Pythonのユニットテストだけで済むならMotoのデコレータが最も手軽だ。なお、AWS Emulatorは自己署名のHTTPSで鍵が起動ごとに変わるため、既存のHTTP前提の設定は書き換えが要る。

注意点・向いている人

- 本番利用・セキュリティテストには使えない: IAMポリシーやリソースポリシー(バケットポリシー、KMSキーポリシー)をAWSと同じようには評価しない。AWSが拒否するリクエストが通ることがある
- 1リージョン・1アカウント: リソースをリージョンやアカウントで分離しない(アカウントIDは 000000000000)。複数リージョンを試すならポートを分けて複数起動する
- メモリ上にのみ保存: 停止すると全リソースが消える。長時間運用や負荷試験は未検証で、アイドル時で約160MiBを使う
- 忠実度はサービスにより差がある: 上の表のとおり合格率は約23%から約87%まで幅がある。使うサービスのスコアと、issues/ の既知のギャップを先に確認する
- 証明書の設定が要る: Node.jsは NODE_EXTRA_CA_CERTS、JavaはPKCS12のtruststore、Rust・.NETは SSL_CERT_FILE など、SDKごとに追加設定がある。S3は localhost ではなく 127.0.0.1 を使う
- S3 Controlは届かない: SDKがアカウントIDをホスト名に付けるため、S3 Controlのリクエストはエミュレータに届かない(公式の記載)
- 信頼できるコードだけ動かす: Lambdaなどでコードを実行する場合、マシンから隔離されず、自分のユーザー権限でファイルを読み書きできる
- テレメトリが既定で有効: 匿名の利用・エラー情報を送る。リクエスト内容や認証情報は含まれないと公式は説明しており、--telemetry off や EMULATOR_TELEMETRY=off で止められる
- プルリクエストは受け付けない: 不具合は GitHub Issues に報告する運用で、セキュリティ上の問題はHackerOneまたはaws-security@amazon.comへ
- 向いている人: AWS連携コードをCIでアカウントなしに回したい人、Rustでテストを書く人、AIコーディングエージェントにAWS前提のアプリをローカルで試させたい人

よくある質問

AWS Emulatorは無料ですか?AWSアカウントは必要ですか?

公式ドキュメントでは追加のサービス料金はなく、AWSアカウントも不要とされている。料金がかかるのは、AWS上にデプロイしたリソースだけだ。ライセンスはCC0-1.0(vendor配下はApache License 2.0)。

LocalStackの代わりにそのまま使えますか?

そのままとは限らない。AWS Emulatorは既定ポートが9297のHTTPSで、起動のたびに新しい鍵と自己署名証明書を作るため、環境変数と証明書の設定が要る。4566番ポートを前提にしたテスト設定はそのままでは動かない。また、対応範囲とスコアはサービスごとに異なるので、自分が使うサービスで試すのが確実だ。

S3・DynamoDB・SQS・Lambdaは使えますか?

いずれもスコアが公開されている。リリースv1.0.385の scores.json.gz を筆者が集計した範囲では、S3約72%、DynamoDB約72%、SQS約77%、SNS約87%、Lambda約63%が合格している。未実装の操作はHTTP 501(NotImplemented)で明示的に失敗する。

Windows・macOSでも動きますか?

動くが、ネイティブではなくDocker経由だ。公式は既製イメージを公開しておらず、公式ドキュメントのDockerfileからイメージをビルドする。ポートは -p 127.0.0.1:9297:9297 のようにローカルだけに公開するよう案内されている。

Rust以外の言語から使えますか?

サーバーモードなら、AWS CLIや各種AWS SDK(Python、JavaScript、Go、Java、.NETなど)から環境変数でエンドポイントを向けて使える。プロセス内に組み込む組み込みモードは、AWS SDK for Rustのテスト向けだ。

AIエージェントとはどう使うのですか?

AWS CLI 2.35.0以上で aws agent-toolkit add-skill --skill-name aws-emulator を実行すると、エミュレータの導入・起動・接続と、プロジェクトが動くかの確認をエージェントに任せられる aws-emulator スキルが入る。

まとめ

AWS Emulatorは、AWS自身が出した無料のローカルAWS APIエミュレータで、CIやローカルでのAWS連携テストをアカウントなしで回せる。忠実度スコアがサービス別・リリース別に公開されているため、「使うサービスがどこまで動くか」を事前に数字で確認できるのが強みだ。一方でIAMや各種ポリシーは検証できず、スコアもサービスによって大きく違う。

導入前に自分のプロジェクトが使うサービスのスコアを見て、本番前には必ず実際のAWSで確認する、という前提で使うのが現実的だ。AWSの構成や費用の考え方は中小企業のためのAWS導入ガイドやAWSのコスト最適化の記事も参照してほしい。AWSの構築・移行の支援は クラウド構築・移行 でも扱っている。

参考リンク(一次ソース)

- https://github.com/aws/aws-emulator
- https://github.com/aws/aws-emulator/releases
- https://aws.amazon.com/blogs/aws/test-your-applications-against-aws-locally-with-aws-emulator/
- https://docs.aws.amazon.com/emulator/latest/userguide/what-is-service.html
- https://docs.aws.amazon.com/emulator/latest/userguide/fidelity.html
- https://docs.aws.amazon.com/emulator/latest/userguide/point-sdk-to-emulator.html
- https://docs.aws.amazon.com/emulator/latest/userguide/security.html
- https://docs.aws.amazon.com/emulator/latest/userguide/getting-started-linux.html
- https://docs.aws.amazon.com/emulator/latest/userguide/getting-started-docker.html
- https://docs.aws.amazon.com/emulator/latest/userguide/getting-started-embedded.html
- https://github.com/ministackorg/ministack
- https://docs.getmoto.org/en/latest/docs/server_mode.html
- https://github.com/localstack/localstack
- https://www.infoq.com/news/2026/02/localstack-aws-community

株式会社オブライト

株式会社オブライトは、ソフトウェア開発、デジタルサイネージ、Web開発、ネットワークシステム、IoT/AR/VRなどの技術サービスを提供する東京のIT企業です。

お気軽にご相談ください

お問い合わせ