技术

《我的 Hugo + Cloudflare 自动化博客搭建手册》 一套属于自己的博客系统，不仅仅是一个网站，更是一份可以陪伴很多年的数字资产。 第一章 为什么重建博客 1.1 写在前面 从学生时代开始，我就一直有写博客的习惯。 最早接触的是 Hexo + GitHub Pages，那时候更多的是为了记录一些折腾电脑、网络和编程的过程。后来由于域名到期、工作繁忙以及博客长期没有维护，整个博客逐渐停止更新，最终也无法继续访问。 多年以后，我重新开始思考一个问题： 互联网上那么多内容，真正属于自己的还有多少？ 朋友圈会被时间淹没，微信公众号受平台限制，知乎、微博等平台都有自己的规则。只有自己拥有的博客，数据、域名、内容、排版、访问方式，全部掌握在自己手里。 因此，我决定重新搭建一个属于自己的博客。 这一次，我希望它不仅仅是一个写文章的网站，而是一套能够长期稳定运行、几乎无需维护、可以陪伴自己很多年的知识管理系统。 1.2 我的目标 重建博客时，我给自己定下了几个目标。 第一，坚持简单。 博客应该把精力放在内容，而不是维护网站本身。 因此，我希望整个发布流程能够尽可能自动化，让写作成为唯一需要关注的事情。 第二，数据完全属于自己。 所有文章都以 Markdown 保存。 所有图片保存在自己的仓库。 所有源码托管在 GitHub。 网站部署在 Cloudflare Pages。 域名使用自己的 leesy.cc。 任何时候，即使更换电脑、更换服务器，也可以快速恢复整个博客。 第三，速度快、访问稳定。 选择 Cloudflare Pages 的原因并不仅仅是免费。 更重要的是： 全球 CDN 加速 自动 HTTPS 自动部署 与 GitHub 无缝集成 不需要维护服务器 整个博客真正实现了静态化部署，没有数据库，没有后台，没有运维压力。 第四，让博客成为长期积累的平台。 博客未来主要记录以下几个方面： 电网技术学习笔记 NAS 与家庭服务器折腾记录 Docker、Cloudflare、Linux 等技术实践 AI 工具使用心得 阅读笔记 健康与运动记录 日常思考与生活随笔 希望很多年以后，再回来看这些文章，依然能够知道当时为什么这样思考、为什么这样做。 ...

说实话，我感觉自己是个笨人。别人两个小时就可以干完的，我需要花费差不多两天才能搞定。尤其是对于这个编程软件之类的，自己总是勤勤恳恳学习，但收获总是不大。从23年在公司安监部借调期间，搭建的hexo博客，上线不到3个月就因为工作太忙而弃之不用。一直到26年年中，才因为一个偶然的机会，主要是AI技术发展太快了，让我这等笨人，也能在自然语言的交流下，实现了github、hugo、cloudflare的一些实用功能。从而让我尘封已久的想法慢慢变成了现实。 第一个，再次搭建一个hugo博客。按照AI的话说，这个很简单，十分钟就帮我搞定。结果我从上午折腾到了下午，又从下午折腾到了晚间，终于经过不断的努力尝试排错，让我这个简陋的博客，正式上线啦。 附上美美的照片： 期间主要经历了以下坑： 1、Hexo → Hugo 迁移 2、图片路径调整 3、GitHub 仓库管理 4、Git 基本操作（commit、push、pull、rebase） 5、GitHub Actions 自动部署 6、GitHub Pages 7、Cloudflare 自定义域名 8、DNS 排查 9、Hugo Front Matter 格式 这每一个，对我来说都是全新内容，加上AI，它的信息并不是最新的，导致它说的很多地方找不到，然后就再次询问，一来二去的，导致一个小问题，别人1秒可以搞定，我却需要半小时才搞明白。 为了不让以后的写博客之路出现故障，在此，我对其中的主要操作细节和流程进行一个记录和复盘，便于以后回顾。 博客地址： https://blog.leesy.cc 源码仓库： https://github.com/zkzkeep/blog 一、博客目录位置 Mac 本地博客目录： 这是正文 ~/Documents/blog 进入博客目录： cd ~/Documents/blog 确认是否进入成功： pwd 应该显示： /Users/leesdove/Documents/blog 二、本地预览博客 进入博客目录： cd ~/Documents/blog 启动 Hugo： hugo server 浏览器访问： http://localhost:1313 停止服务： Ctrl + C 三、新建文章 方法一（推荐） 打开 Typora 新建文件 保存到： ~/Documents/blog/content/posts/ 文件名例如： 我的第一篇文章.md 文章模板： +++ title = "我的第一篇文章" date = 2026-06-25 draft = false tags = ["生活"] categories = ["随笔"] +++ 这里开始写正文 方法二（Hugo命令） 必须先进入博客目录： ...