DirectoryIndex 是 Apache 指定目录默认首页文件名的指令，修改它可自定义访问根目录时优先加载的文件（如 dashboard.php），解决默认首页不符需求的问题。

DirectoryIndex 是什么，改它能解决什么问题

当你访问 http://localhost/ 时，Apache 不会随机返回一个文件，而是按顺序查找一组预设的文件名——这个列表就是 DirectoryIndex。默认值通常是 index.html index.php index.htm。改它，就能让 Apache 在根目录下优先找 home.html、start.php，甚至跳过所有常见名字，直接加载 dashboard.php。

怎么修改 DirectoryIndex（以 XAMPP 为例）

打开 XAMPP 安装目录下的主配置文件：

• Windows：C:\xampp\apache\conf\httpd.conf
• macOS/Linux：/opt/lampp/etc/httpd.conf 或 /Applications/XAMPP/xamppfiles/etc/httpd.conf

在文件中搜索 DirectoryIndex，你会找到类似这一行：

DirectoryIndex index.html index.php index.htm

把它改成你想要的顺序，例如：

DirectoryIndex dashboard.php index.html index.php

注意：修改后必须重启 Apache 才生效；如果用 XAMPP Control Panel，务必点 Stop 再点 Start（Restart 有时不重载该配置）。

Apache Superset Dashboard and SQL Exploration Skill

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

下载

常见错误和陷阱

改完没效果？大概率是这几个原因：

• DirectoryIndex 行被注释掉了（前面有 #），删掉 # 才生效
• 你改的是 httpd-vhosts.conf 里的 DirectoryIndex，但当前请求走的是主服务器（非虚拟主机），所以实际没生效
• 目标文件（如 dashboard.php）不在 DocumentRoot 指向的目录里，或权限不对（比如文件属主不是 daemon 或 www-data）
• Apache 版本较老（2.2 及以前），用了 Allow from all 风格的权限控制，而新配置里混用了 Require all granted，导致整个目录被拒绝访问，连带首页都打不开

DirectoryIndex 和 DocumentRoot 的关系不能拆开看

DirectoryIndex 只在 DocumentRoot（或某个 块）生效范围内起作用。如果你把 DocumentRoot 改成了 C:/xampp/htdocs/myapp，那 DirectoryIndex 查找的起点就是这个目录，而不是原来的 htdocs。很多用户只改了 DirectoryIndex 却忘了同步检查 DocumentRoot 和对应 块里的权限设置，结果页面空白或 403 错误。

最常被忽略的一点：Apache 不会自动创建索引页，也不会“猜”你要哪个文件——它只机械地按 DirectoryIndex 列表从左到右找。漏掉一个空格、多写一个点、路径大小写不一致（尤其在 Linux/macOS 上），都会让它跳过目标文件直奔 403 或 404。