Шпаргалка по всему курсу

1. какой server?      listen (адрес+порт) → server_name → default_server → первый блок
2. какой location?    =  →  самый длинный префикс (с ^~ - стоп)  →  регулярки  →  префикс
3. выйти досрочно?    return / rewrite  (фаза rewrite - ДО access!)
4. кто отдаёт?        root/alias + try_files  |  proxy_pass / fastcgi_pass
5. чем обвесить?      add_header, expires, gzip
6. что в лог?         access_log (пишется ПОСЛЕ ответа)

server rewrite → find location → rewrite → preaccess (limit_*)
→ access (allow/deny, auth) → try_files → content → filters

# ── http: общие объявления ────────────────────────────────────
upstream app { server app-1:8000 max_fails=3 fail_timeout=15s; keepalive 32; }
map $http_upgrade $connection_upgrade { default upgrade; '' close; }
limit_req_zone $binary_remote_addr zone=login:10m rate=5r/m;
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=API:10m
                 inactive=60m max_size=2g;

# ── http: catch-all - чужой Host не видит твой сайт ───────────
server { listen 80 default_server; server_name _; return 444; }

# ── http: http → https с исключением для ACME ─────────────────
server {
    listen 80;
    server_name shop.local www.shop.local;   # без имён ответит catch-all
    location ^~ /.well-known/acme-challenge/ { root /var/www/certbot; }
    location / { return 301 https://$host$request_uri; }  # не в server!
}

# ── файл /etc/nginx/snippets/proxy-headers.conf ───────────────
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;

# ── server: SPA + ассеты ──────────────────────────────────────
location / { try_files $uri $uri/ /index.html; }
location /assets/ {
    try_files $uri =404;              # честная 404 на отсутствующий файл
    # вечный кеш - только файлам с хешем в имени, и без always:
    # иначе на год запомнится и 404
    add_header Cache-Control "public, max-age=31536000, immutable";
}

# ── server: прокси к группе ───────────────────────────────────
location /api/ {
    proxy_pass http://app;
    include /etc/nginx/snippets/proxy-headers.conf;
}

# ── server: лимит на вход ─────────────────────────────────────
# точный location не наследует proxy_pass от /api/ - повторяем
location = /api/login {
    limit_req zone=login burst=5 nodelay;
    limit_req_status 429;
    proxy_pass http://app;
    include /etc/nginx/snippets/proxy-headers.conf;
}

# ── server: WebSocket ─────────────────────────────────────────
location /ws/ {
    proxy_pass http://app;
    proxy_set_header Upgrade    $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_read_timeout 3600s;
}

# ── server: кеш ответов ───────────────────────────────────────
location /api/catalog/ {
    proxy_cache API;
    proxy_cache_key "$scheme$request_method$host$request_uri";
    proxy_cache_valid 200 1m;
    proxy_cache_bypass $cookie_session;
    proxy_no_cache     $cookie_session;
    add_header X-Cache-Status $upstream_cache_status always;
    proxy_pass http://app;
}