Linux Apache虚拟主机中使用RewriteMap的核心是将域名或路径映射关系外置到文件管理，修改即生效无需重启，但需环境支持mod_so和mod_rewrite、配置在VirtualHost内且位于RewriteEngine On之前、映射逻辑清晰；txt:适合几千域名实时编辑，dbm:适合5000+域名高性能查询。
Linux Apache 虚拟主机中使用 RewriteMap，核心是把域名或路径的映射关系从硬编码规则里抽出来，放到外部文件中管理，改完即生效、无需重启服务。但前提是环境支持、配置位置正确、映射逻辑清晰。
确认 Apache 支持 RewriteMap
不是所有 Apache 都能用 RewriteMap。它依赖两个关键模块：mod_so（用于动态加载）和 mod_rewrite（重写基础）。缺一不可。
- 运行 apache2ctl -M | grep -E "(so|rewrite)"，输出中必须同时出现 so_module (shared) 和 rewrite_module (shared)
- 若用 phpEnv、XAMPP 精简版或某些容器镜像，大概率不满足条件——这类环境通常没编译 mod_so，RewriteMap 指令会直接报错 Invalid command 'RewriteMap'
- 不建议强行修改配置顺序或路径绕过限制。稳妥做法是换用标准发行版 Apache（如 Ubuntu 官方 apache2 包、CentOS 的 httpd）或改用 Nginx 的 map 指令
在 VirtualHost 中正确定义和调用
RewriteMap 必须在
- 定义示例：RewriteMap domainmap "txt:/etc/apache2/domain-map.txt" —— 表示用纯文本文件做映射源
- 映射文件每行格式为：源域名 目标URL（空格分隔），支持以 # 开头的注释行
- 调用时用 ${domainmap:%{HTTP_HOST}|NOT_FOUND} 获取匹配结果，注意 %{HTTP_HOST} 不含协议和端口，只取请求头里的原始域名
- 典型跳转规则：
RewriteCond ${domainmap:%{HTTP_HOST}|NOT_FOUND} !=NOT_FOUND
RewriteRule ^(.*) ${domainmap:%{HTTP_HOST}} [R=301,L]
选择合适的映射源类型
txt: 和 dbm: 是最常用的两类，适用场景不同：
- txt: 文件可直接编辑，实时生效，适合几千个域名以内。维护简单，但每次请求都读文件，量大时有性能损耗
- dbm: 把 txt 映射文件编译成哈希数据库（用 httxt2dbm 工具生成），查询接近 O(1)，适合 5000+ 域名。更新时只需重新生成 .dbm 文件，Apache 不需重启
- dbm 生成命令示例：httxt2dbm -i /etc/apache2/domain-map.txt -o /etc/apache2/domain-map.dbm
- 配置中改为：RewriteMap domainmap "dbm:/etc/apache2/domain-map.dbm"
避免常见配置陷阱
很多问题不是功能不行，而是细节没对上：
- RewriteMap 必须定义在
内，不能只写在主配置里；每个站点都要单独定义，不自动继承 - 确保 Options +FollowSymLinks 和 AllowOverride None（或 All）已在对应
块中设置，否则可能报 500 错误 - RewriteCond 只对紧随其后的那一条 RewriteRule 生效，不能跨行复用；多条件要用多个 RewriteCond 串联
- 若映射目标是内部路径（如 /blog），去掉 [R] 标志；若是跳转到外部 URL，必须加 [R=301,L] 或 [R=302,L]
