Início / server / Perguntas / 1173211
Accepted
Reina
Asked: 2025-02-19 21:49:00 +0800 CST

O proxy reverso Nginx remove o prefixo do caminho durante o redirecionamento de barra final na implantação do Docker Compose e Hugo

  • 772

Estou encontrando um problema de reescrita de caminho ao usar o Docker Compose com proxy reverso Nginx para implantar um blog Hugo. As solicitações para IP/Hugo-Blog/X/Y/Zestão sendo redirecionadas para IP/X/Y/Zem vez de manter o /Hugo-Blog/prefixo, resultando em erros 404.
No entanto, quando tento acessar IP/Hugo-Blog/X/Y/Z/diretamente (com uma barra final), funciona corretamente.
A mesma estrutura Hugo funciona corretamente no GitHub Pages em https://ri-nai.github.io/Hugo-Blog/.

Detalhes da configuração:

  1. Infraestrutura: Tencent Cloud Server (plataforma de nuvem chinesa)
  2. Pilha: Docker Compose + proxy reverso Nginx + site estático Hugo

Arquivos de configuração:

  1. docker-compose.yaml:
version: '3'
services:
  homepage: # Homepage Site, works fine
    ...
  blog:
    build: ./Hugo-Blog
    container_name: blog
    expose:
      - "80"
    restart: always

  reverse-proxy:
    image: nginx:stable-alpine
    container_name: reverse-proxy
    volumes:
      - ./nginx-proxy/default.conf:/etc/nginx/conf.d/default.conf:ro
    ports:
      - "80:80"
    depends_on:
      - homepage
      - blog
    restart: always
  1. Hugo-Blog/Dockerfile:
FROM hugomods/hugo:exts-0.128.0 AS builder
COPY . .
RUN hugo --minify --baseURL "https://ri-nai.github.io/Hugo-Blog/"

FROM nginx:stable-alpine
COPY --from=builder /src/public /usr/share/nginx/html
  1. nginx-proxy/default.conf:
server {
    listen 80;
    server_name IP;

    location /Hugo-Blog/ {
        proxy_pass http://blog:80/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    location / {
        proxy_pass http://homepage:80/;
        # ... same headers
    }
}

Tentativa de solução de problemas:

  • A configuração confirmada do Hugo funciona corretamente nas páginas do GitHub

  • Os contêineres Docker verificados estão em execução e acessíveis internamente

Tenta e espera

  • Solicitação paraIP/Hugo-Blog/about

    1. 404 ligadoIP/Hugo-Blog/about
    2. Seguido por 404 emIP/about

  • Esperado: comportamento correspondente ao padrão de redirecionamento 301 → 200 das páginas do GitHub, mantendo /Hugo-Blog/o prefixo

nginx

1 respostas

  1. Best Answer

    Seu erro é a barra final após o proxy_passnome upstream da diretiva, que muitos usuários novatos do nginx consideram sem importância. No entanto, é importante, pois atua como uma parte URI do upstream especificado. Se você ler a proxy_passdocumentação da diretiva com cuidado, encontrará o seguinte:

    Um URI de solicitação é passado ao servidor da seguinte maneira:

    • Se a diretiva proxy_pass for especificada com um URI, quando uma solicitação for passada ao servidor, a parte de um URI de solicitação normalizado correspondente ao local será substituída por um URI especificado na diretiva: 
      location /name/ {
    proxy_pass http://127.0.0.1/remote/;
}
    • ...

    Com o seu

    location /Hugo-Blog/ {
    proxy_pass http://blog:80/;
    ...
}

    snippet de configuração, você está dizendo explicitamente ao nginx para remover o /Hugo-Blog/prefixo do URI da solicitação e substituí-lo por /.

    Da mesma forma, com o seu

    location / {
    proxy_pass http://homepage:80/;
    ...
}

    snippet de configuração, você está removendo /o URI da sua solicitação e adicionando-o novamente, o que não prejudica a solicitação com proxy, mas desperdiça alguns ciclos extras de CPU em uma operação desnecessária.

    Em vez disso, não use nenhuma parte do URI em suas definições upstream:

    location /Hugo-Blog/ {
    proxy_pass http://blog:80;
    ...
}

location / {
    proxy_pass http://homepage:80;
    ...
}

    Dessa forma, o nginx preservará o URI da solicitação como está ao encaminhá-lo aos servidores upstream, evitando quaisquer modificações não intencionais.

    • 1

relate perguntas