HumHub在Apache上运行需启用mod_rewrite、mod_headers、mod_env三模块，Listen端口须与VirtualHost严格对齐，DocumentRoot必须指向web子目录并配置AllowOverride All，且需通过httpd -t验证语法正确后重启。
直接改 httpd.conf 和 httpd-vhosts.conf 就能跑起来，但 HumHub 对 Apache 的模块和目录权限有硬性要求，漏掉任意一项都会 500 或 403。
确认 Apache 模块已启用（HumHub 启动失败的首要原因）
HumHub 依赖 mod_rewrite、mod_headers、mod_env 这三个模块，XAMPP 默认只启用了前两个。不启用会导致重写规则失效、静态资源加载失败、环境变量读取为空 —— 表现为白屏或登录后跳转 404。
- 打开
E:\XAMPP\apache\conf\httpd.conf（Windows）或/opt/lampp/etc/httpd.conf（macOS） - 取消以下三行的注释（去掉开头的
#）：LoadModule rewrite_module modules/mod_rewrite.soLoadModule headers_module modules/mod_headers.soLoadModule env_module modules/mod_env.so - 保存后必须重启 Apache，仅重载配置无效
Listen 和 VirtualHost 端口必须严格对齐
常见错误是 httpd.conf 里加了 Listen 8080，但 httpd-vhosts.conf 里写成 <virtualhost></virtualhost>，结果请求被默认站点吞掉，HumHub 根本没机会响应。
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.conf中添加监听端口（不要删掉原有Listen 80，保留它不影响新端口）：Listen 8080Listen 8081 - 确保
httpd-vhosts.conf中每个<virtualhost></virtualhost>的端口号与Listen完全一致：<virtualhost></virtualhost><virtualhost></virtualhost> -
ServerName值建议统一用localhost，避免因 hosts 映射缺失导致 404；如果要用域名（如humhub-cn.local），必须同步在系统hosts文件中添加127.0.0.1 humhub-cn.local
DocumentRoot 权限和 .htaccess 必须生效
HumHub 的 URL 重写（如 /dashboard）完全依赖 .htaccess，而 XAMPP 默认禁止该文件生效，不处理会直接返回 404 或暴露 PHP 源码。
-
DocumentRoot必须指向 HumHub 的web子目录（不是项目根目录），例如：DocumentRoot "E:/XAMPP/htdocs/humhub/web" - 对应
<directory></directory>块中必须包含：AllowOverride AllRequire local
（XAMPP 5.6+ 推荐用Require local，不用旧式Order/Allow） - 检查
web/.htaccess文件是否存在且未被误删；若被 Git 忽略或 IDE 隐藏，需手动恢复
重启前务必验证配置语法
Apache 启动失败时不会明确提示哪一行出错，只会卡在“Starting…”或报错“Syntax error on line X”。直接重启大概率失败。
- 打开终端（Windows：命令提示符以管理员身份运行；macOS：Terminal）
- 执行：
E:\XAMPP\apache\bin\httpd.exe -t（Windows）/opt/lampp/bin/httpd -t（macOS） - 输出
Syntax OK才可继续；否则根据提示定位行号修改 - 特别注意：
ServerName localhost:8080和Listen 8080端口号不一致、<directory></directory>路径含中文或尾部斜杠、AllowOverride写成AllowOveride这类拼写错误，httpd -t都能立刻发现
最易忽略的是 HumHub 的 web 目录权限和 .htaccess 生效逻辑 —— 很多人把整个项目扔进 htdocs 就以为完事，其实 Apache 只认 web 为入口，其他路径下的 .htaccess 不起作用。配置完别急着浏览器刷新，先跑一遍 httpd -t，再看 Apache 日志 logs/error.log 里的第一行错误，比瞎猜快十倍。
