Nginx 如何在目录结构中查找和清理废弃的虚拟主机历史配置文件

清理废弃虚拟主机配置需三步：定位（查sites-available、conf.d、sites-enabled路径）、识别（检查符号链接、全局引用、访问日志匹配）、安全移除（先隔离→重载验证→观察24小时→彻底删除）。

清理废弃的虚拟主机配置文件，核心是定位、识别、安全移除三步。Nginx 本身不管理配置生命周期，所有“废弃”都靠人工判断，误删可能导致站点不可用，所以不能跳过确认环节。

先找到所有可能存放虚拟主机配置的位置

不同发行版习惯不同，常见路径有三个：

1. /etc/nginx/sites-available/：Debian/Ubuntu 系统的标准位置，所有配置（启用或未启用）都放这里
2. /etc/nginx/conf.d/：CentOS/RHEL/Alpine 等常用目录，以 .conf 结尾的文件都会被自动包含
3. /etc/nginx/sites-enabled/：仅存符号链接，指向 sites-available 中的启用项；它本身不存真实配置，但可反向查出哪些配置正在生效

区分“废弃”还是“仍在使用”

不能只看文件名或修改时间。关键看两点：

1. 检查 sites-enabled/ 目录下是否有对应链接：没有链接且无其他 include 引用，大概率已废弃
2. 搜索全局配置是否间接引用：运行 grep -r "server_name|include" /etc/nginx/ --include="*.conf"，确认该配置没被其他文件 include 进来
3. 观察日志关联性：对比 access.log 中近期请求的 Host 头，和配置里的 server_name 是否匹配；长期无访问记录的更可能是废弃项

安全清理操作步骤

确认废弃后，按顺序执行，避免直接删除：

1. 先把文件移出主配置区：mv /etc/nginx/sites-available/old-site.conf /tmp/（不删，先隔离）
2. 重载 Nginx：nginx -t && systemctl reload nginx，验证服务是否正常，站点是否真的下线
3. 观察 24 小时：确认无业务报错、监控告警、用户反馈，再决定是否彻底删除
4. 最终清理：rm -f /tmp/old-site.conf，并同步清理 /var/log/nginx/old-site-access.log 等关联日志（如有）

预防未来堆积的建议

避免重复劳动，日常可做几件事：

1. 命名带日期或环境标识，例如 blog-prod-2024.conf、api-staging-202503.conf
2. 在配置文件顶部加注释说明用途、上线时间、负责人，如：# [DEPRECATED 2026-06] Replaced by api-v2.conf
3. 把清理动作写成脚本，每次下线前自动检查依赖和访问日志，减少人为疏漏