登录
首页 >  文章 >  php教程

XAMPPApache多端口设置教程

时间:2026-04-29 18:46:05 482浏览 收藏

本文详细解析了在XAMPP中为Apache配置多端口(如8001、8002等)的完整且不可简化的三步法:必须同步修改Listen指令显式声明端口、VirtualHost区块一对一绑定并严格设置带端口的ServerName(如localhost:8001)、以及Directory权限中明确启用Require all granted——任一环节遗漏都会导致403错误或完全无法访问;同时提醒避开Windows端口权限限制、检查防火墙拦截、排除端口占用,并强调配置生效前需确保httpd-vhosts.conf被正确加载、路径规范无中文空格、浏览器地址栏完整输入端口号,堪称XAMPP多站点开发环境下最易踩坑也最需谨守的操作指南。

XAMPP配置Apache多端口监听 XAMPP不同端口对应不同项目

能直接配,但必须同时改三处:ListenVirtualHost、目录权限,漏任何一项都会 403 或 无法访问。

Listen 指令必须显式添加多个端口

Apache 默认只监听 80,不写 Listen 就算后面写了 也无效——Apache 根本不收这个端口的包。

  • xampp\apache\conf\httpd.conf 中找到 Listen 80 行,在它下方新增你要用的端口,比如:
    Listen 8001
    Listen 8002
    Listen 8080
  • 避免使用 1024 以下端口(如 8044321),Windows 下需要管理员权限;推荐从 8001 起用
  • 不要写成 Listen :8001Listen localhost:8001,标准写法就是 Listen 8001

VirtualHost 必须按端口一对一声明,且 ServerName 要匹配

每个端口对应一个 块,ServerName 不是可选字段,必须写,且值要和浏览器访问时的 host 部分一致(通常是 localhost:端口)。

  • 推荐统一写在 httpd-vhosts.conf 文件末尾(路径:xampp\apache\conf\extra\httpd-vhosts.conf),而不是硬塞进 httpd.conf 底部
  • 确保该文件已启用:在 httpd.conf 中取消注释这行:
    Include conf/extra/httpd-vhosts.conf
  • 示例配置(注意路径用正斜杠或双反斜杠,单反斜杠会出错):
    <VirtualHost *:8001>
        ServerName localhost:8001
        DocumentRoot "C:/xampp/htdocs/project-a"
        <Directory "C:/xampp/htdocs/project-a">
            Options Indexes FollowSymLinks
            AllowOverride All
            Require all granted
        </Directory>
    </VirtualHost>
  • ServerName 必须带端口(如 localhost:8001),否则 Apache 可能 fallback 到默认虚拟主机,导致项目串了

Directory 权限配置最容易踩坑:Require all granted 不等于万事大吉

即使 DocumentRoot 路径写对了,如果对应目录没开权限,照样返回 403 Forbidden。XAMPP 旧版默认禁用所有目录访问,新版(如 XAMPP 8.2+)默认用 Require all granted,但你仍需检查两处:

  • 全局兜底权限:确认 httpd.conf 中的根目录块不是这样写的:
    <Directory />
        AllowOverride none
        Require all denied
    </Directory>
    ——这是锁死一切访问的写法,必须改成 Require all granted 或用传统 Order allow,deny + Allow from all(仅限 Apache 2.2)
  • 项目级目录块:每个 内的 块里,必须有 Require all granted(Apache 2.4+)或等效语句;AllowOverride All 是为了支持 .htaccess,非必需但建议加上
  • 路径中不能含中文或空格,否则 Apache 可能解析失败,报错类似:Invalid command 'Order', perhaps misspelled(其实是路径没读到)

Windows 防火墙和端口占用是隐藏拦路虎

配置全对,浏览器打不开?大概率是 Windows 阻断了入站连接,或者别的程序(Skype、IIS、WSL2 的 httpd)占了端口。

  • 检查端口是否被占:netstat -ano | findstr :8001,拿到 PID 后用 tasklist | findstr PID 查进程名
  • 临时放行端口(管理员权限运行 PowerShell):
    New-NetFirewallRule -DisplayName "XAMPP Port 8001" -Direction Inbound -Protocol TCP -LocalPort 8001 -Action Allow
  • 重启 Apache 前务必关闭所有命令行窗口和编辑器,否则配置文件可能被缓存或锁定,改了也不生效
  • 浏览器访问时,地址栏必须完整输入端口,例如 http://localhost:8001/;只输 localhost 会走默认 80 端口,跟你配的完全无关

最常被忽略的是 ServerName 必须带端口、httpd-vhosts.conf 文件必须被 Include 加载、以及 Windows 防火墙默认拦截新端口——这三点不确认清楚,调一整天也白搭。

理论要掌握,实操不能落!以上关于《XAMPPApache多端口设置教程》的详细介绍,大家都掌握了吧!如果想要继续提升自己的能力,那么就来关注golang学习网公众号吧!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>