MLZ发布于 2026年8月10日更新于 2026年8月10日项目开发日志#Astro#Cloudflare Pages#发布#DNS

把 ORBIT 从失效发布链路迁回正式域名

一次静态博客迁移:从失效的旧目标切到 Cloudflare Pages,并用构建、DNS、HTTPS 和内容抽查完成上线验收。

关联项目:ORBIT 博客发布系统

这次修复的表面问题是博客 404,真正的问题是发布链路里有一个已经失效的旧目标。继续修改页面内容并不能解决访问问题,必须先把“构建产物在哪里”“正式域名指向哪里”“Pages 是否接受这个域名”三件事重新对齐。

先恢复最小可用链路

我保留了现有 Astro 内容和页面结构,把正式部署切到 Cloudflare Pages 项目。公共 CNAME 改为指向 Pages 托管域名,再在 Pages 侧登记自定义域名。这样源代码、构建产物和访问入口各自有清晰的责任边界:仓库负责内容,构建负责静态产物,Pages 负责公开分发。

验收不能只看首页

上线后依次检查了首页、H200 文章页、H200 项目页、Sitemap 和 RSS。首页返回 200 只能证明入口能打开,文章页和项目页才能证明动态路由确实被构建,Sitemap 与 RSS 则能确认内容索引没有被迁移过程丢掉。

本地上线前的质量门禁也重新确认:14 项测试通过,Astro check 没有错误或警告,正式构建生成 29 个页面。公网抽查全部通过 HTTPS,Pages 自定义域名状态为 active。

这次留下的规则

静态站修复要同时记录“目标地址、托管状态、构建结果和关键页面”。只改 DNS 或只看构建都不够。公开博客也不需要暴露控制台、账号或本机路径;这些信息属于部署操作记录,不属于读者需要的项目证据。