<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>部署 on DaoWorks</title><link>https://daoworks.cn/tags/%E9%83%A8%E7%BD%B2/</link><description>Recent content in 部署 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/%E9%83%A8%E7%BD%B2/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><item><title>Cloudflare Pages 上线备忘录</title><link>https://daoworks.cn/posts/pages-notes/</link><pubDate>Mon, 02 Nov 2026 00:00:00 +0000</pubDate><guid>https://daoworks.cn/posts/pages-notes/</guid><description>&lt;p&gt;记一下这次上线踩过的点，免得下次重新搜。&lt;/p&gt;&#10;&lt;h2 id="构建设置"&gt;构建设置&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;项&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;值&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Build command&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;hugo --gc --minify&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Build output directory&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;public&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Root directory&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;留空&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Production branch&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;main&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;环境变量里必须加 &lt;code&gt;HUGO_VERSION&lt;/code&gt;，值和本地 &lt;code&gt;hugo version&lt;/code&gt; 查到的一致。开了 PR 预览的话，&lt;strong&gt;Preview 环境也要加同一个变量&lt;/strong&gt;，否则预览部署会构建失败。&lt;/p&gt;&#10;&lt;h2 id="绑定域名的顺序"&gt;绑定域名的顺序&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;先在 Pages 后台 Custom domains 关联域名，再去配 DNS。&lt;/strong&gt; 反过来直接 CNAME 指向 &lt;code&gt;xxx.pages.dev&lt;/code&gt; 会报 522，证书也可能签不下来。&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;根域名：必须把域名加为 Cloudflare zone 并改 NS，之后它自动创建 CNAME&lt;/li&gt;&#10;&lt;li&gt;子域名：二选一——① 在原域名商加一条 CNAME 指向 &lt;code&gt;xxx.pages.dev&lt;/code&gt;；② 把域名改 NS 托管到 Cloudflare（全托管，本项目早期即走②，DigitalPlat 免费域名支持改 NS）&lt;/li&gt;&#10;&lt;li&gt;域名原先有 CAA 记录的，要放行 &lt;code&gt;letsencrypt.org&lt;/code&gt;、&lt;code&gt;pki.goog&lt;/code&gt;、&lt;code&gt;digicert.com&lt;/code&gt;、&lt;code&gt;comodoca.com&lt;/code&gt;&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="其他"&gt;其他&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;static/_headers&lt;/code&gt; 可以配响应头，&lt;code&gt;enableRobotsTXT = true&lt;/code&gt; 会自动生成 robots.txt 并带上 sitemap 地址。图标走目标站 &lt;code&gt;/favicon.ico&lt;/code&gt;，加载失败会回退成名称首字，所以别人换图标顶多裂一张，不影响整站。&lt;/p&gt;</description></item></channel></rss>