Apache伪静态重写模块`mod_rewrite`怎么启用与基础规则测试

梦静姑娘_4472

梦静姑娘_4472

2026-10-14

647人浏览

原创

mod_rewrite 默认未启用,需手动开启模块、配置 allowoverride all 并设置 rewriteengine on 才能生效;ubuntu 用 a2enmod rewrite,rhel 系统需编辑 httpd.conf 加载模块。

apache 的 mod_rewrite 模块默认通常不启用,需手动开启并配置才能使用 url 重写功能。启用后还需确保站点支持 `.htaccess` 或主配置中正确加载规则,否则规则不会生效。

确认并启用 mod_rewrite 模块

在 Linux 系统(如 Ubuntu/Debian 或 CentOS/RHEL)中操作:

  • Ubuntu/Debian:运行 sudo a2enmod rewrite,然后重启 Apache:sudo systemctl restart apache2
  • CentOS/RHEL(含 Rocky/AlmaLinux):编辑 /etc/httpd/conf/httpd.conf,取消注释或添加一行:LoadModule rewrite_module modules/mod_rewrite.so,再执行 sudo systemctl restart httpd
  • 验证是否启用成功:运行 apache2ctl -M | grep rewrite(Debian系)或 httpd -M | grep rewrite(RHEL系),输出含 rewrite_module (shared) 即表示已加载

允许 .htaccess 中使用 RewriteRule

仅启用模块还不够,Apache 默认禁止目录级重写。需在虚拟主机配置或主配置中设置权限:

  • 找到对应站点的 <directory></directory> 块(例如 /var/www/html),确保包含以下配置:
<directory>
    AllowOverride All
    Require all granted
</directory>

⚠️ 注意:AllowOverride None 会完全忽略 .htaccess 文件;设为 All 才允许 RewriteEngine、RewriteRule 等指令生效。

Apache Superset Dashboard and SQL Exploration Skill
Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。

下载

写一个基础规则测试是否工作

在网站根目录创建 .htaccess 文件,内容如下:

RewriteEngine On
RewriteRule ^test$ index.html [L]

说明:

  • RewriteEngine On 是必需的开关,没有它所有规则都不执行
  • ^test$ 匹配精确访问路径 /test(不带斜杠)
  • index.html 是目标文件,Apache 内部重写(URL 不变,但返回 index.html 内容)
  • [L] 表示“最后一条规则”,匹配后不再执行后续规则

保存后访问 http://your-domain/test,若看到首页内容(而非 404),说明 mod_rewrite 已正常工作。

常见失败原因快速排查

  • Apache 配置未重载:改完 httpd.conf 或 apache2.conf 后忘记 systemctl restart
  • .htaccess 放错位置:必须放在被请求的 URL 对应的物理目录下,且该目录在 <directory></directory> 中设置了 AllowOverride All
  • 规则语法错误:比如漏写 RewriteEngine On,或正则表达式写成 test/ 却访问 /test
  • SELinux(RHEL系)限制:若启用了 SELinux,可能阻止读取 .htaccess,可临时用 setsebool -P httpd_read_user_content 1 授权

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

apache ubuntu

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

437

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

920

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

2872

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

956

5

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.17

869

5

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

2023.10.17

434

3

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

2616

4

服务器负载不兼容怎么解决
服务器负载不兼容怎么解决

解决方法:1、增加服务器资源;2、负载均衡;3、优化应用程序;4、增加缓存机制;5、分布式架构;6、限流和熔断;7、自动化扩容。想知道更详细服务器负载不兼容的解决方法,可以访问本专题下面的文章。

2023.10.20

4872

4

宽带如何接入服务器
宽带如何接入服务器

宽带接入服务器的方法有ADSL宽带接入服务器、光纤接入服务器、无线接入服务器和以太网接入服务器等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.20

767

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Apache Maven 官方安装指南
Apache Maven 官方安装指南

共0课时 | 0人学习

Apache Maven 官方用户中心
Apache Maven 官方用户中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习