域名解析前的准备工作
在开始配置 Hexo 域名之前,需要完成几项基础准备工作,以确保后续步骤顺利进行,确保你的 Hexo 站点已成功部署到 GitHub Pages、Vercel 或其他支持静态托管的平台,若选择 GitHub Pages,需已创建仓库并将代码推送至 gh-pages 分支或主分支(根据 GitHub 最新规则),且通过 https://<用户名>.github.io/<仓库名> 可正常访问,准备好一个已注册的域名,建议在阿里云、腾讯云或 Namecheap 等主流服务商处购买,并确保该域名未绑定其他项目,检查本地 Hexo 站点的 _config.yml 文件中 url 配置是否正确——这通常指向你的托管平台地址,url: https://<用户名>.github.io/<仓库名>,虽然后续会覆盖为自定义域名,但初始配置的正确性能避免一些潜在问题。

域名解析的基本操作
域名解析是将域名指向服务器 IP 地址的过程,是 Hexo 配置自定义域名的核心步骤,以阿里云为例,登录域名管理控制台,找到目标域名,进入“解析”设置页面,添加两条主要记录:
-
A 记录:用于将域名指向 IP 地址,若你的托管平台提供固定 IP(如 Vercel 可通过
vercel.com/domains获取),则直接填写 IP;若使用 GitHub Pages,由于 GitHub 动态分配 IP,需改为CNAME记录(见下文),记录值填写托管平台分配的 IP,主机记录填写 (代表根域名)或www(带 www 前缀),TTL 选择默认值即可。 -
CNAME 记录:若托管平台不支持直接 IP 绑定(如 GitHub Pages),需添加 CNAME 记录,主机记录同样为 或
www,记录值填写托管平台提供的域名,GitHub Pages 的<用户名>.github.io或 Vercel 提供的.vercel.app域名。
完成记录添加后,等待 DNS 生效(通常为 10 分钟至 24 小时,可通过 ping <你的域名> 检查是否指向正确 IP),若使用 GitHub Pages,需在仓库根目录创建一个名为 CNAME 的无扩展名文件,内容仅包含你的自定义域名(如 example.com),并推送至托管分支。
Hexo 本地配置与域名关联
域名解析生效后,需在 Hexo 项目中进行本地配置,确保站点生成时正确引用自定义域名,打开 Hexo 站点根目录下的 _config.yml 文件,修改 url 字段为你的自定义域名,url: https://example.com(若使用 www 前缀,则填写 https://www.example.com),若站点启用了 HTTPS(推荐),需确保 url 包含 https:// 前缀。
若你希望同时支持带 www 和不带 www 的访问,可在 _config.yml 中配置 root 字段,若域名是 example.com 且站点存放在子目录(如 https://example.com/blog),则 root: /blog;若直接绑定根域名,root 可留空或设置为 。

完成修改后,执行 hexo clean && hexo generate 重新生成静态文件,并推送至托管平台,通过浏览器访问你的自定义域名,应能看到 Hexo 站点内容。
HTTPS 证书配置与安全优化
虽然 HTTP 可实现域名访问,但 HTTPS 能提升网站安全性和 SEO 排名,建议优先配置,对于 GitHub Pages,可启用 GitHub 提供的免费 HTTPS:进入仓库设置,在“Pages”部分找到“Custom domain”,输入你的域名并勾选“Enforce HTTPS”,等待 GitHub 自动签发证书(约 5 分钟)。
若使用其他托管平台(如 Vercel、Netlify),通常在域名的 DNS 设置中自动配置 HTTPS,或需手动上传证书(如 Let’s Encrypt 提供的免费证书),对于自建服务器,可通过 Certbot 工具自动申请和部署 SSL 证书。
配置 HTTPS 后,需确保 Hexo 生成的静态资源(如图片、CSS 文件)使用相对路径,避免因协议不一致导致资源加载失败,检查主题配置文件,确保 url 字段已正确指向 https 域名,并避免使用硬编码的 http 链接。
常见问题与解决方案
在 Hexo 域名配置过程中,可能会遇到以下问题:
-
域名无法访问:首先检查 DNS 解析是否生效(通过
nslookup或在线 DNS 检查工具),确认托管平台是否正确绑定域名(如 GitHub Pages 的CNAME文件是否存在),若解析生效但访问异常,尝试清除浏览器缓存或使用无痕模式。
-
资源加载失败:通常因
url配置错误导致,检查_config.yml中的url是否为自定义域名,且主题文件中的资源路径是否使用相对路径(如{{ url }}/images/avatar.jpg)。 -
HTTPS 证书错误:若证书未自动签发或显示“不安全”,可尝试手动刷新证书(如 GitHub 的“Enforce HTTPS”选项),或检查 DNS 记录是否包含正确的 CNAME 指向。
-
301 重定向配置:若希望统一
www和非www域名(如将example.com重定向至www.example.com),可在托管平台的重定向设置中配置,或在服务器上通过.htaccess文件(Apache)或 Nginx 配置实现。
总结与进阶建议
配置 Hexo 自定义域名是搭建个人博客的重要一步,核心在于 DNS 解析与本地配置的协同,完成基础配置后,还可进一步优化:启用 CDN 加速(如 Cloudflare)、配置 Google Analytics 分析流量、或通过自定义域名增强品牌标识。
若后续更换托管平台,只需更新 DNS 解析记录及 Hexo 的 url 配置即可,无需大幅修改站点代码,保持域名的稳定性和 HTTPS 的启用,不仅能提升用户体验,也是对网站长期运营的保障,通过以上步骤,你已能熟练掌握 Hexo 域名配置,为个人博客的搭建与推广打下坚实基础。

















