部署你的 Astro 站点至 Netlify

Netlify 为网络应用程序和静态网站提供托管和无服务器后端服务。任何 Astro 网站都可以托管在 Netlify 上！

本指南包括通过网站用户操作界面或 Netlify 的 CLI(命令行工具) 部署到 Netlify 的说明。

项目配置

你的 Astro 项目可以通过三种不同的方式部署到 Netlify：作为一个静态网站，一个服务端渲染的网站，或一个边缘渲染的网站。

静态网站

你的 Astro 项目默认就是静态网站。你不需要任何额外的配置就可以将静态的 Astro 网站部署到 Netlify。

SSR 适配器

为你的 Astro 项目开启 SSR 并在 Netlity 上部署，包括使用 Netlify 的边缘函数：

通过以下的 astro add 命令，添加 Netlify 适配器，在你的 Astro 项目中启用 SSR。这一步将会安装适配器并且对你的 astro.config.mjs 文件进行适当的修改。

npx astro add netlify

如果你更倾向于手动安装适配器，那么请完成以下两个步骤：

使用你喜欢的包管理器将 @astrojs/netlify 适配器安装到你的项目依赖中。如果你正在使用 npm 或者不确定使用何种包管理器，可以在终端运行以下命令：
Terminal window
```
npm install @astrojs/netlify
```

在你的 astro.config.mjs 项目配置文件中添加两行新增内容：

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

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

你还可使用 Netlify 的边缘函数部署你的项目，即通过在 Netlify 适配器的配置中添加 edgeMiddleware: true：

import { defineConfig } from 'astro/config';
import netlify from '@astrojs/netlify/functions';

export default defineConfig({
  output: 'server',
  adapter: netlify({
    edgeMiddleware: true
  }),
});

如何部署

你可以通过网站用户操作界面或使用 Netlify 的 CLI(命令行工具) 进行部署。无论是静态网站还是 SSR 的 Astro 网站，其过程都是相同的。

网站用户操作界面部署方式

如果你的项目存储在 GitHub、GitLab、BitBucket 或 Azure DevOps 中，你可以使用 Netlify 的网站用户操作界面来部署你的 Astro 网站。

在 Netlify dashboard 页面上，点击 Add a new site
选择 Import an existing project

当你从你的 Git 提供商中导入 Astro 仓库时，Netlify 应该会自动检测并预填充正确的配置设置。
确保已输入以下设置，然后按下 Deploy 按钮：
- Build Command: astro build or npm run build
- Publish directory: dist

部署后，你将被重定向到站点概览页面。在那里，你可以编辑你站点的详细信息。

根据你的部署配置，未来对源代码库的任何修改都将触发预览和生产部署。

`netlify.toml` 文件

你可以选择在项目仓库的顶层创建一个新的 netlify.toml 文件，用来配置你的构建命令和发布目录，以及其他项目设置，包括环境变量和重定向。Netlify 将读取此文件并自动配置你的部署。

为了配置默认设置，创建一个 netlify.toml 文件，并填入以下内容：

[build]
  command = "npm run build"
  publish = "dist"

📚 更多信息可以在 Netlify 的博客文章 “部署现有的 Astro Git 仓库” 中找到。

CLI 部署方式

你也可以在 Netlify 上创建一个新的站点，并通过安装和使用 Netlify CLI 来关联你的 Git 仓库。

全局安装 Netlify CLI 工具
Terminal window
```
npm install --global netlify-cli
```
运行 netlify login 并按照指示进行登录并授权 Netlify。
运行 netlify init 并按照指示进行操作。
确认你的构建命令 (astro build)

CLI 将自动检测构建设置（astro build）和部署目录（dist），并将提供一个自动生成且有这些对应设置的 netlify.toml 文件。
推送到 Git 来触发构建和部署

CLI 将向仓库添加一个部署密钥，这意味着每次你使用 git push 时，你的网站都会在 Netlify 上自动重新构建。