avatar
文章
649
标签
2112
分类
180

开发
  • 大前端
  • 人工智能
  • 小程序
  • 桌面应用
  • 游戏开发
服务器&网络
  • 服务器
  • 网络
归档
标签
友链
联系我们
仰观苍穹思环宇
开发
  • 大前端
  • 人工智能
  • 小程序
  • 桌面应用
  • 游戏开发
服务器&网络
  • 服务器
  • 网络
归档
标签
友链
联系我们

从零开始使用GitHub Pages加Hexo加自定义域名搭建个人博客完整指南

发表于2026-06-04|更新于2026-09-12|hexo
GitHub PagesHexo自定义域名DNS解析博客部署
cover of previous post
上一篇
WordPress用户评论头像本地化之完全替代Gravatar并支持自定义上传
cover of next post
下一篇
WordPress使用自定义接口方式(SQL语句)查询WooCommerce产品用户评论与留言以及渲染到前端的完整详细步骤
相关推荐
cover
2026-09-17
Hexo静态博客添加联系表单:用Google Apps Script实现邮件直达
cover
2026-09-14
多设备Hexo安装Butterfly主题里面博客search.xml过大导致GitHub推送失败的完整解决方案(含交互式清理脚本)
cover
2026-09-14
Hexo+Butterfly主题search.xml过大导致GitHub推送失败之完整排查与解决SOP
cover
2026-09-12
用Python批量给Hexo文章自动补齐TDK:DeepSeek驱动、严格YAML、动态备份的完整实践
avatar
鸢尾花序
文章
649
标签
2112
分类
180
联系我们
目录
  1. 1. 第一步:安装Node.js
    1. 1.1. 1.1 下载Node.js
    2. 1.2. 1.2 安装Node.js
    3. 1.3. 1.3 验证安装
  2. 2. 第二步:安装Hexo
    1. 2.1. 2.1 安装Hexo命令行工具
    2. 2.2. 2.2 验证Hexo安装
  3. 3. 第三步:创建Hexo项目并本地运行
    1. 3.1. 3.1 创建Hexo项目
    2. 3.2. 3.2 本地运行Hexo
    3. 3.3. 3.3 常用Hexo命令
  4. 4. 第四步:创建GitHub仓库
    1. 4.1. 4.1 登录GitHub并创建仓库
    2. 4.2. 4.2 配置GitHub连接
  5. 5. 第五步:配置Hexo部署到GitHub
    1. 5.1. 5.1 安装Hexo部署插件
    2. 5.2. 5.2 修改配置文件
    3. 5.3. 5.3 配置博客基础信息
  6. 6. 第六步:部署静态资源到GitHub仓库
    1. 6.1. 6.1 生成并部署
    2. 6.2. 6.2 检查GitHub仓库
  7. 7. 第七步:在GitHub Pages中启用Pages
    1. 7.1. 7.1 打开仓库的Pages设置
    2. 7.2. 7.2 配置Pages源
  8. 8. 第八步:根目录与docs目录的区别
    1. 8.1. 8.1 两种目录的区别
    2. 8.2. 8.2 选择建议
    3. 8.3. 8.3 如果使用docs目录
  9. 9. 第九步:购买域名并设置DNS
    1. 9.1. 9.1 购买域名
    2. 9.2. 9.2 获取GitHub Pages的IP地址
    3. 9.3. 9.3 设置根域名的A记录
    4. 9.4. 9.4 设置www域名的CNAME记录
  10. 10. 第十步:子域名的正确配置
    1. 10.1. 10.1 子域名要使用CNAME而非A记录
    2. 10.2. 10.2 为什么子域名不能用A记录
    3. 10.3. 10.3 子域名配置示例
  11. 11. 第十一步:GitHub账号级别的域名验证
    1. 11.1. 11.1 为什么要验证域名
    2. 11.2. 11.2 添加TXT记录
    3. 11.3. 11.3 完成账号验证
  12. 12. 第十二步:在仓库Pages设置中添加自定义域名
    1. 12.1. 12.1 配置仓库的Pages设置
    2. 12.2. 12.2 创建CNAME文件
    3. 12.3. 12.3 重新部署
  13. 13. 第十三步:多个子域名对应不同仓库
    1. 13.1. 13.1 场景示例
    2. 13.2. 13.2 操作步骤
  14. 14. 第十四步:验证部署是否成功
    1. 14.1. 14.1 验证步骤
    2. 14.2. 14.2 常见问题排查
  15. 15. 第十五步:启用HTTPS
    1. 15.1. 15.1 在仓库设置中启用
    2. 15.2. 15.2 等待证书颁发
  16. 16. 总结:完整配置清单
    1. 16.1. 账号级别需要做的
    2. 16.2. 仓库级别需要做的
    3. 16.3. DNS配置需要做的
  17. 17. 常见问题速查
  18. 18. 结语
    1. 18.1. 追问:
  19. 19. 关于 root: / 的解答
  20. 20. 修改后的 _config.yml
  21. 21. 完整的 _config.yml 修改后版本
  22. 22. 如何只推送静态资源(public目录)而保留源码私有
    1. 22.1. 方法一:使用 .gitignore 忽略源码文件(推荐)
    2. 22.2. 方法二:使用 Hexo 的 clean 和 deploy 分离
      1. 22.2.1. 步骤 1:初始化 Git 仓库(只在第一次执行)
      2. 22.2.2. 步骤 2:将源码推送到私有仓库(Gitee)
      3. 22.2.3. 步骤 3:使用 Hexo 部署静态资源到 GitHub(只推送 public 目录)
    3. 22.3. 方法三:使用两个不同的分支(更彻底的分离)
      1. 22.3.1. 步骤 1:创建 gh-pages 分支用于静态资源
      2. 22.3.2. 步骤 2:修改 _config.yml 部署配置
      3. 22.3.3. 步骤 3:在 GitHub Pages 设置中切换分支
      4. 22.3.4. 步骤 4:源码保留在 master 分支(私有)
    4. 22.4. 方法四:使用 Git 子模块(高级)
    5. 22.5. 推荐使用:方法二 + 方法三 的组合
  23. 23. 完整操作命令汇总
    1. 23.1. 第一次初始化(一次性操作)
    2. 23.2. 日常更新流程
  24. 24. 需要注意的关键点
  25. 25. 总结
