上一篇
Hexo提示SSL证书不安全怎么办？如何配置HTTPS证书
在使用 Hexo 进行博客搭建与维护的过程中，许多开发者在尝试部署到 GitHub Pages 或其他支持 HTTPS 的服务时，可能会遇到关于 SSL 证书安全性的提示或警告，虽然 Hexo 本身是一个静态博客生成器，并不直接处理 SSL 证书的颁发与配置，但在本地开发环境、本地服务器测试以及某些自动化部署脚本中，如果出现“SSL 证书不安全”或类似的提示，通常意味着当前的 HTTPS 连接无法通过浏览器的安全验证，这种情况不仅会影响用户体验，导致浏览器地址栏显示“不安全”警告，还可能阻碍某些依赖安全连接的工具（如 Git 推送、API 调用）正常工作，要彻底解决这一问题，我们需要从本地开发环境配置、证书生成以及部署端设置三个维度进行深入排查和处理。
我们需要明确问题的根源,在本地使用 hexo server 启动服务时，默认情况下 Hexo 是通过 HTTP 协议提供服务的，并不涉及 SSL 证书，如果你看到了 SSL 相关的错误，通常是因为你使用了第三方插件（如 hexo-server-ssl）尝试在本地启用 HTTPS，或者你的浏览器对本地自签名证书存在兼容性问题，当 Hexo 生成的静态文件部署到 GitHub Pages 时，GitHub 会自动提供免费的 SSL 证书，此时若出现证书错误，往往是因为 DNS 解析未生效、缓存问题或自定义域名配置错误，而非 Hexo 本身的问题。
针对本地开发环境中的 SSL 提示，最直接的解决方案是生成并信任自签名证书，你可以使用 OpenSSL 工具在本地生成证书文件，具体步骤包括打开终端，进入 Hexo 项目根目录，执行命令生成私钥和证书文件，生成后，你需要修改 Hexo 的配置文件 _config.yml，启用 SSL 支持并指定证书路径，由于自签名证书不被操作系统和浏览器默认信任，你还需要手动将生成的 .crt 文件添加到操作系统的受信任根证书颁发机构列表中，对于 macOS 用户，可以使用 Keychain Access 导入证书并设置为始终信任；对于 Windows 用户，则需要通过双击证书进入安装向导，选择“本地计算机”并导入到受信任的根证书颁发机构存储中，完成这些步骤后，重启 Hexo 服务器，浏览器应能正常识别并建立安全连接。
为了更清晰地展示不同场景下的解决方案,我们可以参考以下对比表格：
| 场景 | 常见原因 | 解决方案 | 难度 |
|---|---|---|---|
| 本地 Hexo Server | 使用自签名证书且未信任 | 生成证书并手动添加到系统信任库 | 中等 |
| 本地 Hexo Server | 插件配置错误 | 检查 _config.yml 中的 ssl 配置项 | 简单 |
| GitHub Pages 部署 | DNS 解析未生效 | 等待 DNS 传播或检查 CNAME 记录 | 简单 |
| GitHub Pages 部署 | 浏览器缓存问题 | 清除浏览器缓存或使用无痕模式访问 | 简单 |
| 自定义域名部署 | 证书未正确绑定 | 在 GitHub 仓库设置中重新触发证书生成 | 中等 |
除了本地环境,部署到 GitHub Pages 时的 SSL 问题也需特别注意，GitHub Pages 默认强制使用 HTTPS，并自动为 username.github.io 域名提供 Let’s Encrypt 证书，如果你使用了自定义域名，必须确保 DNS 记录正确指向 GitHub 的服务器 IP 或 CNAME 记录，如果在部署后仍提示证书错误，可以尝试在 GitHub 仓库的 Settings -> Pages 中，取消勾选 “Enforce HTTPS” 再重新勾选，以强制 GitHub 重新颁发证书，检查 _config.yml 中的 url 字段是否准确设置为 https:// 开头，这有助于 Hexo 生成正确的内部链接，避免混合内容（Mixed Content）警告。
值得注意的是,现代浏览器对 HTTP 内容的限制日益严格，如果你的页面中嵌入了 HTTP 协议的图片、脚本或样式表，浏览器可能会阻止加载这些资源，从而破坏页面的安全性体验，在解决 SSL 证书问题的同时，务必检查所有静态资源链接是否都使用了 HTTPS 协议，对于本地开发，如果不需要严格的 HTTPS 测试，也可以考虑暂时忽略证书警告，专注于内容创作，待部署到正式环境后再处理证书信任问题，这样能显著提高开发效率。
相关问答 FAQs
Q1: 在本地使用 Hexo 开启 HTTPS 后，浏览器仍然提示“证书不受信任”，该如何解决？
A1: 这是因为自签名证书未被操作系统信任，你需要手动将生成的证书文件添加到系统的受信任根证书颁发机构中，在 macOS 上，双击证书文件打开钥匙串访问，双击证书并选择“始终信任”；在 Windows 上，双击证书，点击“安装证书”，选择“本地计算机”，并将证书放入“受信任的根证书颁发机构”，重启浏览器后，警告应消失。
Q2: 部署到 GitHub Pages 后，自定义域名显示 SSL 证书错误，但 username.github.io 正常，可能是什么原因？
A2: 这通常是因为自定义域名的 DNS 记录配置不正确或尚未完全生效，请检查你的 DNS 提供商处，是否已正确添加 CNAME 记录指向 username.github.io 或 A 记录指向 GitHub 的 IP 地址，GitHub 可能需要几分钟到几小时来为自定义域名签发 SSL 证书，你可以尝试在 GitHub 仓库设置中重新触发 HTTPS 强制启用，或等待 DNS 传播完成后再次检查，如果问题持续，可尝试清除本地 DNS 缓存。
