免费开源AWS模拟器fakecloud:107个服务、100% API一致性,LocalStack的完全替代方案
免费开源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
更完整的演示看仓库示例:
- Python(boto3 版 S3 + SQS + SNS + SSM 全流程):examples/python/demo.py
- Terraform(
endpoints块指向 4566 端口):examples/terraform/main.tf - Docker Compose(含 SQS 收发 + SSM 参数的端到端样例):examples/docker-compose.yml
第一个集成测试的写法(真实 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 的校验方式完全不同:
- 每个服务的 AWS Smithy 模型(官方 SDK 使用的同一份模型)都保存在仓库中;
- CI 基于模型自动生成 258,545 个测试变体,逐个校验请求/响应结构、字段名、错误码、HTTP 状态码;
- 基线固定为全量通过,任何 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 测试。