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

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

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

# http → https с исключением для ACME
server {
    listen 80;
    location /.well-known/acme-challenge/ { root /var/www/certbot; }
    location / { return 301 https://$host$request_uri; }
}

# SPA + ассеты
location / { try_files $uri $uri/ /index.html; }
location /assets/ {
    try_files $uri =404;                       # честная 404 на отсутствующий файл
    add_header Cache-Control "public, max-age=31536000, immutable" always;
}

# прокси к группе
upstream app { server app-1:8000 max_fails=3 fail_timeout=15s; keepalive 32; }
location /api/ {
    proxy_pass http://app;
    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;
}

# WebSocket
map $http_upgrade $connection_upgrade { default upgrade; '' close; }
location /ws/ {
    proxy_pass http://app;
    proxy_set_header Upgrade    $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_read_timeout 3600s;
}

# лимит на вход
limit_req_zone $binary_remote_addr zone=login:10m rate=5r/m;
location = /api/login { limit_req zone=login burst=5 nodelay; limit_req_status 429; }

# кеш ответов
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=API:10m inactive=60m max_size=2g;
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;
}