Hugo 自定义域名配置指南

默认已完成部署，如尚未部署详见《Hugo 博客自动化部署指南》。

网站部署到 GitHub Pages 或 Cloudflare Pages 后，平台会自动分配一个默认域名用于访问（如 https://example.github.io）。如果希望使用自定义域名（如 example.com）使地址更个性化且易于记忆分享，需要先购买域名并完成实名认证，再将 DNS 解析指向部署平台。

下面以 阿里云万网 为例，介绍如何将已有域名绑定到 GitHub Pages 或 Cloudflare Pages。¹

域名绑定

GitHub Pages

打开 阿里云域名控制台，选择域名，点击 解析 > 添加记录：

运行以下命令，创建 CNAME，以便绑定自定义域名：

1

echo "example.com" > CNAME

打开 GitHub 远程仓库，点击 Settings > Pages > Custom domain，输入自定义域名，并勾选 Enforce HTTPS。配置完成后，站点即可通过自定义域名访问。

Cloudflare Pages

打开 Cloudflare，点击 添加域，输入域名（如 example.com），选择 Free 套餐，记录名称服务器。

打开 阿里云域名控制台，点击 域名列表 > 选择域名 > DNS 修改，替换为 Cloudflare 的名称服务器。

DNS 生效后返回 Cloudflare 控制台，点击 Workers 和 Pages，选择对应的 Pages，点击 自定义域 > 添加自定义域（如 example.com 和 www.example.com）。域名校验完成后会自动启用 HTTPS。

自定义域名邮箱（可选）：

• 点击 电子邮件服务 > 电子邮件路由 > 目标地址，添加并验证邮箱地址（如 example@mail.com）。
• 点击 电子邮件服务 > 电子邮件路由 > 接入域名，输入域名（如 example.com），并添加 DNS 记录，Cloudflare 会自动完成配置，接管域名的邮件服务。
• 打开邮件路由，创建 路由规则，如 contact@example.com 发送到电子邮件 example@mail.com。

站点配置

修改主题配置文件：

1

baseURL = "https://example.com/"

运行以下命令，提交并推送修改至 GitHub 仓库：

1
2
3

git add -A
git commit -m "自定义域名"
git push origin main

平台会自动触发构建，完成后即可通过自定义域名访问站点。