Nginx bukan aplikasi yang "tinggal dipasang lalu jalan". Setelah apt install selesai, yang kamu punya adalah situs contoh milik pembuat paket β€” bukan situsmu.

Artikel ini menuntaskan bagian yang paling sering dilompati tutorial: memasang, memahami peta berkasnya, dan memverifikasi bahwa yang melayani permintaan memang situs yang benar.

🎯 Tujuan

Setelah membaca artikel ini, kamu bisa:

  • Memilih sumber paket nginx dan tahu konsekuensi versinya.
  • Menjelaskan peta direktori nginx setelah instalasi tanpa menghafal.
  • Membedakan nginx -t, nginx -T, dan systemctl reload.
  • Menghitung kapasitas kasar dari tiga angka worker.
  • Mencabut situs default dan memasang satu situs sendiri dengan benar.
  • Menghindari kesalahan paling mahal: memasang nginx di server yang port 80/443-nya sudah dipakai.

πŸ“ Konteks nyata

Bayangkan membeli lemari baru, lalu langsung memakainya tanpa membuang isi bawaan pabrik. Setiap kali orang membuka lemari itu, yang terlihat bukan barangmu β€” tapi kertas instruksi dari pabrik.

Itulah yang terjadi ketika nginx dipasang dan situs default-nya dibiarkan. Alamat sekolah dibuka, dan yang muncul adalah halaman "Welcome to nginx!".

πŸ”₯ Kasus nyata: Sebuah SMK memasang nginx di server baru untuk menaikkan situs profil sekolah. Instalasi selesai, systemctl status nginx hijau, dan pekerjaan dianggap beres.

Tiga minggu kemudian ada yang memberi tahu: "Situs sekolah isinya tulisan Welcome to nginx". Selama itu, seluruh pengunjung melihat halaman bawaan β€” karena situs sekolah sebenarnya sudah dibuat, tapi diletakkan di virtual host yang tidak pernah diaktifkan, sementara default milik paket masih menangkap semua permintaan.

Yang membuat masalah ini bertahan tiga minggu bukan kesulitan teknis. Penyebabnya satu: tidak ada pemeriksaan isi. Status layanan hijau hanya berarti proses hidup, bukan berarti halaman yang benar yang keluar.

🧠 Konsep singkat

πŸ”Ή Dua sumber paket, dua konsekuensi

Sumber Versi yang biasa didapat Konsekuensi
Repo distribusi (Ubuntu 24.04) 1.24.0-2ubuntu7.19 Stabil, ikut patch keamanan distro, modul tersedia sebagai paket
Repo resmi nginx.org Rilis terbaru (mis. 1.28.0) Fitur lebih baru, tapi harus menambah repo dan mengurus kuncinya sendiri

Keduanya sah. Yang tidak sah adalah mencampur: memasang dari repo distribusi, lalu menambah modul dari sumber lain tanpa memperhatikan versi. Untuk belajar di lab, repo distribusi hampir selalu cukup.

Sebelum menambah repo resmi nginx, periksa dulu apakah distribusimu sudah didukung di sana. Kalau belum, jangan paksa β€” pakai repo distribusi dan catat versinya.

πŸ”Ή Peta berkas setelah instalasi

Lokasi Isinya Sering disentuh?
/etc/nginx/nginx.conf Konfigurasi utama (worker, log, include) Jarang
/etc/nginx/sites-available/ Berkas konfigurasi situs Ya
/etc/nginx/sites-enabled/ Symlink situs yang aktif Ya
/etc/nginx/conf.d/ Konfigurasi tambahan berakhiran .conf Kadang
/var/log/nginx/ access.log, error.log Dibaca terus
/var/www/html/ Web root bawaan Ya (atau diganti)

Pola sites-available + sites-enabled berasal dari paket Debian/Ubuntu. Di distro lain, biasanya hanya ada conf.d. Keduanya bekerja; yang penting kamu tahu mana yang benar-benar dibaca.

Cara memastikannya satu perintah: nginx -T mencetak seluruh konfigurasi hasil gabungan. Kalau berkasmu tidak muncul di sana, berkas itu tidak dibaca.

πŸ”Ή Tiga perintah yang sering tertukar

Perintah Artinya Kapan dipakai
nginx -t Menguji sintaks konfigurasi Setiap sebelum reload
nginx -T Menguji lalu mencetak konfigurasi gabungan Saat bingung "file mana yang dibaca"
systemctl reload nginx Membaca ulang konfigurasi tanpa memutus koneksi Setelah -t lolos

reload pada konfigurasi yang salah tidak "setengah jalan" β€” nginx lama tetap berjalan dengan konfigurasi lama, dan error-nya masuk ke log. Akibatnya situs terlihat normal padahal perubahanmu tidak pernah aktif. Itu sebabnya nginx -t bukan formalitas.

πŸ”Ή Tiga angka yang menentukan kapasitas

  • worker_processes β€” jumlah proses pekerja. auto berarti mengikuti jumlah CPU.
  • worker_connections β€” jumlah koneksi per worker. Nilai bawaan 512–1024.
  • worker_rlimit_nofile β€” batas berkas terbuka per worker, harus sejalan dengan batas sistem.

