Apache虚拟目录必须配对Alias与块，顺序为Alias在前、Directory紧随其后；内须含Require all granted，PHP解析需用AddHandler或FilesMatch限定.php后缀，且需启用alias和php模块、确保目录权限及服务重启。

Apache虚拟目录配 Directory 权限块，核心是把 Alias 和 配对使用，并确保权限指令符合 Apache 2.4+ 的语法规范（用 Require，不用旧版 Order/Allow/Deny）。

必须配对且顺序正确

Alias 必须写在 外面，不能嵌套，也不能颠倒顺序。错误写法会导致配置不生效或路径解析异常：

• ✅ 正确顺序：Alias /myapp "/var/www/app" → 换行 → ...
• ❌ 错误顺序： 块提前、中间插其他指令、或 Alias 写在 里面

基础权限指令要写全

仅写 Require all granted 不够稳妥，还需明确启用必要特性（如符号链接、目录索引等），并禁用危险选项：

Apache Superset Dashboard and SQL Exploration Skill

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

下载

• Options FollowSymLinks：允许访问符号链接（常用，但避免用 Indexes，防止目录遍历）
• AllowOverride None：禁止 .htaccess 覆盖配置（提升安全性和性能）
• Require all granted：放行所有请求（若需限制 IP，可改用 Require ip 192.168.1.0/24）

PHP 文件要单独处理

别直接在 顶层写 SetHandler application/x-httpd-php —— 这会让所有文件（包括 .jpg、.js）都走 PHP 解析器，导致图片无法加载、JS 报错：

• ✅ 推荐写法：AddHandler application/x-httpd-php .php（只对 .php 后缀生效）
• ✅ 更精细控制（含 .phtml 或自定义后缀）： SetHandler application/x-httpd-php

别忘了前置条件检查

配置写完不生效？大概率卡在这三步：

• 确认 alias 和 php8.1（或对应版本）模块已启用：sudo a2enmod alias php8.1（Debian/Ubuntu）或检查 /etc/httpd/conf.modules.d/ 下有 LoadModule alias_module 和 php_module
• 真实目录要有读取权限：chmod 755 /var/www/app，且 Apache 用户（如 www-data 或 apache）能进入父路径
• 配置文件保存后必须重启服务：sudo systemctl restart apache2（或 httpd）