xampp 多端口部署 kirby cms 可行但不推荐，易遇权限、防火墙、缓存及跨域问题；推荐用多域名+httpd-vhosts.conf+hosts 映射，通过 *:80 虚拟主机与本地域名（如 kirby-a.test）实现稳定开发。
直接说结论：XAMPP 用多端口部署 Kirby CMS 完全可行，但不推荐——端口方案容易撞上权限、防火墙、浏览器缓存和跨域调试问题；用多域名 + httpd-vhosts.conf 配合 hosts 映射才是 Kirby 开发最稳的路。
为什么 Listen 多端口 + VirtualHost *:端口号 在 Kirby 上容易失败
Kirby 的路由、静态资源加载、.htaccess 重写规则（如 RewriteBase）默认按根路径 / 设计。一旦你用 http://localhost:8080/ 访问，Kirby 的前端 JS 可能仍尝试从 /assets/ 加载资源，而 Apache 实际把请求转发给了非标准端口下的 DocumentRoot，导致 404 或混合内容警告。
常见错误现象包括：
- 页面 HTML 能加载，但 CSS/JS 404（路径没带端口，浏览器按
http://localhost/去找） - 后台登录后跳转回
http://localhost/panel/（硬编码重定向，不认你当前的:8080） - 启用 Kirby 的
url配置项手动补端口，结果 API 请求又因 CORS 被拦
根本原因：Kirby 不是“端口感知型”CMS，它依赖服务器暴露的完整请求 URL（$_SERVER['HTTP_HOST'] 和 $_SERVER['REQUEST_URI']），而多端口配置下这些变量未必被 Apache 正确传递或 Kirby 未做适配。
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
正确做法：用域名代替端口，httpd-vhosts.conf 每个项目独立配置
给每个 Kirby 站点分配一个本地域名（如 kirby-a.test、kirby-b.test），让 Apache 把它们都指向 80 端口的不同目录，Kirby 就能自然识别完整 Host —— 这是它原生支持的方式。
实操要点：
- 在
C:\Windows\System32\drivers\etc\hosts末尾加两行：127.0.0.1 kirby-a.test127.0.0.1 kirby-b.test - 确保
XAMPP\apache\conf\httpd.conf中这行已取消注释：Include conf/extra/httpd-vhosts.conf - 编辑
XAMPP\apache\conf\extra\httpd-vhosts.conf，为每个站点写一个块（注意：全部用*:80，不是*:8080）：<virtualhost><br> ServerName kirby-a.test<br> DocumentRoot "C:/xampp/htdocs/kirby-a"<br><directory><br> Require all granted<br> AllowOverride All<br></directory><br></virtualhost>
- Kirby 项目根目录下必须有
.htaccess（官方包自带），且AllowOverride All已启用，否则重写失效，所有路由都会 404
httpd.conf 和 httpd-vhosts.conf 里最容易漏掉的三处细节
这三个地方错一个，整个多站点就静默失败，Apache 不报错但请求全进默认 htdocs：
-
httpd.conf中DocumentRoot和对应<directory></directory>的路径必须一致，且结尾不能有斜杠（C:/xampp/htdocs/kirby-a✅，C:/xampp/htdocs/kirby-a/❌） -
httpd-vhosts.conf中每个<virtualhost></virtualhost>块的ServerName必须和hosts文件里写的域名完全一致（大小写不敏感，但不能多空格、不能带http://） - 重启 Apache 前，务必在 XAMPP 控制面板里先点
Config → Apache (httpd.conf)，运行httpd -t验证语法；若提示Syntax OK再点 Start —— 否则配置无效还找不到原因
真正麻烦的从来不是加几行配置，而是 Apache 把请求悄悄扔给默认站点却不告诉你。盯住 ServerName、DocumentRoot、hosts 三者是否咬死对齐，比折腾端口快得多。