Kapasitas kasar koneksi = worker_processes Γ— worker_connections. Angka ini patokan, bukan janji: kalau aplikasinya lambat, batas sebenarnya ada di aplikasi, bukan di nginx.

πŸ”Ή Kenapa situs default harus dicabut

Situs default memakai default_server pada port 80 dan 443. Artinya: setiap permintaan yang nama domainnya tidak cocok dengan situs mana pun akan dilayani olehnya.

Kalau ia dibiarkan, ada dua akibat:

  • Pengunjung melihat halaman bawaan untuk nama domain yang salah ketik atau belum terdaftar.
  • Kamu mendapat sinyal palsu: "nginx jalan", padahal yang jalan adalah situs contoh.

Mencabutnya bukan sekadar kosmetik β€” ia menghapus satu sumber kebingungan saat diagnosa.

🧩 Istilah penting

  • Directive β€” baris konfigurasi nginx, diakhiri titik koma.
  • Context β€” ruang tempat directive boleh muncul (http, server, location).
  • Server block β€” satu definisi situs di dalam http.
  • default_server β€” penangkap permintaan yang tidak cocok dengan nama mana pun.
  • Root β€” folder yang menjadi pangkal URL.
  • Worker β€” proses yang benar-benar melayani permintaan.
  • Upstream β€” server di belakang nginx yang menerima permintaan hasil teruskan.
  • Reload β€” memuat ulang konfigurasi tanpa mematikan proses.
  • Web root β€” direktori berisi berkas yang disajikan.
  • Symlink aktif β€” tautan di sites-enabled yang menunjuk berkas di sites-available.

πŸ”§ Praktik: memasang dan memverifikasi

Kerjakan di VM lab. Sebelum langkah 1, pastikan tidak ada layanan lain yang memegang port 80/443.

πŸ”Ή Langkah 1 β€” periksa port lebih dulu

sudo ss -tlnp | grep -E ':(80|443) '

Kalau keluarannya menampilkan apache2 atau proses lain, berhenti. Memasang nginx di mesin itu akan gagal mengikat port, dan layanan yang sudah jalan bisa terganggu.

Ini bukan teori: server wiki kami sendiri memakai Apache pada 80 dan 443. Memasang nginx di sana tanpa memindahkan Apache lebih dulu hanya akan menghasilkan address already in use.

πŸ”Ή Langkah 2 β€” lihat versi yang akan dipasang

apt-cache policy nginx

Catat versi kandidatnya. Kalau kamu menulis laporan atau mengajar, sebutkan versi ini β€” bukan "nginx terbaru".

πŸ”Ή Langkah 3 β€” pasang

sudo apt update
sudo apt install -y nginx

Di Ubuntu/Debian, ini juga menyalakan dan mengaktifkan layanan secara otomatis.

πŸ”Ή Langkah 4 β€” potret keadaan awal

nginx -v
systemctl is-enabled nginx
systemctl is-active nginx
sudo ss -tlnp | grep nginx

Empat pemeriksaan, empat pertanyaan berbeda: versi apa, hidup setelah reboot tidak, sedang jalan tidak, dan port mana yang benar-benar dipegang.

πŸ”Ή Langkah 5 β€” uji konfigurasi dan lihat isi gabungannya

sudo nginx -t
sudo nginx -T | head -40

Perhatikan baris terakhir nginx -t: harus "syntax is ok" dan "test is successful". Dua kalimat itu berbeda β€” yang pertama soal sintaks, yang kedua soal seluruh berkas yang dirujuk.

πŸ”Ή Langkah 6 β€” cabut situs default

sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t && sudo systemctl reload nginx

Setelah ini, permintaan ke IP server seharusnya tidak lagi menampilkan halaman bawaan. Kalau masih muncul, berarti ada berkas lain di conf.d/ yang juga memakai default_server β€” temukan lewat nginx -T | grep -n default_server.

πŸ”Ή Langkah 7 β€” pasang satu situs sendiri

sudo mkdir -p /var/www/lab
echo '<h1>Situs lab aktif</h1>' | sudo tee /var/www/lab/index.html
sudo tee /etc/nginx/sites-available/lab <<'EOF'
server {
    listen 80;
    server_name lab.local;
    root /var/www/lab;
    index index.html;
    location / { try_files $uri $uri/ =404; }
}
EOF
sudo ln -sf /etc/nginx/sites-available/lab /etc/nginx/sites-enabled/lab
sudo nginx -t && sudo systemctl reload nginx

Uji tanpa mengubah DNS:

curl -s -H 'Host: lab.local' http://127.0.0.1/

Cara ini penting untuk diajarkan: kamu bisa menguji virtual host tanpa menunggu DNS atau menyentuh /etc/hosts di banyak mesin.

πŸ”Ή Langkah 8 β€” verifikasi lima titik

systemctl is-active nginx
sudo nginx -T | grep -c 'server_name lab.local'
curl -s -H 'Host: lab.local' http://127.0.0.1/ | head -1
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1/
sudo tail -5 /var/log/nginx/access.log

