这篇记录整理了 fichil.com 从无法访问到 Hugo 静态站点正常上线的排障过程。
问题现象
浏览器返回 ERR_CONNECTION_REFUSED。这个错误通常说明域名已经指向服务器,但目标端口没有服务在接收请求。
对这个站点来说,影响很直接:访问链路没恢复之前,新增文章和页面修改都没法在线验证。
排查路径
实际处理时按下面顺序推进:
- 确认域名是否解析到 VPS。
- 检查 Nginx 是否安装并启动。
- 确认服务器是否监听 80 和 443 端口。
- 使用
curl http://127.0.0.1做本机访问验证。 - 检查 Nginx 站点配置。
- 构建 Hugo 站点,并让 Nginx 指向生成后的
public/目录。 - HTTP 链路稳定后再配置 HTTPS。
处理方案
最终采用的是简单稳定的架构:
- Hugo 负责生成静态文件。
- Nginx 负责对外提供访问。
- HTTPS 在 Nginx 层处理。
- GitHub 保存源码、配置和后续维护记录。
这个模式的边界很清楚:写内容、构建 Hugo、部署静态文件、由 Nginx 提供访问。
复盘结论
部署类问题要从外到内排查:
- 先确认网络可达。
- 再确认进程和端口。
- 再确认 Web Server 配置。
- 最后才看 Hugo 构建和站点内容。
这样不会在端口没开、Nginx 没启动的时候,浪费时间去怀疑 Hugo 配置。
后续方向
这个站点后续会继续记录后端开发、DevOps 排障、物流系统集成,以及 AI 辅助开发工作流。