Caddy反向代理Hugo服务器失败：CSS及图标资源无法加载求助

从你给出的报错信息来看，核心问题非常明确：你的网页里的静态资源（比如style.min.css、网站图标）被渲染成了指向https://localhost:8081的路径，但用户访问你的网站时是通过自定义域名mycustomdomain.com，浏览器会试图去连接本地的8081端口（这在用户端显然是不可达的），所以才会触发ERR_CONNECTION_REFUSED错误。

下面是具体的排查和解决步骤：

1. 修正Hugo的baseURL配置 #

这是最常见的触发原因。Hugo生成页面时会根据baseURL参数生成资源的绝对路径，如果你的Hugo服务启动时没有指定正确的域名，就会默认用localhost作为资源路径的前缀。

• 如果是用hugo server运行开发服务器，启动时指定正确的自定义域名：

  hugo server --baseURL https://mycustomdomain.com/ --bind 0.0.0.0 --port 8081
  

  其中--bind 0.0.0.0是让Hugo监听所有网卡，确保同一机器上的Caddy能正常访问到它（即使只绑定localhost也能访问，但绑定所有网卡能避免潜在的权限问题）。

• 如果是生成静态文件后部署，需要在Hugo的配置文件（config.toml/config.yaml）里设置：

  baseURL = "https://mycustomdomain.com/"
  

  然后重新执行hugo命令生成静态文件。

2. 完善Caddyfile的代理配置 #

从你给出的片段来看，代理配置可能不够完整，导致Hugo无法正确识别请求的源域名。以下是两种场景的正确配置：

场景1：反向代理运行中的Hugo开发服务器 #

mycustomdomain.com {
  reverse_proxy localhost:8081 {
    header_up Host {host}
    header_up X-Forwarded-Proto {scheme}
  }

  gzip
}

这里的header_up配置是让Hugo能获取到真实的请求域名和协议，避免生成错误的资源路径。

场景2：部署Hugo生成的静态文件（更推荐生产环境使用） #

如果已经用hugo生成了静态文件，直接用Caddy静态文件服务比反向代理更高效：

mycustomdomain.com {
  root * /home/sean/mycustomdomain.com/public
  file_server

  gzip
}

注意这里的root要指向Hugo生成的public目录，而不是项目根目录。

3. 验证资源路径是否修复 #

完成上述配置后，访问你的网站，打开浏览器开发者工具（F12）切换到「网络」标签，检查静态资源的请求URL是否变为https://mycustomdomain.com/css/style.min.css这类域名前缀的路径。如果路径正确，资源就能正常加载了。

额外排查点 #

• 确保Linode实例的防火墙（比如ufw）没有阻止本地8081端口的访问（不过因为Caddy和Hugo在同一机器，本地访问通常不需要开放外部端口）。
• 清理浏览器缓存，旧缓存可能会保留错误的资源路径，导致问题持续。

内容的提问来源于stack exchange，提问作者Busch