使用.htpasswd与.htaccess为单个页面/文件设置密码保护遇阻

• 先把指令语法和路径搞对
  用Files指令时，路径要对应全局.htaccess的相对位置，比如要保护根目录下的secret-page.php，代码这么写：

  <Files "secret-page.php">
      AuthType Basic
      AuthName "Restricted Content"
      AuthUserFile /home/yourusername/.htpasswd
      Require valid-user
  </Files>
  

  重点：AuthUserFile必须用服务器绝对路径，别用相对路径，比如./.htpasswd大概率失效，得换成你主机上的真实绝对路径（比如/var/www/html/.htpasswd）。

• 避开建站工具的规则冲突
  像WordPress这类建站工具的全局.htaccess里一堆重写规则，会把你的认证规则挤到后面不生效。把密码保护代码直接放在所有RewriteRule规则前面，先执行认证再处理重写。

• 指令的正确用法
  用就得匹配完整的URL路径，比如目标页面是https://yourdomain.com/secret，代码这么写：

  <Location "/secret">
      AuthType Basic
      AuthName "Restricted Content"
      AuthUserFile /path/to/your/.htpasswd
      Require valid-user
  </Location>
  

  如果是PHP文件，路径要带文件名，比如/secret.php。另外要确认主机允许在.htaccess里用，部分虚拟主机可能禁用这个指令。

• 加Files组合拳
  如果目标页面在子目录里，比如/content/secret.php，可以用锁定目录，再用Files指定文件：

  <Directory "/var/www/html/content">
      <Files "secret.php">
          AuthType Basic
          AuthName "Restricted Content"
          AuthUserFile /path/to/your/.htpasswd
          Require valid-user
      </Files>
  </Directory>
  

  同样要保证目录的绝对路径是对的。

• 检查.htpasswd的权限
  把.htpasswd的权限设为644，确保服务器用户能读取这个文件，权限不对的话认证直接失效。

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