https://ningop.com/tags/%E5%8F%8C%E7%AB%AF%E5%90%8C%E6%AD%A5/ Recent content in 双端同步 on Ningfeiyu Hugo zh-cn Sun, 14 Jun 2026 00:00:00 +0800 https://ningop.com/posts/hugo-dual-deploy-github-srht/ Sun, 14 Jun 2026 00:00:00 +0800 https://ningop.com/posts/hugo-dual-deploy-github-srht/ <p><img alt="Dual Deploy" loading="lazy" src="https://ningop.com/images/Dual_Deploy_1b74da0189ea.jpg"></p> <p><strong>问题背景</strong>：同一套 Hugo 源码，想同时部署到：</p> <ul> <li><strong>源站</strong>：<code>https://ningfeiyu.github.io</code> (GitHub Pages)</li> <li><strong>镜像站</strong>：<code>https://ninq.srht.site</code> (sr.ht Pages)</li> </ul> <p>核心痛点：<strong><code>baseURL</code> 冲突</strong> —— 构建时写死哪个域名，另一端的所有绝对链接（导航、canonical、sitemap、资源引用）就会指错。</p> <hr> <h2 id="根因分析">根因分析</h2> <p>Hugo 在构建时会把 <code>baseURL</code> 注入到：</p> <ul> <li>导航菜单 <code>&lt;a href=&quot;https://baseURL/posts/&quot;&gt;</code></li> <li>Canonical 标签 <code>&lt;link rel=&quot;canonical&quot; href=&quot;https://baseURL/...&quot;&gt;</code></li> <li>Sitemap <code>&lt;loc&gt;https://baseURL/...&lt;/loc&gt;</code></li> <li>部分主题内置的绝对资源链接</li> </ul> <p>若只用一个 <code>hugo.toml</code>，双端必有一端链接错指。</p> <hr> <h2 id="解决方案双配置--独立构建目录">解决方案：双配置 + 独立构建目录</h2> <h3 id="1-目录结构">1. 目录结构</h3> <pre tabindex="0"><code>ningfeiyu.github.io/ ├── hugo.toml # 主配置：baseURL = &#34;https://ningfeiyu.github.io/&#34; ├── hugo.srht.toml # 镜像配置：baseURL = &#34;https://ninq.srht.site/&#34; + relativeURLs = true ├── content/ ├── themes/PaperMod/ # 已内置主题（非 submodule） ├── public/ # GitHub Pages 产物 └── public_srht/ # srht.site 产物 </code></pre><h3 id="2-两份配置文件">2. 两份配置文件</h3> <p><strong><code>hugo.toml</code>（GitHub Pages 版）</strong></p>