专题归档 · 2026 年 5 月（编辑分组，非实际写作日期）

MemoFlow 单机部署：从 Caddy 到 Web、API 和 PowerSync

回顾一次确实核查过服务器与仓库配置的 Docker/Caddy/Nginx 项目部署实践。

这次先看真实运行的机器

排查单机部署时，我先核对本地仓库配置，再检查服务器上运行的容器、镜像和 Compose 文件。环境变量只需要核对键名及其作用，没有必要在排障文档里记录实际密钥。

当时整理的链路是浏览器到 Caddy 的 HTTPS 入口，再进入 Web 容器的 Nginx，由它负责静态资源、SPA fallback、以及转发到内部 API。PowerSync 是另一个需要明确生命周期的组件，不应该被模糊地当作“静态页面的一部分”。

另一份旧笔记把 Nginx 分成 TLS 责任之外的静态托管、缓存与 gzip、反向代理、HTTP/1.1 Upgrade、容器内 DNS 等问题。它们都是上线时真正影响行为的环节，但别把完整配置复制成永久适用的模板。

这只是某一日期的基础设施快照，不能反映现在 MemoFlow 生产环境的拓扑。文章省去了服务器别名、内部目录清单、真实入口与部署命令中不需要公开的细节。若将来发布，应和实际环境权限及仓库变更历史核对。