结论：XAMPP用不同端口跑多个站点，必须同步修改httpd.conf的Listen指令和httpd-vhosts.conf中对应端口的<VirtualHost *:端口号>块，缺一即导致404或503；同时需确保ServerName与访问URL完全一致、DocumentRoot为无尾斜杠绝对路径、<Directory>内含Require all granted，且配置后须httpd -t验证语法再重启。

直接说结论：XAMPP 要用不同端口跑多个站点，必须同时改 httpd.conf 的 Listen 和 httpd-vhosts.conf 的 <VirtualHost *:端口号>，漏掉任一环节都会 404 或 503。

修改 httpd.conf 启用多端口监听

Apache 默认只监听 80，不加配置就无法响应 :8080 这类请求。这步是底层前提，不是可选项。

• 打开 XAMPP\apache\conf\httpd.conf
• 找到 Listen 80 这一行，在它下面新增你要的端口，比如：
  Listen 8080
Listen 8081
• 检查 ServerName 行是否匹配——如果只配了 ServerName localhost:80，但又监听 8080，Apache 启动会失败；建议统一改成 ServerName localhost:80（保留默认），再额外加行：
  ServerName localhost:8080
ServerName localhost:8081
• 确认 Include conf/extra/httpd-vhosts.conf 这行没被注释（即前面没有 #）

在 httpd-vhosts.conf 中为每个端口定义 <VirtualHost>

每个端口对应一个独立的 <VirtualHost *:端口号> 块，不能复用同一个块、也不能把多个端口写进一个块里。

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

• 打开 XAMPP\apache\conf\extra\httpd-vhosts.conf
• 每个站点单独写一个块，例如：

  <VirtualHost *:8080>
      ServerName localhost:8080
      DocumentRoot "C:/xampp/htdocs/project-a"
      <Directory "C:/xampp/htdocs/project-a">
          Require all granted
      </Directory>
  </VirtualHost>
  
  <VirtualHost *:8081>
      ServerName localhost:8081
      DocumentRoot "C:/xampp/htdocs/project-b"
      <Directory "C:/xampp/htdocs/project-b">
          Require all granted
      </Directory>
  </VirtualHost>

• DocumentRoot 必须是绝对路径，结尾不能带斜杠（C:/xampp/htdocs/project-a/ 是错的）
• ServerName 必须和你浏览器里输入的地址一致（http://localhost:8080 就填 localhost:8080），否则 Apache 会 fallback 到第一个 <VirtualHost> 块

绕不开的权限与访问控制问题

即使配置全对，也常卡在 403 Forbidden。根本原因是 Apache 2.4+ 默认拒绝所有目录访问，必须显式放行。

• 上面示例里的 <Directory> 块中，Require all granted 是关键，缺了就 403
• 不要去动 httpd.conf 里全局的 Require all denied，那会影响整个服务；只在每个 <VirtualHost> 内部做最小化授权
• 如果项目含 .htaccess，还需把 AllowOverride 设为 All：
  AllowOverride All
• Windows 下路径分隔符用正斜杠 /（不是反斜杠 \），否则 Apache 解析失败

验证语法 + 重启前必做这三件事

改完配置不验证就点 Start，Apache 极大概率启动失败，面板按钮瞬间变灰，错误日志里只显示 “Syntax error”，根本看不出哪行错。

• 打开命令行，cd 到 XAMPP\apache\bin 目录，运行：
  httpd -t
  输出 Syntax OK 才算过关
• 检查 Windows hosts 文件——虽然用 localhost:端口 不需要改 hosts，但一旦你用了自定义域名（如 admin.dev:8080），就必须在 C:\Windows\System32\drivers\etc\hosts 加：
  127.0.0.1 admin.dev
• 浏览器缓存和 DNS 缓存干扰大，测试时优先用无痕窗口，或清空 DNS 缓存：
  ipconfig /flushdns

最容易被忽略的是：端口监听和虚拟主机端口必须严格一致，且 ServerName 必须和实际访问 URL 完全匹配（包括端口号）。少一个冒号、多一个空格，Apache 都不会认。