motomotomato/firestore-emulator

docker-firestore-emulator

!GitHub tag (with filter) https://github.com/toms74209200/docker-firestore-emulator/actions/workflows/build_image.yml/badge.svg](https://github.com/toms74209200/docker-firestore-emulator/actions/workflows/build_image.yml)

镜像概述和主要用途

Firestore Emulator的Docker镜像，旨在为本地开发和测试提供便捷的Firestore数据库模拟环境，无需连接真实Firebase服务。通过该镜像，开发者可快速搭建本地Firestore测试环境，进行应用开发和功能验证。

核心功能和特性

• 本地模拟：无需真实Firebase账号，在本地模拟Firestore数据库功能
• 配置灵活：支持从主机挂载配置文件（默认挂载目录为/firestore）
• 端口映射：默认使用8080端口提供Firestore服务，可通过端口映射暴露到主机
• Emulator UI支持：指定项目ID后可启用Emulator UI（默认端口4000），便于可视化管理
• 轻量部署：支持通过docker run命令或docker-compose快速部署

使用场景和适用范围

• 本地开发Firestore相关应用时的环境搭建
• 单元测试和集成测试中模拟Firestore数据库交互
• 无需访问互联网即可进行Firestore功能验证
• 保护敏感数据，避免在测试环境中使用真实Firebase服务

使用方法和配置说明

基本使用

通过docker run命令启动容器，挂载本地目录作为配置文件目录，并映射8080端口：

bash
$ docker run --rm -p8080:8080 -v$(pwd):/firestore motomotomato/firestore-emulator
┌─────────────────────────────────────────────────────────────┐
│ ✔  All emulators ready! It is now safe to connect your app. │
└─────────────────────────────────────────────────────────────┘

┌───────────┬──────────────┐
│ Emulator  │ Host:Port    │
├───────────┼──────────────┤
│ Firestore │ 0.0.0.0:8080 │
└───────────┴──────────────┘

验证启动状态

启动后，可通过访问http://localhost:8080验证服务是否正常运行：

bash
$ curl http://localhost:8080
OK

启用Emulator UI

需指定项目ID以启用Emulator UI，同时映射4000端口：

bash
$ docker run --rm -p8080:8080 -p4000:4000 -v$(pwd):/firestore motomotomato/firestore-emulator "emulators:start" "--only" "firestore" "--project" "demo"
┌─────────────────────────────────────────────────────────────┐
│ ✔  All emulators ready! It is now safe to connect your app. │
│ i  View Emulator UI at http://127.0.0.1:4000/               │
└─────────────────────────────────────────────────────────────┘

┌───────────┬──────────────┬─────────────────────────────────┐
│ Emulator  │ Host:Port    │ View in Emulator UI             │
├───────────┼──────────────┼─────────────────────────────────┤
│ Firestore │ 0.0.0.0:8080 │ http://127.0.0.1:4000/firestore │
└───────────┴──────────────┴─────────────────────────────────┘

docker-compose配置

通过docker-compose.yml配置文件部署：

yaml
services:
  firestore:
    image: motomotomato/firestore-emulator
    command: ["emulators:start", "--only", "firestore", "--project", "demo"]
    ports:
      - "8080:8080"
      - "4000:4000"
    volumes:
      - .:/firestore

参考资料

• Firebase Local Emulator Suite 简介
  [***]

许可证

MIT License

作者

https://github.com/toms74209200