跳转到内容
Astro Astro

部署你的 Astro 網站

準備好建立並部署你的 Astro 網站嗎？ 跟著我們其中一個部署服務指南或是繼續下滑了解關於 Astro 網站的基本部署方法。

部署指南

根據部署類型篩選

快速部署選項

你可以利用他們的網站儀錶板或 CLI 來快速建立及部署 Astro 網站到數個主機上。

網站 UI

部署你的網站最快的方式就是連結你 Astro 專案的線上 Git 程式庫（如 GitHub, GitLab, Bitbucket）到服務主機提供者，接者利用 Git 之便來持續部署。

這些服務主機平台會自動偵測你 Astro 專案來源程式庫的 push，來建立你的網站並部署到自訂的 URL 或你個人網域的網路上。通常在這些平台設定部署會執行下列幾個步驟：

  1. 將你的程式庫加到線上 Git 提供者（例如 GitHub, GitLab, Bitbucket）。

  2. 選擇一個支援 持續部署 的服務主機（例如 Netlify (EN) 或 Vercel (EN)）然後引入你的 Git 程式庫做為新網站或專案。

    許多普遍的服務主機通常會辨識出你的專案是一個 Astro 網站，且應該會選擇適當的配置設定來建立及部署，如下所示（若不同的話這些設定也可以進行修改）：

  3. 點選 “Deploy” ，然後你的新網站就會被創立在服務主機上一個獨有的 URL （例如 new-astro-site.netlify.app ）。

這些服務主機會自動配置來監看你的 Git 提供者的主要分支的更動，接著會在每一次新的提交重新建立並重新發布你的網站。這些設定普遍來說會在你服務主機提供者的儀表板 UI 上來做配置。

CLI 部署

有些服務主機會有他們自己的命令行介面（CLI），你可以用 npm 來全域安裝到你的主機上。通常，使用 CLI 來部署的情況如下所示：

  1. 全域安裝你服務主機的 CLI 例如：

    Terminal window
    npm install --global netlify-cli

  2. 執行 CLI 並跟著授權及設定等等步驟指示。

  3. 建立你的網站並部署到你的服務主機

    許多普遍的服務主機會為你建立並部署你的網站。他們通常會辨識出你的專案是一個 Astro 網站，且應該會選擇適當的配置設定來建立及部署，如下所示（若不同的話這些設定也可以進行修改）：

    其他服務主機會要求你在本地端建立你的網站並用命令行來部署。

在本地端建立你的網站

許多服務主機像是 Netlify 和 Vercel 會為你建立網站然後發布建立好的輸出檔到網路上。但有些網站會要求你在本地端建立接著執行一個部署指令或上傳你建立好的輸出檔。

你也可能會希望在本地端建立好並預覽你的網站，或是在你自己的環境下找出任何潛在的錯誤或警告。 執行 npm run build 這個指令來建立你的 Astro 網站。

Terminal window
npm run build

預設建立好的輸出檔會被放在 dist/ 這個目錄裡。目錄位置可以用 outDir 這個配置選項 (EN)來改變。

為 SSR 增加一個 Adapter