DocumentRoot 配置需同步修改指令值、对应 Directory 块路径及权限语句（Require all granted），并确保文件系统权限与 SELinux 上下文正确；静态资源缓存须启用 mod_expires 和 mod_headers 模块，通过 ExpiresByType 设置类型化过期时间，并用 Header set Cache-Control "public, max-age=31536000, immutable" 实现高效长期缓存。

配置 apache 的 documentroot 和静态资源缓存策略是两个独立但常需协同处理的任务：前者决定网站文件从哪读，后者决定浏览器如何高效复用这些文件。只设 documentroot 不配缓存，页面反复加载；只配缓存不确认 documentroot 正确，连文件都找不到。下面分两块讲清关键操作。

DocumentRoot 配置要点

DocumentRoot 是 Apache 查找 HTML、CSS、JS、图片等静态资源的起点目录。改它不是改一行就完事，必须同步三处：

• 修改 DocumentRoot 指令值，例如：
  DocumentRoot "/home/www/myapp/public"
• 找到对应 <Directory "…"> 块，把引号内路径改成完全一致的路径，例如：
  <Directory "/home/www/myapp/public">
• 确保该 <Directory> 块内含权限放行语句（Apache 2.4+）：
  Require all granted

配置文件位置因系统而异：
● Ubuntu/Debian：通常在 /etc/apache2/sites-enabled/000-default.conf 或 /etc/apache2/apache2.conf
● CentOS/RHEL：主配置为 /etc/httpd/conf/httpd.conf

静态资源缓存策略配置

对 CSS、JS、图片等静态文件启用缓存，主要靠 mod_expires 和 mod_headers 模块。先确认它们已启用：

• Ubuntu/Debian：sudo a2enmod expires headers
• CentOS/RHEL：sudo httpd -M | grep -E "(expires|headers)"，若无输出需检查 LoadModule 行是否启用

然后在 <Directory> 块内或站点配置中添加缓存规则，例如：

<IfModule mod_expires.c>
  ExpiresActive on
  ExpiresByType text/css "access plus 1 year"
  ExpiresByType application/javascript "access plus 1 year"
  ExpiresByType image/jpg "access plus 1 month"
  ExpiresByType image/jpeg "access plus 1 month"
  ExpiresByType image/png "access plus 1 month"
  ExpiresByType image/gif "access plus 1 month"
</IfModule>

<IfModule mod_headers.c>
  Header set Cache-Control "public, max-age=31536000, immutable"
</IfModule>

说明：
● ExpiresByType 设置不同 MIME 类型的过期时间（相对当前访问时间）
● Cache-Control: immutable 告诉浏览器该资源内容永不变更，可放心长期缓存（适合带哈希名的文件，如 main.a1b2c3.js）
● max-age=31536000 即一年（秒），优先级高于 Expires

interactive-document-writing

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

下载

权限与 SELinux 注意事项

即使路径和缓存都配对了，仍可能返回 403 错误——Apache 进程没权限读新目录：

• Ubuntu/Debian：sudo chown -R www-data:www-data /home/www/myapp/public
sudo chmod -R 755 /home/www/myapp/public
• CentOS/RHEL：sudo chown -R apache:apache /home/www/myapp/public
sudo chmod -R 755 /home/www/myapp/public

若系统启用了 SELinux（常见于 RHEL/CentOS），还需校验上下文：

• 运行 ls -Z /home/www/myapp/public，确认类型为 httpd_sys_content_t
• 若不符，执行 sudo restorecon -Rv /home/www/myapp/public 恢复默认上下文

验证与调试建议

每次修改后务必重启服务并检查响应头：

• 重启：sudo systemctl restart apache2（Debian/Ubuntu）或 sudo systemctl restart httpd（RHEL/CentOS）
• 验证配置语法：sudo apache2ctl configtest 或 sudo httpd -t
• 用 curl 查看响应头：curl -I http://localhost/style.css，确认含 Cache-Control 和 Expires
• 查错误日志定位问题：sudo tail -f /var/log/apache2/error.log 或 /var/log/httpd/error_log

不复杂但容易忽略。DocumentRoot 是入口，缓存是加速器，两者配稳了，网站才既安全又快。