---
title: Apache mod_rewrite URL 重写运维指南
description: 面向企业 IT 运维，介绍 Apache mod_rewrite 的启用、.htaccess 配置、URL 重写规则编写、验证与回退方法，并给出备份、测试环境与安全注意事项。
url: "https://www.lanever.com/docs/apache-mod_rewrite-url-%e9%87%8d%e5%86%99%e8%bf%90%e7%bb%b4%e6%8c%87%e5%8d%97/"
updated: "2026-10-12"
category: Linux
---

# Apache mod_rewrite URL 重写运维指南

> **参考来源与致谢**
>
>
>
> - **引用来源：**[How To Rewrite URLs with mod_rewrite for Apache on Ubuntu 16.04 | DigitalOcean](https://www.digitalocean.com/community/tutorials/how-to-rewrite-urls-with-mod_rewrite-for-apache-on-ubuntu-16-04)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

需要在 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 版本对指令与默认路径可能不同，请查阅对应版本官方文档确认。
