0 bodů

Linux a servery · 40 min

Webový server nginx a HTTPS (obtížnost 4 z 5)

Instalace nginx, struktura konfigurace, server block pro statický web, reverzní proxy, bezpečné úpravy přes nginx -t a reload, certifikát Let's Encrypt přes certbot, přesměrování na HTTPS, logy a diagnostika chyb 403 a 502.

Lidsky řečeno

Webový server je recepční: přijde návštěvník (prohlížeč) a řekne „chci stránku“, recepční ji z police vytáhne a podá. nginx (čti „endžin-eks“) je velmi rychlý recepční, který navíc umí předávat požadavky dalším pracovníkům: jiné aplikaci, která stránku vytvoří, a zpátky ji podat návštěvníkovi. Tomu se říká reverzní proxy. HTTPS je zamčená obálka, ve které se všechno předává, aby to nikdo cestou nepřečetl.

Obtížnost: 4 z 5. Je potřeba skloubit víc věcí najednou: DNS, firewall, konfigurační soubory, oprávnění na soubory a certifikáty. Každá z nich je jednoduchá, ale chyby se projevují nepřímo (třeba 502) a hledání příčiny vyžaduje systém.

Pro koho to je: Pro toho, kdo zvládá SSH, sudo a úpravu souborů v terminálu (lekce SSH klíče a firewall) a chce vystavit na internet vlastní web nebo aplikaci s HTTPS. Potřebuješ doménu a server s veřejnou IP adresou.

Instalace

Debian a Ubuntu:

bash
sudo apt update
sudo apt install nginx
sudo systemctl enable --now nginx
systemctl status nginx

Rocky a AlmaLinux:

bash
sudo dnf install nginx
sudo systemctl enable --now nginx
sudo firewall-cmd --add-service=http --add-service=https --permanent
sudo firewall-cmd --reload

Debian a Ubuntu s ufw:

bash
sudo ufw allow 'Nginx Full'      # porty 80 a 443
sudo ufw status

Test: otevři v prohlížeči http://203.0.113.10 (adresu svého serveru) nebo na serveru spusť curl -I http://localhost. Měla by se objevit úvodní stránka nginx a odpověď HTTP/1.1 200 OK.

Kde co leží

CoDebian, UbuntuRocky, AlmaLinux
Hlavní konfigurace/etc/nginx/nginx.conf/etc/nginx/nginx.conf
Konfigurace webůsites-available/ a odkaz v sites-enabled/soubory *.conf v conf.d/
Ukázkový web/var/www/html/usr/share/nginx/html
Log přístupů/var/log/nginx/access.log/var/log/nginx/access.log
Log chyb/var/log/nginx/error.log/var/log/nginx/error.log
Uživatel procesuwww-datanginx

Hlavní soubor nginx.conf obsahuje obecné nastavení a řádky include, které načítají další soubory. Nezapisuj všechno do něj: každý web dej do vlastního souboru. Konfigurace se skládá z direktiv zakončených středníkem a bloků ve složených závorkách (http, server, location).

Zlaté pravidlo: nginx -t a reload

Konfiguraci vždy nejdřív otestuj a teprve potom načti:

bash
sudo nginx -t
sudo systemctl reload nginx

nginx -t zkontroluje syntaxi a načtení souborů, ale nic nespustí. reload načte novou konfiguraci bez přerušení spojení, kdežto restart všechny odpojí. Když je v konfiguraci chyba, reload ji nenačte a nginx dál běží se starým nastavením. Proto je dobré nejdřív -t. Celou skutečnou konfiguraci včetně všech include vypíše sudo nginx -T.

Statický web (server block)

Příklad pro doménu example.com (nahraď svou) na Debianu nebo Ubuntu.

bash
sudo mkdir -p /var/www/example.com/html
echo '<h1>Funguje to</h1>' | sudo tee /var/www/example.com/html/index.html
sudo chown -R www-data:www-data /var/www/example.com
sudo nano /etc/nginx/sites-available/example.com

Obsah souboru:

nginx
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;

    root /var/www/example.com/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}
DirektivaVýznam
listen 80poslouchá na portu 80 (HTTP), IPv4 i IPv6
server_namepro která jména domén se blok použije
rootsložka s webem
indexsoubor, který se zobrazí pro adresu složky
try_fileszkusí soubor, potom složku, jinak vrátí 404

Aktivace webu (na RHEL rodině soubor rovnou ulož jako /etc/nginx/conf.d/example.com.conf a odkaz nevytvářej):

bash
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo rm /etc/nginx/sites-enabled/default     # odstraní jen odkaz na výchozí web
sudo nginx -t
sudo systemctl reload nginx

Pokud ještě nemáš nastavené DNS, otestuj web podle jména přímo na IP:

bash
curl -I -H "Host: example.com" http://203.0.113.10/
curl --resolve example.com:80:203.0.113.10 http://example.com/

Reverzní proxy

Aplikace (Node.js, Python, Docker kontejner) běží často na lokálním portu (například 127.0.0.1:3000). nginx před ní přijme požadavky z internetu a předá je dál:

nginx
server {
    listen 80;
    listen [::]:80;
    server_name app.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        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;
    }
}

Řádky proxy_set_header předají aplikaci původní jméno, adresu návštěvníka a informaci, jestli přišel přes HTTPS. Bez nich bys v logu aplikace viděl jen adresu 127.0.0.1. Pokud aplikace poslouchá jen na 127.0.0.1, není zvenku přímo dostupná a firewall ji nemusíš otevírat: venku je vidět jen nginx.

