变更记录:从 Docker 四服务迁移到主机直装

公開日: 2026-11-18 15:41 1365文字 7 min read 手書き 一字一句、自分で書きました。

この投稿は「日本語」では表示できません。元の投稿を表示しています。
这篇文章记录了博客部署方案从 Docker 四服务编排改为主机直装的调整过程:因容器被 1Panel 批量清理、Docker 更新成本高而放弃容器方案,改用 Node 运行时加 Caddy 静态服务的架构,并通过幂等补丁脚本适配上游代码。文中还介绍了 AI 摘要接入、构建性能、磁盘清理及若干遗留问题,核心收益是故障面从 Docker 多层链路简化为单一 Node 进程。

记录这次博客部署方案的调整过程,包括为什么要换、换了什么、以及踩到的坑。

一、起点:Docker 四服务方案

最初按一份现成方案部署,用 Compose 编排四个服务:

服务作用端口
koharu-cmsWeb 写作后台4322
koharu-previewAstro dev 预览4321
koharu-webNginx 提供静态站8080
builder一次性构建任务—

这套方案本身能跑通,但落地时改了四处才启动起来:

  1. 部署包默认路径 /docker/...,fnOS 实际是 /vol1/docker
  2. 文档假设 Lucky 在 bridge 网络,实际是 host 网络,无法按容器名反代,改成端口映射
  3. builder 在 profiles: ["tools"] 下,docker compose run 必须显式加 --profile tools
  4. CMS 的 Host 校验只认 localhost,局域网访问 API 全部 403

二、意外:容器被批量清理

11-17 晚上 22:25,在 1Panel 里做了一次容器清理操作。docker events 记录:

22:25:04  创建 koharu-cms-modify-backup-150d7cd94c7841dc…
22:28:02  删除 koharu-cms、koharu-preview
22:28:03  删除 1Panel-deepseek-harness
22:28:27  删除 koharu-web
22:28:43  删除镜像 astro-koharu-fnos:local

三个容器连同镜像、命名卷一起消失,1Panel 甚至删掉了自己的后台容器。

源码目录还在,但恢复要重建 1.75 GB 镜像(约 15 分钟)再跑一次构建(约 8 分钟)。

三、决策:改为主机直装

权衡后放弃 Docker,理由是这台设备上 Docker 的隔离优势没有价值,更新成本却很高:

环节Docker 方案主机直装
首次环境准备拉镜像 + build 镜像 14m51s装 Node + pnpm 约 2 分钟
版本更新依赖变化要 rebuild 镜像 15 分钟pnpm install 4m29s
故障面builder 版本、Dockerfile 阶段、卷覆盖、容器被误删只有 Node 本身
常驻开销dockerd + 三个容器Caddy 13 MB

四、新架构

flowchart LR
    A[Markdown 文章] --> B[pnpm build]
    B --> C[dist 静态文件]
    C --> D[Caddy :8080]
    D --> E[浏览器]
    F[CMS :4322] -.写文件.-> A
    G[dev 预览 :4321] -.热更新.-> A
    H[DeepSeek API] -.生成摘要.-> I[summaries.json]
    I --> B

组件版本:

组件版本位置
Node22.23.5 arm64/opt/node22
pnpm10.28.2corepack
Caddy2.11.9/usr/local/bin/caddy
项目astro-koharu v7.7.5/vol1/www/astro-koharu

Caddy 由 systemd 服务 caddy-koharu.service 守护,已设开机自启。

五、五个本地补丁

上游代码有多处假设不适合当前环境,全部做成 patches/apply.mjs 里的幂等补丁:

补丁文件问题改法
1cms/server.tsHost 只认 localhost,局域网访问 API 403放行 RFC1918 私有网段,公网域名仍拒绝
2package.jsondev 只监听 [::1]追加 --host 0.0.0.0 --port 4321
3src/scripts/generateSummaries.tsAPI 地址硬编码指向本地 LM Studio改读 SUMMARY_* 环境变量
4同上连通性检查不带 Authorization,云端 API 401 被误判为不可用补 Bearer 请求头
5src/pages/post/[...slug].astro摘要面板优先显示手写 description,AI 摘要用不上改为 AI 摘要优先,description 作兜底

补丁脚本可重复执行,已存在的会跳过,匹配不上会明确报错。update.sh 升级时自动重放。

六、接入 AI 摘要

项目自带摘要生成脚本,用的是 OpenAI 兼容接口,改完补丁 3、4 后可接任何服务。

当前接的是 DeepSeek,模型 deepseek-flash(deepseek-chat 已下线)。

实测数据:

项目数值
3 篇生成耗时6.0 秒
单篇 token约 3k 输入 + 150 输出
3 篇成本约 ¥0.02
全量 38 篇预估约 ¥0.2

摘要按「内容 hash + 模型名」缓存,改过的文章重新生成,没动过的走缓存。

需要注意摘要的显示优先级:写了 description 的文章不会显示 AI 摘要,面板会标注为 description;只有不写 description 才会走 AI 摘要(标注 ai)。

七、性能观察

指标数值
首次构建(含图片优化)7 分 23 秒
增量构建(图片缓存命中)2 分 13 秒(其中图片阶段仅 1 秒)
构建产物307 页 / 1853 文件 / 181 MB
pagefind 索引311 页
首页响应约 25 ms,177–221 KB,gzip 压缩
Caddy 内存13 MB
CMS 内存324 MB(仅使用时启动)
dev 预览内存约 700 MB(仅使用时启动)

慢的主要来源是 108 张图片转 avif/webp 多尺寸,以及 pagefind 全文索引。这部分 Hexo 默认不做,所以对比构建速度时要算上功能差异。

八、清理动作

  • 删除旧 Docker 部署目录 590 MB、本地源码副本 72 MB
  • 清理构建缓存 1.754 GB,回收悬空镜像层约 8 GB
  • 删除旧后台项目(含明文凭据的部署脚本)
  • 磁盘 /vol1 从 112 GB 降到 91 GB

九、遗留问题

  1. 无 link 字段的文章,摘要生成脚本用的 key 是相对路径(如 note/shoka-features),页面查找用的是另一套 slug 规则,两者是否始终一致尚未逐一验证。
  2. pnpm koharu generate summaries 是交互式 TUI,脚本化调用必须绕过 CLI 直调 tsx src/scripts/generateSummaries.ts。
  3. 部分 Markdown 扩展(如脚注)渲染不完全,会退化为普通文本,不影响构建。
  4. 设备温度在 CPU 68°C、DDR 69°C 附近,风扇策略由 fnOS 管理,暂未干预。

十、小结

主机直装的核心收益不是”更快”,而是故障面变小:从「Docker daemon + 镜像层 + Compose 编排 + 容器被误删」简化到「Node 进程 + 一个静态服务器」。代价是宿主多了一个 Node 运行时,通过独立目录 /opt/node22 隔离,不碰系统包管理器。

執筆 手書き

投稿をランダムに表示

読み込み中...