floci-io/floci

这是什么？

核心功能

• 01只需修改端点即可兼容标准 AWS SDK、CLI 和基础设施即代码工具。
• 02Lambda、RDS、ElastiCache、ECS、EC2、EKS 等服务基于真实 Docker 容器运行。
• 03提供内存、持久化、混合和预写日志四种存储模式。
• 04通过 12 位数字的访问密钥 ID 实现按账户的资源隔离。
• 05为 Java、Node.js、Python 和 .NET 提供 Testcontainers 模块。

适用场景

• 无需云账号，在本地运行依赖 AWS 的应用代码和测试。
• 在 CI 流水线中使用模拟的 AWS 服务，替代真实云资源。
• 在部署到 AWS 前，用 Terraform、CDK 或 OpenTofu 验证配置。
• 替换现有 Docker Compose 环境中的 LocalStack Community。

快速上手

1. 1

   使用官方 CLI 启动 Floci

   floci start
2. 2

   导出 AWS 环境变量

   eval $(floci env)
3. 3

   对 Floci 运行标准 AWS CLI 命令

   aws s3 mb s3://my-bucket

使用前须知

• !部分服务采用真实的 Docker 执行，因此需要运行中的 Docker 引擎和 Docker 套接字。
• !Web 控制台功能需要将 Docker 套接字挂载到容器中。

标签

常见问题

floci 是什么？

免费开源的本地 AWS 模拟器，无需云账号即可在本机运行兼容 AWS 的服务。 Floci 是一个用于开发、测试和 CI 的本地 AWS 模拟器。只需将 AWS SDK、CLI、Terraform、CDK、OpenTofu 或测试程序的端点指向 http://localhost:4566，即可沿用现有工作流，无需云账号、认证令牌或付费功能。

floci 可以免费使用吗？用的什么许可证？

floci 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

floci 还在维护吗？

活跃维护中。floci 最近一次提交是在 2026年10月20日。

floci 适合用来做什么？

无需云账号，在本地运行依赖 AWS 的应用代码和测试。 在 CI 流水线中使用模拟的 AWS 服务，替代真实云资源。 在部署到 AWS 前，用 Terraform、CDK 或 OpenTofu 验证配置。 替换现有 Docker Compose 环境中的 LocalStack Community。

floci 怎么安装和运行？

使用官方 CLI 启动 Floci: floci start 导出 AWS 环境变量: eval $(floci env) 对 Floci 运行标准 AWS CLI 命令: aws s3 mb s3://my-bucket

在哪里获取 floci？

源代码和安装说明在 GitHub 上：https://github.com/floci-io/floci