Nginx Proxy Manager di VPS: Ulasan dan Panduan Pengaturan

NPM vs Caddy vs Traefik: Reverse Proxy Mana yang Cocok untuk VPS Anda

Ketiga alat ini terbagi menurut empat sumbu yang menentukan pilihan: bagaimana Anda mengonfigurasinya, bagaimana mereka menangani HTTPS, bagaimana mereka menskalakan dengan jumlah service, dan berapa banyak RAM yang mereka gunakan saat idle. Berikut perbandingannya.

Angka RAM idle adalah pengamatan perkiraan dari salah satu perbandingan 2026, bukan persyaratan tetap. Penggunaan sebenarnya bervariasi menurut versi image, fitur yang diaktifkan, lalu lintas, dan logging.

Kriteria peralihan mengikuti langsung dari tabel tersebut. Jika Anda menginginkan dasbor dan menjalankan segelintir service yang tidak sering berubah, NPM adalah alat yang tepat. Jika Anda lebih menyukai konfigurasi sebagai kode, menginginkan footprint terkecil, atau menghargai penyediaan dan perpanjangan HTTPS otomatis dari Caddy tanpa pengaturan ACME, gunakan Caddy. Saya sendiri memilih Caddy pada deployment situs tunggal karena penanganan SSL-nya otomatis dan Caddyfile-nya pendek. Jika Anda sering menambah, menghapus, atau men-deploy ulang container, auto-discovery berbasis label dari Traefik berarti Anda berhenti mendaftarkan setiap host baru secara manual.

Ada juga Nginx polos dengan Certbot, yang lebih disukai sebagian administrator untuk kontrol yang presisi atau deployment non-Docker. Certbot dapat mengotomatiskan perpanjangan sertifikat, tetapi Anda tetap mengelola routing virtual-host dan konfigurasi Nginx sendiri. Jika alasan utama Anda mempertimbangkan NPM adalah menghindari konfigurasi proxy manual, Nginx polos kemungkinan bukan pilihan yang lebih cocok.

Satu catatan tentang pilihan ini: perbandingan byte-guard menempatkan Caddy sebagai opsi paling ringan dalam perbandingan tersebut, dan untuk pengaturan host tunggal 2026 yang baru itu adalah pilihan yang masuk akal. Caddy unggul dalam hal lebih ringan dari NPM, tetapi jika Anda secara khusus menginginkan GUI, itu bukan pilihan terbaik Anda.

Untuk perbandingan berdampingan yang lebih mendalam tentang mesin di baliknya, lihat perbandingan Caddy vs Nginx di VPS.

Prasyarat: apa yang Anda perlukan

Sebelum Anda melakukan deployment, siapkan hal-hal ini. Ini daftar pendek, tetapi lewati satu item saja dan langkah sertifikat akan gagal nanti.

• Sebuah VPS dengan Docker dan Docker Compose terinstal (Ubuntu 22.04 LTS atau Debian 12 tidak masalah).
• Sebuah nama domain, dengan record DNS A (dan AAAA jika Anda menggunakan IPv6) yang mengarah ke IP publik VPS Anda.
• Akses SSH ke VPS.
• Port 80 dan 443 terbuka ke internet pada firewall Anda.
• Port 81 hanya dapat dijangkau oleh Anda, tidak terbuka untuk publik (dibahas di bagian keamanan).

Menyiapkan Nginx Proxy Manager di VPS Anda dengan Docker Compose

Bagian ini men-deploy NPM menggunakan Docker Compose. Begitu record DNS Anda teresolusi ke VPS, pengaturan container itu sendiri cepat, meskipun propagasi DNS dan penerbitan sertifikat mungkin memakan waktu lebih lama.

Pengaturan ini menggunakan satu file Docker Compose dan satu perintah sekali jalan untuk membuat jaringan Docker bersama. Buat sebuah direktori, buat jaringan, tambahkan file docker-compose.yml di bawah ini, lalu jalankan container.

Pertama, buat jaringan Docker bersama:

docker network create proxy

Kemudian buat file docker-compose.yml berkas:

# docker-compose.yml
services:
  npm:
    image: 'jc21/nginx-proxy-manager:<PATCHED_VERSION>'
    restart: unless-stopped
    ports:
      - '80:80'                 # public HTTP
      - '443:443'               # public HTTPS
      - '127.0.0.1:81:81'       # admin UI, reachable only from the VPS itself
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
    networks:
      - proxy
networks:
  proxy:
    external: true

Lampirkan setiap container backend yang harus dijangkau NPM berdasarkan nama service ke jaringan eksternal proxy yang sama. Ini memungkinkan NPM meresolusi container berdasarkan nama service-nya tanpa mempublikasikan port aplikasi backend di VPS.

Cadangkan kedua ./data dan ./letsencrypt sebelum melakukan upgrade. Direktori data berisi basis data NPM dan konfigurasi yang dihasilkan, sedangkan direktori Let's Encrypt berisi material sertifikatnya.

Beberapa hal tentang file ini. Image ini secara default menggunakan basis data SQLite yang tersimpan dalam volume ./data . Itu adalah backend default dan tepat untuk sebagian besar deployment VPS tunggal. Jika Anda membutuhkan basis data eksternal, NPM mendukung MariaDB/MySQL dan PostgreSQL, yang berarti menambahkan service basis data dan variabel environment yang sesuai. Untuk satu VPS, SQLite tetap menjadi default paling sederhana kecuali Anda memiliki alasan yang jelas untuk memindahkan basis data keluar dari volume data. Kebijakan restart: unless-stopped berarti NPM kembali menyala jika VPS reboot, yang memang Anda inginkan untuk service yang berada di depan segalanya.

