XAMPP需手动修改httpd.conf和httpd-vhosts.conf两处权限逻辑才能实现多端口+白名单共存:一是在httpd.conf中添加Listen端口并修改全局<Directory />权限为Require local;二是在httpd-vhosts.conf每个<VirtualHost>内配置匹配DocumentRoot的<Directory>块并设置Require指令,且必须启用Include conf/extra/httpd-vhosts.conf。

XAMPP默认不允许多端口+白名单共存,必须手动改httpd.conf和httpd-vhosts.conf两处权限逻辑,否则8080/8081等端口一开就403或500。
修改httpd.conf启用多端口监听和基础权限
Apache不会自动监听你加的端口,光在httpd-vhosts.conf里写<VirtualHost *:8080>没用。先打开C:\XAMPP\apache\conf\httpd.conf,找到Listen 80这一行,在它下面添加你要的端口:
Listen 8080 Listen 8081 Listen 8000
接着往下翻,找到类似这样的全局目录权限块(通常在210–230行附近):
<Directory />
AllowOverride none
Require all denied
</Directory>这个配置会把所有未显式授权的路径(包括你新增端口下的DocumentRoot)一律拒绝访问。改成:
-
AllowOverride None保持不变(除非你要用.htaccess) - 删掉
Require all denied,换成Require local(只允许本机访问)或Require ip 192.168.1.0/24(指定网段) - 如果真要开放给局域网某几台机器,用
Require ip 192.168.1.100 192.168.1.101
注意:Order Deny,Allow + Allow from all是旧版Apache语法,XAMPP 7.4+(含当前主流版本)已弃用,硬写进去会导致500错误。
在httpd-vhosts.conf中为每个端口单独配白名单
全局<Directory />只管根路径,你每个VirtualHost下的DocumentRoot还得单独授权,否则403照常报。编辑C:\XAMPP\apache\conf\extra\httpd-vhosts.conf,每个<VirtualHost>块里必须包含<Directory>子块:
<VirtualHost *:8080>
DocumentRoot "C:/xampp/htdocs/project-a"
ServerName localhost:8080
<Directory "C:/xampp/htdocs/project-a">
Require local
# 或 Require ip 127.0.0.1 ::1 192.168.1.50
Options Indexes FollowSymLinks
AllowOverride All
</Directory>
</VirtualHost>关键点:
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包,专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括:Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统,可让开发者在个人电脑上轻松模拟服务器环境,无需复杂配置即可运行 WordPress、Thin
-
DocumentRoot路径必须是绝对路径,结尾不能带斜杠(C:/xampp/htdocs/project-a✅,C:/xampp/htdocs/project-a/❌) -
<Directory>里的路径必须和DocumentRoot完全一致,大小写、斜杠方向都要对(Windows下反斜杠\要写成正斜杠/) - 白名单指令必须写在
<Directory>里,写在<VirtualHost>顶层无效
确认httpd-vhosts.conf被主配置加载
很多人改完httpd-vhosts.conf却没生效,是因为httpd.conf里这行被注释了:
#Include conf/extra/httpd-vhosts.conf
删掉开头的#,确保它是:
Include conf/extra/httpd-vhosts.conf
另外检查httpd.conf里有没有其他Include语句意外覆盖了你的配置,比如某些XAMPP版本自带httpd-xampp.conf也会加载vhosts,优先级可能更高。
验证配置并重启,别跳过语法检查
改完所有文件后,不要直接点XAMPP控制面板的Restart——先做语法校验:
- 打开命令行,cd到
C:\XAMPP\apache\bin - 运行:
httpd -t - 如果输出
Syntax OK,再重启Apache;如果报错(如Invalid command 'Require'),说明用了旧语法或模块没启用
常见失败原因:
-
Require指令报错 → 检查httpd.conf里是否启用了mod_authz_core(默认已启用,但若手动关过就需打开LoadModule authz_core_module modules/mod_authz_core.so) - 端口被占用 → 运行
netstat -ano | findstr :8080看PID,再用任务管理器结束对应进程 - 改了
ServerName localhost:8080但Apache启动失败 →ServerName只接受域名+可选端口,但不能强制绑定端口;应写ServerName localhost,端口由<VirtualHost *:8080>决定
白名单逻辑比想象中更“刚性”:哪怕只漏写一个<Directory>块,对应端口下的整个站点就会变成403。不是所有端口共享同一套权限,每个VirtualHost都得自己扛。

















