跳转到内容

部署你的 Astro 网站

准备好构建和部署你的 Astro 网站了吗？ 请遵循我们针对不同部署服务的指南之一，或向下滚动以获取有关部署 Astro 网站的一般指导。

部署指南

标题为“部署指南”的部分

快速部署选项

标题为“快速部署选项”的部分

你可以使用许多主机的网站仪表盘 UI 或 CLI 快速构建和部署 Astro 网站。

网站 UI

标题为“网站 UI”的部分

部署网站的一个快捷方法是将你的 Astro 项目的在线 Git 仓库（例如 GitHub、GitLab、Bitbucket）连接到主机提供商，并利用 Git 进行持续部署。

这些主机平台会自动检测到对你的 Astro 项目源仓库的推送，构建你的网站并将其部署到自定义 URL 或你的个人域名上。在这些平台上设置部署通常会遵循以下步骤：

  1. 将你的仓库添加到在线 Git 提供商（例如 GitHub、GitLab、Bitbucket）

  2. 选择一个支持持续部署的主机（例如 Netlify 或 Vercel），并将你的 Git 仓库导入为一个新站点/项目。

    许多常见的主机都会将你的项目识别为 Astro 网站，并应选择如下所示的适当配置设置来构建和部署你的网站。（如果不是，这些设置是可以更改的。）

  3. 点击“部署”，你的新网站将在该主机的唯一 URL 上创建（例如 new-astro-site.netlify.app）。

主机将被自动配置为监视你的 Git 提供商的主分支的更改，并在每次新提交时重新构建和发布你的网站。这些设置通常可以在你的主机提供商的仪表盘 UI 中配置。

CLI 部署

标题为“CLI 部署”的部分

一些主机会有自己的命令行界面（CLI），你可以使用 npm 在你的机器上全局安装。通常，使用 CLI 进行部署的步骤如下：

  1. 全局安装主机的 CLI，例如

    终端窗口
    npm install --global netlify-cli

  2. 运行 CLI 并按照任何关于授权、设置等的说明进行操作。

  3. 构建你的网站并部署到你的主机

    许多常见的主机会为你构建和部署你的网站。它们通常会将你的项目识别为 Astro 网站，并应选择如下所示的适当配置设置来构建和部署。（如果不是，这些设置是可以更改的。）

    其他主机将要求你在本地构建你的网站并使用命令行进行部署。

在本地构建你的网站

标题为“在本地构建你的网站”的部分

许多像 Netlify 和 Vercel 这样的主机会为你构建网站，然后将构建输出发布到网上。但是，一些网站会要求你在本地构建，然后运行部署命令或上传你的构建输出。

你可能也希望在本地构建以预览你的网站，或在你自己的环境中捕获任何潜在的错误和警告。

运行 npm run build 命令来构建你的 Astro 网站。

终端窗口
npm run build

默认情况下，构建输出将放置在 dist/ 目录下。这个位置可以使用 outDir 配置选项进行更改。

为按需渲染添加适配器

标题为“为按需渲染添加适配器”的部分
贡献 社区 赞助