Docker部署Docusaurus：本地化路径大小写不敏感重定向失效求助

问题背景 #

使用Facebook Docusaurus结合Docker（基于staticfloat/nginx-certbot镜像）搭建网站，中文页面路径均以www.example.tech/zh-CN/开头。需要实现zh-CN路径的大小写不敏感，允许www.example.tech/zh-cn/...、www.example.tech/ZH-cn/...等变体路径正常访问。

尝试在443 server块中添加以下重定向规则后，浏览器提示过多重定向，规则无法正常工作：

location ~* ^/zh-(cn|CN)(/.*)?$ {
    rewrite ^/zh-(cn|CN)(/.*)?$ /zh-CN$2 last;
}

相关配置文件如下：

docker-compose.yml #

version: "3"
services:
  docusaurus:
    restart: unless-stopped
    image: staticfloat/nginx-certbot
    ports:
      - 80:80/tcp
      - 443:443/tcp
    environment:
      CERTBOT_EMAIL: softtimur@gmail.com
    volumes:
      - ./conf.d:/etc/nginx/user.conf.d:ro
      - ./build:/app
      - letsencrypt:/etc/letsencrypt

volumes:
  letsencrypt:

conf.d/server-block.conf #

gzip on;
gzip_proxied any;
gzip_disable "msie6";
gzip_vary on;
gzip_proxied any;
gzip_comp_level 6;
gzip_buffers 16 8k;
gzip_http_version 1.1;
gzip_min_length 256;
gzip_types text/plain text/css application/json application/javascript application/x-javascript text/xml application/xml application/rss+xml text/javascript application/vnd.ms-fontobject application/x-font-ttf font/opentype image/jpeg image/png image/svg+xml image/x-icon;


server {
  listen  3002;
  absolute_redirect off;
  root  /app;

  location = / {
    rewrite ^(.*)$ https://$http_host/docs/introduction redirect;
  }

  location = /docs {
    rewrite ^(.*)$ https://$http_host/docs/introduction redirect;
  }

  location = /addinHelp {
    rewrite ^(.*)$ https://$http_host/docs/introduction redirect;
  }

  location = /privacy {
    rewrite ^(.*)$ https://$http_host/privacy.html redirect;
  }

  location = /docs/helpdeskAndContact {
    rewrite ^(.*)$ https://$http_host/docs/helpdesk-contact redirect;
  }

  location / {
    try_files $uri $uri/ =404;
  }
}


upstream backend {
   server 178.62.87.72:443;
}


server {
    listen              443 ssl;
    ssl_certificate     /etc/letsencrypt/live/www.example.tech/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/www.example.tech/privkey.pem;
    server_name www.example.tech;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_prefer_server_ciphers on;
    ssl_session_timeout 1d;
    ssl_stapling on;
    ssl_stapling_verify on;
    add_header Strict-Transport-Security max-age=15768000;
    add_header X-Frame-Options "";

    proxy_ssl_name "www.backend.io";
    proxy_ssl_server_name on;
   
    location ~ /auth/(.*) {                                                                                            
          proxy_pass  https://backend/example/auth/$1?$query_string;
          proxy_set_header Host www.example.tech;
    }

    location / {
        proxy_set_header    Host                $host;
        proxy_set_header    X-Forwarded-For     $proxy_add_x_forwarded_for;
        proxy_set_header    X-Forwarded-Proto   $scheme;
        proxy_set_header    Accept-Encoding     "";
        proxy_set_header    Proxy               "";
        proxy_pass          http://docusaurus:3002/;

        # 解决socket.io错误的配置
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection "upgrade";
    }
}

解决方案 #

问题根源在于原规则使用~*（不区分大小写匹配），会将正确的/zh-CN/路径也纳入匹配范围，触发重复重定向，导致循环。

修改443 server块的配置，按以下方式调整：

1. 优先匹配正确路径：添加优先级更高的location，直接代理/zh-CN/路径，避免触发重定向规则
2. 处理大小写变体：保留不区分大小写的重定向规则，但排除已经是正确路径的请求

修改后的443 server块核心配置如下：

server {
    listen              443 ssl;
    # 保留原有ssl、server_name等配置...

    proxy_ssl_name "www.backend.io";
    proxy_ssl_server_name on;
   
    location ~ /auth/(.*) {                                                                                            
          proxy_pass  https://backend/example/auth/$1?$query_string;
          proxy_set_header Host www.example.tech;
    }

    # 1. 优先匹配正确的zh-CN路径，直接代理，不触发重定向
    location ^~ /zh-CN/ {
        proxy_set_header    Host                $host;
        proxy_set_header    X-Forwarded-For     $proxy_add_x_forwarded_for;
        proxy_set_header    X-Forwarded-Proto   $scheme;
        proxy_set_header    Accept-Encoding     "";
        proxy_set_header    Proxy               "";
        proxy_pass          http://docusaurus:3002/;

        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection "upgrade";
    }

    # 2. 处理zh-CN的大小写变体，重定向到正确路径
    location ~* ^/zh-(cn|CN)(/.*)?$ {
        # 仅当请求路径不是标准的zh-CN时才执行重定向
        if ($uri !~ ^/zh-CN/) {
            rewrite ^/zh-(cn|CN)(/.*)?$ /zh-CN$2 permanent;
        }
    }

    # 3. 保留原有的根路径代理配置
    location / {
        proxy_set_header    Host                $host;
        proxy_set_header    X-Forwarded-For     $proxy_add_x_forwarded_for;
        proxy_set_header    X-Forwarded-Proto   $scheme;
        proxy_set_header    Accept-Encoding     "";
        proxy_set_header    Proxy               "";
        proxy_pass          http://docusaurus:3002/;

        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection "upgrade";
    }
}

说明 #

• location ^~ /zh-CN/使用^~前缀，优先级高于正则匹配的location，确保正确路径直接走代理，不进入重定向逻辑
• 重定向规则中加入if ($uri !~ ^/zh-CN/)判断，避免对已经是正确路径的请求执行重定向，彻底消除循环
• 使用permanent（301永久重定向）而非last，更利于搜索引擎收录和浏览器缓存

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