# @aglyn/plugins-redirects 中文文档

规范地址：https://npmcn.com/package/%40aglyn/plugins-redirects/

版本：1\.19\.0
npm 元数据更新时间：2026-11-07T13:59:50.129Z
中文译文更新时间：2026-11-05T23:32:28.744Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：541 kB，63 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：11 个
- peer 依赖：react ^19\.2\.8，firebase ^13\.0\.0，@mui/material ^9\.3\.1，firebase-admin ^14\.3\.0
- 首次发布：2026-09-20T23:53:45.736Z
- 最新版本发布：2026-11-07T13:59:49.832Z
- 近 30 天下载量：9411（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：162（近 12 个月 162 个）

## 中文简介

Aglyn的再定向插件:一个站点的URL重定向规则,管理它们的控制台页面,在站点解决路由之前用重定向响应请求的服务器钩. 如果你运行 Aglyn 控制台和租户运行时间和

## 安装

```sh
npm install @aglyn/plugins-redirects
```

也可以使用：`pnpm add @aglyn/plugins-redirects`、`yarn add @aglyn/plugins-redirects`、`bun add @aglyn/plugins-redirects`

## README

# @aglyn/plugins-redirections (英语)

Aglyn的再定向插件:一个站点的URL重定向规则,管理它们的控制台页面,在站点解决路由之前用重定向响应请求的服务器钩. 如果您运行 Aglyn 控制台和租户运行时间并想要重定向规则, 请安装它; 它是一个第一当事方插件, 不是一个独立的库 .

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

## 安装

```
npm install @aglyn/plugins-redirects
```

同伴依赖性 : `react`, (中文(简体) ), `@mui/material`, (中文(简体) ), `firebase`,以及 `firebase-admin` 用于服务器条目.

## 里面有什么东西

**在一个出版的网站上.** 无所取取. 在服务器上执行重定向 : `registerRedirectsApi` (单位:千美元) `tenantApi` 登记员,出口自 `@aglyn/plugins-redirects/server`以 `@aglyn/aglyn/server`。对于每个请求,解析器都得到主机和路径,并返回目的地和状态代码,或者没有.

**控制台** (单位:千美元)`registerRedirectsConsole`,则 `console` 书记官长:a `Redirects` 导航项目于 `/redirects`,门由 `redirects` 权利。 该页面为代码分解并打开后加载.

**主控台服务器声明** (单位:千美元)`registerRedirectsConsoleServerDeclarations`,则 `consoleServerDeclarations` 登记员:服务器中一半的重定向导入和导出 `redirect` 资源草案与 `redirect` 构建操作 Aglyn AI 构建用途来创建,更新或删除一个站点的重定向规则. 编剧将重定向页面的检查(出版角色、 `redirects` 特性, `redirectsPerHost` 在创建、封锁、验证、复制和环路上,保留已公布的页面路径,除非项目说它被要求,并与成员一起为场外目的地盖章。 一条规则没有草案状态,所以一旦写出就被直播. 操纵台 `redirect` 记录路由打开Redictions页面.

**规则模式**从 `.`数字 :

-   `HostRedirect`: 一个规则的 `source`, (中文(简体) ), `destination`, (中文(简体) ), `statusCode` (单位:千美元)`REDIRECT_STATUS_CODES`, (中文(简体) ), `kind` (单位:千美元)`REDIRECT_KINDS`数字 : `exact`, (中文(简体) ), `prefix`, (中文(简体) ), `regex`, (中文(简体) ), `priority` 财务报告和审定财务报表 `enabled`。 。 。 .
-   `matchRedirect(rules, path)`: 按优先顺序评价规则并返回 a `RedirectMatch` 或者说 `null`。残疾、自我瞄准和无效的规则从不开火,只有当规则记录了批准规则的出版商时,才向外部目的地提供服务.
-   `validateRedirectRule`, (中文(简体) ), `compileRedirectRegex`, (中文(简体) ), `normalizeRedirectSource`, (中文(简体) ), `normalizeRedirectDestination`, (中文(简体) ), `isExternalRedirectDestination`, (中文(简体) ), `isSelfRedirect`, (中文(简体) ), `REDIRECT_DEFAULT_PRIORITY`。 。 。 .
-   `BUNDLE_ID` (单位:千美元)`'redirects'`) (中文(简体) ).

## 使用量

插件通过 Aglyn 的插件管理器加载: 生成的加载器会导入包, 并调用在 `plugins.config.json`。在启动时,电线插件用手拨打一次的应用程序:

```ts
// console, client side
import { registerRedirectsConsole } from '@aglyn/plugins-redirects'
registerRedirectsConsole()

// tenant runtime, server side
import { registerRedirectsApi } from '@aglyn/plugins-redirects/server'
registerRedirectsApi()
```

火柴是纯的,可以直接使用:

```ts
import { matchRedirect, type HostRedirect } from '@aglyn/plugins-redirects'

const rules: HostRedirect[] = [
  { source: '/old', destination: '/new', statusCode: 301 },
]
const match = matchRedirect(rules, '/old')
// match?.destination === '/new'
```

## 怎样才合适

一个插件软件包( E)`scope:plugin`) (中文(简体) ). 取决于核心`@aglyn/aglyn`(a) 租户包(`@aglyn/tenant-data-admin`, (中文(简体) ), `@aglyn/tenant-feature-instance`)和通用软件 `@aglyn/shared-*` 软件包。 它没有导入其他插件,核心从不导入: 租户运行时间询问注册的解析器,控制台通过加载器清单到达页面.

## 许可证

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

## 常见问题

### @aglyn/plugins-redirects 是什么？

Aglyn的再定向插件:一个站点的URL重定向规则,管理它们的控制台页面,在站点解决路由之前用重定向响应请求的服务器钩\. 如果你运行 Aglyn 控制台和租户运行时间和

### 如何安装 @aglyn/plugins-redirects？

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

### @aglyn/plugins-redirects 支持 TypeScript 吗？

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

### @aglyn/plugins-redirects 支持 ESM 还是 CommonJS？

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

### @aglyn/plugins-redirects 可以商用吗？

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

### @aglyn/plugins-redirects 的下载量有多少？

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

### @aglyn/plugins-redirects 还在维护吗？

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