https://techblog.shashura1.top/posts/Recent content in Posts on Shura 极客技术笔记Hugozh-cnSat, 04 Jul 2026 00:00:00 +0800https://techblog.shashura1.top/posts/hugo-static-blog-full-build-tutorial/Sat, 04 Jul 2026 00:00:00 +0800https://techblog.shashura1.top/posts/hugo-static-blog-full-build-tutorial/<h2 id="前言">前言</h2> <p>折腾两天完整落地一套免费静态博客方案：本地Markdown写作 + PicGo一键传图到私人网盘图床 + Gitee/GitHub双仓库同步 + Cloudflare Pages自动构建部署 + 自有域名全站HTTPS。 网上大多只有单独Hugo、单独Alist教程，极少有OpenList兼容隧道图床完整流程，本文附上全部可复制Linux命令，同时记录我踩过的所有报错坑，新手可直接照搬操作。</p> <h2 id="一整套架构组件说明">一、整套架构组件说明</h2> <ol> <li>Hugo：本地生成静态网页，写Markdown源文件</li> <li>Git：Gitee为主仓库，单向同步GitHub备用</li> <li>Cloudflare Pages：免费静态站点托管，博客主域名<code>blog.example.top</code>、图床二级域名<code>img.blog.example.top</code></li> <li>OpenList：虚拟机部署，挂载私人网盘充当博客图床，兼容Alist V3 API</li> <li>Cloudflare Zero Trust 永久隧道：内网OpenList暴露公网二级图床域名</li> <li>PicGo 3.0：截图一键上传图床，自动生成Markdown图片链接</li> </ol> <h2 id="二第一部分linux-安装-hugo--初始化博客站点">二、第一部分：Linux 安装 Hugo &amp; 初始化博客站点</h2> <h3 id="环境ubuntudebian-虚拟机nas内置虚拟机通用">环境：Ubuntu/Debian 虚拟机（NAS内置虚拟机通用）</h3> <h4 id="1-系统更新依赖">1. 系统更新依赖</h4> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>sudo apt update <span style="color:#f92672">&amp;&amp;</span> sudo apt upgrade -y </span></span></code></pre></div><ol start="2"> <li>安装 Git、解压工具</li> </ol> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>sudo apt install git unzip wget -y </span></span></code></pre></div><ol start="3"> <li>一键安装 Hugo（扩展版，支持图片 / 资源处理） 以 v0.146.0 版本举例，可自行替换最新版本号：</li> </ol> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#75715e"># 下载64位Linux二进制包</span> </span></span><span style="display:flex;"><span>wget https://github.com/gohugoio/hugo/releases/download/v0.146.0/hugo_0.146.0_linux_amd64.tar.gz </span></span><span style="display:flex;"><span><span style="color:#75715e"># 解压</span> </span></span><span style="display:flex;"><span>tar -zxvf hugo_0.146.0_linux_amd64.tar.gz </span></span><span style="display:flex;"><span><span style="color:#75715e"># 移动到系统全局命令目录</span> </span></span><span style="display:flex;"><span>sudo mv hugo /usr/local/bin/ </span></span><span style="display:flex;"><span><span style="color:#75715e"># 验证安装</span> </span></span><span style="display:flex;"><span>hugo version </span></span></code></pre></div><p>输出版本号即安装成功。</p>