Linux : Instalasi dan Setup Nginx Produksi
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, dansystemctl 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.autoberarti 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-enabledyang menunjuk berkas disites-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-enabledmembuat 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
755untuk direktori dan644untuk berkas adalah titik awal yang aman. - Jangan menampilkan konfigurasi hasil
nginx -Tdi 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 -tsebelum reload, tanpa kecuali. Reload pada konfigurasi salah berjalan diam-diam dengan konfigurasi lama.- Status layanan bukan bukti isi halaman. Yang membuktikan adalah
curlyang 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
- Linux : Nginx Dasar dan Virtual Host β lanjutan langsung: cara nginx memilih situs dan lokasi.
- Linux : Praktikum Virtual Host Nginx dan Diagnosa Situs yang Salah Tampil β lima lapis bukti saat situs salah tampil.
- Linux : Nginx Reverse Proxy, TLS, dan Diagnosa 502 β praktikum meneruskan permintaan ke aplikasi di belakang nginx.
- Debian : Konfigurasi Web Server (Apache) β pembanding bila di server yang sama sudah ada Apache.
- Linux : Firewall Dasar dengan nftables β membuka hanya port yang memang perlu.
π Referensi
- Dokumentasi nginx β Getting Started dan Beginner's Guide: https://nginx.org/en/docs/beginners_guide.html
- Dokumentasi nginx β Controlling nginx (
-t,-T,-s): https://nginx.org/en/docs/control.html - Dokumentasi nginx β Core Module (
worker_processes,worker_connections): https://nginx.org/en/docs/ngx_core_module.html - Paket nginx resmi: https://nginx.org/packages/
- Ubuntu Server Documentation β HTTP servers: https://documentation.ubuntu.com/server/how-to/web-services/