Docker容器中.htaccess与.htpasswd密码不匹配问题

核心问题：你的.htpasswd文件中存储的是明文密码test，但Apache的mod_auth_basic模块要求密码必须是加密后的哈希值，明文无法通过验证。

修复步骤： #

1. 生成加密后的密码行
   进入运行中的容器执行htpasswd命令生成符合要求的密码：

   docker exec -it [你的容器名称或ID] htpasswd -n finn
   

   执行后输入密码test，会输出类似如下格式的内容：

   finn:$apr1$abc123$xyz789...
   

   将这一行完整替换掉你本地admin/.htpasswd文件中的原有内容。

2. 重新构建并运行容器
   因为修改了.htpasswd文件，需要重新构建镜像让新文件同步到容器内：

   docker build -t your-site-image .
   docker run -d -p 80:80 your-site-image
   

额外检查项： #

• 确认.htaccess中的AuthUserFile路径正确：/var/www/html/admin/.htpasswd，从你的Dockerfile和配置来看路径是正确的，权限也已设置为644，无需调整。
• 确保Apache的mod_auth_basic和mod_authn_file模块已启用，php:7.4-apache镜像默认已包含这些模块，若不确定可在容器内执行a2enmod auth_basic authn_file并重启Apache。

为什么Windows本地运行正常？ #

Windows环境下的Apache可能被配置为允许明文密码（这是不安全的配置），或者你在本地使用的原本就是加密后的密码，迁移时误替换成了明文。

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