@aglyn/plugins-redirects

中文文档
1.19.0发布于 2026/11/07Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 9411

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

中文使用文档
文档目录5 节
  1. 安装
  2. 里面有什么东西
  3. 使用量
  4. 怎样才合适
  5. 许可证

@aglyn/plugins-redirections (英语)

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

从Aglyn monorepo出版到npm. 随后的版本 语义版本。 。 。 .

安装

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。在启动时,电线插件用手拨打一次的应用程序:

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

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

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

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 页面存档备份,存于互联网档案馆

版本与发布记录

@aglyn/plugins-redirects 共发布 162 个版本,首次发布于 2026/09/21;过去 12 个月发布了 162 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.19.0latest2026/11/07今天
1.18.02026/11/07今天
1.17.02026/11/07今天
1.16.02026/11/07今天
1.15.22026/11/061 天前
1.15.12026/11/061 天前

其他发布通道:beta → 1.0.0-beta.296。

关于 @aglyn/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 和提交记录判断。