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:
sudo apt update
sudo apt install nginx
sudo systemctl enable --now nginx
systemctl status nginxRocky a AlmaLinux:
sudo dnf install nginx
sudo systemctl enable --now nginx
sudo firewall-cmd --add-service=http --add-service=https --permanent
sudo firewall-cmd --reloadDebian a Ubuntu s ufw:
sudo ufw allow 'Nginx Full' # porty 80 a 443
sudo ufw statusTest: 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ží
| Co | Debian, Ubuntu | Rocky, 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 procesu | www-data | nginx |
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:
sudo nginx -t
sudo systemctl reload nginxnginx -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.
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.comObsah souboru:
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;
}
}| Direktiva | Význam |
|---|---|
listen 80 | poslouchá na portu 80 (HTTP), IPv4 i IPv6 |
server_name | pro která jména domén se blok použije |
root | složka s webem |
index | soubor, který se zobrazí pro adresu složky |
try_files | zkusí 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):
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 nginxPokud ještě nemáš nastavené DNS, otestuj web podle jména přímo na IP:
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:
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ěř:
- Doména má v DNS záznam A (případně AAAA) směřující na IP serveru. Ověř
dig +short example.com(nebonslookup example.com). - Na serveru i ve firewallu poskytovatele jsou otevřené porty 80 a 443.
- V nginx už existuje
server_namese 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):
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/certbotZískání certifikátu s úpravou nginx:
sudo certbot --nginx -d example.com -d www.example.comCertbot 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:
sudo certbot renew --dry-run
systemctl list-timers | grep certbotJak vypadá výsledek
Po certbotu bude v konfiguraci v podstatě tohle (a můžeš to napsat i ručně):
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í
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ědiLogy rostou, ale na Debianu a Ubuntu se o jejich rotaci stará logrotate automaticky (viz lekce Zabezpečení a zálohy serveru).
Typické chyby
| Chyba | Typická příčina | Co zkontrolovat |
|---|---|---|
| 403 Forbidden | nginx nemá právo číst soubor nebo složku, chybí index.html, na RHEL SELinux | namei -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í soubor | cesta v root, jméno souboru (velká/malá písmena) |
| 502 Bad Gateway | aplikace za proxy neběží nebo má jiný port | systemctl status aplikace, ss -tlnp, curl http://127.0.0.1:3000 |
| 504 Gateway Timeout | aplikace odpovídá příliš pomalu | log aplikace, proxy_read_timeout |
| 413 Request Entity Too Large | nahrávaný soubor je větší než limit | client_max_body_size 20m; |
bind() ... Address already in use | port 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 webu | default web zachytává požadavek | server_name, smazání odkazu default, nginx -T |
Vyzkoušej si to
Doplň příkaz nebo direktivu
Vyber správnou možnost
Spoj soubor a jeho obsah
Která chyba patří k jaké příčině?
Co je rozdíl mezi reload a restart?
Reload je šetrnější. Když je v konfiguraci chyba, nginx dál běží se starým nastavením.
Co musí platit, aby certbot získal certifikát pro example.com?
Let's Encrypt ověřuje, že ovládáš doménu. Pro ověření se připojí na port 80 serveru, na který doména ukazuje.
Aplikace za nginx neběží a nginx vrací chybu. Jakou?
502 Bad Gateway znamená, že nginx neuspěl při spojení s aplikací, na kterou předává požadavky.
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.