部署你的 Astro 站点至 Vercel

你可以使用 Vercel 零配置的将 Astro 站点部署到其全球边缘网络中。

本指南包括通过 Vercel 网站 UI 或 Vercel 的 CLI 将 Astro 站点部署到 Vercel 的相关说明。

项目配置

你的 Astro 项目可以作为静态站点或服务端渲染站点（SSR）部署到 Vercel。

静态站点

默认情况下，你的 Astro 项目是一个静态站点。你无需任何额外配置即可将静态 Astro 站点部署到 Vercel。

SSR 适配器

要在 Astro 项目中启用 SSR 并在 Vercel 上部署：

使用以下 astro add 命令为你的 Astro 项目中添加 Vercel 适配器以开启 SSR。此命令将安装适配器并同时自动对你的 astro.config.mjs 文件进行适当的配置。

npx astro add vercel

pnpm astro add vercel

yarn astro add vercel

如果你更喜欢手动安装适配器，你需要完成以下两个步骤：

使用你喜欢的包管理器将 @astrojs/vercel 适配器安装到项目的依赖项中。
- npm
- pnpm
- Yarn
终端窗口
npm install @astrojs/vercel
终端窗口
pnpm add @astrojs/vercel
终端窗口
yarn add @astrojs/vercel

在你的 astro.config.mjs 配置文件中添加以下配置。

import { defineConfig } from 'astro/config';
import vercel from '@astrojs/vercel/serverless';

export default defineConfig({
  output: 'server',
  adapter: vercel(),
});

如何部署

你可以通过 Vercel 的网站 UI 或使用 Vercel 提供的官方 CLI（命令行界面）部署 Astro 站点到 Vercel。部署静态站点和 SSR 站点的过程相同。

通过网站 UI 部署

将你的代码推送到你的在线 Git 存储库（GitHub、GitLab、BitBucket 等）。
导入你的项目至 Vercel。
Vercel 将自动检测 Astro 项目并自动为其配置正确的设置。
你的应用程序已部署完成了！（例如：astro.vercel.app）

在你的项目完成导入和部署后，所有后续内容推送到（生产分支外的）分支都将自动生成预览部署（Preview Deployments），以及对生产分支（通常是名为“main”的分支）所做的任何更改都将自动被部署为生产部署（Production Deployment）。

详细请参考 Vercel 文档的 Git 集成部分。

通过 CLI 部署

安装 Vercel CLI 并运行 vercel 以进行部署。
- npm
- pnpm
- Yarn
终端窗口
npm install -g vercel vercel
终端窗口
pnpm add -g vercel vercel
终端窗口
yarn global add vercel vercel
Vercel 将自动检测 Astro 项目并自动为其配置正确的设置。
当被问及 Want to override the settings? [y/N]（想要覆盖配置吗？），选择 N（No）。
你的应用程序已部署完成了！（例如：astro.vercel.app）