Резервный backend и обработка ошибок upstream

Задача и общий подход

Материал посвящён теме «Резервный backend и обработка ошибок upstream» с акцентом на сопровождению, обновлению и откату.

Reverse proxy отделяет публичный вход от внутреннего приложения. Backend может слушать только localhost, а Nginx отвечает за TLS, заголовки, ограничения доступа и обработку ошибок.

Практический порядок одинаков для любой рабочей системы: зафиксировать исходное состояние, создать резервную точку, изменить один компонент, проверить результат и только затем переходить дальше.

Когда применять этот порядок

Этот сценарий подходит для следующих ситуаций:

• плановое внедрение или перенос компонента категории «Reverse proxy» на новый VPS
• изменение портов, домена, сертификата, маршрута или способа публикации сервиса
• разбор инцидента, когда локальная и внешняя проверки дают разные результаты
• подготовка к обновлению пакета или восстановлению после неудачного изменения

Что должно получиться

После выполнения руководства по теме «Резервный backend и обработка ошибок upstream» результат должен быть измеримым:

• сохранить резервную точку и понятный сценарий отката
• оставить наружу только необходимые интерфейсы и порты
• зафиксировать логи и признаки успешного запуска
• получить воспроизводимую конфигурацию, проверяемую командами

Резервная точка

Сохраните именно те файлы и параметры, которые собираетесь менять.

TS=$(date +%F-%H%M%S)
mkdir -p /root/iiadmin-change-$TS
cp -a /path/to/config /root/iiadmin-change-$TS/
systemctl status SERVICE --no-pager > /root/iiadmin-change-$TS/status-before.txt
ss -lntup > /root/iiadmin-change-$TS/listeners-before.txt

Рядом с копией запишите точную команду восстановления. Это особенно важно, если откат будет выполнять другой администратор.

Подготовка перед изменениями

Подготовительный этап снижает риск потерять доступ и смешать несколько причин одной неисправности.

• Проверьте свободное место, DNS и системное время.
• Сохраните копии изменяемых файлов с датой и временем.
• Используйте встроенную проверку синтаксиса конфигурации.
• Откройте вторую административную сессию и не закрывайте текущую.
• Зафиксируйте текущие порты, процессы и состояние службы.

Пошаговая настройка

Выполняйте блоки последовательно и после каждого шага проверяйте код возврата команды.

ss -lntp | grep ':8080'
curl -v http://127.0.0.1:8080/

proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

sudo nginx -t && sudo systemctl reload nginx
curl -vk https://example.org/app/

