Web 服务器与网关 / 系统课时

修改配置后怎样安全生效

修改配置后怎样安全生效

编辑器保存配置不会改变正在处理请求的 Worker。本篇把备份、配置检查、重载和请求验证连成一次操作,并说明检查失败与重载失败分别怎样处理,避免把“命令返回成功”误当作上线完成。

学习目标

  • 在变更前保存可恢复的配置版本。
  • 通过检查后重载,并验证实际处理请求的配置。
  • 区分语法检查、重载请求与业务验收的边界。

先确定回退版本

以下示例适用于 systemd 管理的单一系统实例,主配置为 /etc/nginx/nginx.conf,已有站点文件为 /etc/nginx/conf.d/demo.conf。变更前确认这些路径实际有效;若实例由容器或另一个主配置启动,应使用该实例的管理方式。

将备份放在 include 匹配范围之外。可用配置仓库提交保存旧版本,也可放入 /var/backups/nginx/;不要在 conf.d 中创建另一份仍以 .conf 结尾的文件,否则备份也可能成为有效站点,引起重复监听或域名冲突。

检查通过才发送重载

下面命令中的时间戳用于区分备份版本。执行备份后,用编辑器修改站点,再执行检查与重载部分;它们适用于前面已说明的系统实例。

bash
set -e
# 使用独立备份目录,避免被站点 include 重新读入。
sudo install -d -m 700 /var/backups/nginx
stamp=$(date +%Y%m%d-%H%M%S)
sudo cp -a /etc/nginx/conf.d/demo.conf "/var/backups/nginx/demo.conf.$stamp"
sudoedit /etc/nginx/conf.d/demo.conf
# set -e 让检查失败时立即停止,不继续发起重载。
sudo nginx -t -c /etc/nginx/nginx.conf
sudo systemctl reload nginx
systemctl is-active nginx

预期结果:检查输出包含 syntax is ok 和 test is successful,随后服务状态为 active。备份名中的时间戳实际会变化;sudoedit 是交互编辑步骤,保存退出后命令才继续。若任何命令失败,应先读错误信息,不要跳过检查单独执行后续命令。

nginx -t 会检查语法并尝试打开引用的文件;它不能证明上游应用健康、域名解析正确或每个请求都返回预期内容。Master 接到重载后还要尝试应用新配置,例如打开新的监听 Socket;失败时会保留旧配置。配置检查参数与重载机制应结合使用。

用目标请求确认行为

假设本次改动把 demo.test 的 /health 配置为返回 ready-v2,且站点监听本机 8080,执行:

bash
# 显式指定 Host,确保验证的是目标站点而非默认站点。
curl -sS -H 'Host: demo.test' -w '\nstatus=%{http_code}\n' http://127.0.0.1:8080/health

预期输出:

text
ready-v2
status=200

若仍得到旧内容,先查 sudo journalctl -u nginx -n 30 --no-pager 和该实例的错误日志,确认重载有没有应用失败,再核对监听地址与主配置。测试客户端应新建连接;已有长连接可能仍由旧 Worker 处理,不能用它推断所有新连接的行为。

出现异常时怎样回退

恢复本次备份对应的旧站点文件后,再执行相同的配置检查、重载和目标请求验证。若只是磁盘配置写错且没有成功重载,原 Worker 通常仍在使用旧配置;应先修正磁盘文件,避免后续服务重启时读取坏配置。重载适合普通配置变更,模块或二进制升级则应采用相应的升级流程。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

修改配置后怎样安全生效

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通