# @clerk/backend-core 中文文档

规范地址：https://npmcn.com/package/%40clerk/backend-core/

版本：2\.13\.2
npm 元数据更新时间：2026-07-13T16:52:28.699Z
中文译文更新时间：2026-11-10T01:10:50.603Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40clerk/backend-core
原文对照：https://npmcn.com/package/%40clerk/backend-core/?lang=original
项目主页：https://clerk.dev/
源码仓库：https://github.com/clerkinc/javascript

弃用说明：This package has been deprecated - use @clerk/backend instead

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

- 包体积（解压后）：589 kB，351 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=14
- 运行依赖：8 个
- 首次发布：2022-01-20T09:53:38.484Z
- 最新版本发布：2023-01-20T08:02:59.882Z
- 近 30 天下载量：8826（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：228（近 12 个月 0 个）

## 中文简介

办事员后端API核心资源和JavaScript环境的认证工具.

## 安装

```sh
npm install @clerk/backend-core
```

也可以使用：`pnpm add @clerk/backend-core`、`yarn add @clerk/backend-core`、`bun add @clerk/backend-core`

## README

[![](https://images.clerk.dev/static/logo-light-mode-400x400.png)](https://clerk.dev/?utm_source=github&utm_medium=clerk_backend_core)  

# @ clerk/ 后端核心

[![Chat on Discord](https://img.shields.io/discord/856971667393609759.svg?logo=discord)](https://discord.com/invite/b5rXHjAg7A) [![Clerk documentation](https://img.shields.io/badge/documentation-clerk-green.svg)](https://clerk.dev/docs?utm_source=github&utm_medium=clerk_backend_core) [![Follow on Twitter](https://img.shields.io/twitter/follow/ClerkDev?style=social)](https://twitter.com/intent/follow?screen_name=ClerkDev)

[更改日志](https://github.com/clerkinc/javascript/blob/main/packages/backend-core/CHANGELOG.md) • 妇女 [报告错误](https://github.com/clerkinc/javascript/issues/new?assignees=&labels=bug&template=bug_report.md&title=Bug%3A+) • 妇女 [请求特性](https://github.com/clerkinc/javascript/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=Feature%3A+) • 妇女 [问一个问题](https://github.com/clerkinc/javascript/issues/new?assignees=&labels=question&template=ask_a_question.md&title=Support%3A+)

* * *

# 折旧警告

这个软件包已经贬值了,有利于异形 [`@clerk/backend`](https://github.com/clerkinc/javascript) 它现在用于所有服务器启用的办事员软件包。 此软件包今后不会收到任何更新 。 不应直接使用----请仅作为参考.

## 概览

此软件包为 Clave 后端 API 提供了核心资源,并为 JavaScript 环境提供了低级认证功能. 它大多被作为其他Clear SDK的基地.

## 开始

### 安装

```sh
npm install @clerk/backend-core
```

### 构建

要用 TypeScript 编译器在本地构建软件包, 请运行 :

```sh
npm run build
```

## 建筑

`@clerk/backend-core` 包含基本办事员功能的所有逻辑,而不作为平台/环境,具体包括:

-   确定会话的认证状态 .
-   正在验证一个办事员标志状态 .
-   办事员 API 资源管理.

### 如何运作

此软件包被作为Clave JavaScript SDK和环境的基础构件. 如果客户只执行一些针对环境的公用事业,则通过提供所需的所有业务逻辑来实现这一点.

[![](https://images.clerk.dev/static/backend_api_architecture.png)](https://clerk.dev/)  

实质上,客户应在办事员中提供这些关键职能 [基础](https://npmcn.com/package/%40clerk/backend-core/src/Base.ts#47) 财务报告和审定财务报表 [办事员备份Api](https://npmcn.com/package/%40clerk/backend-core/src/api/ClerkBackendApi.ts) 类 :

1.  公钥导入 `importKeyFunction`。 。 。 .
2.  JWT 签字核查 `verifySignatureFunction`。 。 。 .
3.  Base64 解码 `decodeBase64Function`。 。 。 .
4.  HTTP 获取 API 资源管理的工具 `ClerkFetcher`。 。 。 .

在提供这些在 `Base` 财务报告和审定财务报表 `ClerkBackendApi` 类,您可以使用 SDK 业务逻辑所需的所有办事员公用事业.

## 使用量

### 为新的 SDK 创建基础

```ts
const importKey = async (jwk: JsonWebKey, algorithm: Algorithm) => {
  //  ...
};

const verifySignature = async (algorithm: Algorithm, key: CryptoKey, signature: Uint8Array, data: Uint8Array) => {
  // ...
};

const decodeBase64 = (base64: string) => {
  // ...
};

/** Base initialization */
const examplePlatformBase = new Base(importKey, verifySignature, decodeBase64);
```

创建后 `Base` 例如:

```ts
examplePlatformBase.verifySessionToken(...);

examplePlatformBase.getAuthState(...);
```

这个 `Base` 公用事业包括开发目标平台所需的任何额外逻辑和中间软件的构件.

### 验证会议标志的核准缔约方

办事员的JWT会话代号,包含azp请求,在代号生成时等于请求的起源. 您可以提供一份白名单的来源清单, 用于在每次象征性的验证中进行验证, 以保护您对子域饼干泄漏攻击的应用。 以下为例:

```ts
const authorizedParties = ['http://localhost:3000', 'https://example.com'];

examplePlatformBase.verifySessionToken(token > { authorizedParties });
```

### API 资源

API 资源管理也由该软件包通过 [办事员备份Api](https://npmcn.com/package/%40clerk/backend-core/src/api/ClerkBackendApi.ts) 课。 有关API 资源的更多信息,请查看 [资源文件页面](https://reference.clerk.dev/reference/backend-api-reference)。 。 。 .

要在 JavaScript 平台上使用 Clave 后端 API 包装器, 您需要提供一些特定的 SDK 信息和 HTTP 获取工具 。 看见更多在 [办事员后端 APIProps](https://npmcn.com/package/%40clerk/backend-core/src/api/ClerkBackendApi.ts#17) 执行.

## 支助

你可以以下列任何方式与我们联系:

-   加入我们的官方社团 [Discord 服务器](https://discord.com/invite/b5rXHjAg7A)
-   打开 a [GitHub 支持问题](https://github.com/clerkinc/javascript/issues/new?assignees=&labels=question&template=ask_a_question.md&title=Support%3A+)
-   列出的联系选项 [我们的支持页面](https://clerk.dev/support?utm_source=github&utm_medium=clerk_backend_core)

## 捐款

我们欢迎所有社区的贡献! 如果你想以任何方式作出贡献,请阅读 [我们的捐款准则](https://github.com/clerkinc/javascript/blob/main/packages/backend-core/docs/CONTRIBUTING.md)。 。 。 .

## 警卫

`@clerk/backend-core` 遵循安全方面的良好做法,但不能保证100%的安全.

`@clerk/backend-core` 提供 **"就这样"** 没有 **保证**. 冒险使用.

_欲了解更多信息并报告安全问题,请参见我们 [安全记录](https://github.com/clerkinc/javascript/blob/main/packages/backend-core/docs/SECURITY.md)。 。 。 ._

## 许可证

本项目根据以下规定获得许可证: **麻省理工学院许可证**。 。 。 .

见 [自由主义](https://github.com/clerkinc/javascript/blob/main/packages/backend-core/LICENSE) 更多信息.

## 常见问题

### @clerk/backend-core 是什么？

办事员后端API核心资源和JavaScript环境的认证工具\.注意：该包已被作者标记为弃用——This package has been deprecated - use @clerk/backend instead

### 如何安装 @clerk/backend-core？

在项目目录运行 npm install @clerk/backend-core，或使用 pnpm add / yarn add / bun add。

### @clerk/backend-core 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/clerk\_\_backend-core 是否存在。

### @clerk/backend-core 支持 ESM 还是 CommonJS？

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

### @clerk/backend-core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=14。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @clerk/backend-core 可以商用吗？

@clerk/backend-core 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @clerk/backend-core 的下载量有多少？

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

### @clerk/backend-core 还在维护吗？

最新版本 2\.13\.2 发布于 2023/01/20（3 年前）；至今共发布 228 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/01/20。作者已将其标记为弃用，新项目建议寻找替代方案。