崎径其镜赵安琪的博客 ·

一文详解Hexo 博客搭建

💡 原文中文，约4000字，阅读约需10分钟。

📝

内容提要

本文介绍了如何使用GitHub Actions将Hexo博客部署到GitHub Pages，包括准备工作、仓库设置、生成个人访问令牌和配置工作流等步骤。强调了避免上传不必要文件和备份重要数据的注意事项，并提到可以通过自定义域名优化网址。

🎯

使用Github Actions将Hexo部署到Github Pages需要准备两个仓库，一个Private用于存放博客源文件，另一个Public用于存放生成的静态网页文件。
生成Personal access tokens时，需确保包含repo权限，并将其配置到Github Actions中以执行自动部署。
在_config.yml中配置推送地址，确保指向Public的Github Pages仓库。
创建Github Actions工作流文件deploy.yml，设置触发条件、构建步骤和部署步骤。
使用.gitignore文件排除不必要的文件，如node_modules和生成的静态页面，以避免上传不必要的内容。
在配置自定义域名时，需要在Github Pages仓库设置Custom domain，并进行域名解析。

🔎

将Hexo博客源文件和生成的静态网页分开存放在两个不同的仓库中，可以有效降低源文件泄露的风险。Private仓库保护了博客内容，而Public仓库则专注于展示生成的网页，适合对隐私有较高要求的用户。

在配置GitHub Actions时，确保生成的Personal access tokens具备repo权限，以便顺利执行自动部署。此外，注意配置文件中的node版本，旧版Hexo可能与新版本的Node不兼容，需根据实际情况调整。

使用自定义域名可以提升博客的专业性和可识别性。在配置时，确保在GitHub Pages的设置中正确输入域名，并进行相应的DNS解析，以避免访问问题。

❓

需要准备两个仓库，一个Private用于存放博客源文件，另一个Public用于存放生成的静态网页文件，并配置GitHub Actions工作流。

生成的Token必须包含repo权限，并在GitHub Actions中配置以执行自动部署。

需要在_config.yml中设置deploy部分，指定Public的GitHub Pages仓库地址。

在blog_base目录下创建.github文件夹，再在其中创建workflows文件夹，并创建deploy.yml文件，设置触发条件和构建步骤。

使用.gitignore文件可以排除不必要的文件，如node_modules和生成的静态页面，以避免上传不必要的内容。

在GitHub Pages仓库的Settings中设置Custom domain，并在域名解析中进行相应配置。

🏷️