# @aglyn/shared-util-fbserver 中文文档

规范地址：https://npmcn.com/package/%40aglyn/shared-util-fbserver/

版本：1\.19\.0
npm 元数据更新时间：2026-11-07T14:00:19.864Z
中文译文更新时间：2026-11-05T22:02:21.306Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aglyn/shared-util-fbserver
原文对照：https://npmcn.com/package/%40aglyn/shared-util-fbserver/?lang=original
项目主页：https://aglyn.com/
源码仓库：https://github.com/aglyn/aglyn

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：33.7 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：firebase-admin ^14\.3\.0
- 首次发布：2026-09-20T23:54:40.016Z
- 最新版本发布：2026-11-07T14:00:19.535Z
- 近 30 天下载量：14260（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：160（近 12 个月 160 个）

## 中文简介

服务器端 Firebase 管理员: 初始化的模块 `firebase-admin` 从环境变量中默认应用并曝光 Firestore 和 Auth 访问器。 它主要是Aglyn服务器端数据层(QQAglyn/tena)的内部构件

## 安装

```sh
npm install @aglyn/shared-util-fbserver
```

也可以使用：`pnpm add @aglyn/shared-util-fbserver`、`yarn add @aglyn/shared-util-fbserver`、`bun add @aglyn/shared-util-fbserver`

## README

# @aglyn/ shared- util- fbserver (韩语)

服务器端 Firebase 管理员: 初始化的模块 `firebase-admin` 从环境变量中默认应用并曝光 Firestore 和 Auth 访问器。 它主要是Aglyn服务器侧数据层的内部构件(Aglyn)`@aglyn/tenant-data-admin`); 只有当您想要在自己的节点进程中使用相同的靴子时,才直接安装.

> 从Aglyn monorepo出版到npm. 随后的版本 [语义版本](https://semver.org/)。 。 。 .

## 安装

```
npm install @aglyn/shared-util-fbserver
```

同伴依赖 : `firebase-admin` (单位:千美元)`^14.3.0`) (中文(简体) ).

## 里面有什么东西

单一模块, `src/lib/fbserver`,从包根再导出:

-   `fbAdmin` (亦为默认导出) - 模块化的Admin SDK上的小外观:
    -   `fbAdmin.firestore(app?)` 返回 Firestore 实例; `fbAdmin.firestore.FieldValue` 财务报告和审定财务报表 `fbAdmin.firestore.Timestamp` 是行政SDK课程.
    -   `fbAdmin.auth(app?)` 返回 Auth 服务.
-   `fbAdminApp` - 初始化项目 `App`,或 `undefined` 当初始化被跳过时.
-   `verifyIdToken(idToken)` - 核实一个消防基地的标识牌 并随时检查吊销.
-   `firestoreDatabaseId()` - 读 `FIRESTORE_DATABASE_ID`; 设定时, `fbAdmin.firestore()` 目标命名数据库而不是 `(default)`。 。 。 .

### 它在导入时初始化

导入此包会运行靴子夹 。 如果 Firebase app 已经存在, 它会被重用 。 否则,该模块为:

| 变量 | 需求 | 目的 |
| --- | --- | --- |
| `NEXT_PUBLIC_FIREBASE_PROJECT_ID` | 对 | 项目编号 |
| `FIREBASE_CLIENT_EMAIL` | 对 | 服务账户电子邮件 |
| `FIREBASE_PRIVATE_KEY` | 对 | 服务账户密钥; 文字 `\n` 序列转换为新行 |
| `NEXT_PUBLIC_FIREBASE_DATABASE_URL` | 没有 | 实时数据库 URL |
| `FIRESTORE_DATABASE_ID` | 没有 | 名为 Firestore 的数据库,在呼叫时读取 |

如果缺少所需的三个变量中的任何一个,则静悄悄地跳过初始化,以便仅加载模块的构建步骤不会崩溃。 这件事情没有初始化 稍后 `fbAdmin.firestore()` 或者说 `fbAdmin.auth()` 调用失败, 除非您自己初始化默认应用 .

`package.json` 列表 `./src/lib/fbserver.*` 下级 `sideEffects`。这告诉捆绑者,即使似乎没有使用任何输入,进口也必须保留,因为进口本身就是应用程序的初始化。 对于消费者来说,意思是:这是一个只使用服务器的模块,具有导入时间效应. 永远不要从可以到达浏览器捆绑的代码中导入它,并期望应用程序在模块加载的时刻存在(或被跳过).

## 使用量

```ts
import fbAdmin, { verifyIdToken } from '@aglyn/shared-util-fbserver'

const decoded = await verifyIdToken(idToken)
const snap = await fbAdmin.firestore().doc(`users/${decoded.uid}`).get()
const now = fbAdmin.firestore.Timestamp.now()
```

## 怎样才合适

A 类 `shared` 软件包:通用,对Aglyn的模型一无所知,它没有进口其他Aglyn软件包。 共享软件包可能只导入其他共享软件包,它们没有插件的域名. 在单体中,它被 `@aglyn/tenant-data-admin`,行政SDK数据层.

## 许可证

阿帕奇2.0 (英语). 资料来源: [https://github.com/aglyn/aglyn/tree/main/libs/shared/util/fbserver 页面存档备份,存于互联网档案馆](https://github.com/aglyn/aglyn/tree/main/libs/shared/util/fbserver)

## 常见问题

### @aglyn/shared-util-fbserver 是什么？

服务器端 Firebase 管理员: 初始化的模块 firebase-admin 从环境变量中默认应用并曝光 Firestore 和 Auth 访问器。 它主要是Aglyn服务器端数据层\(QQAglyn/tena\)的内部构件

### 如何安装 @aglyn/shared-util-fbserver？

在项目目录运行 npm install @aglyn/shared-util-fbserver，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：firebase-admin（^14\.3\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aglyn/shared-util-fbserver 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aglyn/shared-util-fbserver 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aglyn/shared-util-fbserver 可以商用吗？

@aglyn/shared-util-fbserver 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aglyn/shared-util-fbserver 的下载量有多少？

根据 npm 官方下载统计，@aglyn/shared-util-fbserver 在 2026/10/05 – 2026/11/03 这 30 天内被下载 14,260 次，日均约 475 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aglyn/shared-util-fbserver 还在维护吗？

最新版本 1\.19\.0 发布于 2026/11/07（今天）；至今共发布 160 个版本，其中过去 12 个月发布了 160 个；首次发布于 2026/09/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。