mod_macro通过定义可复用的VirtualHost模板大幅提升Apache多站点配置效率。适用于5个以上结构相似站点，需显式加载模块并用$变量占位定义宏，再通过Use指令批量调用。

当服务器需要托管几十甚至上百个结构相似的虚拟主机时，逐个复制粘贴 块不仅容易出错，还会让配置文件臃肿难维护。mod_macro 的核心价值就在这里：它把重复的骨架抽成可调用的模板，只暴露关键变量，大幅提升配置一致性与可扩展性。

确认是否适合启用 mod_macro

不是所有场景都值得引入 mod_macro。它最适合以下情况：

• 有 5 个以上 virtualhost，且大部分指令（如 PHP-FPM 代理、日志路径规则、目录权限）高度一致
• 新增站点频率高，希望“改一行就上线”，而非每次手动复制+修改 6 处
• 团队协作中需避免因漏改某处 ServerAlias 或 Require 指令导致的访问异常

如果只有 2–3 个站点，或各站点差异极大（比如有的要 SSL 重定向、有的禁用 .htaccess、有的走不同后端），硬套宏反而增加理解成本和调试难度。

加载模块并验证可用性

mod_macro 不是 Apache 默认内置模块，必须显式加载：

• Debian/Ubuntu：运行 sudo a2enmod macro，再 sudo systemctl reload apache2
• RHEL/CentOS：确保 EPEL 已启用，安装 httpd-mod-macro，然后在 httpd.conf 中添加 LoadModule macro_module modules/mod_macro.so
• 验证是否生效：apachectl -t -D DUMP_MODULES | grep macro 应输出 macro_module (shared)；再执行 apachectl -t 确保无语法错误

定义一个带参数的 VirtualHost 宏

把共性部分写进 ，用 $变量名 占位。例如：

  
    ServerName $domain
    DocumentRoot $docroot
    ErrorLog $docroot/../logs/$domain-error.log
    CustomLog $docroot/../logs/$domain-access.log combined
    
      Require all granted
      AllowOverride All
    
  

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

注意：$domain 和 $docroot 是纯文本替换，不支持默认值、条件判断或路径拼接。宏名 VHostBase 区分大小写，且必须定义在全局作用域（不能嵌套在 或其他块内）。

批量调用宏并组织配置结构

在主配置或 conf/extra/httpd-vhosts.conf 中，按需调用：

Use VHostBase example.com /var/www/example
Use VHostBase blog.example.com /var/www/blog
Use VHostBase api.example.com /var/www/api

建议将宏定义单独存为 conf/macro/vhost-base.macro，再通过 Include conf/macro/*.macro 加载，保持主配置清爽。每次新增站点，只需追加一行 Use 指令，无需触碰任何结构逻辑。