@fedify/astro

中文文档
2.1.32发布于 2026/11/17MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 6441

与Astro合并

中文使用文档
文档目录4 节
  1. Deno 用户
  2. 对于 Bun 用户
  3. 如何运作
  4. 安装

@feedify/astro: 加入联邦 Astro

JSR npm Follow @fedify@hollo.social

该套装自Fedify 2.1.0起提供.

此软件包提供了一个简单的整合方式 联邦 与 天体。 。 。 .

首先,加入你的整合 (原始内容存档于2018-09-21). astro.config.mjs数字 :

import { defineConfig } from "astro/config";
import { fedifyIntegration } from "@fedify/astro";

export default defineConfig({
  integrations: [fedifyIntegration()],
  output: "server",
});

然后,在 src/中相软件.ts数字 :

import { createFederation } from "@fedify/fedify";
import { fedifyMiddleware } from "@fedify/astro";

const federation = createFederation<void>({
  // Omitted for brevity; see the related section for details.
});

export const onRequest = fedifyMiddleware(
  federation,
  (context) => void 0,
);

Deno 用户

如果你使用德诺,你应该导入 @deno/astro-adapter 内 (原始内容存档于2018-09-21). astro.config.mjs 并将其作为适配器:

import { defineConfig } from "astro/config";
import { fedifyIntegration } from "@fedify/astro";
import deno from "@deno/astro-adapter";

export default defineConfig({
  integrations: [fedifyIntegration()],
  output: "server",
  adapter: deno(),
});

而任务在 德诺·杰森 应当更新以使用 deno run npm:astro 改为 astro数字 :

{
  "tasks": {
    "dev": "deno run -A npm:astro dev",
    "build": "deno run -A npm:astro build",
    "preview": "deno run -A npm:astro preview"
  }
}

对于 Bun 用户

如果您使用 Bun, 请安装 @nurodev/astro-bun 并配置为 Astro 适配器 :

import { defineConfig } from "astro/config";
import { fedifyIntegration } from "@fedify/astro";
import bun from "@nurodev/astro-bun";

export default defineConfig({
  integrations: [fedifyIntegration()],
  output: "server",
  adapter: bun(),
});

然后使用 Bun 启动 Astro 开发, 运行生成的服务器条目 用于预览或制作的建筑后点:

{
  "scripts": {
    "dev": "bunx --bun astro dev",
    "build": "bunx --bun astro build",
    "preview": "bun ./dist/server/entry.mjs"
  }
}

如何运作

Fedify作为包绕Astro请求处理器的中间软件行为. 中间软件截取收到的 HTTP 请求并将其发送到 基于请求路径和 Accept 标题 (即内容谈判). 此架构允许 Fedify 和您的 Astro 用于在同一域和端口共存的应用程序.

这个 fedifyIntegration() 函数配置 Vite 的 SSR 设置以确保 那个 @fedify/fedify 财务报告和审定财务报表 @fedify/vocab 在安全部门改革期间适当捆绑.

例如,如果您请求 /. 众所周知/网指 联邦遗嘱 自行处理请求,但如果您请求 用户/联络 (假设你的Astro应用有 页面的路径) Accept: text/html 信头 Fedify 将把请求发送给 Astro 页面处理器。 或者如果你定义了演员调度器 页:1 /users/{identifier} ,并请求与 Accept: application/activity+json 信头,联邦将发送请求 到适当的演员调度员.

安装

deno add jsr:@fedify/astro  # Deno
npm  add     @fedify/astro  # npm
pnpm add     @fedify/astro  # pnpm
yarn add     @fedify/astro  # Yarn
bun  add     @fedify/astro  # Bun

版本与发布记录

@fedify/astro 共发布 399 个版本,首次发布于 2026/03/03;过去 12 个月发布了 399 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.1.32latest2026/11/17今天
2.3.16-dev.28452026/11/17今天
2.5.0-dev.28442026/11/17今天
2.3.16-dev.28412026/11/17今天
2.4.6-dev.28372026/11/17今天
2.5.0-dev.28352026/11/161 天前

其他发布通道:pr-697 → 2.2.0-pr.697.18,pr-708 → 2.2.0-pr.708.19,pr-709 → 2.2.0-pr.709.20,pr-695 → 2.2.0-pr.695.23,pr-710 → 2.2.0-pr.710.26,pr-715 → 2.2.0-pr.715.28。

关于 @fedify/astro 的常见问题

@fedify/astro 是什么?

与Astro合并

如何安装 @fedify/astro?

在项目目录运行 npm install @fedify/astro,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:astro(^5.0.0)、@fedify/fedify(^2.1.32)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@fedify/astro 支持 TypeScript 吗?

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

@fedify/astro 支持 ESM 还是 CommonJS?

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

@fedify/astro 可以商用吗?

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

@fedify/astro 的下载量有多少?

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

@fedify/astro 还在维护吗?

最新版本 2.1.32 发布于 2026/11/17(今天);至今共发布 399 个版本,其中过去 12 个月发布了 399 个;首次发布于 2026/03/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。