开发工具#容器

floci:免费开源的本地 AWS 模拟器,LocalStack 可直接替换

floci 一条 docker compose up 起本地 AWS 形状服务:无账号无令牌无付费墙,SDK 与 Terraform 指 4566,MIT。

项目资料

GitHub Ecosystem
仓库地址github.com/floci-io/floci
许可证
MIT
主语言
Java
星标
29,648
核查时间
2026-11-05

以上快照资料以核查当日为准,可能随版本或运营策略变化。

本地开发要连 AWS:要么拿真实账号冒风险,要么忍受 LocalStack 的账号、令牌与付费墙。开源项目 floci(MIT,截至 2026-11-05 有 29,648 星)给出第三条路:docker compose up 一条命令,本机就有 AWS 形状的服务——无账号、无认证令牌、无功能门槛,把 AWS SDK、CLI、Terraform、CDK、OpenTofu 或测试套件指到 http://localhost:4566,既有工作流原样保留。它还是 LocalStack 的 drop-in 替代:换掉镜像名就能继续用。

核心功能

  • 零门槛本地云:不需要云账号与令牌,CI 里也能跑,测试环境与生产配置天然分离,也不用再管谁占用了共享账号的并发额度。
  • LocalStack 平替:提供专门的迁移文档,换镜像、保工作流。
  • SDK 全兼容:AWS SDK、CLI、Terraform、CDK、OpenTofu、Testcontainers 都按原方式对接 4566 端口。
  • 家族化:同门还有 floci-az(Azure 本地模拟器)与 floci-ui(本地云的 Web 控制台),一套理念覆盖多家云。
  • 迁移路径清晰:仓库为 LocalStack 用户写了专门的迁移章节,常见差异与配置对照都列在明面。

典型使用场景

  • 集成测试:CI 里起一套 S3/SQS 形状的服务,测试不花钱也不外联;每个 PR 起一套独立实例,互不串数据。
  • IaC 预演:Terraform/OpenTofu 计划先在本地模拟器上验证,再推真实账号,避免「计划即变更」的事故。
  • 离线开发:差旅或内网环境不受云可达性限制。
  • Testcontainers 集成:仓库自带 Testcontainers 章节,JVM 生态的测试直接挂 4566。

快速上手

docker compose up

然后把 AWS 端点指到 http://localhost:4566 即可;从 LocalStack 迁移按仓库的 Migrating 章节换镜像名。官方 Docker 镜像发布在 floci/floci,release 由 GitHub Actions 自动构建并附构建状态徽章,升级可以直接跟随 latest 标签。

小结

floci 适合要频繁起 AWS 形状依赖的测试与 CI 场景;需要完整服务覆盖或生产级仿真细节的团队仍要评估 LocalStack 的付费版功能面。要点与边界:MIT、Java 实现、2 月开库至今 29,648 星,Docker 镜像在 floci/floci 官方发布;本地模拟器不模拟真实云的配额、限流与区域行为,压测与成本估算仍需真云验证;服务覆盖清单以仓库的 Services 章节为准,替换前先核对你在用的服务是否在列。它和站内写过的 agent-autoloop 解决的不是同一件事,但属于同一类趋势:把过去必须连云的能力搬回本地——autoloop 把持续运行的 Agent 搬回一台机器,floci 把开发测试依赖的那朵云搬回一个容器。