这本网站是怎样发布出去的

这一页把前面几页串起来。你写的 Markdown 怎么变成 handbook.ccccczzm.com 上的一页，中间经过谁的手，哪一步是人做的，哪一步是程序按约定自动做的。看懂了，你就知道自己以后做一个网站需要什么。

Write in Markdown, commit to Git, push to GitHub, let Cloudflare build it, check the preview, merge. No server of your own.Escribe en Markdown, guarda en Git, sube a GitHub, deja que Cloudflare lo construya, revisa la vista previa, fusiona. Sin servidor propio.

自己不用有服务器，页面提前做好，来了直接给

一条流水线

必须掌握

Markdown 文件        你写的正文
   ↓ 提交            Git 拍快照，附一句说明
GitHub               仓库放在这里
   ↓ 通知            GitHub 通过 API 告诉 Cloudflare「有新提交」
Cloudflare 构建      Cloudflare 取走文件，运行 Astro，把 .md 变成 HTML
   ↓
预览地址             改动在分支上时，得到一个临时网址
   ↓ 合并到 main     你看过预览，点合并
正式网站             handbook.ccccczzm.com 更新

人只做三件事：写、说明、看预览后合并。其他都是程序之间按约定进行的，见 API 一章。

为什么这样做：你不需要自己有一台一直开着的电脑当服务器。Cloudflare 把生成好的页面放到全世界的服务器上，谁访问就近取。这叫静态网站：页面提前做好，来了直接给，所以快、便宜、几乎不会被攻破。

每一步在哪里看

知道即可

• 提交历史：GitHub 仓库页面的「Commits」，每一条是一次提交和它的说明。
• 预览地址：合并请求页面下方，Cloudflare 的机器人会留言，里面有链接。
• 构建过程：Cloudflare 后台的「部署」列表，每一次构建一行，点进去有日志。
• 正式网站对应哪次提交：部署列表里标着提交编号，和 GitHub 上的对得上。

域名是怎么接上的

知道即可

ccccczzm.com 这个域名注册在 Cloudflare。handbook.ccccczzm.com 是它下面的一条记录，指向 Cloudflare 放这本手册的地方。根域名 ccccczzm.com 现在空着，留给你自己的网站。到时候另开一个仓库、另建一个项目，走同一条流水线，再加一条记录指过去。两边互不影响。

域名怎么读、谁是主人，在诈骗一章。

构建失败怎么办

必须掌握

你什么时候会遇到这个问题：合并请求下面 Cloudflare 留言说构建失败，没有预览地址。

最简单可靠的做法：

1. 正式网站没有受影响。失败的构建不会发布，上一次成功的版本还在。
2. 点进日志，看最后几行红字。多半是 Markdown 写错了：开头的 --- 少了一条，title: 后面漏了内容，链接的括号没配对。
3. 整段复制给 AI，先让它解释，再改。
4. 改完再提交一次，它会重新构建。

这就是排查顺序那一套：先看提示，再回忆改了什么。

花了多少钱

知道即可

• 域名：一年几十元，注册在 Cloudflare。
• GitHub 私有仓库：免费。
• Cloudflare 放网站：免费额度远超一本手册的需要。

总成本就是域名。这是 2026 年 9 月的情况，价格会变，原则不变：静态网站几乎不花钱。

这一套还能干什么

知道即可

任何一个装满 Markdown 文件的文件夹，都能用同样的流水线变成一个网站：你的个人网站、读书笔记、一个项目的资料页。工具会换，这三层不变：写在纯文本里，历史记在 Git 里，发布交给别人的服务器。

练习

打开 Cloudflare 的部署列表，找到最近一次部署，看它对应的提交编号；再到 GitHub 的 Commits 里找到同一个编号，读那条提交说明。你刚刚从正式网站一路追溯到了写它的那一次改动。这就是可追溯。