<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Cloudflare on DaoWorks</title><link>https://daoworks.cn/tags/cloudflare/</link><description>Recent content in Cloudflare on DaoWorks</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Mon, 16 Nov 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://daoworks.cn/tags/cloudflare/index.xml" rel="self" type="application/rss+xml"/><item><title>上线前备忘录：静态站从零到 Cloudflare Pages</title><link>https://daoworks.cn/posts/deploy-checklist/</link><pubDate>Mon, 16 Nov 2026 00:00:00 +0000</pubDate><guid>https://daoworks.cn/posts/deploy-checklist/</guid><description>&lt;p&gt;这套流程从零跑到 Cloudflare Pages，踩了不少坑。浓缩成清单，照着做就不会卡。&lt;/p&gt;&#10;&lt;blockquote&gt;&#10;&lt;p&gt;为什么选静态站、砍掉了哪些后台能力，看 &lt;a href="https://daoworks.cn/posts/why-static-nav/"&gt;为什么没用带后台的导航程序&lt;/a&gt;；为什么最终没做热榜，看 &lt;a href="https://daoworks.cn/posts/why-no-hotboard/"&gt;为什么放弃了热榜模块&lt;/a&gt;。&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;h2 id="阶段-0装-hugo"&gt;阶段 0：装 Hugo&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;包管理器（scoop/choco/winget）&lt;strong&gt;全都没有&lt;/strong&gt;，走 GitHub Releases 手动装&lt;/li&gt;&#10;&lt;li&gt;装 &lt;strong&gt;extended&lt;/strong&gt; 版（将来 Sass 编译要用），不是标准版&lt;/li&gt;&#10;&lt;li&gt;下载 21.5 MB 实测花了 &lt;strong&gt;19 分钟&lt;/strong&gt;，GitHub 有时极慢，要有耐心&lt;/li&gt;&#10;&lt;li&gt;版本判定：v0.170.0 起 &lt;code&gt;hugo version&lt;/code&gt; &lt;strong&gt;不再打印 &lt;code&gt;+extended&lt;/code&gt;&lt;/strong&gt;。别误判。改用 &lt;code&gt;hugo env&lt;/code&gt; 看 &lt;code&gt;libsass&lt;/code&gt;/&lt;code&gt;sass&lt;/code&gt;，或直接看二进制里有没有 &lt;code&gt;libsass&lt;/code&gt; 字符串&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="阶段-1配置真值"&gt;阶段 1：配置真值&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;hugo.toml&lt;/code&gt; 三个关键值，&lt;strong&gt;最后绑定的域名一定要写对&lt;/strong&gt;：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-toml" data-lang="toml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;baseURL&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;https://daoworks.cn/&amp;#34;&lt;/span&gt; &lt;span class="c"&gt;# 末尾 / 不能丢，影响 canonical/sitemap/RSS&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;title&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;DaoWorks&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;params&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;author&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;道作 DaoWorks&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="阶段-2本地双验证"&gt;阶段 2：本地双验证&lt;/h2&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo --gc --minify &lt;span class="c1"&gt;# 生产构建，检查 public/ 产物齐全&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo server -D &lt;span class="c1"&gt;# 开发服务器，逐个路由确认 200&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#10;&lt;li&gt;检查 &lt;code&gt;public/&lt;/code&gt;：&lt;code&gt;index.html&lt;/code&gt;、&lt;code&gt;sitemap.xml&lt;/code&gt;、&lt;code&gt;index.xml&lt;/code&gt;、&lt;code&gt;robots.txt&lt;/code&gt;、&lt;code&gt;404.html&lt;/code&gt;&lt;/li&gt;&#10;&lt;li&gt;检查 canonical 是否已是最终域名&lt;/li&gt;&#10;&lt;li&gt;有 3 个弃用警告（&lt;code&gt;languageCode&lt;/code&gt;→&lt;code&gt;locale&lt;/code&gt;、&lt;code&gt;.Site.LanguageCode&lt;/code&gt;→&lt;code&gt;.Site.Language.Locale&lt;/code&gt;、&lt;code&gt;.Site.Data&lt;/code&gt;→&lt;code&gt;hugo.Data&lt;/code&gt;），&lt;strong&gt;本次不修&lt;/strong&gt;，等 Hugo 真删了再迁&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="阶段-3首次提交"&gt;阶段 3：首次提交&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;仓库级配置身份（&lt;strong&gt;不要动全局&lt;/strong&gt;）：&lt;code&gt;git config user.name&lt;/code&gt;/&lt;code&gt;user.email&lt;/code&gt;&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;.gitignore&lt;/code&gt; 必须含 &lt;code&gt;public/&lt;/code&gt;、&lt;code&gt;resources/&lt;/code&gt;、&lt;code&gt;.hugo_build.lock&lt;/code&gt;——提交前用 &lt;code&gt;git check-ignore&lt;/code&gt; 确认生效&lt;/li&gt;&#10;&lt;li&gt;提交后验证 &lt;code&gt;git status&lt;/code&gt; clean、&lt;code&gt;public/&lt;/code&gt; 不在跟踪列表&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="阶段-4推送"&gt;阶段 4：推送&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;SSH 大概率不通&lt;/strong&gt;（实测：&lt;code&gt;Permission denied (publickey)&lt;/code&gt;，因为 ssh-agent 没跑 + key 名非默认）。&lt;strong&gt;直接走 HTTPS&lt;/strong&gt;（2026-11-17 实测用 &lt;code&gt;gh&lt;/code&gt; + &lt;code&gt;GH_TOKEN&lt;/code&gt; 环境变量方案成功）：&lt;/p&gt;</description></item></channel></rss>