location /app/ {
    proxy_pass http://127.0.0.1:8080;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

proxy_connect_timeout 5s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;

Имена доменов, адреса, порты и пути в примерах условные. Перед выполнением замените их фактическими значениями.

Проверка результата

Проверка должна охватывать конфигурацию, процесс, listener и реальный запрос.

• backend отвечает локально
• Nginx видит upstream
• URI после proxy_pass корректен
• клиентский IP передаётся
• длинные ответы не обрываются

systemctl is-active SERVICE
systemctl status SERVICE --no-pager
journalctl -u SERVICE -n 80 --no-pager
ss -lntup

Типичные ошибки

Чаще всего восстановление усложняют следующие действия:

• перезапуск службы до проверки синтаксиса
• изменение нескольких компонентов одной командой без промежуточных тестов
• использование устаревшей команды без проверки версии пакета
• открытие административного порта для всего интернета
• проверка только локального подключения без внешнего теста
• удаление рабочей конфигурации до успешного запуска новой

Безопасность

После получения рабочего результата уменьшите количество исключений и временных разрешений.

• используйте принцип минимально необходимых прав
• не храните секреты в публикуемых конфигурациях и журналах
• закрывайте временные порты после завершения теста
• выдавайте файлам конфигурации минимальные права
• ограничивайте административный доступ доверенными IP или VPN

Диагностика, если не заработало

Диагностика строится как последовательное исключение уровней, а не случайный набор перезапусков.

1. Подтвердите симптом точной командой и запишите время.
2. Проверьте конфигурацию штатным тестом.
3. Проверьте процесс и последние записи журнала.
4. Убедитесь, что нужный адрес и порт слушаются.
5. Сравните локальный запрос с запросом извне.
6. Только затем проверяйте firewall, DNS и маршрут.
7. Меняйте одну переменную и повторяйте тот же тест.

Для темы «Резервный backend и обработка ошибок upstream» важно не путать открытый firewall с запущенным сервисом: правило доступа не создаёт listener, а активный процесс не гарантирует доступность извне.

Дальнейшее сопровождение

Рабочая конфигурация со временем устаревает и требует контроля.

• храните резервную копию вне VPS
• документируйте нестандартные пути и зависимости
• периодически выполняйте тестовое восстановление
• после обновления повторяйте тест конфигурации и портов
• контролируйте таймеры, сертификаты и автоматические задания

Откат изменений

Откат выполняется в обратном порядке и с теми же проверками, что использовались после настройки.

1. отключить новый location
2. вернуть server-блок
3. проверить nginx -t
4. перезагрузить и проверить основной сайт

Не удаляйте неудачную конфигурацию до выяснения причины: она полезна для diff и разбора инцидента.

Контрольный список

Перед тем как считать тему «Резервный backend и обработка ошибок upstream» закрытой, пройдите список:

Что дополнительно сверить в документации

При подготовке материала были сопоставлены разделы русскоязычной документации. Для углублённой проверки полезно изучить:

• Модуль ngx_http_proxy_module
• Резервное копирование системы
• Содержание
• Создание архива
• Восстановление из архива
• dd - копирование раздела
• Создание образа
• Восстановление раздела из образа

Данные, которые нужно сохранить до изменения

Перед работой по теме «Резервный backend и обработка ошибок upstream» сохраните состояние именно тех компонентов, которые участвуют в схеме: активную конфигурацию, статус процесса, открытые порты, последние ошибки и результат контрольного запроса. Этот набор позволит отличить последствия новой правки от ранее существовавшего поведения.

Полезно хранить вывод в одном каталоге с временной меткой и коротким README. При разборе инцидента это быстрее, чем повторно собирать сведения после нескольких перезапусков.

location /app/ {
    proxy_pass http://127.0.0.1:8080;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Финальная проверка с точки зрения реального клиента

Последнюю проверку темы «Резервный backend и обработка ошибок upstream» выполняйте тем же способом, которым сервисом будет пользоваться человек или приложение: с нужным доменом, протоколом, учётной записью и внешней сетью. Локальная команда остаётся диагностическим этапом, но не заменяет прохождение всей цепочки.

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

proxy_connect_timeout 5s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;

Контрольные точки именно для этой темы

Для темы «Резервный backend и обработка ошибок upstream» заранее запишите исходные значения и ожидаемый результат. Это позволяет повторить один и тот же тест до изменения, после применения и после возможного отката.

Не считайте задачу завершённой по одному зелёному статусу. Проверка должна охватывать конфигурацию, процесс, сетевой уровень, журнал и прикладной ответ.

• backend отвечает локально
• Nginx видит upstream
• URI после proxy_pass корректен
• клиентский IP передаётся
• длинные ответы не обрываются

ss -lntp | grep ':8080'
curl -v http://127.0.0.1:8080/

Отделение backend от публичного прокси

Reverse proxy состоит из двух независимых соединений: клиент подключается к Nginx, а Nginx — к backend. Поэтому сначала проверяйте приложение напрямую на локальном адресе, и лишь затем публичный URL.

Если прямой запрос не проходит, правка proxy_set_header или TLS не поможет. Проверьте процесс, listener, локальный firewall, Unix-сокет и журнал приложения.

ss -lntp | grep ':8080'
curl -v --max-time 10 http://127.0.0.1:8080/
journalctl -u BACKEND_SERVICE -n 80 --no-pager

Источники и документация

Источники использованы для выбора терминов, контрольных вопросов и команд. Полные абзацы чужих публикаций не копируются.

• Модуль ngx_http_proxy_module
• Резервное копирование системы | Русскоязычная документация по Ubuntu
• etckeeper | Русскоязычная документация по Ubuntu
• Как развернуть свой веб-сайт на Next.js и Django в облаке