floci

🏠 本地 AWS 开发：Floci 如何让云开发"断网也能跑"

想象一下这个场景：你正在高铁上处理一个紧急需求，需要调试 AI 应用的 S3 文件上传逻辑——但没有网络，连不上 AWS。云原生开发被基础设施卡脖子的焦虑，每个开发者都不陌生。

Floci 解决的就是这个问题：把 52 种 AWS 服务"装进"你的本地 Docker，一行命令启动，随时随地开发调试，云代码本地跑。

---

🌤️ 为什么叫 Floci？

Floci 源自"floccus"——积云的一种，看起来像爆米花🌽。创始人希望这个工具像积云一样轻量、随处可见，却又能承载重量级的云开发工作。

Floci 的诞生背景很明确：LocalStack 社区版越来越"难用"。付费墙、功能限制、认证令牌……这些障碍让开发者社区需要一个新的免费替代品。

---

🧩 核心能力：52 种 AWS 服务，本地跑

Floci 不是一个"简化版 AWS"，而是尽可能追求协议级兼容的模拟器。

应用服务层：S3（对象存储）、DynamoDB（NoSQL 数据库）、SQS（消息队列）、SNS（消息通知）、Lambda（函数计算）——这些是日常开发接触最多的服务，Floci 均有完整支持。

数据服务层：RDS（关系数据库）、ElastiCache（Redis）、Neptune（图数据库）、OpenSearch（搜索引擎）——其中 Lambda、RDS、Neptune 等使用真实 Docker 容器而非代码模拟，保证行为保真度。

事件与编排：EventBridge、Step Functions、CloudWatch Logs/Metrics——完整的事件驱动编排能力。

基础设施层：API Gateway、Cognito（身份认证）、ECS/EC2/EKS（容器与虚拟机）、Secrets Manager、KMS（密钥管理）——覆盖从认证到部署的完整链路。

AI 相关特性：支持 Bedrock（Claude/GPT 模型调用）的本地模拟，以及 Athena（数据湖查询）和 MSK（Kafka 流处理），这些都是 AI 应用常用的后端服务。

---

⚡ 部署有多简单？

一行命令：

floci start
eval $(floci env)
aws s3 mb s3://my-bucket

这是最理想的情况。Floci 提供官方 CLI，安装后 floci start 自动拉取镜像、启动服务。

Docker Compose：

services:
  floci:
    build: .
    ports:
      - "4566:4566"
      - "6379-6399:6379-6399"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

对于 CI/CD 流水线或 Kubernetes 环境，直接 docker compose up 即可。多阶段 Dockerfile（Java 25 + Quarkus 构建 + Alpine JRE 运行时）也保证了镜像体积可控。

存储模式可选：内存（最快，重启丢失）、持久化（named volumes）、混合模式、WAL 日志模式，满足从快速原型到生产级测试的不同需求。

---

🔌 生态集成：SDK 和 Testcontainers 无缝接入

Floci 的核心设计哲学是"零改造接入"——你不需要改一行代码，只需要把 endpoint 指向 http://localhost:4566。

AWS SDK v2（Java）：

var client = DynamoDbClient.builder()
    .endpointOverride(URI.create("http://localhost:4566"))
    .region(Region.US_EAST_1)
    .credentialsProvider(StaticCredentialsProvider.create(
        AwsBasicCredentials.create("test", "test")))
    .build();

AWS CLI：

aws dynamodb create-table --table-name demo-table ...

Python Boto3、Node.js AWS SDK、Terraform、CDK、OpenTofu——所有主流 AWS 工具链均可直接指向 Floci，不需要任何特殊配置。docker-compose 中内置 awscli 并配置了 endpoint URL 覆盖，开箱即用。

Testcontainers 集成是另一个亮点。Floci 官方维护了 Java、Node.js、Python 三种语言的 Testcontainers 模块，每个测试用例可以启动独立的 Floci 容器实例，隔离测试环境，告别共享状态的坑。

---

🏗️ 技术架构：Java + Quarkus 的工程选择

Floci 选择 Java 25 + Quarkus 3.32 作为技术栈，这是一个务实而高效的选择：

• Quarkus 提供了极快的启动速度（GraalVM 原生编译支持）和低内存占用，适合长时间运行的服务模拟器
• 分层设计：Controller（协议解析）→ Service（业务逻辑）→ Model（领域对象），AWS JSON 11 协议和 Query 协议各有独立 Controller
• 核心基础设施：EmulatorConfig、ServiceRegistry、StorageBackend + StorageFactory、EmulatorLifecycle——这些是所有服务共用的基础设施
• 异常处理：统一的 AwsException + AwsExceptionMapper 保证所有错误响应符合 AWS 规范，不泄漏内部信息

代码质量方面：完整的 JUnit 5 测试套件、RestAssured 集成测试、详细的 AGENT.md 指导规范（连 AI 编码助手都有操作手册），说明项目维护水准较高。

---

⚖️ 与 LocalStack 的对比

特性	Floci	LocalStack 社区版
价格	完全免费	免费版功能受限
认证	无需 token	需要注册获取 token
服务数量	52+ 种	更多但部分需付费
Docker 依赖	必须	必须
Testcontainers	官方支持	社区支持
活跃度	快速增长	成熟稳定

---

🎯 谁应该用 Floci？

适用场景：

• 🚄 高铁/飞机上需要断网开发的云原生应用开发者
• 🤖 构建 AI 应用、需要调试 S3/DynamoDB/Lambda 的 AI 工程师
• 🔄 追求 CI/CD 零成本的团队（GitHub Actions 免费跑）
• 📦 Terraform/CDK IaC 脚本的本地验证
• 🎓 学习 AWS 服务但不想产生费用的学生/爱好者

不适用场景：

• 需要 LocalStack Pro 高级服务（如 X-Ray 追踪、Elasticsearch 完整功能）
• 对 AWS 模拟精度要求极高（99%+）的生产前测试
• 需要真实 GPU 资源的 AI 模型推理测试

---

📈 发展趋势

Floci 仓库在 2025 年初创建，随后快速增长至 13K+ stars，GitHub trending 多次上榜。它代表了云开发工具民主化的一个方向：让每一个开发者都能在本地完整复现云环境，而不依赖云厂商的"免费额度"或商业产品。随着 Claude/GPT 等 AI 编程工具的普及，Floci 这类"AI 友好的 AWS 沙箱"价值会更加凸显。