Lima titik ini menutup lima pertanyaan: layanan hidup, konfigurasi terbaca, isi benar, kode status masuk akal, dan ada jejak di log.

🏭 Dipakai di dunia kerja

  • Sekolah dan lab β€” nginx dipasang untuk situs profil, e-learning, atau sebagai pintu aplikasi internal. Pemeriksaan isi halaman wajib, karena "hijau di systemctl" tidak berarti benar.
  • Kantor dan UMKM β€” satu server sering menampung beberapa virtual host. Pola sites-available/sites-enabled membuat penambahan situs tidak mengacak yang lama.
  • Hosting dan VPS β€” penyedia sering memasang nginx lebih dulu; pelanggan harus tahu bahwa situs default mereka mungkin masih aktif.
  • ISP dan NOC β€” nginx dipakai sebagai reverse proxy dan load balancer; pemahaman worker dan connection menjadi dasar kapasitas.
  • Klinik dan rumah sakit β€” pemasangan web server adalah bagian dari perubahan yang harus tercatat, karena menyangkut layanan yang dipakai staf.
  • Freelancer β€” dokumen pemeriksaan seperti pada langkah 8 bisa diserahkan sebagai bukti serah terima, bukan hanya "sudah saya pasang".

βœ… Verifikasi

Titik periksa Perintah Hasil yang benar
Port belum dipakai ss -tlnp Tidak ada proses lain di 80/443
Versi tercatat apt-cache policy nginx Versi kandidat diketahui
Layanan aktif systemctl is-active active
Hidup setelah reboot systemctl is-enabled enabled
Konfigurasi sah nginx -t syntax ok + test successful
Berkas terbaca nginx -T Nama situsmu muncul
Default tercabut grep default_server Tidak ada, atau hanya milik situsmu
Isi benar curl -H 'Host: …' Halaman situsmu, bukan halaman bawaan
Jejak log tail access.log Permintaan uji tercatat

⚠️ Kesalahan umum & troubleshooting

Gejala Penyebab Perbaikan
address already in use Port 80/443 dipakai proses lain Hentikan/pindahkan proses itu, jangan paksa
Masih muncul "Welcome to nginx" Situs default belum dicabut Hapus symlink default, reload
nginx -t alert soal /var/log/nginx/error.log Dijalankan tanpa hak tulis ke log Pakai sudo; alert ini bukan kegagalan konfigurasi
Perubahan tidak berefek Reload tidak dijalankan, atau berkas tidak terbaca nginx -T lalu reload
403 Forbidden Izin direktori/berkas terlalu ketat Periksa namei -l dan pemilik web root
404 padahal berkas ada root menunjuk folder yang salah Cocokkan root dengan lokasi sebenarnya
Halaman situs lain muncul server_name tidak cocok, jatuh ke default Periksa urutan pencocokan nama
Layanan gagal start setelah edit Sintaks salah, reload dibatalkan nginx -t menunjuk baris bermasalah

Dua catatan penting untuk pengajaran:

  • Pesan error menunjuk baris berikutnya, bukan baris penyebab. Kalau kamu menghapus titik koma di akhir baris, error sering muncul sebagai "invalid parameter" pada baris sesudahnya. Ajarkan siswa membaca satu baris sebelum pesan error.
  • Alert berbeda dengan error. Alert soal log bukan alasan untuk membongkar konfigurasi yang sudah sah.

πŸ” Catatan keamanan

  • Pasang nginx hanya di mesin yang kamu kelola. Di server produksi, pemasangan paket baru adalah perubahan yang harus disetujui.
  • Jangan biarkan web root berisi berkas sensitif: .env, arsip basis data, atau folder .git.
  • Matikan penanda versi bila tidak diperlukan (server_tokens off;), agar tidak membagikan informasi yang tidak perlu.
  • Setelah instalasi, pastikan hanya folder yang memang publik yang bisa dibaca. Hak 755 untuk direktori dan 644 untuk berkas adalah titik awal yang aman.
  • Jangan menampilkan konfigurasi hasil nginx -T di tempat publik β€” isinya peta lengkap server.

πŸ“Œ Kesimpulan

Memasang nginx punya tiga tahap yang tidak boleh dilewat: pasang, periksa port lebih dulu, lalu buktikan isinya.

Tiga hal yang paling menentukan:

  • Port adalah syarat, bukan detail. Satu server satu pemegang port. Periksa sebelum memasang.
  • nginx -t sebelum reload, tanpa kecuali. Reload pada konfigurasi salah berjalan diam-diam dengan konfigurasi lama.
  • Status layanan bukan bukti isi halaman. Yang membuktikan adalah curl yang mengembalikan halaman situsmu.

Kalau hanya punya sepuluh menit sebelum mengajar: pastikan langkah 1, 5, 6, dan 7 sudah kamu jalankan sendiri di lab. Sisanya bisa dijelaskan sambil praktik.

πŸ”— Materi terkait

πŸ“š Referensi