本文章没有找到对应的语言版本

这是这个博客的第一篇文章。

本来想搞一个隆重的开场白，写点什么"为什么要写博客"或者"未来想记录什么"之类的宣言。但想了想——博客这东西，先有内容比先有理念重要。所以第一篇不立 flag，先把建站这件事记录下来，至少证明它真的能跑。

选型

需求很简单：

  • 静态博客（不想维护后端，不想操心数据库）
  • 主题好看（个人博客总要有点审美）
  • 部署省心（git push 一下就能上线最好）
  • 自定义域（不想用 xxx.github.io 这种后缀）

最后选的是：

  • Hugo —— Go 写的静态站点生成器，速度快，构建就是几秒的事
  • reimu 主题 —— D-Sketon/hugo-theme-reimu，东方 Project 风格，看板娘、樱花飘落那些我都不开，但整体审美很对我胃口
  • Cloudflare Pages —— 接 GitHub 仓库，push 即部署，全球 CDN + 自动 HTTPS
  • 域名 20033999.xyz 下的子域 blog.20033999.xyz

过程

1. 本地装 Hugo

Ubuntu 20.04，本机 hugo 不存在。apt 装的是个老古董，主题要求的版本又太新。直接去 GitHub release 抓 tarball：

1
2
3

curl -L -o hugo.tar.gz https://github.com/gohugoio/hugo/releases/download/v0.124.1/hugo_extended_0.124.1_linux-amd64.tar.gz
tar -xzf hugo.tar.gz hugo
sudo mv hugo /usr/local/bin/

版本是 v0.124.1，是当时能找到的最后一个能在我机器 glibc 2.31 上跑起来的 extended 版。hugo_extended 比普通版多了 SCSS 编译能力，主题要用到。

⚠️ 但 reimu 主题其实要求 hugo >= 0.158.0，需要 glibc 2.34+。我本机 2.31 不够。

这个弯绕了很久，最后的解法是：本地不 build，让 Cloudflare Pages build。Pages 端用的是最新 Hugo，没问题。

2. 建仓库 + 装主题

1
2
3
4
5

gh repo create blog --private --description "Personal blog (Hugo + reimu, deployed on Cloudflare Pages)"
git clone git@github.com:yursamor/blog.git
cd blog
hugo new site . --force
git submodule add https://github.com/D-Sketon/hugo-theme-reimu.git themes/reimu

主题用 submodule 引进来——好处是后面主题升级 git submodule update --remote 就行，坏处是第一次 clone 仓库要记得 git submodule update --init --recursive。

主题的 config/_default/params.yml 拷一份到自己的 config/_default/ 下面，按需改。reimu 主题是配置驱动型，菜单、社交链接、评论系统、看板娘开关都在那一个文件里。

写几个示例页面：about.md、friend.md、archives/_index.md、post/hello-world.md。hugo new post/xxx.md 会自动套用 archetype 模板，把 title / date / draft 这些字段填好。

3. Cloudflare Pages

在 dashboard 的 Workers & Pages 里：

  1. Create application → Pages → Connect to GitHub
  2. 选 yursamor/blog，授权 Cloudflare 装 GitHub App（账号级一次性的操作）
  3. Framework preset 选 Hugo，Build command 留默认（hugo --gc --minify），Build output 填 public
  4. 环境变量加 HUGO_VERSION=0.158.0 —— 这步重要，否则 Pages 用的是它默认的版本
  5. Save and Deploy

第一次构建大概 30-60 秒，构建日志能在 dashboard 看到。

4. 绑自定义域

Pages 项目 → Custom domains → Set up a domain → 输入 blog.20033999.xyz → Continue → Activate。

dashboard 内部会自动加 CNAME、自动签 SSL 证书（Google CA）。我看到的状态从 pending 到 active 也就一两分钟，证书签下来 10 分钟内。

这步我没折腾 API，因为 Cloudflare Pages 的 custom domain 走的是 SSL for SaaS 流程，需要 Custom Hostnames 权限（这是个付费功能）。用 dashboard 一键激活反而是最快的——3 次点击，30 秒搞定。

我之前钻了 API 的牛角尖，绕了一个多小时没搞定，最后还是 dashboard 一键解决。记住这个教训：别跟 API 死磕该用 UI 的东西。

现在的样子

站点结构：

blog/
├── config/_default/      # 主题配置
├── content/             # 文章（Markdown）
├── static/              # 静态资源（avatar / favicon / banner / 友链头像...）
├── themes/reimu/        # 主题（submodule）
└── hugo.toml            # 站点元数据

部署流程：

  • 改内容 → git push
  • Cloudflare Pages 检测到 push → 自动 build → 自动部署 → 自动 HTTPS 续期
  • 日常只有"写文章"和"git push"两件事

下一步

博客搭好了，下一步要面对的是写什么。

想了几个方向，但不想立 flag：博客这东西写得出来比写得好重要。先更新起来，风格以后再调。

如果有想看的内容（折腾记录、ACG 杂谈、工具测评），欢迎留言告诉我。

本博客搭建于 2026 年 6 月，部署在 Cloudflare Pages。如果你想看搭建过程中踩的所有坑，回头我整理一篇《用 hugo + reimu + Cloudflare Pages 搭博客的血泪史》。