@deno/astro-adapter

中文文档
0.6.0发布于 2026/07/02MITES Module零依赖构建来源已验证近 30 天下载 1.7万

将您的 Astro 站点部署到 Deno 服务器

中文使用文档
文档目录9 节
  1. 概览
  2. 为什么是Astro Deno
  3. 安装
  4. 使用量
  5. 配置
  6. 开始
  7. 端口和主机名称
  8. 实例
  9. 捐款

@deno/astro适应器

这个适配器可以让Astro在德诺运行你的SSR站点. Astro 6在德诺工作 运行时间( 没有节点) .

学着如何在我们的星座上部署 Deno 部署指南。 。 。 .

概览

为什么是Astro Deno

德诺 类似节点的运行时间,但有一个API,即 更类似于浏览器的API. 这个适配器提供 Deno 的 API 访问权限 并创建一个脚本来运行您在 Deno 服务器上的工程 .

  • 你在用Astro做静态场地建造者吗?
    不,你不需要一个适配器

  • 您是否使用 Astro 服务器侧渲染( SSR) ?
    是的,你需要一个适配器

  • 您是否希望将您的网站部署到 Deno 部署? 吗?
    是的,你还需要一个适配器

安装

添加 Deno 适配器, 在您的 Astro 项目中启用 SSR 如下 步骤 :

1. 增加适配器

deno add npm:@deno/astro-adapter

2. 更新您的 Astro.config.mjs 文件

// astro.config.mjs
import { defineConfig } from "astro/config";
import deno from "@deno/astro-adapter";

export default defineConfig({
  output: "server",
  adapter: deno(),
});

3. 下一步,更新您的 deno.json(或软件包.json)

// deno.json
{
  "tasks": {
    "dev": "deno run -A npm:astro dev",
    "build": "deno run -A npm:astro build",
    "preview": "deno run --allow-net --allow-read --allow-env ./dist/server/entry.mjs",
  },
}

// package.json
{
  "scripts": {
    "dev": "deno run -A npm:astro dev",
    "build": "deno run -A npm:astro build",
    "preview": "deno run --allow-net --allow-read --allow-env ./dist/server/entry.mjs",
  },
}

4. 您可以在本地预览您的制作 Astro 站点和 Deno

deno task build 
deno task preview

使用量

之后 执行构建 将有一个 dist/server/entry.mjs 模块。 您可以启动服务器 在您的 Deno 应用程序中导入此模块 :

import "./dist/server/entry.mjs";

见 start 下面的选项,用于您如何对启动 Astro服务器.

您也可以直接使用 deno 运行脚本 :

deno run --allow-net --allow-read --allow-env ./dist/server/entry.mjs

配置

要配置此适配器, 将对象传递到 deno() 函数调用 astro.config.mjs。 。 。 .

// astro.config.mjs
import { defineConfig } from "astro/config";
import deno from "@deno/astro-adapter";

export default defineConfig({
  output: "server",
  adapter: deno({
    //options go here
  }),
});

开始

此适配器在导入时会自动启动服务器 。 你可以转身 这与关闭 start 选项 :

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

export default defineConfig({
  output: "server",
  adapter: deno({
    start: false,
  }),
});

如果您禁用此功能, 您需要写入您的 Deno 网络服务器 。 导入和呼叫 handle 从生成的条目脚本中获取请求:

import { handle } from "./dist/server/entry.mjs";

Deno.serve((req: Request) => {
  // Check the request, maybe do static file handling here.

  return handle(req);
});

端口和主机名称

您可以设置端口( 默认 ): 8085)和主机名(默认: 0.0.0.0用于 要使用的 deno 服务器 。 若为 start 错误, 这没有效果; 您自己的服务器 必须配置端口和主机名.

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

export default defineConfig({
  output: "server",
  adapter: deno({
    port: 8081,
    hostname: "myhost",
  }),
});

实例

这个 Deno + Astro 模板 包含a preview 命令直接运行条目脚本。 运行 npm run build 接下来 npm run preview 运行生产 deno 服务器.

捐款

要配置您的开发环境, 克隆寄存器并安装 依赖性.

git clone
cd astro-adapter
deno i

Deno Astro适配器目前由Deno 2.x公司建造并测试. 为了测试你 更改确保您安装了 Deno 2.x

deno task test

最后,您可以检查您的代码格式

deno fmt

这个包由德诺的核心团队维护. 欢迎您提交 发行或公关!

版本与发布记录

@deno/astro-adapter 共发布 15 个版本,首次发布于 2024/04/25;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.6.0latest2026/07/024 个月前
0.5.22026/05/295 个月前
0.5.12026/05/056 个月前
0.4.02026/04/097 个月前
0.3.22025/09/221.1 年前
0.3.12025/05/231.5 年前

关于 @deno/astro-adapter 的常见问题

@deno/astro-adapter 是什么?

将您的 Astro 站点部署到 Deno 服务器

如何安装 @deno/astro-adapter?

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

@deno/astro-adapter 支持 TypeScript 吗?

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

@deno/astro-adapter 支持 ESM 还是 CommonJS?

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

@deno/astro-adapter 可以商用吗?

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

@deno/astro-adapter 的下载量有多少?

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

@deno/astro-adapter 还在维护吗?

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