教程Node.jsAstro

在 Zeabur 上部署 Astro

Astro 是一个现代网站构建工具，拥有强大的开发者体验与轻量级输出。

本文将帮助你在 Zeabur 上部署 Astro 网站。

步骤一：创建一个 Astro 项目

你可以使用下面的命令创建一个 Astro 项目并按照提示进行配置。

npm create astro@latest

步骤二：安装 @zeabur/astro-adapter 包

Zeabur 为 Astro 提供了一个适配器包，你可以使用下面的命令进行安装。

pnpm i @zeabur/astro-adapter

安装完成后，你需要在你的 astro.config.mjs 中配置适配器。

import zeabur from '@zeabur/astro-adapter/serverless';
 
export default {
  // ...
  adapter: zeabur(),
  output: 'server'
  // ...
};

这样，你的 Astro 项目就准备好部署到 Zeabur 了。

使用容器化的方式部署

有时候，你的 Astro 项目可能有一些特殊的需求而不适合使用 Serverless 的方式部署，例如它可能依赖于某个需要执行很久的 API 请求来进行服务器端渲染（Server Side Rendering）。

在这种情况下，你可以用 Astro 官方的 @astrojs/node 来改用容器化的方式部署在 Zeabur 上：

import node from '@astrojs/node';
 
export default {
  // ...
  adapter: node({ mode: 'standalone' }),
  output: 'server'
  // ...
};

步骤三：部署到 Zeabur

方法一：使用 Zeabur CLI

首先，确保你已经按照 Zeabur CLI 部署 的指南安装好了 Zeabur CLI。

然后，在你刚初始化好的 Astro 项目中，将尚未提交到版本控制的文件加入到 Git 中。

git add -A
git commit -m "Initial commit"

接着，使用下面的命令部署你的服务。

zeabur

方法二：使用 Zeabur 控制台

前往 Zeabur 控制台 并创建一个新项目。

然后，点击 Deploy New Service 按钮，选择从 GitHub 部署。

💡

如果你是第一次在 Zeabur 上从 GitHub 部署项目，你需要先配置并安装 GitHub 应用。 你可以在 这里 查看更详细的指南。

当你选择好仓库和分支后，Zeabur 将会自动开始构建你的服务。

Zeabur 会自动检测到你的服务是由 Astro 构建的，所以你不需要做任何额外的配置。你的部署将会在几分钟内完成。

步骤四：绑定域名

部署完成后，你可能需要为你的 Astro 网站配置域名。

打开服务页面的 “Domain” 标签页，然后点击 “Generate Domain” 或 “Custom Domain”。

关于如何为你的服务绑定域名的更多信息，请参考 绑定域名。

Node.jsExpress