floci-io/floci-az

这是什么？

核心功能

• 01所有服务统一通过 4577 端口访问，无需云账号或认证令牌。
• 02Azure Functions、Event Hubs 及多种数据库引擎以真实 Docker 容器运行。
• 03兼容标准 Azure SDK，现有连接字符串和调用方式无需修改。
• 04提供内存、持久化、混合和预写日志等多种存储模式。
• 05可选在同一端口启用 HTTPS，自签名证书在运行时生成。

适用场景

• 在 CI 中对 Blob、Queue 或 Table 存储运行集成测试，无需真实 Azure 订阅。
• 使用与生产相同的 HTTP 触发器在本地开发 Azure Functions。
• 针对本地 ARM 兼容端点测试 Terraform 或 Bicep 部署。
• 离线验证 Cosmos DB SQL API 查询以及 Event Hubs 的生产者与消费者逻辑。

快速上手

1. 1

   创建包含 floci-az 服务的 docker-compose.yml 文件

2. 2

   使用 Docker Compose 启动模拟器

   docker compose up

使用前须知

• !Azure Functions 需要挂载 Docker 套接字，因此主机上需要可用的 Docker 访问权限。
• !Terraform 和 OpenTofu（azurerm）需要启用可选的 TLS 配置，默认未开启。

收录于专题

标签

常见问题

floci-az 是什么？

开源免费的本地 Azure 模拟器，在 localhost:4577 提供 Blob、Queue、Table、Functions、Cosmos DB 等兼容服务。 Floci AZ 是一个本地 Azure 模拟器，用于开发、测试和 CI 环境。它将多种 Azure 兼容服务统一放在同一端口，现有的 Azure SDK、CLI 或 Terraform 配置只需指向 http://localhost:4577 即可使用，无需云账号、认证令牌或付费功能。

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

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

floci-az 还在维护吗？

活跃维护中。floci-az 最近一次提交是在 2026年11月5日。

floci-az 适合用来做什么？

在 CI 中对 Blob、Queue 或 Table 存储运行集成测试，无需真实 Azure 订阅。 使用与生产相同的 HTTP 触发器在本地开发 Azure Functions。 针对本地 ARM 兼容端点测试 Terraform 或 Bicep 部署。 离线验证 Cosmos DB SQL API 查询以及 Event Hubs 的生产者与消费者逻辑。

floci-az 怎么安装和运行？

创建包含 floci-az 服务的 docker-compose.yml 文件 使用 Docker Compose 启动模拟器: docker compose up

在哪里获取 floci-az？

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