nginx虽无内置模板引擎，但可通过标准化结构、文件分离与小工具辅助实现多站点配置的统一生成：定义含domain_placeholder和site_id占位符的基础server模板，按约定批量生成独立conf文件，并拆分http跳转与https服务模板，配合nginx -t验证及reload机制确保安全上线。
Nginx 本身不内置模板引擎，但可以通过「标准化结构 + 文件分离 + 小工具辅助」实现统一模板驱动的多站点配置生成，既保证规范性，又避免重复劳动。
用基础 server 块定义通用模板
一个可复用的最小化模板应包含所有必要字段，且留出变量占位（便于后续替换）：listen 80;
server_name DOMAIN_PLACEHOLDER;
root /var/www/SITE_ID/public;
index index.html index.php;
access_log /var/log/nginx/SITE_ID_access.log;
error_log /var/log/nginx/SITE_ID_error.log;
location / {
try_files $uri $uri/ =404;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
关键点：
- DOMAIN_PLACEHOLDER 和 SITE_ID 是人工或脚本替换的锚点
- 所有路径、日志名、PHP 版本等均按约定统一，不写死具体域名或路径
- 不含 if、rewrite 等易出错指令，保持语义清晰
按站点批量生成独立 conf 文件
推荐将每个站点配置存为 `/etc/nginx/conf.d/{site_id}.conf`，例如 `blog.example.com.conf`、`shop.example.com.conf`。 生成方式有三种实用选择：- 手动复制模板 → 替换占位符 → 保存为新文件（适合 3–5 个站点）
- 用 shell 脚本批量生成（适合中等规模）：
printf "$template" | sed "s/DOMAIN_PLACEHOLDER/blog.example.com/g; s/SITE_ID/blog_example_com/g" > /etc/nginx/conf.d/blog.example.com.conf
- 使用现成工具如 nginx-config-gen 或简单 Python 脚本读取 YAML 清单（如 sites.yml），循环渲染 Jinja2 模板，输出标准 conf
HTTPS 和重定向也纳入模板体系
主域名归集、HTTP 强制跳转、SSL 配置不能例外，应拆分为两个模板：- HTTP 跳转模板（80 端口）：只含 listen 80 + server_name 列表 + return 301 https://www.php.cn/link/59fe6c40cb71e8112889c205aa286559
- HTTPS 服务模板（443 端口）：含 ssl_certificate、ssl_certificate_key（路径可参数化）、server_name www.main.com、完整 PHP/静态处理逻辑
这样，每个站点最终生成 2 个 conf 文件（HTTP 跳转 + HTTPS 服务），逻辑分离、职责明确，也方便证书轮换或策略调整。
验证与加载机制要固化
无论多少个站点，上线前必须执行固定动作： - 每个新 conf 文件保存后，运行 sudo nginx -t 验证语法 - 确认无误再执行 sudo systemctl reload nginx - 主配置中确保已启用 include /etc/nginx/conf.d/*.conf;（通常默认存在，建议检查） - 可加简单校验脚本：遍历 conf.d 下所有 .conf，检查是否含 server_name、root、listen 等必需指令不复杂但容易忽略
