documentroot 必须放在 virtualhost 块内，因其天然对应单个网站语义边界，可隔离根目录、权限、路由及运行环境；全局设置会被忽略且易引发冲突，多站点部署需按站点粒度精细化路径与权限控制。

因为 VirtualHost 块天然对应“一个网站”的语义边界，把 DocumentRoot 放在里面，能明确隔离不同站点的根目录、权限、路由和运行环境，避免全局污染和配置冲突。

DocumentRoot 必须绑定到具体服务单元

Apache 的设计逻辑是：每个可访问的网站（即每个可响应 HTTP 请求的域名或端口）都需要独立定义其文档根。VirtualHost 就是这个最小服务单元——它封装了 ServerName、端口、日志路径、SSL 设置等完整上下文。DocumentRoot 作为该站点的文件起点，自然应与之同级声明。写在全局（如 httpd.conf 顶层）只适用于单站服务器，且一旦启用虚拟主机，全局 DocumentRoot 就会被忽略，容易引发预期外的行为。

权限与路径控制必须按站点粒度精细化

不同站点往往需要不同的访问策略（比如有的允许 .htaccess，有的禁用；有的需 FollowSymLinks，有的不需要）。这些必须通过 块配合 DocumentRoot 路径生效，而 只能在服务器级或 VirtualHost 内使用。把 DocumentRoot 和对应的 都放在同一个 VirtualHost 里，能确保权限规则严格作用于该站点路径，不会误影响其他站点。若 DocumentRoot 在全局，而 在 VirtualHost 中，路径可能不匹配，导致 403 错误。

Apache Superset Dashboard and SQL Exploration Skill

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

下载

多站点部署时，全局 DocumentRoot 无法满足需求

• 一个 VirtualHost 只能有一个 DocumentRoot，但一台服务器常托管多个域名
• 各站点文件路径不同（如 /var/www/site-a/public、/srv/app-b/web），必须分别指定
• 若强行共用全局 DocumentRoot，就得靠子目录模拟多站，但 PHP 的 __DIR__、require_once 等会基于全局根计算路径，极易出错
• ServerName 匹配、SSL 配置、日志分离等都依赖 VirtualHost 的隔离性，DocumentRoot 是其中不可分割的一环

配置可维护性与排错效率更高

当所有站点配置集中在一个 VirtualHost 块内（含 DocumentRoot、、ServerAlias、ErrorLog），新增、修改或停用站点只需操作单个文件或区块。运维人员一眼就能看清“这个域名对应哪套文件、谁有权限、走什么规则”。全局配置混杂多个站点逻辑，不仅易出错，而且 reload 或语法检查时更难定位问题来源。

不复杂但容易忽略