floci

本地开发时，你是否曾为「只用一下 AWS S3」就得开个云账号、配置权限、担心账单而头疼？Floci 正是来解决这个痛点的——它是一个完全免费、开源的本地 AWS 模拟器，让你直接在电脑上跑起 52 种 AWS 服务的模拟版本，不用联网，不用注册，不用付费。

背景故事：LocalStack 社区版「关门」后的开源新选择

Floci 的诞生有很强的时代背景。2025 年 3 月，长期作为 LocalStack 社区替代方案的 LocalStack 社区版宣布停运，要求用户注册并获取认证 Token，同时冻结了安全更新。这一变化在 DevOps 圈引发了不少讨论——很多开发者需要一个真正免费、无限制的本地 AWS 模拟工具。

floci-io/floci 项目在此时接棒，由开源社区接力维护，旨在填补这个空白。Floci 名称来源于「floccus」（卷云），logo 也采用了轻飘飘的云朵形象，定位就是「轻盈、免费、永远开源」。项目用 Java/Quarkus 构建，核心定位是替代 LocalStack，面向需要本地 AWS 环境的开发者、CI/CD 流水线、以及教学演示场景。

类比理解：给开发者用的「本地 AWS 副本」

把 Floci 想象成一个装在你电脑里的 AWS 数据中心镜像。它完全复刻了 AWS 的接口协议，你现有的 AWS SDK、CLI 命令、Terraform 配置、CDK 代码都可以无缝指向本地地址 http://localhost:4566，就像换了一个端点而已。

比如原本上传文件到 S3 的命令：

aws s3 mb s3://my-bucket

在 Floci 环境下不需要任何修改，只要设置好本地端点就能工作。这让本地测试和真实云环境之间的迁移成本几乎为零。

核心功能：52 种 AWS 服务，全部本地运行

Floci 支持 52 种 AWS 服务，覆盖范围极广：

• 存储与数据库：S3、DynamoDB、RDS（PostgreSQL/MySQL/MariaDB）、ElastiCache（Redis）、Neptune（图数据库）
• 消息队列：SQS、SNS、EventBridge、Scheduler
• 无服务器计算：Lambda（真实 Docker 容器执行）、API Gateway v1/v2、Step Functions
• 身份与安全：IAM、STS、Cognito、KMS、Secrets Manager、SSM
• 数据分析：Kinesis、Firehose、OpenSearch
• 容器服务：ECS、EC2、EKS（真实 Docker 支撑，不是浅层模拟）
• 构建服务：CodeBuild（真实 Docker 执行）
• 其他：SES、S3、CloudFormation、CloudWatch 等

其中很多服务（Lambda、ECS、EC2、EKS、RDS、Neptune、ElastiCache、MSK、CodeBuild）使用真实 Docker 容器执行，而非传统模拟器的浅层 Stub，这是 Floci 相对于早期 LocalStack 社区版的重大优势——测试结果更接近真实云环境。 图1：Floci 支持的 AWS 服务概览

技术架构：Quarkus + JAX-RS + Vert.x 的高性能组合

从项目源码分析，Floci 的技术栈非常明确：

后端核心：

• Quarkus 3.34.6（Java 生态的现代化框架，支持 GraalVM Native Image）
• JAX-RS / RESTEasy Reactive（高性能 REST API 框架）
• Vert.x（异步网络通信层，用于 WebSocket 支撑 Neptune Gremlin 协议等）

存储层：

• Redis（ElastiCache 模拟）
• Elasticsearch（OpenSearch 模拟）
• PostgreSQL / MySQL / MariaDB（RDS 模拟）
• SQLite / RocksDB（DynamoDB 本地模拟）
• JSON 文件存储（Jackson 序列化，S3 后端）

部署架构：Quarkus HTTP Router 统一入口，Stateless Services（SSM、SQS、IAM 等无状态服务）和 Stateful Services（需要持久化存储的 RDS、DynamoDB 等）分层处理。Native Image 模式下启动仅需 ~24ms，空闲内存约 13MiB，远优于 LocalStack 约 143MiB 的表现。

上手体验：两种方式，最快 1 分钟跑起来

方式一：CLI 一键启动（推荐）

# 安装 floci CLI
curl -fsSL https://floci.io/install.sh | sh

# 一键启动
floci start

# 自动配置 AWS 环境变量
export $(floci env | xargs)

# 直接使用 aws cli
aws s3 mb s3://my-bucket

方式二：Docker Compose

services:
  floci:
    image: floci/floci:latest
    ports:
      - "4566:4566"

docker compose up

两种方式都不需要注册账号、不需要认证 Token，凭证可以是任意非空字符串（测试用途）。Native binary（约 40MB）启动速度快到可以直接用于 CI 流水线，每次测试都从干净状态开始。

局限性：不避讳的坦诚分析

1. 没有 Web UI：LocalStack 提供了一个 Web 控制面板，Floci 目前只有 CLI 和 API，这对习惯图形界面的用户来说是个门槛
2. 真实 Docker 依赖：Lambda、ECS 等服务依赖宿主机 Docker，在没有 Docker 的环境（如某些 CI 容器）中无法使用这些高级功能
3. S3 模拟限制：使用 JSON 文件存储而非真实对象存储，大文件场景下性能与真实 S3 有差距
4. Java 生态绑定：核心是 Java 项目，对非 JVM 技术栈的团队来说维护成本略高
5. 新项目稳定性：2025-2026 年新崛起，长期社区维护的稳定性还有待验证

行业意义：开源云模拟的新时代

Floci 的出现标志着本地云模拟工具进入了一个新阶段。从 2023 年以前 LocalStack 的一家独大，到 2026 年 Floci 的快速崛起，社区正在用开源的方式维护一个真正「无锁」的云开发工具。

关键趋势：真实 Docker 执行正在取代浅层 Stub，使得本地测试的保真度大幅提升；Native Image 技术的应用让冷启动时间从秒级压缩到毫秒级，使得在 CI 中运行完整集成测试成为可能。

对于 AI 开发者而言，Floci 特别有价值：AI 应用的存储、消息队列、身份认证等基础设施往往依赖 AWS 服务，本地开发时用 Floci 可以完全离线运行，大幅缩短调试周期。