apache文本密码认证核心是mod_authn_file模块与htpasswd工具，不依赖数据库或外部服务，配置轻、故障面小、日志清晰，适用于保护后台目录、测试页或内部工具入口；ubuntu 18.04/20.04默认启用相关模块，密码文件须存于web根目录外并设640权限，推荐在站点配置中用directory块而非.htaccess实现高效可控认证。
apache 用文本文件做密码认证，核心就是 mod_authn_file 模块 + htpasswd 工具，不依赖数据库、不调用外部服务，配置轻、故障面小、日志清晰，特别适合保护后台目录、测试页面或内部工具入口。
确认模块已启用
Ubuntu 系统（18.04/20.04）默认已加载 mod_authn_file、mod_auth_basic 和 mod_authz_core，无需手动 a2enmod。验证方式：
- 运行 apache2ctl -M | grep auth，应看到 authn_file、auth_basic、authz_core 等字样
- 若缺失，执行 sudo a2enmod authn_file auth_basic authz_core 后重启 Apache
生成安全的密码文件
密码文件必须存放在 Web 根目录之外（如 /etc/apache2/.htpasswd 或 /var/www/.htpasswd），绝不能放在 /var/www/html/ 下可被下载的位置。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 首次创建： sudo htpasswd -cB /etc/apache2/.htpasswd admin
（-c 表示新建文件，-B 强制使用 bcrypt 加密，Ubuntu 20.04+ 推荐） - 追加用户（不覆盖原文件）： sudo htpasswd -B /etc/apache2/.htpasswd devuser
- 查看文件内容（仅哈希，无明文）： sudo cat /etc/apache2/.htpasswd，应类似 admin:$2y$10$...
配置受保护目录
推荐在站点配置文件中（如 /etc/apache2/sites-available/000-default.conf）内嵌
- 示例配置段（保护 /var/www/html/admin 目录）：
AuthType Basic
AuthName "Admin Area"
AuthBasicProvider file
AuthUserFile /etc/apache2/.htpasswd
Require valid-user
- AuthName 是弹窗里显示的提示文字，必须带英文双引号
- Require valid-user 允许任意合法用户；若只准某人进，改写为 Require user admin
- 配置完别忘了 sudo systemctl reload apache2
常见问题排查要点
认证失败时，优先检查这三项：
- 密码文件路径是否为绝对路径，且 Apache 进程有读取权限（sudo chown root:www-data /etc/apache2/.htpasswd && sudo chmod 640 /etc/apache2/.htpasswd）
- Directory 路径是否与实际 URL 访问路径严格一致（注意末尾斜杠、大小写）
- 错误日志位置：/var/log/apache2/error.log，搜索 authentication failure 或 AH01617 错误码
