nginx reverse proxy útmutató

Mit csinál a reverse proxy

• Egyetlen nyilvános belépési pont. Az nginx a 80-as és 443-as porton figyel, és minden domaint vagy útvonalat a megfelelő alkalmazáshoz továbbít, így maguk az alkalmazások soha nem néznek ki közvetlenül az internetre.
• HTTPS egy helyen. A tanúsítványokat az nginx kezeli; a mögötte lévő alkalmazások sima HTTP-t használhatnak localhoston.
• Több alkalmazás egy szerveren. Az app.example.com, az api.example.com és az example.com/blog mind más-más szolgáltatáshoz vezethet.
• Extrák: tömörítés, gyorsítótárazás, feltöltési korlátok és hozzáférési szabályok, az alkalmazás módosítása nélkül.

1. lépés: Az nginx telepítése

sudo apt update
sudo apt install nginx

Nyisd meg a http://your-server-ip címet, és meg kell jelennie az nginx üdvözlőoldalának. Ha ufw-t használsz, engedélyezd a webes forgalmat ezzel: sudo ufw allow 'Nginx Full'.

Győződj meg róla, hogy az alkalmazásod fut, és magán a szerveren elérhető, például így: curl http://127.0.0.1:3000. Ha ez nem sikerül, az nginx sem fog.

2. lépés: A proxy server blokk létrehozása

Ubuntun minden oldal kap egy fájlt a /etc/nginx/sites-available/ mappában, amelyet egy sites-enabled alatti hivatkozás kapcsol be. Hozd létre a /etc/nginx/sites-available/app.example.com fájlt:

server {
    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;
    }
}

Kapcsold be, teszteld a konfigurációt, és töltsd újra:

sudo ln -s /etc/nginx/sites-available/app.example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Irányítsd a domain A rekordját a szerveredre, és a http://app.example.com már az alkalmazásodat mutatja. Újratöltés előtt mindig futtasd az nginx -t parancsot: kiszűri az elírásokat, mielőtt leállítanák az oldalt.

A fejlécek és a záró perjel

• A Host továbbítja a látogató által kért domaint. Nélküle az nginx a proxy_pass címét küldi, és a hostból linkeket építő alkalmazások elromlanak.
• Az X-Real-IP és az X-Forwarded-For továbbítja a látogató IP-címét. Nélkülük minden kérés úgy néz ki, mintha a 127.0.0.1 címről jönne.
• Az X-Forwarded-Proto megmondja az alkalmazásnak, hogy a látogató HTTPS-t használt-e, így az nem irányít át végtelen körben.

Az Ubuntu nginx csomagja ezeket a sorokat a /etc/nginx/proxy_params fájlban szállítja, így az include proxy_params; egy rövidítés.

A záró perjel számít. Egy útvonal alatti alkalmazásnál:

location /app/ {
    proxy_pass http://127.0.0.1:3000/;
}

Ha a port után van perjel, a /app/login /login-ként érkezik az alkalmazáshoz. Nélküle az alkalmazás a teljes /app/login útvonalat kapja.

WebSockets

A chatalkalmazások, élő dashboardok és sok adminpanel WebSocketeket használ, amelyekhez két extra fejléc kell. Add hozzá ezt a mapet egyszer, a http blokkon belül, például egy új /etc/nginx/conf.d/websocket.conf fájlban:

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

Aztán a location blokkban:

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_read_timeout 1h;

Az nginx lezárja azt a proxyzott kapcsolatot, amely 60 másodpercig semmit nem küld; a hosszabb proxy_read_timeout nyitva tartja a csendes WebSocketeket. A proxy_http_version 1.1 csak az nginx 1.29.7-től alapértelmezett, az Ubuntu 24.04 pedig az 1.24-et szállítja, ezért hagyd benne a sort.

3. lépés: Ingyenes HTTPS Certbottal

sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/local/bin/certbot
sudo certbot --nginx -d app.example.com

A Certbot ingyenes Let's Encrypt tanúsítványt szerez, hozzáadja a HTTPS-beállításokat a server blokkodhoz, és át tudja irányítani a HTTP-t HTTPS-re. A tanúsítványt automatikusan megújítja; ellenőrizd ezzel: sudo certbot renew --dry-run. A tanúsítványokról bővebben: hogyan szerezz ingyenes SSL tanúsítványt.

Az 502, 504 és 413 hibák javítása

Minden módosítás után: sudo nginx -t, majd sudo systemctl reload nginx.

Futtasd HytHost VPS-en

A reverse proxyhoz olyan szerver kell, ahol te rendelkezel a 80-as és 443-as port felett. A HytHost VPS csomagok KVM-en futnak, teljes root hozzáféréssel, SSD tárhellyel és DDoS védelemmel; válaszd az Ubuntu 24.04-et, és kövesd a fenti lépéseket. Konténerekben futtatod az alkalmazásaidat? Előbb állítsd be a Dockert a Docker telepítése Ubuntura útmutatóval, és kösd a konténerek portjait a 127.0.0.1 címre, hogy csak az nginx érje el őket.