免费开源AWS模拟器fakecloud:107个服务、100% API一致性,LocalStack的完全替代方案

原创2026-10-28 13:48:58137 阅读

免费开源AWS模拟器fakecloud:107个服务、100% API一致性,LocalStack的完全替代方案

fakecloud 是一款免费、开源的本地 AWS 模拟器(AWS Emulator),也是 LocalStack 的完全替代方案:单个约 19 MB 的二进制文件,支持 107 个 AWS 服务、7,657 个 API 操作,并通过 258,545/258,545 个 Smithy 一致性测试变体,实现真实的 100% API 一致性。无需账号、无需 auth token、无付费层级,把 AWS SDK 指向 http://localhost:4566 即可开始本地开发与集成测试。

⚠️ 背景:2026 年 3 月起,LocalStack 用专有镜像替换了开源社区版,要求账号和 token,且多个核心服务转为付费。fakecloud 正是为此而生——让团队保留一个完全本地、完全免费的 AWS 测试工作流。

为什么选择 fakecloud:与 LocalStack 社区版对比

维度 fakecloud LocalStack Community(2026-03 后)
许可证 AGPL-3.0,可商用 专有,付费计划
认证 无需任何账号/token 需要账号 + token
体积与启动 ~19 MB 单文件,~10 MiB 空闲内存,~300ms 启动,无需 Docker ~1 GB 镜像,~150 MiB,~3s 启动,必须 Docker
API 一致性 真实 100%(258,545 个 Smithy 变体) 部分一致
付费墙服务 无(RDS、Cognito、SES、ElastiCache、ECS/ECR、EKS 等全部免费) 多个核心服务仅付费可用
测试断言 SDK TypeScript / Python / Go / PHP / Java / Rust / .NET 共 7 种 仅 Python、Java

完整的迁移对照见 website/content/localstack-alternative.md。

3 种方式快速安装 AWS 模拟器

fakecloud 是一个静态单文件二进制,任选一种方式安装:

# 方式一:一键脚本(推荐,macOS / Linux 通用)
curl -fsSL https://fakecloud.dev/install.sh | bash
fakecloud

# 方式二:Homebrew
brew install fakecloud

# 方式三:Docker
docker run --rm -p 4566:4566 ghcr.io/faiscadev/fakecloud

Rust 生态用户也可以直接 cargo install fakecloud;从源码运行则先克隆仓库再构建:

git clone https://gitcode.com/gh_mirrors/fak/fakecloud
cd fakecloud
cargo run --release --bin fakecloud

安装细节(含 Alpine/musl、版本锁定等)见 website/content/docs/getting-started/install.md。

✅ 启动后监听 http://localhost:4566——与 LocalStack 相同的端口,现有配置基本不用改。

5 分钟接入:用 AWS CLI 跑通第一个测试

fakecloud 不校验凭证,但大多数 SDK 要求设置占位凭证:

export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test
export AWS_REGION=us-east-1

# 用官方 AWS CLI 直接操作,应用代码零改动
aws --endpoint-url http://localhost:4566 sqs create-queue --queue-name my-queue

更完整的演示看仓库示例:

第一个集成测试的写法(真实 AWS SDK + 官方测试 SDK 断言)参考 website/content/docs/getting-started/first-test.md。

107 个服务、7,657 个操作:覆盖率一览

fakecloud 按"深度优先"策略落地服务——一个服务只有通过了全部 Smithy 模型测试变体和跨服务联动,才算"已支持"。部分代表服务:

类别 服务 亮点
计算与容器 EC2(807 操作)、Lambda(88)、ECS(77)、ECR(58) Lambda 在真实容器中跑 31 种运行时;ECR 支持 docker push/pull
存储与数据库 S3(112)、DynamoDB(58)、RDS(164)、ElastiCache(75) RDS 跑真实 Postgres/MySQL/MariaDB/Oracle/SQL Server/Db2
消息与集成 SQS(23)、SNS(42)、EventBridge(57)、Step Functions EventBridge → Step Functions、S3 → Lambda 等 15+ 条链路端到端执行
安全与管理 IAM(180)、STS、SSM(152)、KMS、CloudFormation(90) 完整策略评估:权限边界、会话策略、ABAC、SCP
AI Bedrock(222 操作横跨 4 个 API) 真实 InvokeModel/Converse 流式、guardrails、agents,支持故障注入

每个服务的支持深度、控制面/数据面划分和已知限制,完整清单在 website/content/docs/parity.md 与 website/content/supported-services.md。

为什么敢声称 100% API 一致性:Smithy 模型校验

