文章目录

先给问题留下一份记录

这是一份站点维护参考笔记，假设 Nginx 已经安装。开始前记下访问地址、发生时间、完整错误提示，以及最近修改过的配置。区分“连不上”“返回错误状态”和“页面内容不对”，后续检查才有方向。下面的 example.com 是占位域名，使用时换成自己管理的域名。

第一步：确认版本与配置

nginx -v
sudo nginx -t

-t 会检查配置语法，并尝试打开配置中引用的文件；报错里的文件名和行号通常是首要线索。若使用了非默认配置，检查和运行时应使用相同的 -c 路径、前缀及相关参数。nginx -T 还会把配置打印出来，可能包含内部地址或敏感字段，分享输出前要自行检查。这些参数以 Nginx 命令行文档 为准。

先看 server 块是否监听了预期端口，server_name 是否匹配访问域名，再看静态目录的 root 与入口文件。配置检查通过，只说明这一层通过了检查，不能证明域名解析、证书和页面内容都正确。

第二步：通过检查后再重载

配置有备份、检查成功后，才执行重载。由系统服务管理器启动的实例，可按本机服务管理方式操作；下面是 Nginx 自带的信号方式：

sudo nginx -s reload

重载时主进程会检查并尝试应用新配置，成功后启动新工作进程，让旧进程完成已有请求；无法应用时会继续使用旧配置。操作需要相应权限，并应针对实际运行的实例。流程见 Nginx 入门指南。重载后仍要访问页面确认，不能把命令没有输出当作验证完成。

第三步：看响应，也看内容

curl -I https://example.com/
curl -sS -o /dev/null -w '%{http_code}\n' https://example.com/

第一条发送 HEAD 请求，适合查看状态码、内容类型和重定向位置；第二条发起普通 GET 并只输出状态码。-sS 隐藏进度但保留错误提示，参数含义可查 curl 官方手册。有些应用对 HEAD 和 GET 的处理不同，所以检查头部后还要在浏览器打开首页、文章与静态资源。

按现象缩小范围

出现重定向时先核对目标地址与协议；出现 404 时核对请求路径、文件名大小写和发布目录；出现 403 时检查入口文件、目录及读取权限。连接超时则继续检查解析、监听和网络路径，不要只反复改网页文件。

最后查看实际配置指定的访问日志与错误日志，把时间和请求路径对应起来。每次只改一个可验证的问题，保留修改前后结果；日志对外分享前删去访客信息、令牌和内部路径等敏感内容。