1.1 选择代码仓库#

​ 首先需要建立一个代码仓库，上传博客代码。常见的代码仓库有Gitee和GitHub，考虑国内的法律监管风险以及Gitee已经在国内停止提供Pages服务，还是按照常规做法，在GitHub建立代码仓库，上传源代码。

1.2 给代码仓库命名#

​ 考虑到GitHub Pages服务的默认启动目录，需要将代码仓库名称直接命名为<username>.github.io的形式，username为GitHub账户的用户名。

1.3 修改astro.config.mjs#

​ 把根目录下astro.config.mjs中的site字段更新为https://<username>.github.io，base字段依然保持为/，依照这种设定， 开发环境（pnpm dev） 和 生产环境（pnpm build） 的调试结果就可以保持一致。

1.4 新增gitignore文件#

​ 由于在开发过程中，需要使用pnpm install创建开发环境、使用pnpm dev和pnpm build进行本地调试，而这些命令产生的内容不必上传至代码仓库中，因此，需要在根目录下创建.gitignore文件，以便在提交代码时，忽略无需上传的内容。

1
# ./gitignore文件内容
2
node_modules/
3
dist/

2.1 创建workflows目录#

​ 在项目的.github目录下，创建workflows目录，用来存放Github Actions所需的工作流。

2.2 新增deploy.yml文件#

​ 在 .github/workflows/ 的目录里创建一个新文件deploy.yml，内容更新如下：

1
name: Deploy to GitHub Pages
2
on:
3
  # 每次推送到 `main` 分支时触发这个“工作流程”
4
  # 如果你使用了别的分支名，请按需将 `main` 替换成你的分支名
5
  push:
6
    branches: [ main ]
7
  # 允许你在 GitHub 上的 Actions 标签中手动触发此“工作流程”
8
  workflow_dispatch:
9
# 允许 job 克隆 repo 并创建一个 page deployment
10
permissions:
11
  contents: read
12
  pages: write
13
  id-token: write
14
jobs:
15
  build:
16
    runs-on: ubuntu-latest
17
    steps:
18
      - name: Checkout your repository using git
19
        uses: actions/checkout@v4
20
      - name: Install, build, and upload your site
21
        uses: withastro/action@v3
22
        # with:
23
          # path: . # 存储库中 Astro 项目的根位置。（可选）
24
          # node-version: 20 # 用于构建站点的特定 Node.js 版本，默认为 20。（可选）
25
          # package-manager: pnpm@latest # 应使用哪个 Node.js 包管理器来安装依赖项和构建站点。会根据存储库中的 lockfile 自动检测。（可选）
26
  deploy:
27
    needs: build
28
    runs-on: ubuntu-latest
29
    environment:
30
      name: github-pages
31
      url: ${{ steps.deployment.outputs.page_url }}
32
    steps:
33
      - name: Deploy to GitHub Pages
34
        id: deployment
35
        uses: actions/deploy-pages@v4

2.3 配置Actions功能#

​ 先在仓库项目的Settings中将Build and deployment的source改为Github Actions，启动Github Actions的功能，然后再在Actions里选择配置deploy.yml文件。

构建结果

​ 当一切设置完成后，GitHub Actions会在提交代码之后，自动触发部署流程，构建结果也会反馈在页面中。如果上述配置都运作正常，那么GitHub Actions会反馈success的结果，并且博客也会自动部署在GitHub Pages服务上，可以通过<username>.github.io进行访问了。

3.1 EdgeOne Pages介绍#

3.2 EdgeOne账号注册#

​ EdgeOne有国内版和国际版之分，基础功能相同：DDoS防护、Web应用防火墙、内容分发网络、智能加速等，主要区别在于费用结算、ICP备案、账号注册网站和访问速度等：

• 费用结算

  • 国内版：使用人民币结算
  • 国际版：使用美元结算

• ICP备案

  • 国内版：必须实名认证和ICP备案，才能对外开放使用，而ICP备案需要强制购买云服务器才能申请
  • 国际版：可以不用实名认证和ICP备案，就可以对外开放使用

• 账号注册网站

  • 国内版：官网：https://cloud.tencent.com，控制台：https://console.cloud.tencent.com/edgeone/pages
  • 国际版：官网：https://www.tencentcloud.com，控制台：https://console.tencentcloud.com/edgeone/pages

• 访问速度

  • 国内版：全球可访问，国内网络访问流畅，但只能使用3小时有效的免费域名，如果要用自定义域名，必须实名认证并网络备案
  • 国际版：全球可访问，国内网络访问速度不及专线访问速度，但比cloudflare、netify、GitHub服务快，虽然也只能使用3小时有效的免费域名，但是支持不必网络备案的自定义域名

​ 基于部署易用性、审查机制和成本最小化考量，选择 国际版 进行账号注册和使用。

​ 国际版账号注册后，可以免费领取四个加速计划，只要参与活动、分享至X平台和Facebook平台就行：点击链接即可，不用关心是否分享成功。

3.3 EdgeOne Pages部署Astro博客#

​ EdgeOne Pages目前支持Github、Gitee、CNB等git提供商的接入。

4.1 搜索域名#

提醒

如果要在国内备案，请优先选用常见的后缀名，如.com、.net、.xyz、.site等。使用小众的后缀名，有一定概率无法通过国内备案流程。

4.2 对比价格#

• 横向对比各家网站对同一域名给出的价格，货比三家，择优选购
• 纵向考虑是否有必要存续更长的时间，一般新域名首年、新用户首单都会有划算的价格，但之后域名续费的价格较高，需谨慎考虑

提醒

多数情况下，域名购买后不予退款，下单需谨慎。

4.3 购买完成#

• 可以在域名管理器里查看已经购买的域名

5.1 在EdgeOne增加自定义域名#

• 在EdgeOne的pages服务中选择部署成功的项目，然后进入项目设置页面，选择添加自定义域名

• 在弹出的页面中输入自定义域名，如www.shadowchencsd.blog，点击下一步

• 在弹出的页面中，复制记录值，以用于在spaceship配置CNAME

5.2 在spaceship配置CNAME#

• 在spaceship中搜索高级DNS功能，选择购买的域名，进行CNAME配置

• 在自定义记录中添加记录，主机填写www，类型选择CNAME，值填写EdgeOne提供的记录值

5.3 在EdgeOne更新自定义域名#

• 在spaceship页面等待DNS广播完成，直到广播图标出现✅

• 切换至EdgeOne网站的项目设置处，此时新域名的DNS记录变为已设置状态，点击验证进行DNS记录验证

• 验证通过后，EdgeOne会自动申请免费的SSL证书，用于托管自定义域名网站

• 等待证书申请完成后，就可以通过自定义域名访问博客站点了