XAMPP配置多端口并设置访问白名单-php教程-PHP中文网

xampp需手动修改httpd.conf和httpd-vhosts.conf两处权限逻辑才能实现多端口+白名单共存：一是在httpd.conf中添加listen端口并修改全局权限为require local；二是在httpd-vhosts.conf每个内配置匹配documentroot的块并设置require指令，且必须启用include conf/extra/httpd-vhosts.conf。

xampp配置多端口并设置访问白名单

XAMPP默认不允许多端口+白名单共存，必须手动改httpd.conf和httpd-vhosts.conf两处权限逻辑，否则8080/8081等端口一开就403或500。

修改`httpd.conf`启用多端口监听和基础权限

Apache不会自动监听你加的端口，光在httpd-vhosts.conf里写<virtualhost></virtualhost>没用。先打开C:\XAMPP\apache\conf\httpd.conf，找到Listen 80这一行，在它下面添加你要的端口：

Listen 8080
Listen 8081
Listen 8000

接着往下翻，找到类似这样的全局目录权限块（通常在210–230行附近）：

<directory></directory>
    AllowOverride none
    Require all denied

这个配置会把所有未显式授权的路径（包括你新增端口下的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></directory>只管根路径，你每个VirtualHost下的DocumentRoot还得单独授权，否则403照常报。编辑C:\XAMPP\apache\conf\extra\httpd-vhosts.conf，每个<virtualhost></virtualhost>块里必须包含<directory></directory>子块：

<virtualhost>
    DocumentRoot "C:/xampp/htdocs/project-a"
    ServerName localhost:8080
    <directory>
        Require local
        # 或 Require ip 127.0.0.1 ::1 192.168.1.50
        Options Indexes FollowSymLinks
        AllowOverride All
    </directory></virtualhost>

关键点：

XAMPP 8.0.30

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></directory>里的路径必须和DocumentRoot完全一致，大小写、斜杠方向都要对（Windows下反斜杠\要写成正斜杠/）
白名单指令必须写在<directory></directory>里，写在<virtualhost></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></virtualhost>决定