📺 引言：为什么在 2026 年，我依然选择静态博客？

平时看到好玩有趣的网站或技术点，总想记录下来。试过各种 Notion、语雀等在线文档，虽然方便，但总觉得数据不掌握在自己手里，且跨平台加载速度偶尔让人抓狂。 经过一番探索，我选择了 Hugo。 作为一个基于 Go 语言的静态网站生成器，它极速的构建能力和纯粹的 Markdown 体验，让我重新找回了写作的快感。

然而，真正让这套系统“丝滑”起来的，是我将其与 OpenList 整合，并解决了一系列反向代理与兼容性“坑点”之后。

🔍 痛点发现：子目录下的“路径迷踪”

为了方便管理，我并没有给博客单独配域名，而是将其挂载在主站的子路径下。但在部署过程中，我遇到了几个典型问题：

静态资源 404：Hugo 默认生成的绝对路径在子目录下会失效。

移动端适配瑕疵：原本简洁的界面在手机 Safari 上，由于底部信息堆叠，显得不够美观。

缓存残留：每次通过 Nginx 修改配置或更新文章，Cloudflare 的缓存总让新内容“迟到”。

🛠️ 深度折腾：从 BaseURL 到 Nginx 精细化调优

1. 配置修正：让路径回归正确

在 Hugo 的 config.toml 中，最关键的一步是正确设置 baseURL。

Ini, TOML

baseURL = "https://[域名]/post/"
publishDir = "public"

这样确保了 Hugo 在构建时，所有的 CSS 和 JS 引用都能自动补全子目录前缀。

2. 前端调优：一行代码的“减法艺术”

针对手机端显示臃肿的问题，我利用 Hugo 模板的自定义功能，通过一段简单的 CSS 强制覆盖了多余的页脚元素。 这不仅解决了双行显示的问题，还让页面视觉重心回归到了文字本身。

HTML

<style>
  /* 强制精简底部容器，提升移动端视觉空间 */
  .footer { display: none !important; }
</style>

3. 反代集成：与 OpenList 的完美共存

利用 Nginx 的 location 块，我实现了博客与 OpenList 导航页的无缝切换。 这种部署方式让我可以在一个入口下，既能管理网盘资源，又能静心写作。

🚀 最终成效：毫秒级的加载体验

通过这一系列调优，我的博客目前达到了以下指标：

构建速度：百篇文章秒级生成。

访问体验：配合 Cloudflare 全球加速，国内访问也能实现“秒开”。

全平台统一：无论是在 PC 还是手机端，底部信息始终保持单行精致。

💡 运维复盘笔记

必做 SOP：修改配置后，务必执行 hugo --gc --minify 进行压缩，并去 Cloudflare 执行 Purge Everything。

路径细节：在子目录环境下，一定要检查图片链接是否使用了相对路径。

✍️ 写在最后

折腾 Hugo 的乐趣，不在于写出多么华丽的代码，而在于通过不断地调优、修剪，把一个工具打磨成自己最顺手的武器。 如果你也在追求极致的加载速度和自主掌控的数据，Hugo 绝对值得一试。