
免费的庇护所:使用Hexo创建自己的博客网站,免费,可扩展
废土纪年2025,AI洪流席卷大地后的第三个冬日…
你在废墟中醒来,身边散落着破碎的硬盘碎片和锈蚀的服务器残骸。信息的瓦砾堆积如山,而你唯一的求生工具只剩下一台勉强运行的终端。
在这个数据荒芜的世界里,知识就是最后的货币,而一个安全的庇护所,是你在AI废土中生存下去的唯一希望。
你决定在GitHub的遗迹上,用Hexo的古老技术,为自己建造一座免费的数字庇护所——一个属于拾荒者的博客堡垒…
知乎主页:https://www.zhihu.com/people/feng-zhi-shen-yun-89
在这个信息爆炸的时代,拥有一个属于自己的博客网站显得尤为重要。今天我将带大家使用Hexo和GitHub Pages搭建一个完全免费、功能强大且可扩展的个人博客。
什么是Hexo?
Hexo是一个快速、简洁且高效的博客框架,基于Node.js开发,支持Markdown语法,拥有丰富的主题和插件生态。
官方网站: https://hexo.io/
GitHub仓库: https://github.com/hexojs/hexo
准备工作
在开始之前,请确保您已经安装了:
- Node.js (版本 12.0 或更高)
- Git
- GitHub 账号
第一步:创建GitHub仓库
- 登录GitHub,创建一个新仓库
- 仓库名必须为:
用户名.github.io
(例如:mygitname.github.io
) - 设置为public仓库
第二步:配置SSH密钥
为了方便后续的代码推送,我们需要配置SSH密钥。
- 在桌面空白处右键,选择”Git Bash Here”
- 生成SSH密钥:
1 | ssh-keygen -t rsa -C "你的邮箱@example.com" |
- 找到生成的公钥文件,路径通常为:
1 | C:\Users\用户名\.ssh\id_rsa.pub |
- 用记事本打开pub文件,把里面的内容全都复制,然后去GitHub的Settings -> SSH and GPG keys中添加新的SSH密钥
- 回到GitBash窗口输入下面代码,测试SSH连接是否成功:
1 | ssh -T git@github.com |
第三步:安装和初始化Hexo
- 创建一个空文件夹作为博客目录
- 在该文件夹中打开Git Bash
- 执行以下命令:
1 | # 初始化Hexo项目 |
- 浏览器访问
http://localhost:4000
即可看到您的博客
按 Ctrl + C
退出本地服务器。
第四步:配置部署
- 打开根目录下的
_config.yml
文件 - 滑动到文件底部,找到deploy配置项,修改为:
1 | deploy: |
- 安装部署插件:
1 | npm install hexo-deployer-git --save |
第五步:部署到GitHub Pages
执行以下命令将博客部署到GitHub Pages:
1 | # 清理缓存 |
或者使用简写命令:
1 | hexo clean && hexo g && hexo d |
第六步:发布文章
创建新文章非常简单:
1 | hexo new 文章标题 |
这会在 source/_posts/
目录下生成一个新的Markdown文件,您可以用任何文本编辑器编辑它。
常见问题解决
1. 部署时出现 “Deployer not found: git” 错误
解决方案: 安装Git部署插件
1 | npm install hexo-deployer-git --save |
2. 访问GitHub Pages显示404
可能原因:
- 仓库名格式不正确(必须是
用户名.github.io
) - 还没有完全部署完成(等待几分钟)
- 分支设置错误(确保部署到正确分支)
完整的工作流程
日常写博客的完整流程:
1 | # 1. 创建新文章 |
总结
恭喜!您现在已经拥有了一个完全免费的个人博客网站。接下来您可以:
- 选择喜欢的主题
- 安装有用的插件
- 自定义网站样式
- 开始写作您的第一篇文章
记住,最重要的不是工具本身,而是坚持不懈地创作有价值的内容。愿您的博客成为知识分享的美好园地!
相关链接:
夜幕渐渐降临,废土上的寒风开始呼啸…
你终于在天黑之前完成了数字庇护所的建造,但这个过程并不顺利。几次险些失败的尝试让你明白,在这个危险的数字废土中,每一个细节都可能成为生死存亡的关键。
你决定在庇护所的墙上刻下这些血泪教训,为后来的拾荒者指路,避免他们在黑暗中迷失方向…
⚠️ 避坑指南:废土求生必知
🔍 问题诊断:当庇护所建造失败时
如果遇到 hexo clean
和 hexo generate
命令无法正常生成 public
文件夹中的HTML文件:
1 | # 使用调试模式查看具体错误信息 |
观察输出信息中的关键线索:
Segmentation fault
- 渲染过程崩溃ERROR
开头的错误信息- 在哪个文件渲染时停止
🛠️ 排除故障:二分查找法
当确认是Markdown文件格式问题导致渲染崩溃时:
备份问题文件
1
2# 备份当前文章
cp source/_posts/问题文章.md source/_posts/问题文章_backup.md二分排除内容
- 删除文章的一半内容,测试
hexo g
- 如果成功生成,问题在删除的部分
- 如果仍然失败,问题在保留的部分
- 重复此过程直到找到具体的问题行
- 删除文章的一半内容,测试
常见问题点
1
2
3
4
5
6
7
8# Front Matter格式错误
title: 标题
# 此处的某些字段会导致hexo g 运行失败,Segmentation fault
# 处理方法就是找出哪个字导致的,删除掉,诡异的bug
categories: 分类名称
tags: ["xxx", "xxx"]
🚨 致命陷阱:空仓库危机
⚠️ 警告: 如果 public
文件夹生成失败,hexo deploy
会上传空内容到Git仓库!
现象:
1 | $ hexo d |
后果: GitHub仓库中的所有文件被删除,网站变成空白页面
预防措施:
1 | # 部署前务必检查public文件夹 |
🔧 紧急恢复:当庇护所被摧毁时
如果GitHub仓库已被清空:
检查Git历史记录
- 在GitHub仓库页面查看commits
- 可以回滚到文件删除前的版本
重新部署
1
2
3
4
5# 删除损坏的部署文件夹
rm -rf .deploy_git
# 确保正确生成后重新部署
hexo clean && hexo generate && hexo deploy
💡 生存智慧:预防胜于治疗
- 定期备份源码 - 为博客源文件创建Git仓库
- 分步验证 - 每次修改后先本地测试
hexo s
- 谨慎部署 - 确认
public
文件夹内容正确后再执行hexo d
- 版本控制 - 使用Git管理您的博客源码,而不仅仅是生成的静态文件
记住:在数字废土中,备份就是生命线,谨慎就是求生本能!