# @blitzjs/auth 中文文档

规范地址：https://npmcn.com/package/%40blitzjs/auth/

版本：3\.0\.2
npm 元数据更新时间：2025-09-11T13:04:04.576Z
中文译文更新时间：2026-11-08T06:57:51.110Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：223 kB，27 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：21 个
- peer 依赖：blitz 3\.0\.2，next \*，next-auth \*，secure-password 4\.0\.0
- 首次发布：2022-04-15T00:32:17.455Z
- 最新版本发布：2025-09-11T13:04:04.328Z
- 近 30 天下载量：64406（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：176（近 12 个月 0 个）

## 中文简介

[![Blitz.js](https://raw.githubusercontent.com/blitz-js/art/master/github-cover-photo.png)](https://blitzjs.com/)

## 安装

```sh
npm install @blitzjs/auth
```

也可以使用：`pnpm add @blitzjs/auth`、`yarn add @blitzjs/auth`、`bun add @blitzjs/auth`

## README

[![Blitz.js](https://raw.githubusercontent.com/blitz-js/art/master/github-cover-photo.png)](https://blitzjs.com/)

 [![](https://img.shields.io/badge/Join%20our%20community-6700EB.svg?style=for-the-badge&labelColor=000000&logoWidth=20&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAYAAADDPmHLAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAQ9SURBVHgB7d3dVdtAEIbhcSpICUoH0IEogQqSVBBSAU4FSSpIOoAORAfQgSghHXzZ1U/YcMD4R9rZmf2ec3y448LyiNf27iLiGIAmPLrweC9Un3DhrzG6EarLNP09nlwJ1SOZ/lQr5N80/S/p2QMVCBf5N17XCfm1Y/rBHqjAG9PPHvBsz+mf9WAP+HLA9M/YA14cOP2payH7jpj+VCtk1wnTP+vj7xCy6cTpn7EHLMLp059iD1iD8eveJbVCNsSLheX1YA/YgOWnf8YeKB3Wmf7Ud6Fy4f/FHmtpxbl3YlC4MJ/Cj0bWdwPnPbARg+L0S54XQHS32WwuxClzd4CM0z9rPfeAuTtA5ulPXYQ7wZ04Y+oOoDD9KZc9YOoOoDj9s4dwFzgXR6w1wIPoOvPWA9buAHEJ173o3gWiy3AnuBUHLEbgmYwvAk1/wuM8vAgexThzbwPDkx7/DHwVXfFOxP2GmsKd4Ab6zPeAyU8CI7AHFmH2BRCBPXAyk18GzUrqAXCTiR4ssyj0VFw/oCU8+e+RZ33AWz6KMaYbIIWxB+JSLs1bsbkeMN0AqakHvoku9oA2sAfqBvbAQdw0QArsgb25aYBUQT3QgT2gB+yBuqGcHij2UCqXDZACe2Anlw2QYg/QAOyBuoE98CL3DZDCuK4/rh/Q7oGL6U+TOvcNkJoijN8X1C48+T+g75eQDrAH/qmqAVJgDwyqaoAUe4AGYA/UDZX3QLUNkEIZPRCd5+6BahsgVUgPROwBTSijB7jpVAvGHriHvmw9wAZ4BpX1ABvgmakHtPcbRuwBTWAPULgAV9D/jKDY9YRvwvgEaurD44uQHvAol7qBW7WKluVtIHiUS7GyvA0s6CiXDnxrpQfsgbqBS7GKk/2jYHCrVlGyfxTMrVo0ALdq1Q3sgSKofh0M9oA61a+D2QM0AHugbmAPqClmSRjK2apVVQ8UsySsoK1aHdgDesCtWnUDeyCrIpeFg1u3sylyWTi3btMA7IG6gT2wuuK3hoE9sKrit4YVslWLPaAN7IG6ocKt2zmY2h4O9sDiTG0PZw/QANy6XTewBxZj9ogYVHy025LMHhEz9cBn0We6B0yfERReBLfhx0/R1YQHPx/QBPbA0VwcEwf2wNFcHBPHHjiem3MC2QPHcXdSaJjA+KfgTPQ8hhfjBzHC40mhlzJ+Xq9lK4a4PCs43AVaGTed5mZq+iOXZwWHi3AnOj2wFWNcnxYe7gTxLtBKHuamP/J+Wnh8a5irB7ZC5Yk9gPX1QuXC+usHWqGyhYvUYR0a7zboUOFCNVhnk0krZAOW7wFOvzXhom2xnEbIHizTA1wEYhWW6YFGyC6c1gOcfg9wfA80Qj7g8B7g9HuCww+haIR8wf49wOn3Cvv9k8tGyC/s7gFOv3fY3QONkH+v9MBWqB7PeqDn9FcIT//kcitUn6kHOu/T/xfWzlQy3dEHhwAAAABJRU5ErkJggg==)](https://discord.blitzjs.com/)[![](https://img.shields.io/badge/all_contributors-403-17BB8A.svg?style=for-the-badge&labelColor=000000)](https://npmcn.com/package/%40blitzjs/auth/#readme-contributors-) [![](https://img.shields.io/npm/l/blitz.svg?style=for-the-badge&labelColor=000000&color=blue) ](https://github.com/blitz-js/blitz/blob/main/LICENSE)[![](https://img.shields.io/npm/v/blitz.svg?style=for-the-badge&labelColor=000000&color=E65528)](https://www.npmjs.com/package/@blitzjs/auth)

  

# Blitz Auth - 框架不可知认证

  

### [文档链接](https://blitzjs.com/docs/auth)

### [GitHub 链接](https://github.com/blitz-js/blitz/tree/main/packages/blitz-auth)

### 快速启动

#### 安装 Blitz Auth

```bash
`npm i @blitzjs/auth`
# yarn add @blitzjs/auth
# pnpm add @blitzjs/auth
```

_也可以选择使用 [`npx`](https://www.npmjs.com/package/npx)_

### 框架支助

目前 Blitz Auth 的用法仅用 Next.js 来记录 。 我们正在努力增加对其他框架的支持.

#### 设置 Blitz Auth 在 Next.js 中

##### 客户端设置

在您的闪光客户端文件中添加以下内容 :

```ts
import {AuthClientPlugin} from "@blitzjs/auth"
import {setupBlitzClient} from "@blitzjs/next"

export const authConfig = {
  cookiePrefix: "testapp",
}

const {withBlitz} = setupBlitzClient({
  plugins: [AuthClientPlugin(authConfig)],
})

export {withBlitz}
```

##### 服务器设置

然后,在闪电服务器.ts文件中添加以下内容:

```ts
import {setupBlitzServer} from "@blitzjs/next"
import {AuthServerPlugin, PrismaStorage, simpleRolesIsAuthorized} from "@blitzjs/auth"
import {db} from "db"
import {authConfig} from "./blitz-client"

const {gSSP, gSP, api} = setupBlitzServer({
  plugins: [
    AuthServerPlugin({
      ...authConfig,
      storage: PrismaStorage(db),
      isAuthorized: simpleRolesIsAuthorized,
    }),
  ],
})

export {gSSP, gSP, api}
```

## 常见问题

### 如何安装 @blitzjs/auth？

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

### @blitzjs/auth 支持 TypeScript 吗？

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

### @blitzjs/auth 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @blitzjs/auth 可以商用吗？

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

### @blitzjs/auth 的下载量有多少？

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

### @blitzjs/auth 还在维护吗？

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