克隆模板#

根据作者的README进行fork仓库，然后克隆到一台你正在使用的笔记本或台式机上(Windows/MacOS/Linux都行)。

部署到 github.io 网址#

在 astro.config.mjs 中配置文件设置 site 和 base 选项。

import { defineConfig } from 'astro/config'

export default defineConfig({  
+ site: 'https://astronaut.github.io',  
+ base: 'my-repo',
})

配置 GitHub Action#

1. 在你克隆的根目录下中的 .github/workflows/ 目录(没有文件夹就创建文件夹)创建一个新文件 deploy.yml，并粘贴以下 YAML 配置信息。下面的文件什么也不用改。

name: Deploy to GitHub Pages

on:
  # 每次推送到 `main` 分支时触发这个“工作流程”
  # 如果你使用了别的分支名，请按需将 `main` 替换成你的分支名
  push:
    branches: [ main ]
  # 允许你在 GitHub 上的 Actions 标签中手动触发此“工作流程”
  workflow_dispatch: 

# 允许 job 克隆 repo 并创建一个 page deployment
permissions:
  contents: read
  pages: write
  id-token: write

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout your repository using git
        uses: actions/checkout@v4
      - name: Install, build, and upload your site
        uses: withastro/action@v3
        #with:
          # path: . # 存储库中 Astro 项目的根位置。（可选）
          # node-version: 20 # 用于构建站点的特定 Node.js 版本，默认为 20。（可选）
          # package-manager: pnpm@latest # 应使用哪个 Node.js 包管理器来安装依赖项和构建站点。会根据存储库中的 lockfile 自动检测。（可选）

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4

2. 在 GitHub 上，跳转到存储库的 Settings 选项卡并找到设置的 Pages 部分。
3. 选择 GitHub Actions 作为你网站的 Source，然后按 Save。
4. 提交（commit）这个新的“工作流程文件”（workflow file）并将其推送到 GitHub。

OK，你的网站现在应该已完成发布了！当你将更改推送到 Astro 项目的存储库时，GitHub Action 将自动为你部署它们。

通过网站 UI 部署#

直接打开Vercel官网，使用Github的账号登录。

1. 导入你的项目 至 Vercel。
2. Vercel 将自动检测 Astro 项目并自动为其配置正确的设置。如下图，什么都不用动，直接点击Deploy就好。
3. 部署完成。现在可以通过Vercel默认给你分配的二级域名访问博客了。

自定义域名#

进入部署好的然后点击Settings下的Domains中，点击Add，输入域名。Add之后，如果看到下图中的提示（Invalid Configuration）👇,说明要是这个域名解析生效，需要在你的域名商管理后台配置对应的Cname解析和A解析。