Apache2网站身份认证不通过问题求助

问题背景 #

在配置了SSL证书的Apache2服务器（含已注册子域名）上设置用户登录验证，执行以下命令创建密码文件：

sudo htpasswd -c /etc/apache2/.htpasswd

文件已生成哈希格式的密码，但用户访问时输入的账号始终无法通过验证。已尝试清除缓存、使用隐私浏览器、修改apache.conf中的FilesMatch配置，问题依旧。

服务器关键配置 #

/etc/apache2/sites-available/my-site.conf

<IfModule mod_ssl.c>
<VirtualHost *:443>
    ServerName my-site.com
    ServerAlias subdomain.my-site.com
    DocumentRoot /var/www/my-site/public_html

    <Directory /var/www/my-site/public_html>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    <Location "/">
        AuthType Digest
        AuthName "Restricted Area"
        AuthDigestDomain /
        AuthDigestProvider file
        AuthUserFile /etc/apache2/.htpasswd
        Require valid-user
    </Location>

SSLCertificateFile /etc/letsencrypt/live/subdomain.my-site.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/subdomain.my-site.com/privkey.pem
Include /etc/letsencrypt/options-ssl-apache.conf
</VirtualHost>
</IfModule>

/etc/apache2/apache.conf（核心片段）

<Directory /var/www/>
        Options Indexes FollowSymLinks
        AllowOverride None
        Require all granted
</Directory>

AccessFileName .htaccess
#<FilesMatch "^.ht">
#        Require all denied
#</FilesMatch>

注：/etc/apache/httpd.conf为空，无.htaccess文件。

解决步骤 #

1. 修复认证类型与密码文件的不匹配 #

配置中使用了AuthType Digest（摘要认证），但htpasswd命令仅用于生成**Basic（基础认证）**的密码文件，二者完全不兼容，这是验证失败的核心原因。

方案A：切换为Basic认证（最简便）

修改my-site.conf中的<Location>段，将认证类型改为Basic：

<Location "/">
    AuthType Basic
    AuthName "Restricted Area"
    AuthUserFile /etc/apache2/.htpasswd
    Require valid-user
</Location>

方案B：保留Digest认证（需重新生成密码文件）

若坚持使用摘要认证，需用htdigest命令重新创建适配的密码文件（注意AuthName必须与配置中的完全一致）：

sudo htdigest -c /etc/apache2/.htdigest "Restricted Area" 用户名

再修改配置中的对应参数：

<Location "/">
    AuthType Digest
    AuthName "Restricted Area"
    # 明确指定所有需要验证的域名，避免子域名适配问题
    AuthDigestDomain https://my-site.com/ https://subdomain.my-site.com/
    AuthDigestProvider file
    # 替换为新生成的Digest格式密码文件
    AuthUserFile /etc/apache2/.htdigest
    Require valid-user
</Location>

2. 确保Apache能读取密码文件 #

设置正确的文件权限，让Apache进程（默认用户为www-data）拥有读取权限：

sudo chown root:www-data /etc/apache2/.htpasswd
sudo chmod 640 /etc/apache2/.htpasswd

3. 验证配置并重启服务 #

先检查配置语法是否合法：

sudo apache2ctl configtest

若输出Syntax OK，重启Apache生效：

sudo systemctl restart apache2

4. 排查权限规则冲突 #

当前Directory段设置了Require all granted，而Location要求valid-user，Apache会优先执行更严格的规则，但如果仍有问题，可将认证规则移至Directory段内替代Location：

<Directory /var/www/my-site/public_html>
    Options Indexes FollowSymLinks
    AllowOverride All
    AuthType Basic
    AuthName "Restricted Area"
    AuthUserFile /etc/apache2/.htpasswd
    Require valid-user
</Directory>

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