通过 Gitea 部署 Hexo 教程
内容提要
本文介绍了通过 Gitea 部署 Hexo 博客的步骤，包括安装 Node.js 和 Git、注册 Gitea、配置 Git 用户名和 SSH 密钥、初始化 Hexo 项目、创建文章、生成静态文件、启动本地服务器、在 Gitea 创建仓库、配置 Hexo 部署、安装 Git 部署插件、启用 Gitea Page 服务及可选的自定义域名配置。
延伸解读
部署流程中的关键配置点
教程中，Git 全局用户名和邮箱的配置、SSH 密钥的生成与添加是连接本地与 Gitea 的基础。在 Hexo 的 _config.yml 中，deploy 部分的 repo 地址需使用 SSH 格式，并指定 branch 为 master。此外，安装 hexo-deployer-git 插件是部署成功的必要条件，这些步骤若遗漏或出错，将直接导致部署失败。
Gitea Page 服务的启用与访问
在 Gitea 仓库设置中启用 Gitea Page 服务，并选择 master 分支进行部署，同时勾选强制使用 HTTPS，可确保博客通过安全连接访问。部署成功后，默认访问地址为 https://<你的用户名>.gitee.io。需注意，该地址依赖于 Gitea 实例的域名配置，若自建 Gitea，实际访问地址可能不同。
自定义域名的配置要点
若需使用自定义域名，需在 Hexo 项目根目录创建 CNAME 文件并填入域名，重新部署后，在域名管理后台添加一条 CNAME 记录指向 yourusername.gitee.io。此步骤为可选，且需确保域名解析生效，否则自定义域名无法访问。教程未涉及 HTTPS 证书配置，使用自定义域名时可能需额外处理。
常见问题与排查方向
教程提到页面样式显示不正确时，应检查 _config.yml 中的 URL 设置。这通常是因为 URL 未正确指向博客的最终访问地址，导致 CSS、JS 等资源加载失败。部署后若遇到类似问题，可优先核对 URL 和 root 配置，确保与 Gitea Page 的实际路径一致。
Q&A
如何安装 Node.js 和 Git？
确保在开始之前已经安装了 Node.js 和 Git。
如何在 Gitea 上配置 Git 用户名和邮箱？
使用命令 $ git config --global user.name "gitea用户名" 和 $ git config --global user.email "你的邮箱" 来配置。
如何初始化 Hexo 项目？
使用命令 $ hexo init 和 $ npm install 来初始化 Hexo 项目。
如何将 Hexo 部署到 Gitea？
在 Gitea 创建新仓库，配置 Hexo 的部署信息，然后使用 $ hexo clean、$ hexo g 和 $ hexo d 命令进行部署。
如何启用 Gitea Page 服务？
进入 Gitea 的仓库设置，启用 Gitea Page 服务，并选择 master 分支进行部署。
如何配置自定义域名？
在 Hexo 项目的根目录下创建 CNAME 文件并输入域名，然后在域名管理后台添加 CNAME 记录。
