概要
Floci は、無料でオープンソースの ローカルAWSエミュレータ。 LocalStack Community のサポート終了を受け、 認証不要・CI制限なし を強みとする代替案。 高速起動・低メモリ消費・軽量イメージ を実現。 20以上のAWSサービス をサポートし、 MITライセンス で自由に利用可能。 docker compose up で即座に利用開始。
Flociとは
- floccus雲 (ポップコーン状の雲)に由来する、 軽量・無料・OSS なローカルAWSエミュレータ
- LocalStack Community Edition のサンセット(2026年3月)後の 制限回避 を目的とした選択肢
- 認証トークン不要、 CI/CD制限なし、 セキュリティアップデート継続
- docker compose up だけで即利用可能な手軽さ
FlociとLocalStackの比較
- 認証トークン :Flociは不要、LocalStackは2026年3月以降必須
- CI/CDサポート :Flociは無制限、LocalStackは有料プラン必須
- セキュリティアップデート :Flociは継続、LocalStackは凍結
- 起動時間 :Flociは約24ms、LocalStackは約3.3秒
- アイドル時メモリ :Flociは約13MiB、LocalStackは約143MiB
- Dockerイメージサイズ :Flociは約90MB、LocalStackは約1.0GB
- ライセンス :FlociはMIT、LocalStackは制限付き
サポートサービス
- API Gateway v2 / HTTP API、 Cognito、 ElastiCache(Redis + IAM認証)
- RDS(PostgreSQL + MySQL + IAM認証)、 S3 Object Lock(COMPLIANCE / GOVERNANCE)
- DynamoDB Streams、 IAM(ユーザー、ロール、ポリシー、グループ)
- STS(全7操作)、 Kinesis(ストリーム、シャード、ファンアウト)
- KMS(署名、検証、再暗号化)
- 20以上のサービスサポート、全408件のSDKテスト合格
クイックスタート
- docker-compose.yml 例
- サービス名:floci
- イメージ:hectorvent/floci:latest
- ポート:4566
- ボリューム:./data:/app/data
- 起動方法 :docker compose up
- アクセスURL :http://localhost:4566
- 任意のAWSリージョン・クレデンシャル利用可能
- 環境変数設定例
- AWS_ENDPOINT_URL=http://localhost:4566
- AWS_DEFAULT_REGION=us-east-1
- AWS_ACCESS_KEY_ID=test
- AWS_SECRET_ACCESS_KEY=test
- 環境変数設定例
- AWS CLI操作例
- aws s3 mb s3://my-bucket
- aws sqs create-queue --queue-name my-queue
- aws dynamodb list-tables
SDK連携例
- Java(AWS SDK v2)
- DynamoDbClient.builder().endpointOverride(URI.create("http://localhost:4566"))
- Python(boto3)
- boto3.client("s3", endpoint_url="http://localhost:4566", region_name="us-east-1", aws_access_key_id="test", aws_secret_access_key="test")
- Node.js(AWS SDK v3)
- new S3Client({ endpoint: "http://localhost:4566", region: "us-east-1", credentials: { accessKeyId: "test", secretAccessKey: "test" }, forcePathStyle: true })
イメージタグ
- latest :ネイティブイメージ(推奨、サブ秒起動)
- latest-jvm :JVMイメージ(幅広いプラットフォーム対応)
- x.y.z / x.y.z-jvm :ピン留めリリース
設定方法
- 全設定項目は環境変数(FLOCI_プレフィックス)で上書き可能
- QUARKUS_HTTP_PORT(デフォルト4566):HTTPポート
- FLOCI_DEFAULT_REGION(デフォルトus-east-1):AWSリージョン
- FLOCI_DEFAULT_ACCOUNT_ID(デフォルト000000000000):AWSアカウントID
- FLOCI_STORAGE_MODE(デフォルトhybrid):ストレージモード(memory、persistent、hybrid、wal)
- FLOCI_STORAGE_PERSISTENT_PATH(デフォルト./data):データディレクトリ
- 詳細は公式ドキュメント参照
ライセンス
- MITライセンス :商用・非商用問わず自由利用可能