免费的庇护所:使用Hexo创建自己的博客网站,免费,可扩展

免费的庇护所:使用Hexo创建自己的博客网站,免费,可扩展

风之神韵的庇护所 Lv1

废土纪年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仓库

  1. 登录GitHub,创建一个新仓库
  2. 仓库名必须为:用户名.github.io(例如:mygitname.github.io
  3. 设置为public仓库

第二步:配置SSH密钥

为了方便后续的代码推送,我们需要配置SSH密钥。

  1. 在桌面空白处右键,选择”Git Bash Here”
  2. 生成SSH密钥:
1
ssh-keygen -t rsa -C "你的邮箱@example.com"
  1. 找到生成的公钥文件,路径通常为:
1
C:\Users\用户名\.ssh\id_rsa.pub
  1. 用记事本打开pub文件,把里面的内容全都复制,然后去GitHub的Settings -> SSH and GPG keys中添加新的SSH密钥
  2. 回到GitBash窗口输入下面代码,测试SSH连接是否成功:
1
ssh -T git@github.com

第三步:安装和初始化Hexo

  1. 创建一个空文件夹作为博客目录
  2. 在该文件夹中打开Git Bash
  3. 执行以下命令:
1
2
3
4
5
6
7
8
9
10
11
# 初始化Hexo项目
hexo init

# 安装依赖
hexo install

# 生成静态文件
hexo g

# 启动本地服务器
hexo s
  1. 浏览器访问 http://localhost:4000 即可看到您的博客

Ctrl + C 退出本地服务器。

第四步:配置部署

  1. 打开根目录下的 _config.yml 文件
  2. 滑动到文件底部,找到deploy配置项,修改为:
1
2
3
4
deploy:
type: git
repository: https://github.com/你的用户名/你的用户名.github.io.git
branch: main
  1. 安装部署插件:
1
npm install hexo-deployer-git --save

第五步:部署到GitHub Pages

执行以下命令将博客部署到GitHub Pages:

1
2
3
4
5
6
7
8
# 清理缓存
hexo clean

# 生成静态文件
hexo g

# 部署到GitHub
hexo d

或者使用简写命令:

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
2
3
4
5
6
7
8
9
10
# 1. 创建新文章
hexo new "我的新文章"

# 2. 编辑文章(使用您喜欢的编辑器)

# 3. 本地预览
hexo s

# 4. 部署到线上
hexo clean && hexo g && hexo d

总结

恭喜!您现在已经拥有了一个完全免费的个人博客网站。接下来您可以:

  • 选择喜欢的主题
  • 安装有用的插件
  • 自定义网站样式
  • 开始写作您的第一篇文章

记住,最重要的不是工具本身,而是坚持不懈地创作有价值的内容。愿您的博客成为知识分享的美好园地!


相关链接:


夜幕渐渐降临,废土上的寒风开始呼啸…

你终于在天黑之前完成了数字庇护所的建造,但这个过程并不顺利。几次险些失败的尝试让你明白,在这个危险的数字废土中,每一个细节都可能成为生死存亡的关键。

你决定在庇护所的墙上刻下这些血泪教训,为后来的拾荒者指路,避免他们在黑暗中迷失方向…

⚠️ 避坑指南:废土求生必知

🔍 问题诊断:当庇护所建造失败时

如果遇到 hexo cleanhexo generate 命令无法正常生成 public 文件夹中的HTML文件:

1
2
# 使用调试模式查看具体错误信息
hexo generate --debug

观察输出信息中的关键线索:

  • Segmentation fault - 渲染过程崩溃
  • ERROR 开头的错误信息
  • 在哪个文件渲染时停止

🛠️ 排除故障:二分查找法

当确认是Markdown文件格式问题导致渲染崩溃时:

  1. 备份问题文件

    1
    2
    # 备份当前文章
    cp source/_posts/问题文章.md source/_posts/问题文章_backup.md
  2. 二分排除内容

    • 删除文章的一半内容,测试 hexo g
    • 如果成功生成,问题在删除的部分
    • 如果仍然失败,问题在保留的部分
    • 重复此过程直到找到具体的问题行
  3. 常见问题点

    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
2
3
4
5
6
$ hexo d
INFO Clearing .deploy_git folder...
INFO Copying files from public folder...
On branch master
nothing to commit, working tree clean
Everything up-to-date

后果: GitHub仓库中的所有文件被删除,网站变成空白页面

预防措施:

1
2
3
4
5
6
# 部署前务必检查public文件夹
ls public
# 确保包含: index.html, css/, js/, 等文件

# 确认生成成功后再部署
hexo clean && hexo generate && ls public && hexo deploy

🔧 紧急恢复:当庇护所被摧毁时

如果GitHub仓库已被清空:

  1. 检查Git历史记录

    • 在GitHub仓库页面查看commits
    • 可以回滚到文件删除前的版本
  2. 重新部署

    1
    2
    3
    4
    5
    # 删除损坏的部署文件夹
    rm -rf .deploy_git

    # 确保正确生成后重新部署
    hexo clean && hexo generate && hexo deploy

💡 生存智慧:预防胜于治疗

  • 定期备份源码 - 为博客源文件创建Git仓库
  • 分步验证 - 每次修改后先本地测试 hexo s
  • 谨慎部署 - 确认 public 文件夹内容正确后再执行 hexo d
  • 版本控制 - 使用Git管理您的博客源码,而不仅仅是生成的静态文件

记住:在数字废土中,备份就是生命线,谨慎就是求生本能!

知乎主页:https://www.zhihu.com/people/feng-zhi-shen-yun-89

Comments