部署你的 Astro 站点至 Vercel

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

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

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

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

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

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

npx astro add vercel

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

1. 使用你喜欢的包管理器将 @astrojs/vercel 适配器 安装到项目的依赖项中。如果你正在使用 npm 或不确定想要使用什么包管理器，请在终端中运行：

     npm install @astrojs/vercel

2. 在你的 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 站点的过程相同。

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

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

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

1. 安装 Vercel CLI 并运行 vercel 以进行部署。

   npm install -g vercel
   vercel

2. Vercel 将自动检测 Astro 项目并自动为其配置正确的设置。

3. 当被问及 Want to override the settings? [y/N]（想要覆盖配置吗？），选择 N（No）。

4. 你的应用程序已部署完成了！（例如：astro.vercel.app）

你可以使用 vercel.json 来覆盖 Vercel 的默认行为并配置其他设置。例如，你可以在部署时为 HTTP 响应附加标头。

📚 详细请参考 Vercel 文档的 项目配置。

Astro v2.0 不再支持 Node 14，因此请确保你的项目使用 Node 16.12.0 或更高版本。你可以在项目设置的 “通用” 页面中的 “构建步骤和无服务器函数” 下 自定义所使用的 Node.js 版本。