HTTPS s Let's Encrypt a certbot

Let's Encrypt vydává certifikáty zdarma a automaticky. Nástroj certbot certifikát získá, upraví konfiguraci nginx a zajistí obnovu.

Před spuštěním ověř:

  1. Doména má v DNS záznam A (případně AAAA) směřující na IP serveru. Ověř dig +short example.com (nebo nslookup example.com).
  2. Na serveru i ve firewallu poskytovatele jsou otevřené porty 80 a 443.
  3. V nginx už existuje server_name se správnou doménou, certbot podle něj ví, který blok upravit.

Instalace certbotu podle doporučení na certbot.eff.org (pro Ubuntu a Debian jako snap):

bash
sudo apt remove certbot          # pokud je nainstalovaná starší verze z apt
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/local/bin/certbot

Získání certifikátu s úpravou nginx:

bash
sudo certbot --nginx -d example.com -d www.example.com

Certbot se zeptá na e-mail (pro upozornění na expiraci) a souhlas s podmínkami. Poté nabídne přesměrování HTTP na HTTPS. Zvol ho. Certifikát leží v /etc/letsencrypt/live/example.com/ (fullchain.pem, privkey.pem).

Obnova je automatická (certifikáty platí zhruba 90 dní a certbot je obnovuje sám, kratší platnost se plánuje, takže se na automatiku musíš spolehnout). Ověř ji:

bash
sudo certbot renew --dry-run
systemctl list-timers | grep certbot

Jak vypadá výsledek

Po certbotu bude v konfiguraci v podstatě tohle (a můžeš to napsat i ručně):

nginx
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;
    return 301 https://example.com$request_uri;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    root /var/www/example.com/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

Příkaz return 301 dělá trvalé přesměrování z HTTP na HTTPS a zachová cestu i parametry ($request_uri). Chceš-li HTTP/2, přidej do bloku s listen 443 ssl direktivu http2 on; (na nginx 1.25.1 a novějších, u starších verzí se píše listen 443 ssl http2;). Pozor na www: pokud přesměrováváš www.example.com na HTTPS, musí být www.example.com také v certifikátu (přepínač -d u certbotu), jinak návštěvníci uvidí varování o certifikátu.

Logy a ladění

bash
sudo tail -f /var/log/nginx/access.log       # kdo a co si žádá
sudo tail -f /var/log/nginx/error.log        # chyby
journalctl -u nginx -n 50                    # start a reload služby
sudo ss -tlnp | grep nginx                   # na kterých portech poslouchá
curl -I https://example.com                  # hlavičky odpovědi

Logy rostou, ale na Debianu a Ubuntu se o jejich rotaci stará logrotate automaticky (viz lekce Zabezpečení a zálohy serveru).

Typické chyby

ChybaTypická příčinaCo zkontrolovat
403 Forbiddennginx nemá právo číst soubor nebo složku, chybí index.html, na RHEL SELinuxnamei -l /var/www/example.com/html/index.html (každý adresář v cestě potřebuje právo x), vlastník, ls -Z
404 Not Foundšpatný root nebo chybí souborcesta v root, jméno souboru (velká/malá písmena)
502 Bad Gatewayaplikace za proxy neběží nebo má jiný portsystemctl status aplikace, ss -tlnp, curl http://127.0.0.1:3000
504 Gateway Timeoutaplikace odpovídá příliš pomalulog aplikace, proxy_read_timeout
413 Request Entity Too Largenahrávaný soubor je větší než limitclient_max_body_size 20m;
bind() ... Address already in useport 80 už používá jiný program (třeba Apache)sudo ss -tlnp a hledej řádek s portem 80
Vidíš stránku nginx místo svého webudefault web zachytává požadavekserver_name, smazání odkazu default, nginx -T

Vyzkoušej si to

Doplň

Doplň příkaz nebo direktivu

Vyber

Vyber správnou možnost

Spoj dvojice

Spoj soubor a jeho obsah

Roztřiď

Která chyba patří k jaké příčině?

Kvíz

Co je rozdíl mezi reload a restart?

Kvíz

Co musí platit, aby certbot získal certifikát pro example.com?

Kvíz

Aplikace za nginx neběží a nginx vrací chybu. Jakou?

Kartičky

Kartičky: nginx a HTTPS

Pod kapotou · WebSocket, bezpečnostní hlavičky a HSTS

Pro WebSocket za proxy přidej do location direktivy proxy_http_version 1.1;, proxy_set_header Upgrade $http_upgrade; a proxy_set_header Connection "upgrade";. HSTS (hlavička Strict-Transport-Security) říká prohlížeči, ať web otevírá jen přes HTTPS po dlouhou dobu. Zapínej ho opatrně, až když HTTPS bezpečně funguje a máš automatickou obnovu certifikátu. Nesprávně nastavené HSTS může web po vypršení certifikátu zablokovat. Také nikdy nedávej do konfigurace skutečný soukromý klíč mimo adresář certbotu a nekopíruj ho do repozitáře.

Co mít hotové po této lekci

  • Nainstalovaný nginx, povolené porty 80 a 443 ve firewallu.
  • Vlastní server block pro statický web a ověřené nginx -t.
  • Jedna reverzní proxy na lokální aplikaci (nebo aspoň rozumíš ukázce).
  • Platný certifikát přes certbot, přesměrování HTTP na HTTPS a ověřené certbot renew --dry-run.
  • Víš, kde jsou logy, a umíš rozlišit 403, 404 a 502.