mod_dir 和 mod_mime 各司其职：mod_dir 通过 DirectoryIndex 查找默认文件或触发目录列表，不识别URL后缀；mod_mime 仅设置内容类型与处理器，不参与索引选择；二者无法组合实现按后缀名动态分发目录索引。

Apache 本身不提供“基于后缀名的自动化目录索引分发”这种功能——**mod_dir 和 mod_mime 各司其职，不能组合出按文件扩展名动态选择不同索引页的行为**。这是个常见误解。下面直接讲清楚它们能做什么、不能做什么，以及如何用合理方式逼近类似效果。

mod_dir 只负责找默认文件或触发目录列表

它通过 DirectoryIndex 指令按顺序查找指定名称的文件（如 index.html、index.php），找到就返回；没找到且启用了 Options Indexes，才交给 mod_autoindex 生成统一的目录列表。

它不识别后缀名含义，也不根据请求路径的扩展名切换索引逻辑。

• DirectoryIndex index.html index.md index.json → 依次查这三个名字，跟当前请求 URL 的后缀无关
• 访问 /docs/ 或 /docs/.html（非法路径）都一样走同一套索引流程
• 哪怕你把 DirectoryIndex 写成 index.py index.sh，它也只是尝试执行这些文件（需 handler 配置支持），不是“按后缀分发索引”

mod_mime 只负责声明内容类型与处理方式

mod_mime 的作用是：看到 .html 就设 Content-Type: text/html，看到 .json 就设 application/json，或给 .pl 绑定 perl-script handler。

Apache Superset Dashboard and SQL Exploration Skill

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

下载

它不参与“该显示哪个索引页”或“该生成哪种目录视图”的决策，只在内容确定后补充元数据。

• AddType text/markdown .md → 浏览器收到 index.md 时知道怎么渲染，但不决定是否选它作索引
• AddHandler cgi-script .cgi → 允许执行 foo.cgi，但 DirectoryIndex foo.cgi 是否生效仍取决于 mod_dir 查找结果和权限

想实现“按后缀类型展示不同索引风格”，得换思路

真正可行的方式是：**用一个通用入口脚本（PHP/Python/CGI）读取当前目录，按文件后缀分类组织 HTML 输出**。mod_dir 负责把它设为默认索引，mod_mime 负责让它正确执行或返回对应类型。

• 写一个 index.cgi 或 index.php，扫描当前目录下所有文件，按 .html、.pdf、.md 分组，生成带图标、描述、排序的定制页面
• 在配置中启用：
  DirectoryIndex index.php
AddHandler application/x-httpd-php .php（确保 PHP 解析）
• 若想让 /api/ 返回 JSON 格式目录清单，可写 index.json.php 并配：
  AddType application/json .json.php
DirectoryIndex index.json.php

注意两个关键限制

Apache 原生不支持“请求 /static/ 显示 HTML 索引，请求 /static/.json 却返回 JSON 目录”这类路由级分发——这属于应用层逻辑，必须靠脚本或反向代理（如 Nginx + Lua / Apache + mod_rewrite + CGI）实现。

• 不要试图用 RewriteRule ^(.*)\.json$ /index.json.php?dir=$1 模拟，因为 /static/ 末尾无后缀，无法匹配
• 也不要依赖 MultiViews（mod_negotiation），它只协商同名多版本（index.html / index.html.en），不适用于目录索引场景