替换静态站点为Wagtail：如何将/index.html重定向至对应页面？

Hey there! Let's sort out this redirect issue for your Wagtail migration. Since your old static site had both regular URLs and /index.html entry points for every page, we need to handle two key cases: redirecting any /path/index.html request to the clean /path/ URL, and making sure direct hits to /index.html (root or subpaths) land on the corresponding Wagtail page. Here are two reliable approaches depending on your setup:

This keeps the redirect logic inside your application, which is great if you want portability across different servers.

• Add catch-all URL patterns
  In your project's urls.py, insert these patterns before your Wagtail URL include. They'll intercept any requests ending with /index.html and redirect them properly:

  from django.shortcuts import redirect
  from django.urls import re_path
  from wagtail import urls as wagtail_urls
  
  urlpatterns = [
      # Handle subpaths like /about/index.html → /about/
      re_path(r'^(.*)/index.html$', lambda request, path: redirect(f'/{path}/', permanent=True)),
      # Handle root /index.html → /
      re_path(r'^index.html$', lambda request: redirect('/', permanent=True)),
      # Your existing Wagtail routes
      path('', include(wagtail_urls)),
  ]
  

  • The permanent=True flag sends a 301 redirect, which is SEO-friendly—it tells search engines the page has moved for good.
  • Wagtail serves pages at their clean URLs by default, so you don't need extra config there—just make sure you haven't accidentally set page slugs to include index.html.

If you have access to your web server config, this is the most efficient option—redirects happen before the request even reaches your Wagtail app, saving resources.

For Nginx #

Add these rules to your server block before the location block that proxies to Wagtail:

# Redirect root /index.html to homepage
rewrite ^/index.html$ / permanent;

# Redirect any /path/index.html to /path/
rewrite ^(.*)/index.html$ $1/ permanent;

Don't forget to reload Nginx afterward: sudo systemctl reload nginx

For Apache #

Add these lines to your .htaccess file (or virtual host config):

# Redirect root /index.html to homepage
Redirect permanent /index.html /

# Redirect subpath /index.html URLs
RewriteEngine On
RewriteRule ^(.*)/index.html$ $1/ [R=301,L]

Ensure mod_rewrite is enabled on your Apache server if using this method.

Quick Tips to Verify & Reinforce #

• Test redirects: Use curl to check status codes, like:

  curl -I https://yourdomain.com/team/index.html
  

  You should see a 301 Moved Permanently response pointing to https://yourdomain.com/team/.
• Add canonical tags: To boost SEO, include a canonical link in your Wagtail base template pointing to the clean URL. Wagtail's page.full_url gives you this by default, so add:

  <link rel="canonical" href="{{ page.full_url }}">
  

  This helps search engines recognize the preferred URL for each page.

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