Apache配置：除指定路径外全站基础认证失效问题排查

你的核心问题是：Apache虚拟主机配置中，/webhook/bitbucket路径无法绕过基础认证，而类似规则在/admin/configuration上正常工作。根因是应用的.htaccess将所有非静态资源请求重写到index.php，导致Apache处理内部重写后的请求时，再次触发根路径的认证规则，同时<Location>指令的处理逻辑也可能导致例外规则未生效。

以下是三种可行的解决方案：

方案1：用环境变量跳过认证 #

通过SetEnvIf匹配目标URI并设置环境变量，在根认证规则中允许该变量对应的请求：

<VirtualHost *:443>
  ServerName test.tonnerklaps.local
  DocumentRoot /srv/satisfy/public
  SSLCertificateFile /etc/ssl/certs/test.tonnerklaps.local.pem
  SSLCertificateKeyFile /etc/ssl/private/test.tonnerklaps.local-key.pem

  # 匹配目标路径并设置环境变量
  SetEnvIf Request_URI "^/webhook/bitbucket$" skip_auth=1

  <Location "/">
    LogMessage "L root %{REQUEST_URI}"
    AuthType Basic
    AuthName "Restricted Access"
    AuthBasicProvider file
    AuthUserFile "/var/www/passwd/passwords"
    # 允许认证用户或跳过认证的请求
    <RequireAny>
      Require user packagist
      Require env skip_auth
    </RequireAny>
  </Location>
</VirtualHost>

方案2：在.htaccess中添加认证例外 #

先调整VirtualHost允许.htaccess修改认证配置，再在应用的public/.htaccess中添加规则：

1. 在VirtualHost中添加目录配置：

<Directory "/srv/satisfy/public">
  AllowOverride AuthConfig FileInfo
</Directory>

2. 在public/.htaccess的RewriteEngine On之后添加：

<If "%{REQUEST_URI} == '/webhook/bitbucket'">
  AuthType None
  Require all granted
</If>

方案3：调整规则顺序与合并逻辑 #

确保更具体的路径规则优先定义，同时关闭认证合并避免规则冲突：

<VirtualHost *:443>
  ServerName test.tonnerklaps.local
  DocumentRoot /srv/satisfy/public
  SSLCertificateFile /etc/ssl/certs/test.tonnerklaps.local.pem
  SSLCertificateKeyFile /etc/ssl/private/test.tonnerklaps.local-key.pem

  # 先定义具体路径的例外规则
  <Location "/webhook/bitbucket">
    LogMessage "L webhook %{REQUEST_URI}"
    AuthMerging Off
    AuthType None
    Require all granted
  </Location>

  # 再定义根路径的认证规则
  <Location "/">
    LogMessage "L root %{REQUEST_URI}"
    AuthType Basic
    AuthName "Restricted Access"
    AuthBasicProvider file
    AuthUserFile "/var/www/passwd/passwords"
    Require user packagist
  </Location>
</VirtualHost>

关键注意事项 #

• 修改配置后必须重启Apache生效：sudo systemctl restart apache2
• Apache的<Location>指令按配置文件顺序处理，更具体的路径规则需优先定义，避免被根规则覆盖
• 内部重写请求（如转发到index.php）会再次触发根路径规则，因此通过环境变量匹配原始URI是更可靠的方式

内容的提问来源于stack exchange，提问作者mkreis