参考来源与致谢
- 引用来源:How To Rewrite URLs with mod_rewrite for Apache on Ubuntu 16.04 | DigitalOcean
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
需要在 Apache 上把可读性较好的路径映射到实际脚本或静态文件,或按条件做跳转时,可使用 mod_rewrite。常见用途包括:把 /about 映射到 about.html,把查询参数形式转换为路径形式,以及按主机名、协议或来源做条件跳转。本文以 Ubuntu 16.04 上的 Apache 2 为例,其他版本请查阅对应版本文档确认指令与默认路径。
准备与风险 #
- 准备一台测试服务器或测试虚拟主机,先在测试环境验证规则,再同步到生产。
- 修改前备份 Apache 配置目录与站点根目录,例如对
/etc/apache2和站点目录做归档备份。 - 确认已安装 Apache 2,并具备
sudo权限。 - 重写规则写错可能导致 500 错误、循环重定向或页面无法访问。生产变更前应安排回退窗口。
- 不要把密码、令牌、密钥等敏感信息写入
.htaccess或站点配置。
处理步骤 #
1. 启用模块 #
干净安装的 Apache 2 通常未启用该模块。执行:
sudo a2enmod rewrite
sudo systemctl restart apache2
若提示模块已启用,可跳过启用步骤,但仍需重启使配置生效。
2. 允许 .htaccess 覆盖 #
默认情况下 Apache 不允许 .htaccess 应用重写规则。编辑站点配置文件,例如 /etc/apache2/sites-available/000-default.conf,在 <VirtualHost *:80> 块内为站点目录增加允许覆盖的设置:
<Directory /var/www/html>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Require all granted
</Directory>
保存后重启 Apache:
sudo systemctl restart apache2
官方文档更推荐把规则直接写入服务器配置文件,因为 Apache 处理
.htaccess会带来额外开销。若同一服务器上有多个站点,使用.htaccess便于维护,且修改后无需重启、无需 root 权限。两种方式按运维规范选择。
3. 创建 .htaccess 并开启重写引擎 #
在站点根目录创建 .htaccess,首行写入:
RewriteEngine on
该文件以点开头,默认隐藏。注意其权限与属主,避免被未授权账号修改。
4. 编写重写规则 #
通用结构如下:
RewriteRule pattern substitution [flags]
pattern:匹配 URL 的正则表达式。substitution:实际目标路径或地址。flags:可选标志,用于控制大小写、终止处理、重定向状态码等。
示例:把 /about 映射到 about.html:
RewriteRule ^about$ about.html [L]
示例:按条件跳转,例如仅对特定主机名生效:
RewriteCond %{HTTP_HOST} ^[站点域名]$ [NC]
RewriteRule ^old-path$ /new-path [R=301,L]
示例:把查询参数形式转换为路径形式:
RewriteCond %{QUERY_STRING} ^id=([0-9]+)$
RewriteRule ^article$ /article/%1? [L]
规则按出现顺序处理,标志 [L] 表示停止后续规则,[R=301] 表示永久重定向。使用 301 前务必确认目标地址长期有效,否则客户端会缓存跳转。
验证方法 #
- 重启或重载 Apache 后,用浏览器或命令行请求测试路径,确认返回预期内容与状态码。
- 检查响应头中的状态码与
Location字段,确认跳转符合预期。 - 查看 Apache 错误日志与访问日志,例如
/var/log/apache2/error.log与access.log,定位规则未生效或循环重定向问题。 - 在测试环境覆盖正常路径、带参数路径、不存在路径三类用例。
回退建议 #
- 保留变更前的配置与
.htaccess备份,出现异常时直接还原并重启 Apache。 - 若规则导致站点不可用,可先注释或删除新增规则,再逐步排查。
- 生产环境变更建议分批进行,先在小流量或测试虚拟主机验证。
常见问题 #
- 规则不生效:确认模块已启用、
AllowOverride已允许、RewriteEngine on已写入,并已重启或重载 Apache。 - 出现 500 错误:多为正则或标志写法有误,检查语法并查看错误日志。
- 循环重定向:检查规则是否反复匹配自身,必要时增加条件限制。
- 性能考虑:规则较多时优先写入服务器配置文件,减少
.htaccess解析开销。 - 版本差异:不同 Apache 版本对指令与默认路径可能不同,请查阅对应版本官方文档确认。
