Alias 专管静态资源映射，ScriptAlias 专管可执行脚本映射；前者直接返回文件，后者启动解释器执行脚本；二者共存时 ScriptAlias 优先级更高，路径不可重叠，需分别配置 Directory 权限与执行权限。
Alias 和 ScriptAlias 是 Apache 中用于路径映射的两个核心指令，它们分工明确：Alias 专管静态资源（如图片、CSS、JS），ScriptAlias 则专管可执行脚本（如 CGI、Python、PHP-CGI）。用好这两者，就能在单台 Apache 服务器上干净地实现静态与动态内容的物理分离，无需额外代理或后端服务。
Alias 映射静态资源路径
Alias 把一个 URL 前缀映射到文件系统中某个目录，Apache 会直接读取并返回其中的文件，不执行任何处理。适合存放前端资源。
- 基本写法：Alias /static/ "/var/www/assets/" 表示访问 /static/logo.png 时，实际读取的是 /var/www/assets/logo.png
- 必须配合
Require all granted - 若目标路径是符号链接（如 ln -s /mnt/cdn/static /var/www/assets），需确保 Apache 配置中启用了 FollowSymLinks，否则 -f 条件可能失效导致跳过压缩等后续处理
ScriptAlias 映射脚本执行入口
ScriptAlias 不仅做路径映射，还强制将该目录下所有文件视为可执行程序——Apache 会启动解释器运行它，并把标准输出作为 HTTP 响应返回。这是 CGI 类脚本的安全执行边界。
- 典型配置：ScriptAlias /cgi-bin/ "/usr/lib/cgi-bin/"，请求 /cgi-bin/report.py 就会执行 /usr/lib/cgi-bin/report.py
- 与 Alias 的关键区别：ScriptAlias 自动启用
ExecCGI，且默认拒绝目录索引（禁止列目录），更安全 - 支持任意后缀脚本，但需确保文件有执行权限（
chmod +x），且首行指定解释器（如#!/usr/bin/env python3） - Windows 下可写成：ScriptAlias /py/ "D:/scripts/"，访问 /py/hello.py 即运行对应脚本
两者共存时的注意事项
Alias 和 ScriptAlias 可同时存在，但顺序和路径不能重叠。Apache 按配置顺序匹配，一旦命中 ScriptAlias，就不会再检查同级 Alias。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 避免冲突：不要写
Alias /cgi-bin/ ...和ScriptAlias /cgi-bin/ ...共存；也不建议ScriptAlias /static/ ...—— 这会让图片被当成脚本执行，报 500 错误 - 路径优先级：ScriptAlias > Alias > DocumentRoot。例如
ScriptAlias /api/ "/opt/scripts/"和Alias /api/v1/docs.html "/var/www/docs.html"，后者永远不会生效，因为 /api/ 已被 ScriptAlias 拦截 - 调试技巧：开启
LogLevel info，查看 error_log 中类似 [info] [client x.x.x.x] ScriptAlias matched: /cgi-bin/test.pl 的日志，确认实际匹配路径
一个完整可用的分离示例
以下配置让静态资源走 /static/，脚本走 /run/，互不干扰：
ServerName example.com
DocumentRoot "/var/www/html"
# 静态资源
Alias /static/ "/var/www/public/"
Require all granted
# 脚本入口
ScriptAlias /run/ "/var/www/scripts/"
Require all granted
这样，/static/style.css 直接返回文件，/run/counter.pl 执行 Perl 脚本，逻辑清晰，运维可控。
