跳转到内容

将你的 Astro 站点部署到 Vercel

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

本指南包含通过 Vercel 网站界面或其 CLI 部署的说明。

项目配置

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

静态站点

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

按需渲染适配器

使用以下 astro add 命令添加 Vercel 适配器，以在你的 Astro 项目中启用按需渲染。这将一步完成适配器的安装并对你的 astro.config.mjs 文件进行适当的更改。

npx astro add vercel

pnpm astro add vercel

yarn astro add vercel

若要手动安装，或了解更多配置选项（例如使用 Vercel Edge Functions 部署项目的 Astro 中间件），请参阅 Vercel 适配器指南。

如何部署

你可以通过 Vercel 网站界面或使用 Vercel 的 CLI（命令行界面）进行部署。对于静态和按需渲染的 Astro 站点，部署过程是相同的。

网站 UI 部署

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

在你的项目被导入和部署后，所有后续对分支的推送都将生成预览部署，而对生产分支（通常是“main”）所做的所有更改都将产生生产部署。

了解更多关于 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。
你的应用程序已部署！（例如 astro.vercel.app）

使用 `vercel.json` 配置项目

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

了解更多关于 Vercel 的项目配置。

更多部署指南

贡献社区赞助