⚠️ 重要前置条件：实名认证
不完成实名认证，域名无法正常使用！
需要完成的认证
| 认证类型 | 平台 | 时间 | 说明 |
|---|---|---|---|
| 阿里云实名认证 | 阿里云账号 | 即时 | 购买域名前必须完成 |
| 域名注册局实名 | 域名注册局 | 1-3天 | 购买域名后必须完成 |
实名认证信息要求
必须使用真实信息：
- ✅ 真实姓名（与身份证一致）
- ✅ 真实身份证号
- ✅ 真实手机号（能接收验证码）
- ✅ 真实邮箱
❌ 虚假信息会导致：
- 域名被锁定（serverHold 状态）
- 无法解析
- 无法转移
- 域名被收回
第一阶段：购买域名前的准备
步骤 1：阿里云账号实名认证
访问：https://account.console.aliyun.com/
操作：
- 登录阿里云账号
- 点击「实名认证」
- 选择认证方式：
- 个人认证：上传身份证正反面照片
- 企业认证：上传营业执照
- 填写真实姓名和身份证号
- 人脸识别验证
- 等待审核（通常几分钟到几小时）
验证方法：
控制台 → 账号中心 → 实名认证
状态显示：「已实名认证」
步骤 2：准备购买信息
需要准备：
- 支付宝/银行卡（付款）
- 域名名称（如：wuqq547.top）
- 真实联系信息
第二阶段：购买域名
步骤 3：搜索并购买域名
访问：https://wanwang.aliyun.com/
操作：
- 在搜索框输入想要的域名（如：wuqq547）
- 选择后缀（.top / .com / .cn 等）
- 点击「查询域名」
- 选择可用的域名，点击「加入清单」
- 点击「立即购买」
- 选择购买年限（建议 1 年起）
- 确认订单，支付
⚠️ 关键：购买时填写的信息必须真实！
步骤 4：完成域名注册局实名
访问：https://dc.console.aliyun.com/
操作：
- 找到刚购买的域名
- 状态显示：「未实名认证」或「注册局实名认证中」
- 点击「实名认证」
- 选择认证类型：
- 个人：上传身份证照片
- 企业：上传营业执照
- 填写信息（必须与阿里云账号实名信息一致）
- 提交审核
审核时间：1-3 个工作日
验证方法：
域名控制台 → 找到域名
状态显示：「正常」或「实名认证成功」
常见状态说明：
未实名认证→ 需要提交资料审核中→ 等待 1-3 天实名认证失败→ 信息有误，重新提交正常→ 可以使用了！
第三阶段：配置 DNS 解析
步骤 5：获取阿里云 DNS 服务器地址
访问：https://dns.console.aliyun.com/
操作：
- 找到你的域名
- 页面顶部显示分配的 NS 地址：
dns15.hichina.com dns16.hichina.com - 复制这两个地址
步骤 6：修改域名 NS 服务器
访问：https://dc.console.aliyun.com/
操作：
- 找到域名，点击「管理」
- 找到「DNS 服务器」或「DNS 修改」
- 点击「修改 DNS 服务器」
- 选择「使用自定义 DNS」
- 填入：
dns15.hichina.com dns16.hichina.com - 点击「确认」
⚠️ 注意：
- NS 修改后需要 10 分钟 - 48 小时 生效
- 期间不要重复修改
步骤 7：添加 DNS 解析记录
访问：https://dns.console.aliyun.com/
操作：
- 找到域名，点击「解析」
- 点击「添加记录」
- 依次添加 5 条记录：
记录 1：
记录类型：A
主机记录：@
解析线路：默认
记录值：185.199.108.153
TTL：10分钟
记录 2：
记录类型：A
主机记录：@
解析线路：默认
记录值：185.199.109.153
TTL：10分钟
记录 3：
记录类型：A
主机记录：@
解析线路：默认
记录值：185.199.110.153
TTL：10分钟
记录 4：
记录类型：A
主机记录：@
解析线路：默认
记录值：185.199.111.153
TTL：10分钟
记录 5：
记录类型：CNAME
主机记录：www
解析线路：默认
记录值：wubajie.github.io
TTL：10分钟
添加完成后，记录列表应显示：
A @ 185.199.108.153
A @ 185.199.109.153
A @ 185.199.110.153
A @ 185.199.111.153
CNAME www wubajie.github.io
第四阶段：配置 GitHub Pages
步骤 8：配置自定义域名
访问：https://github.com/用户名/用户名.github.io/settings/pages
（将「用户名」替换为你的 GitHub 用户名）
操作：
- 找到「Custom domain」输入框
- 填入你的域名：
wuqq547.top - 点击「Save」
- 等待 DNS 检查（显示绿色 ✓）
- 勾选「Enforce HTTPS」（强制 HTTPS）
⚠️ 注意：
- 如果 DNS 检查失败，说明 NS 还没生效，等待后再试
- HTTPS 证书需要几分钟到几小时生成
步骤 9：创建 CNAME 文件
本地操作：
# 进入博客项目目录
cd ~/Documents/blog_wqq/my-tech-blog
# 创建 CNAME 文件
echo "wuqq547.top" > static/CNAME
# 验证内容
cat static/CNAME
# 输出：wuqq547.top
为什么需要 CNAME 文件？
- GitHub Pages 通过 CNAME 文件识别自定义域名
- 每次推送后，GitHub 会读取这个文件
第五阶段：本地配置与部署
步骤 10：修改 Hugo 配置
编辑 hugo.toml：
code ~/Documents/blog_wqq/my-tech-blog/hugo.toml
修改 baseURL：
baseURL = 'https://wuqq547.top/'
完整配置示例：
baseURL = 'https://wuqq547.top/'
languageCode = 'zh-cn'
title = 'wuqq 的 Blog'
theme = 'PaperMod'
[params]
description = "wuqq的技术博客"
author = "wuqq"
步骤 11：构建并推送
# 进入项目目录
cd ~/Documents/blog_wqq/my-tech-blog
# 清理旧构建
rm -rf public/
# 构建网站
hugo --minify
# 检查生成的 CNAME 文件
cat public/CNAME
# 应该输出：wuqq547.top
# Git 提交
git add -A
git commit -m "配置自定义域名 wuqq547.top"
# 推送到 GitHub
git push origin main
第六阶段：验证与测试
步骤 12：验证 DNS 解析
Mac 终端执行：
# 检查 NS 服务器
dig NS wuqq547.top +short
# 预期输出：
# dns15.hichina.com.
# dns16.hichina.com.
# 检查 A 记录
dig A wuqq547.top +short
# 预期输出：
# 185.199.108.153
# 185.199.109.153
# 185.199.110.153
# 185.199.111.153
# Ping 测试
ping -c 4 wuqq547.top
# 预期：能 ping 通，显示 GitHub IP
步骤 13：验证网站访问
# HTTP 头信息检查
curl -I https://wuqq547.top
# 预期输出：
# HTTP/2 200
# server: GitHub.com
# ...
步骤 14：浏览器访问测试
访问以下地址：
- ✅ https://wuqq547.top/（主域名）
- ✅ https://www.wuqq547.top/（www 子域名）
- ✅ https://wubajie.github.io/（原地址，应自动跳转）
检查要点：
- 显示 🔒 安全锁（HTTPS 正常）
- 地址栏显示 wuqq547.top
- 页面内容正确加载
常见问题排查
Q1: 域名显示「未实名认证」
原因：域名注册局实名未完成
解决：
- 访问 https://dc.console.aliyun.com/
- 找到域名，点击「实名认证」
- 重新提交身份证照片
- 等待 1-3 天
Q2: ping 域名显示 Unknown host
原因：NS 服务器未生效或 DNS 记录未添加
排查步骤：
# 1. 检查 NS
dig NS wuqq547.top +short
# 应该返回 dns15.hichina.com
# 2. 检查 A 记录
dig A wuqq547.top +short
# 应该返回 4 个 GitHub IP
解决：
- NS 不对 → 去域名控制台修改 DNS 服务器
- A 记录为空 → 去 DNS 控制台添加解析记录
Q3: GitHub Pages 显示 404
原因：CNAME 文件缺失或配置错误
解决：
- 检查
static/CNAME文件存在 - 检查内容为纯域名（无 https://）
- 重新构建推送
Q4: 访问跳转到旧域名
原因：浏览器缓存或 Hugo 配置错误
解决：
- 清除浏览器缓存（Cmd + Shift + R）
- 检查
hugo.toml中baseURL正确 - 重新构建推送
Q5: HTTPS 证书错误
原因：证书正在生成或配置错误
解决：
- 等待 1 小时（证书自动生成）
- GitHub Pages 设置中取消勾选「Enforce HTTPS」
- 等待 2 分钟
- 重新勾选「Enforce HTTPS」
完整流程图
┌─────────────────────────────────────────────────────────────┐
│ 第一阶段：实名认证（必须！） │
│ 阿里云账号实名 → 购买域名 → 域名注册局实名 │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 第二阶段：DNS 配置 │
│ 获取 NS 地址 → 修改域名 NS → 添加 A/CNAME 记录 │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 第三阶段：GitHub 配置 │
│ Pages 设置域名 → 勾选 HTTPS → 创建 CNAME 文件 │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 第四阶段：本地配置 │
│ 修改 hugo.toml → 构建 → 推送 │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 第五阶段：验证 │
│ dig 检查 → ping 测试 → 浏览器访问 │
└─────────────────────────────────────────────────────────────┘
关键检查清单
购买域名前
- 阿里云账号已完成实名认证
- 准备好真实身份证信息
购买域名后
- 完成域名注册局实名认证
- 等待实名审核通过（1-3天）
- 域名状态显示「正常」
配置 DNS
- 获取阿里云分配的 NS 地址
- 修改域名 NS 服务器
- 添加 4 条 A 记录
- 添加 1 条 CNAME 记录
- 等待 NS 生效（10分钟-48小时）
配置 GitHub
- Pages 设置中填入自定义域名
- DNS 检查通过（绿色 ✓）
- 勾选 Enforce HTTPS
本地配置
- 创建 static/CNAME 文件
- 修改 hugo.toml baseURL
- 构建并推送
验证
- dig NS 返回正确
- dig A 返回 4 个 IP
- ping 通域名
- 浏览器能访问
- HTTPS 证书正常
总结
核心要点：
- 实名认证是前提 - 不完成无法使用域名
- 信息必须真实 - 虚假信息会导致域名被锁定
- NS 配置是关键 - 域名注册商和 DNS 服务商要一致
- 耐心等待生效 - DNS 传播需要时间
时间预估：
- 阿里云实名：几小时
- 域名注册局实名：1-3 天
- NS 生效：10 分钟 - 48 小时
- 总计：3-5 天
你的博客地址：https://wuqq547.top/
参考链接：