144 lines
10 KiB
Markdown
144 lines
10 KiB
Markdown
# P26 · апрель 2020 · Reverse proxy перед приложением — тройное ревью
|
||
|
||
Статус: **принят в publication registry 31 июля 2026 года**. Registry
|
||
накладывает ревизии по стабильным slug и сохраняет дату и автора базового
|
||
архива. `articles.json`, стандарт, очередь и package-конфигурация не
|
||
перезаписывались.
|
||
|
||
## Состав пакета
|
||
|
||
| Материал | Stable slug | Визуал | Основной текст по draft gate |
|
||
| --- | --- | --- | ---: |
|
||
| Практика | `editorial-2020-04-practice-reverse-proxy` | `reverse-proxy-request-hops-2020.svg` | 9 620 знаков |
|
||
| Механизм | `editorial-2020-04-mechanism-reverse-proxy` | `reverse-proxy-header-boundary-2020.svg` | 10 533 знака |
|
||
| Разбор | `editorial-2020-04-field-reverse-proxy` | `reverse-proxy-diagnosis-2020.svg` | 10 504 знака |
|
||
|
||
Ревизии не содержат полей `date` и `author`: при будущей интеграции сохраняются
|
||
дата, автор и slug базового архива.
|
||
|
||
## Проход 1 — факты и техника
|
||
|
||
### Проверенные опоры
|
||
|
||
- [Nginx `ngx_http_proxy_module`](https://nginx.org/en/docs/http/ngx_http_proxy_module.html): `proxy_pass`, явная подстановка `Host`, `proxy_set_header`, а также различие `proxy_connect_timeout`, `proxy_send_timeout` и `proxy_read_timeout`.
|
||
- [Nginx `ngx_http_realip_module`](https://nginx.org/en/docs/http/ngx_http_realip_module.html): адрес по header меняется только для источника, который явно назван через `set_real_ip_from`.
|
||
- [Nginx `ngx_http_log_module`](https://nginx.org/en/docs/http/ngx_http_log_module.html): `log_format`, `access_log`, `request_time` и роль формата журнала как наблюдаемого артефакта.
|
||
- [RFC 7239](https://www.rfc-editor.org/rfc/rfc7239): `Forwarded`, связь со старым семейством `X-Forwarded-*` и ограничение целостности forwarded-данных без доверенной цепочки proxy.
|
||
- [RFC 7230](https://www.rfc-editor.org/rfc/rfc7230): исторический HTTP/1.1-контекст апреля 2020 года для маршрутизации и `Host`.
|
||
|
||
### Что проверено в тексте
|
||
|
||
1. Reverse proxy описан как граница двух HTTP-hop-ов, а не как «прозрачный провод».
|
||
2. `proxy_read_timeout` назван интервалом между последовательными чтениями ответа, а не полной длительностью ответа.
|
||
3. `Host`, `X-Forwarded-*` и real IP не объявлены достоверными без источника и договора доверия.
|
||
4. 502/504 названы входом в диагностическую ветку, а не самостоятельным диагнозом.
|
||
5. Учебная конфигурация не подменяет реальную: `127.0.0.1`, пути, timeout-значения, URL и токены явно помечены заполнителями.
|
||
|
||
### Границы и запреты
|
||
|
||
В текст не добавлены service mesh, OpenTelemetry, Kubernetes Ingress или
|
||
современные облачные практики как опыт автора 2020 года. Не опубликованы
|
||
реальные hostnames, IP-адреса, cookie, токены, secrets или пользовательские
|
||
данные. `curl`, access-log и значения времени даны как учебные либо
|
||
синтетические примеры; они не выдаются за запуск на стенде.
|
||
|
||
**Вердикт прохода 1: пройден.** Технические утверждения привязаны к первичным
|
||
источникам, а недоказанные эксплуатационные выводы явно ограничены.
|
||
|
||
## Проход 2 — редактура, голос и структура
|
||
|
||
### Проверка голоса M3 / апрель 2020
|
||
|
||
Автор развивает ширину от HTTP и локальной доставки к backend boundary:
|
||
`клиент → Nginx → приложение`, конфигурация, таймаут, безопасный access-log.
|
||
Тон прагматичный: «симптом → причина → проверка → действие». Он не говорит
|
||
от лица владельца крупной платформы и не обещает универсальные значения
|
||
таймаутов. Слова `upstream`, `hop`, `TLS termination`, `Forwarded` и real IP
|
||
привязаны к конфигурации, журналу или конкретному ограничению.
|
||
|
||
### Обязательные элементы в каждой статье
|
||
|
||
| Критерий | Практика | Механизм | Разбор |
|
||
| --- | --- | --- | --- |
|
||
| Проблема и цена в первых двух абзацах | Да | Да | Да |
|
||
| 5–15 тыс. знаков основного текста | Да | Да | Да |
|
||
| `table` с `caption` и `thead` | Да | Да | Да |
|
||
| `figure` с содержательными `alt` и подписью | Да | Да | Да |
|
||
| Конфигурация, curl или log-пример | Nginx + curl | Nginx + log format | log format + синтетический log + curl |
|
||
| Нумерованный маршрут | Да | Да | Да |
|
||
| Не менее двух первичных/официальных ссылок | 5 | 5 | 5 |
|
||
|
||
Проверены повторы, канцелярские обобщения и анахронизмы. Заголовки отвечают
|
||
именно на вопрос соответствующей статьи: практический контракт, механизм двух
|
||
соединений и безопасное расследование. В финалах зафиксированы следующий шаг
|
||
и границы применимости, а не обещание «решить все proxy-проблемы».
|
||
|
||
**Вердикт прохода 2: пройден.** Плотность достаточна, тон соответствует
|
||
переходу автора к delivery и backend boundary в 2020 году.
|
||
|
||
## Проход 3 — визуал и выпускной preflight
|
||
|
||
### Реально выполненные проверки
|
||
|
||
```text
|
||
node --check scripts/upgrade-2020-04.mjs
|
||
→ code 0
|
||
|
||
npm run audit:draft -- scripts/upgrade-2020-04.mjs
|
||
→ code 0
|
||
→ PASS practice: 9 620 body chars
|
||
→ PASS mechanism: 10 533 body chars
|
||
→ PASS field: 10 504 body chars
|
||
|
||
xmllint --noout public/assets/editorial/2020/reverse-proxy-request-hops-2020.svg \
|
||
public/assets/editorial/2020/reverse-proxy-header-boundary-2020.svg \
|
||
public/assets/editorial/2020/reverse-proxy-diagnosis-2020.svg
|
||
→ code 0
|
||
```
|
||
|
||
`npm` напечатал известные предупреждения пользовательской конфигурации
|
||
`store-dir`, `cache-dir`, `public-hoist-pattern`; команда завершилась кодом 0,
|
||
они не относятся к P26.
|
||
|
||
### Визуальный preflight
|
||
|
||
Все три SVG отрендерены Sharp при ширине 375 px и просмотрены вручную:
|
||
|
||
- `reverse-proxy-request-hops-2020.svg` — вертикальная последовательность
|
||
клиента, Nginx, приложения и совместной диагностики; переполнения и обрезания
|
||
не обнаружены.
|
||
- `reverse-proxy-header-boundary-2020.svg` — крупные карточки источника,
|
||
договора и чтения приложением; вторичный текст остаётся различимым.
|
||
- `reverse-proxy-diagnosis-2020.svg` — пять вертикальных шагов расследования;
|
||
стрелки не перекрывают подписи, финальная карточка читается на 375 px.
|
||
|
||
SVG не содержат внешних ресурсов. В HTML каждой статьи есть отдельные
|
||
содержательные `alt` и `figcaption`; таблицы завёрнуты в `table-scroll`, как
|
||
требует существующий шаблон.
|
||
|
||
Основной редактор независимо просмотрел финальные raster-версии трёх схем на
|
||
375 px и подтвердил этот результат. После подключения registry strict audit и
|
||
production build также пройдены. Они не подменяют запуск Nginx, `curl` или
|
||
browser на конкретном стенде.
|
||
|
||
### Невыполненные проверки, которые не выдаются за факты
|
||
|
||
- Nginx не запускался и конфигурация не загружалась в daemon.
|
||
- Учебный `curl` не выполнялся.
|
||
- Browser, CI, staging и production-прогон не выполнялись.
|
||
- Не было доступа к реальному access-log или логу приложения; строка в статье
|
||
явно названа синтетической.
|
||
|
||
### Интеграционная проверка
|
||
|
||
| Проверка | Результат |
|
||
| --- | --- |
|
||
| Strict audit после подключения registry | PASS: 9 620 / 10 533 / 10 504 знака; 1 / 2 / 1 table и 2 / 2 / 3 code example |
|
||
| `npm run build` | PASS, code 0, 374 статические страницы |
|
||
| Scope/self-review | PASS: в revision нет `date`/`author`, `articles.json` не перезаписан |
|
||
|
||
**Выпусковой вердикт: тройное ревью пройдено, пакет принят к публикации.**
|
||
Статические проверки подтверждают качество редакционного слоя, но не
|
||
утверждают фактическое поведение Nginx, доступность стенда или реальный
|
||
access-log; для конкретного проекта это отдельный сценарий.
|