До сих пор nginx отдавал файлы с диска. Теперь за ним встанет приложение — две его копии, как это и бывает в работе. Писать приложение не будем: возьмём готовый маленький веб-сервер, встроенный в Python, он уже встречался в разделе про сети.
Продолжаем на сайте stand.provision.internal из прошлой практики. Работай в tmux из раздела про Linux: копии приложения будут жить в фоне этого окна, и при обрыве SSH без tmux они умрут вместе с ним. Понадобятся три вещи, которые узнают обычно только на проде: что приложение видит через прокси, как выглядит отказ одной копии и что получает пользователь, когда упали все.
Шаг 1. Каталоги для двух копий
Каждая копия будет отдавать свою страницу, чтобы было видно, кто ответил. Флаг -p у mkdir создаёт недостающие каталоги по пути.
mkdir -p ~/devops-lab/app-a ~/devops-lab/app-bШаг 2. Страница каждой копии
Знак > записывает вывод echo в файл, это разбирали в разделе про Linux.
echo "app A" > ~/devops-lab/app-a/index.html echo "app B" > ~/devops-lab/app-b/index.html
Шаг 3. Запустить копии
Встроенный сервер Python отдаёт файлы из текущего каталога. Перейдём в каталог первой копии.
cd ~/devops-lab/app-aЗапускаем на порту 8000. Флаг -b задаёт адрес: 127.0.0.1 значит «только для этой машины», снаружи копию не увидеть. Знак & в конце отправляет программу в фон, и терминал остаётся свободным.
python3 -m http.server 8000 -b 127.0.0.1 &[1] 5120 Serving HTTP on 127.0.0.1 port 8000 (http://127.0.0.1:8000/) ...
[1] — номер фоновой задачи, 5120 — номер процесса. Номер задачи живёт только в этом окне, поэтому останавливать копии будем по имени, через pkill. Теперь вторая копия на 8001.
cd ~/devops-lab/app-bpython3 -m http.server 8001 -b 127.0.0.1 &[2] 5121 Serving HTTP on 127.0.0.1 port 8001 (http://127.0.0.1:8001/) ...
Эти серверы будут печатать в терминал строку на каждый запрос — так и задумано, по ним видно, что до них доехало.
Шаг 4. Спросить копию напрямую
Прежде чем ставить прокси, убедимся, что копия сама отвечает.
curl http://127.0.0.1:8000/127.0.0.1 - - [01/Oct/2026 10:30:12] "GET / HTTP/1.1" 200 - app A
Первая строка — журнал копии: запрос GET / пришёл и получил 200. Вторая — сам ответ. Если копия не отвечает напрямую, через nginx она не ответит тем более.
Шаг 5. Прокси к одной копии
Начнём с самого простого прокси — к одной копии. Открой файл сайта из прошлой практики.
sudo nano /etc/nginx/sites-available/provisionВнутри блока server, перед блоком location /, добавь новый location.
location /api/ { proxy_pass http://127.0.0.1:8000/; }
location /api/ ловит все адреса, которые начинаются с /api/, а proxy_pass пересылает такой запрос копии на порту 8000 и возвращает её ответ пользователю. Сохрани файл: в nano это Ctrl+O, Enter, затем Ctrl+X. Как всегда, сначала проверка, потом применение.
sudo nginx -tnginx: configuration file /etc/nginx/nginx.conf test is successfulsudo systemctl reload nginxФлаг -s у curl убирает служебный шум.
curl -s http://stand.provision.internal/api/127.0.0.1 - - [22/Oct/2026 09:56:46] "GET / HTTP/1.0" 200 - app A
Ответила копия A — запрос прошёл через nginx. Посмотри на строку журнала копии: пришёл GET /, а не GET /api/.
Шаг 6. Зачем слэш в конце
Отрезал /api/ слэш в конце proxy_pass. Проверим это на себе: убери последний слэш, чтобы строка стала proxy_pass http://127.0.0.1:8000;, сохрани, проверь и примени — те же nginx -t и reload.
curl -sI http://stand.provision.internal/api/127.0.0.1 - - [22/Oct/2026 09:56:47] "HEAD /api/ HTTP/1.0" 404 - HTTP/1.1 404 File not found Server: nginx/1.24.0 (Ubuntu)
Флаг -I просит только заголовки ответа — в первой строке код. Без слэша nginx передаёт путь как есть, копия получила GET /api/ — а такого файла у неё нет, отсюда 404. Со слэшем префикс location заменяется на путь из proxy_pass. Верни слэш на место, проверь и примени.
Шаг 7. Группа из двух копий
Одна копия — одна точка отказа: упадёт она, упадёт и сайт. Опишем группу из двух. В самое начало файла, выше блока server, вставь блок upstream.
upstream app { server 127.0.0.1:8000; server 127.0.0.1:8001; }
upstream — группа серверов с именем, здесь app. Её место снаружи server: ошибка "upstream" directive is not allowed here значит, что блок попал внутрь. Теперь направь /api/ на группу — в proxy_pass вместо адреса копии впиши имя группы, слэш сохраняется.
proxy_pass http://app/;Проверь и примени, а потом спроси /api/ несколько раз подряд: стрелка вверх и Enter.
curl -s http://stand.provision.internal/api/app BОтветы приходят то от A, то от B — nginx раздаёт запросы по кругу. Строго через одну они идут, только если у nginx один рабочий процесс. На машине с несколькими ядрами процессов несколько, у каждого свой круг, и подряд может прийти «A, A, B, A» — это нормально: обе копии в работе.
Шаг 8. Что видит приложение
Приложению нужно знать, на какой сайт пришли и с какого адреса. Посмотрим, что nginx ему передаёт. Поможет программа nc (netcat): она слушает порт и печатает всё, что пришло. Добавь в server ещё один, отладочный location — рядом с /api/.
location /debug/ { proxy_pass http://127.0.0.1:8002/; }
Проверь и примени. Флаг -l у nc значит «слушать», дальше адрес и порт отладочного location.
nc -l 127.0.0.1 8002 &Ответа nc не пришлёт, поэтому флаг -m 2 велит curl сдаться через две секунды.
curl -s -m 2 http://stand.provision.internal/debug/GET / HTTP/1.0 Host: 127.0.0.1:8002 Connection: close User-Agent: curl/8.5.0 Accept: */*
Это ровно тот запрос, который получает приложение. В Host — не имя сайта, а адрес копии, и о клиенте ни слова: для приложения все запросы пришли от самого nginx. Сайт с несколькими доменами не поймёт, какой из них открыли, а журнал приложения будет полон одинаковых 127.0.0.1. Останавливать nc не нужно: когда curl сдался, nginx закрыл соединение, и nc завершился сам — шелл скажет об этом строкой Done.
Шаг 9. Передать заголовки
Исправим. Внутри блока server, сразу после строки index index.html;, добавь четыре заголовка. Написанные на уровне server, они действуют во всех location с proxy_pass внутри него.
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;
Host — имя сайта из запроса пользователя. X-Real-IP — адрес клиента. X-Forwarded-For — цепочка адресов, если прокси несколько. X-Forwarded-Proto — пришли по HTTP или HTTPS, это понадобится в уроке про HTTPS. Проверь, примени и повтори опыт с nc.
nc -l 127.0.0.1 8002 &curl -s -m 2 http://stand.provision.internal/debug/GET / HTTP/1.0 Host: stand.provision.internal X-Real-IP: 127.0.0.1 X-Forwarded-For: 127.0.0.1 X-Forwarded-Proto: http Connection: close User-Agent: curl/8.5.0
Теперь приложение знает имя сайта, адрес клиента и схему. Адрес клиента здесь 127.0.0.1, потому что curl запущен на той же машине; запрос с другого компьютера показал бы его адрес.
Шаг 10. Уронить одну копию
Теперь ломаем. Останови копию B. pkill ищет процесс, флаг -f велит сверять всю строку запуска, а не только имя программы, — так найдётся именно копия на порту 8001.
pkill -f "http.server 8001"Спроси /api/ несколько раз.
curl -s http://stand.provision.internal/api/app AСколько ни повторяй — отвечает только A, и ошибок пользователь не видит. А nginx записал, что случилось, в журнал ошибок. Флаг -n 1 у tail — последняя строка.
sudo tail -n 1 /var/log/nginx/error.log... connect() failed (111: Connection refused) while connecting to upstream, ... upstream: "http://127.0.0.1:8001/"Connection refused — порт 8001 никто не слушает. По полю upstream видно, какая именно копия упала.
Шаг 11. Уронить все копии
Останови и копию A.
pkill -f "http.server 8000"curl -I http://stand.provision.internal/api/HTTP/1.1 502 Bad Gateway Server: nginx/1.24.0 (Ubuntu)
Вот как выглядит полный отказ: nginx жив и отвечает сам, но за ним никого нет. А /health по-прежнему отдаёт ok — его формирует nginx, без приложения. Запомни это различие: 502 значит «чинить приложение, а не nginx».
Шаг 12. Поднять копии обратно
Для сдачи обе копии должны работать. Повтори шаг 3: перейди в каталог и запусти копию, сначала A, потом B. Тот же шаг пригодится, если ты вернулся после перерыва: проверь ss -tln | grep 800 — нет строк с 8000 и 8001, значит копии умерли вместе с прошлой сессией, подними их снова.
cd ~/devops-lab/app-apython3 -m http.server 8000 -b 127.0.0.1 &То же для копии B в ~/devops-lab/app-b на порту 8001. После этого снова проверь шаг 7: отвечают обе копии.
Что спросят на собеседовании
- Как nginx ведёт себя, если одна копия в upstream упала?Не дозвонившись, пробует следующую и выводит упавшую из ротации на fail_timeout, по умолчанию 10 секунд. Причина пишется в error.log.
- Пользователи видят 502. Что делать первым?Открыть error.log nginx: там адрес upstream и причина — Connection refused, timeout или обрыв. 502 почти всегда значит, что упало приложение, а не nginx.
- Почему приложение слушает только 127.0.0.1?Чтобы к нему нельзя было прийти в обход прокси и обойти TLS, лимиты и журнал.