Apache2 mod_rewrite自定义维护页配置问题及解决方法

问题背景 #

你尝试在Apache虚拟主机中配置mod_rewrite，当/var/www/maintenance.html存在时，给除特定IP外的用户展示自定义维护页，但遇到两个棘手问题：

• 维护页存在时，页面显示的是Apache默认的"Service Unavailable"提示，而非你准备的maintenance.html
• 调整配置后又触发了10次内部重定向循环，错误日志显示请求反复被重定向到/var/www/maintenance.html

原配置的问题分析 #

先拆解你最初的配置片段，看看问题出在哪：

RewriteEngine on
RewriteCond /var/www/maintenance.html -f
RewriteCond %{REQUEST_URI} !^/maintenance\.html$
RewriteCond %{REMOTE_ADDR} !^00\.00\.00\.000
RewriteRule ^ - [R=503]
ErrorDocument 503 /var/www/maintenance.html

1. 默认503页面问题：ErrorDocument指令需要的是Web可访问的URL路径，而非服务器本地的文件系统路径。你直接写/var/www/maintenance.html，Apache无法将这个路径映射为合法的Web请求，所以只能 fallback到系统默认的503提示。
2. 重定向循环问题：当你改成相对路径/maintenance.html时，因为这个文件不在你的DocumentRoot（/var/www/my_project.de/public）目录下，Apache找不到该文件会再次触发503错误；同时原配置里的%{REQUEST_URI} !^/maintenance\.html$条件在503重定向后不生效——重定向后的请求会带有REDIRECT_STATUS=503的环境变量，但原配置没判断这个，导致重写规则被反复触发，最终超出内部重定向限制。

正确解决方案 #

通过配置Alias将维护页所在目录映射为Web可访问路径，并调整RewriteCond避免循环，最终可用的虚拟主机配置如下：

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    ServerName my_project.de
    ServerAlias www.my_project.de
    
    # 把本地/var/www目录映射为Web可访问的/errordocs路径
    Alias /errordocs /var/www

    # 允许Apache访问这个映射的目录
    <Directory /var/www>
        Require all granted
    </Directory>

    # 用映射后的合法URL指定503错误页
    ErrorDocument 503 /errordocs/maintenance.html

    DocumentRoot /var/www/my_project.de/public

    <Directory /var/www/my_project.de/public/>
      Options Indexes FollowSymLinks MultiViews
      AllowOverride All
      Require all granted
    </Directory>

    RewriteEngine on
    RewriteCond /var/www/maintenance.html -f
    # 只对初始请求生效，避免重定向循环（重定向后REDIRECT_STATUS会有值）
    RewriteCond %{ENV:REDIRECT_STATUS} ^$
    RewriteCond %{REMOTE_ADDR} !^00\.00\.00\.000
    RewriteRule ^ - [R=503]

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

关键改进点 #

• Alias映射：通过Alias /errordocs /var/www把维护页所在的/var/www目录暴露为Web路径/errordocs，让ErrorDocument能正确定位到自定义页面
• 避免循环：添加RewriteCond %{ENV:REDIRECT_STATUS} ^$，只对未经过重定向的初始请求触发503重写，防止重定向后再次触发规则
• 权限设置：给/var/www目录添加Require all granted，确保Apache有权限读取维护页文件

现在你只需在/var/www目录下放置maintenance.html，就能自动启用维护模式；删除该文件则立即恢复正常服务。

内容的提问来源于stack exchange，提问作者schwaluck