DocumentRoot 配置必须用绝对路径且末尾无斜杠，配对同路径的 <Directory> 块并显式 Require all granted，路径须独立最小化（如 /var/www/example.com），HTTPS 和多站点需各自虚拟主机中单独声明。

Apache 的 DocumentRoot 不是随便改个路径就行，它关系到网站能否访问、权限是否安全、多站点是否隔离。关键在于路径写法、配套授权、权限归属和上下文位置这四点。

DocumentRoot 必须用绝对路径，且末尾不能带斜杠

Apache 不会“猜”你的路径意图，只按字面解释。相对路径如 htdocs、./myapp 或 ../public 一律无效，启动时可能静默回退到默认目录，或直接报错。

• Linux/macOS 正确写法：DocumentRoot "/var/www/example.com"（开头是 /，结尾无斜杠）
• Windows 正确写法：DocumentRoot "C:/htdocs/myapp"（盘符开头，斜杠统一用正斜杠 /）
• 错误示例：DocumentRoot "/var/www/html/"（末尾斜杠易导致重写规则拼接异常）
• 错误示例：DocumentRoot "D:\www"（反斜杠在配置中可能被转义，应统一用 /）

DocumentRoot 要配对 块并显式授权

只改 DocumentRoot 不够，Apache 2.4+ 默认拒绝所有访问，必须用 明确放行。这个 的路径必须和 DocumentRoot 完全一致，否则返回 403 Forbidden。

interactive-document-writing

通过全交互式问答对话，逐章节完成长文档的创建、编写和审计。适用于白皮书、方案书、用户手册、分析报告等需要深度共创的文档。 当用户提到"交互式写文档"、"一起写白皮书"、"逐章讨论"、"Step by Step写文档"、"帮我写方案书/报告/手册"， 或者用户想通过问答方式完成任何长文档编写时，使用此技能。即使用户...

下载

• 正确示例：
  <Directory "/var/www/example.com">
    Require all granted
  </Directory>
• 注意：路径字符串需与 DocumentRoot 一字不差，包括大小写和空格；若用了符号链接， 中应写真实路径而非链接路径
• 不要遗漏 Require all granted（Apache 2.4+），旧版的 Allow from all 在新版已失效

路径选择要符合安全基线：独立、最小、可控

别把 DocumentRoot 放在系统根目录（/）、用户主目录（/home/www）或 Apache 安装目录（/usr/local/apache2/htdocs）下。这些位置容易引发越权、备份混乱或权限冲突。

• 推荐路径：/srv/www/example.com（符合 Linux FHS 标准，专为服务数据设计）
• 或 /var/www/example.com（常见、语义清晰，但需确保该目录不混放其他项目）
• 禁止在 DocumentRoot 内存放敏感文件（如 .env、config.php、数据库备份）——它们不该被 Web 进程直接读取
• 目录属主建议设为 www-data:www-data（Debian/Ubuntu）或 apache:apache（RHEL/CentOS），权限设为 755（目录）、644（文件）

HTTPS 和多站点场景下，DocumentRoot 必须单独声明

HTTP 和 HTTPS 是两个独立的虚拟主机，DocumentRoot 不继承、不共享。HTTPS 的 块里必须显式写出 DocumentRoot，并配同路径的 授权。

• 若 HTTP 站点用 DocumentRoot "/var/www/app"，HTTPS 也得写一遍，不能省略
• 多站点必须用多个 ，每个块内设自己的 DocumentRoot —— 单个 VirtualHost 内无法设置多个根目录
• 子目录托管多个应用？不要试图在 /var/www/html/app1 和 /var/www/html/app2 下分别设根，而应为 app1.example.com 和 app2.example.com 各建一个 VirtualHost