Zola 2026-06-10T00:00:00+00:00 https://orhan.cn/tags/zola/atom.xml 2026-06-10T00:00:00+00:00 2026-06-10T00:00:00+00:00 menzil https://orhan.cn/posts/zola-port-forwarding/ <p>Zola 默认使用 <code>127.0.0.1:1111</code> 启动开发服务器：</p> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">zola</span><span> serve </span></code></pre> <p>这个默认配置只监听当前机器的本机回环地址。如果要通过端口转发、远程开发环境、局域网设备、容器或云服务器访问，就需要让 Zola 监听所有网络接口。</p> <h2 id="tui-jian-qi-dong-ming-ling">推荐启动命令<a class="anchor" aria-hidden="true" href="#tui-jian-qi-dong-ming-ling" hidden="">#</a> </h2> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">zola</span><span> serve</span><span style="color:#bf616a;"> --interface</span><span> 0.0.0.0</span><span style="color:#bf616a;"> --port</span><span> 1111 </span></code></pre> <p>如果端口转发工具使用的是其他端口，例如 <code>3000</code>：</p> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">zola</span><span> serve</span><span style="color:#bf616a;"> --interface</span><span> 0.0.0.0</span><span style="color:#bf616a;"> --port</span><span> 3000 </span></code></pre> <p>核心参数是：</p> <table><thead><tr><th>参数</th><th>作用</th></tr></thead><tbody> <tr><td><code>--interface 0.0.0.0</code></td><td>监听所有网络接口，允许外部转发访问</td></tr> <tr><td><code>--port 3000</code></td><td>指定 Zola 开发服务器端口</td></tr> </tbody></table> <h2 id="pei-he-gong-kai-zhuan-fa-di-zhi">配合公开转发地址<a class="anchor" aria-hidden="true" href="#pei-he-gong-kai-zhuan-fa-di-zhi" hidden="">#</a> </h2> <p>如果端口转发工具给了一个公开 URL，例如：</p> <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>https://example-tunnel.example.com </span></code></pre> <p>可以把它传给 Zola：</p> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">zola</span><span> serve \ </span><span style="color:#bf616a;"> --interface</span><span> 0.0.0.0 \ </span><span style="color:#bf616a;"> --port</span><span> 3000 \ </span><span style="color:#bf616a;"> --base-url</span><span> https://example-tunnel.example.com </span></code></pre> <p>这样页面里的链接、静态资源路径和刷新地址会更接近实际访问环境。</p> <h2 id="chang-jian-chang-jing">常见场景<a class="anchor" aria-hidden="true" href="#chang-jian-chang-jing" hidden="">#</a> </h2> <h3 id="vs-code-port-forwarding-dev-containers">VS Code Port Forwarding / Dev Containers<a class="anchor" aria-hidden="true" href="#vs-code-port-forwarding-dev-containers" hidden="">#</a> </h3> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">zola</span><span> serve</span><span style="color:#bf616a;"> --interface</span><span> 0.0.0.0</span><span style="color:#bf616a;"> --port</span><span> 1111 </span></code></pre> <p>然后在端口面板里转发 <code>1111</code>。</p> <h3 id="ngrok-cloudflare-tunnel">ngrok / Cloudflare Tunnel<a class="anchor" aria-hidden="true" href="#ngrok-cloudflare-tunnel" hidden="">#</a> </h3> <p>先启动 Zola：</p> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">zola</span><span> serve</span><span style="color:#bf616a;"> --interface</span><span> 0.0.0.0</span><span style="color:#bf616a;"> --port</span><span> 1111 </span></code></pre> <p>再把 <code>1111</code> 转发出去。拿到公开 URL 后，如果页面资源路径不对，再加上 <code>--base-url</code>：</p> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">zola</span><span> serve</span><span style="color:#bf616a;"> --interface</span><span> 0.0.0.0</span><span style="color:#bf616a;"> --port</span><span> 1111</span><span style="color:#bf616a;"> --base-url</span><span> https://your-public-url </span></code></pre> <h3 id="ju-yu-wang-shou-ji-yu-lan">局域网手机预览<a class="anchor" aria-hidden="true" href="#ju-yu-wang-shou-ji-yu-lan" hidden="">#</a> </h3> <p>电脑和手机在同一个网络时，可以这样启动：</p> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">zola</span><span> serve</span><span style="color:#bf616a;"> --interface</span><span> 0.0.0.0</span><span style="color:#bf616a;"> --port</span><span> 1111 </span></code></pre> <p>然后在手机浏览器打开：</p> <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>http://电脑的局域网 IP:1111 </span></code></pre> <h2 id="pai-cha-wen-ti">排查问题<a class="anchor" aria-hidden="true" href="#pai-cha-wen-ti" hidden="">#</a> </h2> <p>如果端口转发后仍然访问不了，按这个顺序检查：</p> <ol> <li>Zola 是否使用了 <code>--interface 0.0.0.0</code></li> <li>端口号是否和转发工具里的端口一致</li> <li>防火墙或云服务器安全组是否放行了该端口</li> <li>页面资源路径是否需要设置 <code>--base-url</code></li> <li>端口是否被其他程序占用</li> </ol> <p>可以用下面的命令确认 Zola 参数：</p> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">zola</span><span> serve</span><span style="color:#bf616a;"> --help </span></code></pre> <p>重点看这两个选项：</p> <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>-i, --interface &lt;INTERFACE&gt; </span><span>-p, --port &lt;PORT&gt; </span></code></pre> <h2 id="zui-duan-ke-yong-ban-ben">最短可用版本<a class="anchor" aria-hidden="true" href="#zui-duan-ke-yong-ban-ben" hidden="">#</a> </h2> <p>平时只需要记住这一条：</p> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">zola</span><span> serve</span><span style="color:#bf616a;"> --interface</span><span> 0.0.0.0</span><span style="color:#bf616a;"> --port</span><span> 1111 </span></code></pre> <p>只要不是单纯在本机浏览器里访问 Zola，端口转发场景基本都应该显式加上 <code>--interface 0.0.0.0</code>。</p>