如何配置 Apache 用户认证 mod_auth

apache basic认证需启用auth_basic和authz_user模块，用htpasswd创建密码文件并设正确权限，再在directory块中配置authtype、authname、authuserfile和require指令，且必须启用https以防凭据泄露。

如何配置 apache 用户认证 mod_auth_basic

Apache 的 mod_auth_basic 是最常用的基础身份验证方式，配置不难，但有几个关键环节必须到位，否则会提示 500 错误或直接跳过认证。

Basic 认证依赖两个核心模块：auth_basic 和 authz_user（部分版本还需 authn_core）。在终端执行：

a2enmod auth_basic
a2enmod authz_user
systemctl restart apache2（Debian/Ubuntu）或 systemctl restart httpd（RHEL/CentOS）

验证是否加载成功：apache2ctl -M | grep -E "(auth_basic|authz_user)"，应看到两行输出。

使用 htpasswd 创建加密的用户凭据文件。首次创建需加 -c 参数（会覆盖已有文件）：

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

下载

htpasswd -c /etc/apache2/.htpasswd admin → 输入并确认密码
追加用户时去掉 -c：htpasswd /etc/apache2/.htpasswd devuser
文件路径建议用绝对路径，且确保 Apache 进程（如 www-data 或 apache 用户）有读取权限：chown root:www-data /etc/apache2/.htpasswd && chmod 640 /etc/apache2/.htpasswd

在虚拟主机配置（如 /etc/apache2/sites-available/000-default.conf）或 .htaccess 中添加认证块。推荐优先写入主配置而非 .htaccess（更安全、性能更好）：

<directory>
    AuthType Basic
    AuthName "管理员区域"
    AuthUserFile /etc/apache2/.htpasswd
    Require valid-user
</directory>

说明：

AuthName 是浏览器弹窗显示的提示文字，同一域名下相同 AuthName 值可复用凭证（避免重复输入）
Require valid-user 允许密码文件中所有用户；若只允特定用户，写成 Require user admin 或 Require user admin devuser
若用 .htaccess，对应目录需先允许重写：AllowOverride AuthConfig，且所在目录的父级 <directory></directory> 中不能设 AllowOverride None

Basic 认证本身明文传输 Base64 编码的用户名密码，绝不可裸奔 HTTP：

务必搭配 HTTPS（SSL/TLS），否则密码极易被截获
不建议用于高敏感场景（如后台管理入口），可考虑 mod_auth_digest（Digest 认证）或结合 OAuth 等方案
若访问时无弹窗、直接 401 或 500，请检查：模块是否加载、密码文件路径是否正确、Apache 是否有读取权限、配置语法是否报错（apache2ctl configtest）

如何配置 Apache 用户认证 mod_auth_basic