Zola 默认使用 127.0.0.1:1111 启动开发服务器：
zola serve
这个默认配置只监听当前机器的本机回环地址。如果要通过端口转发、远程开发环境、局域网设备、容器或云服务器访问，就需要让 Zola 监听所有网络接口。
推荐启动命令
zola serve --interface 0.0.0.0 --port 1111
如果端口转发工具使用的是其他端口，例如 3000：
zola serve --interface 0.0.0.0 --port 3000
核心参数是：
| 参数 | 作用 |
|---|---|
--interface 0.0.0.0 | 监听所有网络接口，允许外部转发访问 |
--port 3000 | 指定 Zola 开发服务器端口 |
配合公开转发地址
如果端口转发工具给了一个公开 URL，例如：
https://example-tunnel.example.com
可以把它传给 Zola：
zola serve \
--interface 0.0.0.0 \
--port 3000 \
--base-url https://example-tunnel.example.com
这样页面里的链接、静态资源路径和刷新地址会更接近实际访问环境。
常见场景
VS Code Port Forwarding / Dev Containers
zola serve --interface 0.0.0.0 --port 1111
然后在端口面板里转发 1111。
ngrok / Cloudflare Tunnel
先启动 Zola：
zola serve --interface 0.0.0.0 --port 1111
再把 1111 转发出去。拿到公开 URL 后，如果页面资源路径不对，再加上 --base-url：
zola serve --interface 0.0.0.0 --port 1111 --base-url https://your-public-url
局域网手机预览
电脑和手机在同一个网络时，可以这样启动：
zola serve --interface 0.0.0.0 --port 1111
然后在手机浏览器打开：
http://电脑的局域网 IP:1111
排查问题
如果端口转发后仍然访问不了，按这个顺序检查：
- Zola 是否使用了
--interface 0.0.0.0 - 端口号是否和转发工具里的端口一致
- 防火墙或云服务器安全组是否放行了该端口
- 页面资源路径是否需要设置
--base-url - 端口是否被其他程序占用
可以用下面的命令确认 Zola 参数：
zola serve --help
重点看这两个选项：
-i, --interface <INTERFACE>
-p, --port <PORT>
最短可用版本
平时只需要记住这一条：
zola serve --interface 0.0.0.0 --port 1111
只要不是单纯在本机浏览器里访问 Zola，端口转发场景基本都应该显式加上 --interface 0.0.0.0。