最新文章
Hexo静态博客添加联系表单:用Google Apps Script实现邮件直达
Hexo静态博客添加联系表单:用Google Apps Script实现邮件直达2026-09-17
白手起家没有资源的人如何通过资源整合一步步突破认知并打通合作路径的完整分析
白手起家没有资源的人如何通过资源整合一步步突破认知并打通合作路径的完整分析2026-09-15
独立站定位四步法服务谁、解决什么、凭什么是你、怎么赚钱——WordPress独立站从模糊定位到清晰战略的完整框架
独立站定位四步法服务谁、解决什么、凭什么是你、怎么赚钱——WordPress独立站从模糊定位到清晰战略的完整框架2026-09-15
Duplicator全量迁移WordPress后HTTPS挂了正确做法是只换wp-content并在duplicator部署网站的时候1Panel里把数据库host填成mysql而不是localhost
Duplicator全量迁移WordPress后HTTPS挂了正确做法是只换wp-content并在duplicator部署网站的时候1Panel里把数据库host填成mysql而不是localhost2026-09-15
多设备Hexo安装Butterfly主题里面博客search.xml过大导致GitHub推送失败的完整解决方案(含交互式清理脚本)
多设备Hexo安装Butterfly主题里面博客search.xml过大导致GitHub推送失败的完整解决方案(含交互式清理脚本)2026-09-14
告别逐个转换用md2pdf一键批量把Markdown变成PDF
告别逐个转换用md2pdf一键批量把Markdown变成PDF2026-09-14
Hexo+Butterfly主题search.xml过大导致GitHub推送失败之完整排查与解决SOP
Hexo+Butterfly主题search.xml过大导致GitHub推送失败之完整排查与解决SOP2026-09-14
用Python批量给Hexo文章自动补齐TDK:DeepSeek驱动、严格YAML、动态备份的完整实践
用Python批量给Hexo文章自动补齐TDK:DeepSeek驱动、严格YAML、动态备份的完整实践2026-09-12
©2022 - 2026 By 鸢尾花序