---
title: Ubuntu 22.04 上启用 Apache2 mod_rewrite 模块
description: 面向企业 IT 运维，说明 Ubuntu 22.04 上启用 Apache2 mod_rewrite 的适用场景、准备与风险、操作步骤、验证方法、回退建议及常见问题，涉及配置修改前先备份并建议在测试环境验证。
url: "https://www.lanever.com/docs/ubuntu-22-04-%e4%b8%8a%e5%90%af%e7%94%a8-apache2-mod_rewrite-%e6%a8%a1%e5%9d%97/"
updated: "2026-10-12"
category: Linux
---

# Ubuntu 22.04 上启用 Apache2 mod_rewrite 模块

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

## 适用场景

站点需要基于规则重写请求 URL，例如将动态路径映射为静态形式、把旧地址跳转到新地址，或在内部转发请求而不改变浏览器地址栏。Apache 的 `mod_rewrite` 提供基于正则表达式的重写引擎，可按服务器变量、环境变量、HTTP 请求头等条件组合规则。若仅需简单跳转，也可评估 `Redirect` 或 `Alias` 等更轻量方案。

## 准备与风险

- 确认已安装 Apache2，且具备 `sudo` 权限的管理员账号。
- 明确站点根目录，例如 `/var/www/[站点目录]`，以及对应虚拟主机配置文件路径。
- 修改配置前备份：`sudo cp /etc/apache2/sites-available/[站点配置].conf /etc/apache2/sites-available/[站点配置].conf.bak`。
- 建议先在测试环境验证规则，再同步到生产环境。
- 启用 `AllowOverride All` 会允许 `.htaccess` 覆盖目录配置，可能带来性能开销与安全面扩大，应仅对必要目录开启。
- 重写规则写错可能导致 500 错误或跳转循环，务必保留可回退的备份。

## 处理步骤

### 1. 启用模块

执行：

```
sudo a2enmod rewrite
```

若提示模块已启用，可跳过。随后检查模块是否在列表中：

```
apache2ctl -M | grep rewrite
```

### 2. 配置虚拟主机

编辑站点配置文件，例如：

```
sudo nano /etc/apache2/sites-available/[站点配置].conf
```

在对应 `<Directory>` 段内设置允许覆盖。示例：

```
<Directory /var/www/[站点目录]>
 Options FollowSymLinks
 AllowOverride All
 Require all granted
</Directory>
```

若不需要 `.htaccess`，可将规则直接写入虚拟主机配置，并把 `AllowOverride` 保持为 `None`，以减少运行时解析开销。

### 3. 检查语法并重载

重载前先校验配置：

```
sudo apache2ctl configtest
```

输出 `Syntax OK` 后再重载服务：

```
sudo systemctl reload apache2
```

若需完全重启：

```
sudo systemctl restart apache2
```

## 验证方法

- 确认模块已加载：`apache2ctl -M | grep rewrite`。
- 在站点目录放置测试规则，例如将 `/old-path` 重写到 `/new-path`，用浏览器或 `curl -I` 查看响应状态与 `Location` 头。
- 查看错误日志定位问题：`sudo tail -f /var/log/apache2/error.log`。
- 确认未出现 500、403 或无限重定向。

## 回退建议

1. 恢复备份配置：`sudo cp /etc/apache2/sites-available/[站点配置].conf.bak /etc/apache2/sites-available/[站点配置].conf`。
2. 如需停用模块：`sudo a2dismod rewrite`。
3. 再次执行 `sudo apache2ctl configtest`，通过后重载服务。
4. 回退后复查站点可访问性与日志。

## 常见问题

- **规则不生效**：确认 `AllowOverride` 是否允许读取 `.htaccess`，或规则是否放在正确目录段内。
- **出现 500 错误**：多为规则语法或正则错误，检查错误日志中的具体提示。
- **跳转循环**：检查规则条件是否缺少终止判断，避免重复匹配同一请求。
- **性能下降**：大量 `.htaccess` 解析会增加开销，建议将规则集中到虚拟主机配置。
- **版本差异**：不同 Apache 版本对指令与模块行为可能存在差异，具体支持范围请查阅对应版本文档。

> 生产环境变更前请完成备份，并优先在测试环境验证规则与回退流程。
