如何解决hugo server启动本地服务时遇到的各种问题
2023-09-24
1分钟阅读时长
hugo server 启动慢
如果你用了hugo module,并且你的网络环境不好(国内网络),可能会遇到服务很久都启动不起来的情况。如下:
hugo server --bind=0.0.0.0 --baseURL=192.168.2.73 --disableFastRender
hugo: downloading modules …
然后就一直卡在这了,这是因为hugo在尝试更新模块内容,但是请求服务器卡住了。hugo是基于golang的,此时你可以尝试为go和hugo的更新源设置代理。你可以在你的环境变量里添加 GOPROXY 和 HUGO_MODULE_PROXY 来解决这个问题。
这里以macOS举例:
# 往~/.bash_profile里添加下面的命令,然后使用source ~/.bash_profile来重载环境变量
# 启用 Go Modules 功能(可选)
export GO111MODULE=on
# 配置 GOPROXY 环境变量
export GOPROXY=https://goproxy.io
# 配置hugo proxy
export HUGO_MODULE_PROXY=https://goproxy.cn
hugo server局域网无法访问的问题
成功启动hugo服务后,本地访问是没有问题的,但是你会发现无法使用局域网的其他设备访问。这是因为hugo没有监听局域网地址,需要在启动参数里加上--bind=0.0.0.0
让hugo监听所有地址,这时才能访问成功。
但是实际访问之后,会发现页面乱的一塌糊涂。有的样式和资源文件加载失败。这是因为默认hugo的资源域名是指向本机的,此时你需要修改hugo的baseURL为你本机IP才行,命令如下:
hugo server --bind=0.0.0.0 --baseURL=192.168.2.73