Jalankan dan pastikan ia berjalan:

docker compose up -d
docker compose ps

Output yang diharapkan: container npm dengan status Up, port 80 dan 443 dipetakan secara publik, dan port 81 hanya terikat ke 127.0.0.1. Start pertama memakan waktu beberapa menit sementara NPM menghasilkan kunci JWT, menginisialisasi basis data, dan membuat pengguna admin default. Dokumentasi pengaturan resmi menjelaskan urutan first-run ini.

Buat tunnel SSH dari komputer lokal Anda sebelum membuka antarmuka admin:

ssh -L 8181:127.0.0.1:81 user@your-vps

Kemudian buka http://127.0.0.1:8181 di browser Anda. Pada instalasi baru, masuk dengan [email protected] dan changeme, lalu segera ganti email dan kata sandi default. Jangan buat dasbor dapat dijangkau publik selama kredensial default masih aktif.

Setelah Anda mengubah kredensial admin, tambahkan proxy host pertama Anda:

1. Di dasbor, buka Hosts, lalu Proxy Hosts, lalu Add Proxy Host.
2. Atur Domain Name ke subdomain Anda (misalnya cloud.example.com).
3. Atur Forward Hostname / IP ke nama container backend atau IP, dan Forward Port ke port tempat ia mendengarkan.
4. Simpan. Proxy host muncul dalam daftar, dan lalu lintas ke subdomain tersebut kini mencapai container Anda.

Jika Anda menjalankan UI manajemen Docker bersama ini, pola yang sama berlaku: arahkan subdomain ke alat manajemen container dengan cara yang sama, dan lakukan hal yang sama untuk stack pemantauan Prometheus dan Grafana yang ingin Anda tempatkan di belakang proxy.

Mengonfigurasi HTTPS Otomatis untuk Subdomain

Bagian ini memberi Anda sertifikat Let's Encrypt yang valid dan diperpanjang otomatis untuk subdomain Anda. Prasyaratnya adalah yang sering menjebak orang: record DNS A untuk subdomain tersebut harus sudah mengarah ke VPS Anda, dan port 80 harus dapat dijangkau dari internet, karena Let's Encrypt memverifikasi domain dengan menghubunginya kembali.

Dengan proxy host telah dibuat, minta sertifikatnya:

1. Sunting proxy host, buka tab SSL tab.
2. Di bawah Sertifikat SSLpilih Request a new SSL Certificate.
3. Aktifkan Force SSL dan HTTP/2 Support. Aktifkan HSTS hanya setelah memastikan HTTPS berfungsi dengan benar, karena browser dapat menyimpan kebijakan tersebut di cache dan mempersulit pemulihan dari kesalahan konfigurasi sertifikat atau proxy.
4. Setujui ketentuan Let's Encrypt dan simpan.

Secara default, NPM menggunakan challenge HTTP-01 untuk nama non-wildcard, memvalidasi setiap hostname yang diminta melalui port 80. Sebuah sertifikat dapat memuat beberapa nama non-wildcard, tetapi HTTP-01 tidak dapat menerbitkan sertifikat wildcard. Nama wildcard seperti *.example.com memerlukan challenge DNS-01 dengan penyedia DNS yang didukung. Untuk pengaturan normal satu subdomain per service, HTTP-01 adalah semua yang Anda butuhkan, dan perpanjangan berlangsung otomatis.

Menentukan Ukuran VPS Anda untuk Nginx Proxy Manager

NPM sendiri ringan; pertanyaan penentuan ukuran sebenarnya tentang NPM ditambah service yang berada di belakangnya. Footprint idle proxy jarang menjadi kendala. Sebuah instance Nextcloud atau blog Ghost akan menggunakan lebih banyak sumber daya daripada proxy itu sendiri.

Berikut cara tier-tier tersebut bekerja dalam praktik:

• Baseline praktis minimum: 1 GB RAM, 1 vCPU, dan 10 GB penyimpanan. Satu panduan penentuan ukuran pihak ketiga menggunakan baseline yang sama, tetapi perlakukan sebagai panduan perencanaan, bukan persyaratan resmi NPM. Ini cukup untuk NPM, sistem operasi, dan beberapa service ringan, tetapi menyisakan ruang gerak yang terbatas.
• Nyaman: 2 GB RAM, 1 vCPU, 20 GB penyimpanan. NPM ditambah tiga hingga lima service dengan ruang untuk bernapas. Ini adalah titik ideal bagi sebagian besar self-hoster.
• Naik tingkat: 4 GB RAM, 2 vCPU. Untuk delapan hingga dua belas service, atau pengaturan dengan lalu lintas yang signifikan di mana Anda menginginkan ruang gerak CPU untuk terminasi TLS.

Angka yang Anda jadikan patokan ukuran adalah jumlah dari aplikasi yang di-proxy, bukan NPM. Jumlahkan footprint RAM dari service yang ingin Anda jalankan, tambahkan overhead idle kecil dari proxy di atasnya, lalu pilih tier di atas angka itu dengan margin.

Menentukan ukuran server adalah bagian yang mudah. Menjalankan NPM tetap berarti menyediakan VPS, menginstal Docker, menarik image, dan menjalani pengaturan first-run itu. Jika Anda lebih suka melewati langkah-langkah penyediaan, marketplace Cloudzy memiliki deployment Nginx Proxy Manager sekali klik di VPS NVMe. Ini menyalakan container di server yang baru, sehingga Anda langsung menuju dasbor dan proxy host pertama Anda. Bagaimanapun, tier ukuran di atas adalah patokan yang Anda sediakan.

Pertanyaan yang Sering Diajukan