Astro-Paper主题部署到GitHub Pages并配置自定义域名指南

Astro-Paper是一个基于Astro框架构建的静态博客主题，本文将详细介绍如何将其部署到GitHub Pages服务并配置自定义域名。

准备工作

在开始部署前，请确保已完成以下准备工作：

1. 已在GitHub上创建仓库并完成Astro-Paper主题的初始化
2. 拥有一个可用的自定义域名（如未购买可跳过域名配置部分）
3. 本地开发环境已配置好Node.js和Git

部署步骤

1. 基础配置修改

首先需要修改主题的基础配置，打开项目中的src/config.ts文件，找到站点URL相关配置项，将其修改为你的GitHub Pages地址或自定义域名地址。

// src/config.ts示例配置
export const SITE = {
  website: "https://yourusername.github.io/", // GitHub Pages地址
  // 或使用自定义域名
  // website: "https://yourdomain.com/",
  // 其他配置...
};

2. 创建CNAME文件

如需使用自定义域名，需要在项目的public目录下创建名为CNAME的文件（无扩展名），文件内容只需一行，填写你的域名：

yourdomain.com

3. GitHub仓库设置

完成代码修改后，按照以下步骤配置GitHub仓库：

1. 进入仓库的Settings页面
2. 找到Pages设置项
3. 选择部署分支（通常为gh-pages或main分支）
4. 设置部署源为GitHub Actions（如果使用自动化部署）

4. 部署工作流

Astro-Paper主题已内置了对GitHub Pages的支持，无需额外配置astro.config.mjs文件。当你将代码推送到GitHub后，GitHub Actions会自动构建并部署站点。

注意事项

1. DNS配置：如果使用自定义域名，需要在域名注册商处配置CNAME记录指向你的GitHub Pages地址
2. HTTPS：GitHub Pages默认启用HTTPS，建议强制使用HTTPS访问
3. 缓存问题：部署后如有样式未更新，可能是浏览器缓存导致，可尝试清除缓存或使用无痕模式访问
4. 构建时间：首次部署可能需要几分钟时间才能生效

常见问题解决方案

若部署后遇到404错误，请检查：

• 站点URL配置是否正确
• CNAME文件是否存在于public目录
• GitHub Pages是否已成功启用
• 自定义域名的DNS解析是否生效

通过以上步骤，你可以轻松地将Astro-Paper主题博客部署到GitHub Pages，并享受稳定、免费的托管服务，同时保持专业的自定义域名访问体验。