Nginx – Перехват только 404 от бэкенда и отображение пользовательской страницы ошибки

Вопрос или проблема

server {
    listen 443 ssl http2;
    server_name mydomain.com;

    # Конфигурация обратного прокси
    location / {
        # Позволяю Nginx обрабатывать основное блокирование
        if ($block_access) {
            return 403;
        }

        # Проксирование запроса к бэкэнду
        proxy_pass http://localhost:8080/;
        proxy_buffering off;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Connection $http_connection;

        # Перехватывать только ошибки 404 с бэкэнда
        proxy_intercept_errors on;
        error_page 404 /errors/404.html;

        # Обслуживать пользовательскую страницу ошибки 404
        location = /errors/404.html {
            root /var/www/html;
            internal;
        }
    }

    # Обслуживать пользовательскую страницу ошибки 403 для заблокированного доступа ($block_access = true)
    error_page 403 /errors/403.html;
    location = /errors/403.html {
        root /var/www/html;
        internal;
    }

    location /errors/ {
        root /var/www/html;
        try_files $uri $uri/ =404;
    }
}

    location / {
        proxy_pass http://localhost:8080/;
        proxy_intercept_errors on;
        ...

        error_page 403 /errors/403.html;
        error_page 404 /errors/404.html;
    }

Ответ или решение

Конфигурация сервера Nginx, описанная в вашем случае, нуждается в доработке для корректного отображения пользовательских страниц ошибок, особенно 403 и 404. Важно понимать, как Nginx обрабатывает ответы от бэкенда и какие настройки необходимы для переопределения стандартных страниц ошибок.

Теория: Интерцепция и обработка ошибок в Nginx

Nginx, выступая в роли реверс-прокси сервера, предоставляет механизмы для обработки и перенаправления ошибок. Директивы error_page и proxy_intercept_errors играют ключевую роль в этой обработке.

1. proxy_intercept_errors:
Эта директива сообщает Nginx о необходимости перехвата ошибок, возвращаемых бэкендом. Это позволяет серверу отображать заданные страницы ошибок вместо стандартных страниц от бэкенда. Однако, при использовании этой директивы, перехват происходит для всех ошибок, если не указаны конкретные страницы ошибок через error_page.

2. error_page:
Данная директива определяет пути к пользовательским страницам ошибок. При конфигурации error_page важно учитывать, что эти директивы наследуются только в отсутствие аналогичных указаний на уровне текущей конфигурации.

Пример: Проблемы в текущей конфигурации

Ваш текущий конфигурационный блок выглядит следующим образом:

location / {
    if ($block_access) {
        return 403;
    }
    proxy_pass http://localhost:8080/;
    proxy_buffering off;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Connection $http_connection;
    proxy_intercept_errors on;
    error_page 404 /errors/404.html;

    location = /errors/404.html {
        root /var/www/html;
        internal;
    }
}

error_page 403 /errors/403.html;
location = /errors/403.html {
    root /var/www/html;
    internal;
}

location /errors/ {
    root /var/www/html;
    try_files $uri $uri/ =404;
}

Проблемы заключаются в следующем:

• Nginx перехватывает ошибку 404, как ожидалось, благодаря директиве proxy_intercept_errors и наличию error_page 404.
• Однако, ошибка 403 генерируется непосредственно в рамках Nginx (не от бэкенда), и error_page 403 должен быть явно определен внутри директивы location /.

Применение: Решение проблемы

Чтобы решить проблему с пользовательской страницей ошибки 403, необходимо добавить директиву error_page 403 внутри блока location /. Тем самым, Nginx сможет обрабатывать 403 ошибки, генерируемые им локально, корректно перенаправляя на пользовательскую страницу.

Вот пересмотренный фрагмент вашей конфигурации:

location / {
    if ($block_access) {
        return 403;
    }
    proxy_pass http://localhost:8080/;
    proxy_buffering off;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Connection $http_connection;
    proxy_intercept_errors on;

    # Обработка 403 ошибки
    error_page 403 /errors/403.html;
    # Обработка 404 ошибки
    error_page 404 /errors/404.html;

    location = /errors/404.html {
        root /var/www/html;
        internal;
    }
}

error_page 403 /errors/403.html;
location = /errors/403.html {
    root /var/www/html;
    internal;
}

location /errors/ {
    root /var/www/html;
    try_files $uri $uri/ =404;
}

Дополнительные рекомендации

• Убедитесь, что файлы /errors/403.html и /errors/404.html существуют и имеют правильные права доступа.
• Проверьте логи Nginx для поиска дополнительных сообщений об ошибках, которые могут возникать при загрузке пользовательских страниц.
• Убедитесь, что нет других конфликтующих конфигураций, которые могут переопределять обработку ошибок в других местах конфигурации.

Эти изменения помогут правильно настроить отображение пользовательских страниц ошибок для обеих ситуаций — как для ошибок 403, так и для 404, генерируемых в Nginx и бэкендом соответственно.