普通 mock 库只覆盖"用得到的几个 API",而 fakecloud 的校验方式完全不同:

  1. 每个服务的 AWS Smithy 模型(官方 SDK 使用的同一份模型)都保存在仓库中;
  2. CI 基于模型自动生成 258,545 个测试变体,逐个校验请求/响应结构、字段名、错误码、HTTP 状态码;
  3. 基线固定为全量通过,任何 PR 只要有一个变体失败或某服务低于基线,CI 直接红灯——没有"抖动容忍"。

基线数据与机制说明见 conformance-baseline.json 和 conformance-baseline-notes.md。此外 CI 还会跑上游 terraform-provider-aws 的 TestAcc* 验收套件,捕获 SDK 测试发现不了的 waiter/字段漂移问题。

真实基础设施:Lambda、RDS、ElastiCache 不是 stub

这是 fakecloud 与浅层 mock 最大的区别:

  • Lambda:拉取真实 AWS Lambda 运行时容器执行你的 handler,覆盖 31 种官方运行时(Node.js 16–26、Python 3.8–3.15、Java 8–25、.NET 8/10、Go 等);
  • RDS:真实拉取 PostgreSQL / MySQL / MariaDB / Oracle / SQL Server / Db2 镜像作为"数据库实例",你的 SQL 索引、触发器、扩展全都真实工作;
  • ElastiCache:真实 Redis / Valkey / Memcached,LPUSH、XADD、stream、pub/sub、Lua 脚本均可用;
  • EC2 / ECS:实例与任务作为真实容器运行(默认 Docker,也可通过 FAKECLOUD_CONTAINER_BACKEND=k8s 切到原生 K8s Pod)。

💡 fakecloud 本身不需要 Docker;只有上述"真实容器类"服务才需要 Docker(与 LocalStack Pro 的要求一致)。

跨服务联动 + 7 语言测试断言 SDK

集成测试最难的往往不是单服务,而是服务之间的链路。fakecloud 的真实联动包括:EventBridge → Step Functions、S3 → Lambda、SES 入站 → S3/SNS/Lambda 等 15+ 条端到端链路——S3 里上传一个对象,订阅的 Lambda 会真实执行。

断言侧,官方提供 7 种语言的测试 SDK(TypeScript、Python、Go、PHP、Java、Rust、.NET),让测试直接检查"副作用",无需手写 HTTP:

import { FakeCloud } from "fakecloud";

const fc = new FakeCloud();
// 应用通过正常 AWS SDK 发邮件,测试直接断言
const { emails } = await fc.ses.getEmails();
expect(emails).toHaveLength(1);

await fc.reset(); // 测试间重置

各语言 SDK 源码见 sdks/typescript/、sdks/python/、sdks/go/、sdks/java/、sdks/php/、sdks/dotnet/ 与 crates/fakecloud-sdk/。

从 LocalStack 迁移:改一行镜像即可

官方迁移指南覆盖 docker-compose、CI(GitHub Actions)、Terraform、CDK、Serverless Framework 的逐行对照,核心结论一句话:换掉镜像/安装命令,保留 http://localhost:4566 和 dummy 凭证,其余不变:

services:
  fakecloud:
    image: ghcr.io/faiscadev/fakecloud:latest
    ports:
      - "4566:4566"
  • SERVICES=s3,sqs,... 环境变量可以删掉(fakecloud 默认启动全部服务,且都很轻量)
  • LOCALSTACK_AUTH_TOKEN 可以删掉(fakecloud 无 token 概念)
  • LocalStack Pro 的 PERSISTENCE=1 对应 fakecloud 的 --persist /path/to/dir

完整步骤见 website/content/blog/migrate-from-localstack.md。

常见问题(FAQ)

  • 它是生产级云基础设施吗? 不是。fakecloud 定位是测试与本地开发工具,生产环境请用真实 AWS。
  • AGPL 会影响我的应用吗? 不会。把它当开发/测试依赖使用,零 AGPL 传染;只有你修改 fakecloud 本身并以网络服务再分发才触发 copyleft 条款。
  • AI 编码工具能用吗? 可以。README 提供了 Claude Code(CLAUDE.md)、Cursor(.cursor/rules)、GitHub Copilot 的现成片段,让 AI 助手自动用 fakecloud 做 AWS 集成测试。
  • 遇到不一致怎么办? 那就算 bug——按 CONTRIBUTING.md 约定提交问题即可,项目路线图完全由真实需求驱动。

📌 总结:如果你在找一个免费、无账号、无 token 的本地 AWS 模拟器来替代 LocalStack,fakecloud 提供了 107 个服务、真实 Lambda/RDS/Redis 执行、100% Smithy 一致性校验和 7 语言测试 SDK,是目前最完整的开源方案。克隆仓库(git clone https://gitcode.com/gh_mirrors/fak/fakecloud)或按上文一条命令安装,300 毫秒后即可开始本地 AWS 测试。

登录后查看全文
fakecloud