在很多后台系统中，“导出 PDF” 看似一个按钮，实则需要一条完整的渲染链路。本文记录一次基于 Gotenberg 的工程实践：从需求与技术选型出发，到 URL 转 PDF、登录态传递、前端打印模式、动态分页与 waitForExpression，再到 POC 验证、参数调优、批量导出与踩坑经验，抽取出可复用的落地思路。

本站原使用 GitHub Pages 的 “Deploy from branch” 模式部署，随着站点复杂度增加，在构建环境隔离、Secrets 管理和多平台同步上逐渐力不从心。本文记录将 Hugo + LoveIt 主题项目完整迁移至 GitHub Actions 过程中踩过的 7 个坑及对应解法，涵盖双仓库推送、代理配置、计费陷阱与版本控制等最佳实践。

Docker Engine 与 Docker Compose 的版本搭配是容器化部署中极易被忽视却至关重要的兼容性问题。本文梳理 Compose 从 V1（Python）到 V2（Go）再到 V5 的版本演进史与完整兼容矩阵，解释为何版本号从 v2.40 直接跳跃到 v5.x。同时给出 Docker 25.0.0 的最佳适配版本推荐、V1/V2 架构与功能差异对比，以及生产环境的版本选择决策树和升级路径。

控制平面修复后节点仍处于 NotReady 状态，根因是 CNI 网络插件没有部署。本文完整记录 NotReady 的排查思路、Calico 以 Operator 方式在线/离线部署的操作步骤，并深入分析 Kubelet 系统污点引发 CNI 部署死锁的原因及 Operator 模式如何破局。