Firebase 代理服务 v1.0.0

服务概述

Firebase代理服务是一个基于Cloudflare Workers构建的高性能代理，专为解决Firebase服务在特定网络环境下的访问限制而设计。此服务支持Firebase的所有产品线，包括Firebase Auth、Realtime Database、Storage、Functions等。

API端点

授权认证

为了保护代理服务不被滥用，所有请求需要提供有效的API密钥作为auth查询参数。例如：

https://your-worker.workers.dev/www.gstatic.com/firebasejs/9.22.0/firebase-app-compat.js?auth=your-api-key

API密钥应当保密，不应在公开场合分享。在生产环境中，建议经常更换API密钥并限制允许的请求来源。

使用示例

基本用法

以下是在客户端使用代理服务的基本示例：

// 定义代理配置
const PROXY_URL = "https://your-worker.workers.dev";
const AUTH_KEY = "";

// 导入Firebase SDK
document.write(`<script src="${PROXY_URL}/www.gstatic.com/firebasejs/9.22.0/firebase-app-compat.js?auth=${AUTH_KEY}"></script>`);
document.write(`<script src="${PROXY_URL}/www.gstatic.com/firebasejs/9.22.0/firebase-auth-compat.js?auth=${AUTH_KEY}"></script>`);

// 初始化Firebase
window.onload = function() {
  firebase.initializeApp({
    apiKey: "YOUR_API_KEY",
    authDomain: "YOUR_PROJECT_ID.firebaseapp.com",
    databaseURL: `${PROXY_URL}/YOUR_PROJECT_ID-default-rtdb.firebaseio.com?auth=${AUTH_KEY}`,
    projectId: "YOUR_PROJECT_ID",
    storageBucket: `${PROXY_URL}/YOUR_PROJECT_ID.appspot.com?auth=${AUTH_KEY}`,
    messagingSenderId: "YOUR_MESSAGING_SENDER_ID",
    appId: "YOUR_APP_ID"
  });
  
  // 现在可以正常使用Firebase服务
  firebase.auth().onAuthStateChanged(function(user) {
    console.log("Auth state changed:", user);
  });
};

Firebase模块化SDK (v9+)

如果使用现代的模块化SDK，示例如下：

// 定义代理配置
const PROXY_URL = "https://your-worker.workers.dev";
const AUTH_KEY = "";

// 异步导入Firebase模块
import { initializeApp } from `${PROXY_URL}/www.gstatic.com/firebasejs/9.22.0/firebase-app.js?auth=${AUTH_KEY}`;
import { getAuth, onAuthStateChanged } from `${PROXY_URL}/www.gstatic.com/firebasejs/9.22.0/firebase-auth.js?auth=${AUTH_KEY}`;

// 初始化Firebase
const app = initializeApp({
  apiKey: "YOUR_API_KEY",
  authDomain: "YOUR_PROJECT_ID.firebaseapp.com",
  databaseURL: `${PROXY_URL}/YOUR_PROJECT_ID-default-rtdb.firebaseio.com?auth=${AUTH_KEY}`,
  projectId: "YOUR_PROJECT_ID",
  storageBucket: `${PROXY_URL}/YOUR_PROJECT_ID.appspot.com?auth=${AUTH_KEY}`,
  messagingSenderId: "YOUR_MESSAGING_SENDER_ID",
  appId: "YOUR_APP_ID"
});

// 使用Firebase服务
const auth = getAuth(app);
onAuthStateChanged(auth, (user) => {
  console.log("Auth state changed:", user);
});

配置选项

代理服务提供以下配置选项，管理员可以修改CONFIG对象来自定义服务行为：