如何设置XAMPP以配置多个端口并启用Permissions-Policy权限策略？

本文共计766个文字，预计阅读时间需要4分钟。

XAMPP自身不支持直接通过图形界面或配置项启用Permissions-Policy响应头。您需要在Apache配置文件中手动添加HTTP头部。具体步骤如下：

多端口配置必须改两个地方：Listen + VirtualHost

只在 httpd.conf 里加 Listen 8080 不够，Apache 2.4+ 默认不会把新端口自动映射到虚拟主机。你必须同时在 httpd-vhosts.conf 中为每个端口定义完整 <VirtualHost *:8080> 块，否则请求会 fallback 到默认站点（通常是 htdocs），甚至返回 403。

• 确认 httpd.conf 中已取消注释：Include conf/extra/httpd-vhosts.conf
• 每个 <VirtualHost *:PORT> 必须包含独立的 <Directory> 块，不能复用全局配置
• DocumentRoot 路径必须是绝对路径，结尾不能带斜杠（如 C:/xampp/myapp，不是 C:/xampp/myapp/）
• Windows 下路径分隔符统一用正斜杠 /，避免反斜杠转义问题

Permissions-Policy 只能通过 Header 指令注入，且需按端口分别设置

Apache 的 Header set 指令作用域是当前配置上下文，<VirtualHost *:8080> 里的设置不会影响 *:8081。想让所有端口都带策略，就得每个 <VirtualHost> 块内单独写一次。

• 确保 mod_headers 已启用：检查 httpd.conf 中 LoadModule headers_module modules/mod_headers.so 未被注释
• 在每个 <VirtualHost> 内的 <Directory> 块中添加：Header set Permissions-Policy "geolocation=(), microphone=(), camera=()"
• 如果项目需部分权限（如允许 iframe 全屏），写成：Header set Permissions-Policy "fullscreen=(self), geolocation=()"
• 不要在 httpd.conf 全局区域加该 Header，否则可能被后续虚拟主机覆盖或触发 500 错误

403 错误大概率是 Directory 权限和 Header 冲突导致

Apache 2.4+ 把访问控制从 Order/Allow 改为 Require，但很多老教程仍教你改 Allow from all。如果你混用两种语法（比如保留 AllowOverride None 又加 Require all granted），Apache 会静默拒绝请求，且错误日志未必报明原因。

• 每个 <Directory> 块内必须统一用 Require 语法：Require all granted
• 若要限制仅本地访问，写 Require local，别用 Allow from 127.0.0.1
• Header set 必须放在 Require 规则之后，否则某些 Apache 版本会跳过设置
• 修改后务必运行 httpd -t 验证配置语法，再重启服务

真正麻烦的不是加端口或加 Header，而是每个端口都要重复一遍权限和策略配置，漏掉一个 <Directory> 块，那个端口就既没访问权也没策略保护——这种“半生效”状态最难排查。