goatlab/firebase-emulator

Goat - Firebase Emulator

即开即用的Firebase模拟器基础镜像，适用于本地开发和测试Firebase服务。可通过默认配置快速启动，也支持自定义配置以满足特定开发需求。 源码文件参见https://github.com/goat-io/fluent/tree/master/packages/dev/Database/Firebase%E3%80%82

核心功能和特性

• 默认启用所有Firebase模拟器，包含完整的默认配置
• 提供Web UI界面，便于管理和监控模拟器状态
• 支持通过自定义Dockerfile或挂载卷进行配置定制
• 兼容Docker和Docker Compose部署方式

使用场景和适用范围

• Firebase应用的本地开发环境搭建
• Firebase服务（如Firestore、Realtime Database、Cloud Functions等）的离线测试
• 团队协作时的统一开发环境配置

使用方法和配置说明

Docker 快速启动

若无需自定义任何服务配置，可直接通过docker run命令启动：

bash
docker run goatlab/firebase-emulator:latest -p 5000:5000 -p 5002:5001 -p 8080:8080 -p 8085:8085 -p 9099:9099 -p 9000:9000 -p 4500:4500 -p 4400:4400 -p 4001:3000 -p 4000:4000

启动结果

启动成功后，访问 localhost:4000 即可打开Firebase模拟器UI界面。

Docker Compose 部署

可使用以下docker-compose配置示例启动模拟器：

yaml
version: '3.1'
services:
  #######################################################
  #  Firebase 模拟器
  #######################################################
  firebase:
    image: goatlab/firebase-emulator:latest
    ports:
      - 5000:5000  # Firebase Hosting
      - 5002:5001  # Cloud Functions
      - 8080:8080  # Cloud Firestore
      - 8085:8085  # Cloud Pub/Sub
      - 9000:9000  # Realtime Database
      - 4001:3000  # UI端口
      - 4000:4000  # UI端口
    command: 'firebase emulators:start --project test'
    tty: true
    restart: unless-stopped
    networks:
      - fire-network
networks:
  fire-network:
    driver: bridge

启动命令：

bash
docker-compose up --build firebase

自定义配置

通过创建自定义Dockerfile，基于此镜像添加自定义配置文件。可将配置文件复制到容器内的/app目录，或挂载卷到/app目录（根据实际需求选择）。

自定义Dockerfile示例：

Dockerfile
FROM goatlab/firebase-emulator:latest

# 复制自定义配置文件到/app目录
COPY ./startfirebase.json /app/firebase.json
COPY ./firestore.indexes.json /app/firestore.indexes.json
COPY ./firestore.rules /app/firestore.rules
COPY ./database.rules.json /app/database.rules.json
COPY ./storage.rules /app/storage.rules
# 复制函数代码和静态资源
COPY ./functions /app/functions
COPY ./public /app/public

构建并运行自定义镜像：

bash
docker build -t my-firebase-emulator .
docker run my-firebase-emulator

Docker Compose 中使用自定义镜像

若使用docker-compose，需将配置中的image替换为build配置，指定自定义Dockerfile路径：

yaml
firestore:
  build:
    context: .
    dockerfile: ./Dockerfile  # 指向自定义Dockerfile路径
  ports:
    # 端口映射配置...
  # 其他配置...