Bab 4 dari 9 · ASJ
Web Server (Nginx)
Web server melayani halaman web ke klien lewat protokol HTTP/HTTPS. Nginx adalah web server dan reverse proxy yang ringan, cepat, dan stabil — pilihan utama di server produksi. Konfigurasinya berbasis file teks sehingga mudah diotomatiskan.
Konsep dasar
- HTTP (port 80) — protokol web tanpa enkripsi.
- HTTPS (port 443) — HTTP + TLS (terenkripsi).
- Document root — folder tempat file web disimpan (default
/var/www/html). - Virtual host / server block — satu server melayani banyak domain.
- Reverse proxy — Nginx di depan, meneruskan permintaan ke aplikasi (Node, PHP, Python).
Instalasi dan kontrol
sudo apt update
sudo apt install nginx
sudo systemctl enable --now nginx
systemctl status nginx
nginx -v # versi
nginx -t # uji konfigurasi
sudo systemctl reload nginx # muat ulang tanpa downtime
Setelah terpasang, buka http://IP-server di browser — muncul halaman default Nginx.
Struktur konfigurasi Nginx
/etc/nginx/
├── nginx.conf konfigurasi utama
├── sites-available/ definisi situs (belum aktif)
├── sites-enabled/ symlink situs aktif
├── conf.d/ konfigurasi tambahan
└── snippets/ potongan konfigurasi
Poin penting: Situs didefinisikan di
sites-available/, lalu diaktifkan dengan symlink kesites-enabled/. Ini memudahkan menyalakan/mematikan situs tanpa menghapus konfigurasi.
Server block sederhana
Buat file /etc/nginx/sites-available/sekolah:
server {
listen 80;
server_name sekolah.local www.sekolah.local;
root /var/www/sekolah;
index index.html index.htm;
location / {
try_files $uri $uri/ =404;
}
}
Aktifkan dan uji:
sudo mkdir -p /var/www/sekolah
echo "<h1>Halo Sekolah</h1>" | sudo tee /var/www/sekolah/index.html
sudo ln -s /etc/nginx/sites-available/sekolah /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
Penjelasan:
listen 80— port yang didengarkan.server_name— nama domain yang dilayani.root— folder file web.try_files— cari file, kalau tidak ada balas 404.
Reverse proxy
Meneruskan permintaan ke aplikasi yang berjalan di port lain (mis. Node.js di 3000):
location /api/ {
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;
}
Poin penting: Header
X-Real-IPdanX-Forwarded-Forpenting agar aplikasi di belakang tahu IP asli pengunjung, bukan IP Nginx.
HTTPS dengan Let's Encrypt (Certbot)
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d sekolah.local -d www.sekolah.local
sudo systemctl status certbot.timer # perpanjangan otomatis
Certbot otomatis mengubah server block agar memakai HTTPS dan mengarahkan HTTP → HTTPS.
Konfigurasi manual HTTPS:
server {
listen 443 ssl;
server_name sekolah.local;
ssl_certificate /etc/letsencrypt/live/sekolah.local/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/sekolah.local/privkey.pem;
root /var/www/sekolah;
}
Redirect HTTP ke HTTPS
server {
listen 80;
server_name sekolah.local;
return 301 https://$host$request_uri;
}
PHP dengan Nginx (opsional)
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}
Perlu paket php-fpm terpasang dan berjalan.
Log dan troubleshooting
/var/log/nginx/access.log # setiap permintaan
/var/log/nginx/error.log # error Nginx
journalctl -u nginx -n 50 # log service
sudo tail -f /var/log/nginx/error.log
Error umum:
| Gejala | Kemungkinan penyebab |
|---|---|
| 403 Forbidden | Izin folder salah / index tidak ada |
| 404 Not Found | File tidak ada / root salah |
| 502 Bad Gateway | Aplikasi backend mati / proxy_pass salah |
| 504 Gateway Timeout | Backend terlalu lambat |
| Situs default muncul | Symlink sites-enabled belum dibuat |
Poin penting: Selalu jalankan
nginx -tsebelumreload. Konfigurasi salah yang langsung di-reload bisa mematikan seluruh situs.
Latihan
- Apa bedanya
sites-availabledansites-enabled? - Perintah apa untuk menguji konfigurasi Nginx tanpa memuat ulang?
- Apa fungsi reverse proxy?
- Apa arti error 502 Bad Gateway?
Kunci jawaban:
sites-availablemenyimpan definisi situs (belum aktif);sites-enabledberisi symlink ke situs yang aktif.nginx -t.- Meneruskan permintaan dari klien ke server aplikasi di belakangnya (mis. Node.js), sekaligus menangani HTTPS dan load balancing.
- Nginx tidak bisa menghubungi server backend (aplikasi mati atau
proxy_passsalah).