Lewati ke konten
AbyfineIntermedia
Hosting & Server

Nginx Reverse Proxy untuk Beberapa Aplikasi

Satu server untuk beberapa aplikasi: atur virtual host, teruskan header yang benar, tangani WebSocket, dan pasang TLS di Nginx reverse proxy.

A4 menit baca
Bagikan
Ilustrasi artikel: Nginx Reverse Proxy untuk Beberapa Aplikasi

Satu server sering harus melayani lebih dari satu aplikasi: situs utama, panel admin, API, dan mungkin aplikasi internal. Membuka port berbeda untuk masing-masing memang bisa, tetapi alamat dengan nomor port tidak nyaman dan sering ditolak oleh aturan jaringan.

Reverse proxy menyelesaikan itu. Nginx menerima permintaan di port 80 dan 443, lalu meneruskannya ke aplikasi yang tepat berdasarkan nama domain atau path.

Yang perlu diingat

  • Setiap aplikasi sebaiknya punya blok server sendiri agar konfigurasi mudah dirawat.
  • Header Host, X-Real-IP, dan X-Forwarded-Proto wajib benar agar aplikasi membangun URL dan log dengan tepat.
  • Galat 502 hampir selalu berasal dari aplikasi di belakang proxy, bukan dari Nginx itu sendiri.

Satu server sering harus melayani lebih dari satu aplikasi: situs utama, panel admin, API, dan mungkin aplikasi internal. Membuka port berbeda untuk masing-masing memang bisa, tetapi alamat dengan nomor port tidak nyaman dan sering ditolak oleh aturan jaringan.

Reverse proxy menyelesaikan itu. Nginx menerima permintaan di port 80 dan 443, lalu meneruskannya ke aplikasi yang tepat berdasarkan nama domain atau path.

Peran reverse proxy

Reverse proxy berada di depan aplikasi. Ia bisa mengakhiri TLS, menambahkan header, membatasi ukuran unggahan, dan mencatat akses di satu tempat. Aplikasi di belakangnya cukup mendengarkan di localhost atau port internal.

Karena semua trafik masuk lewat satu titik, konfigurasi keamanan dan sertifikat menjadi lebih mudah dirawat. Namun titik yang sama juga menjadi tempat kesalahan berdampak luas: satu aturan salah bisa membuat semua aplikasi tidak bisa diakses.

Satu blok server per aplikasi

Setiap domain mendapat blok server sendiri. Di dalamnya, server_name menentukan domain yang dilayani, dan location / menentukan ke mana permintaan diteruskan. Untuk aplikasi yang berjalan di port 3000, arahnya ke http://127.0.0.1:3000.

Perhatikan garis miring di akhir proxy_pass. Perbedaan satu karakter bisa mengubah path yang diterima aplikasi. Uji dengan halaman yang mencetak URL, jangan menebak dari dokumentasi. Jika aplikasi berada di subpath, biasanya lebih aman menangani prefiks di sisi aplikasi daripada mengandalkan penulisan ulang path yang rumit.

server {
    listen 443 ssl;
    server_name app.example.com;
    client_max_body_size 20m;
    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-Proto $scheme;
    }
}

Header yang wajib diteruskan

Aplikasi perlu tahu permintaan asli datang dari mana dan dengan skema apa. Tanpa header yang benar, log menunjukkan semua pengunjung sebagai 127.0.0.1, pengalihan kembali ke HTTP, dan aplikasi mengira koneksi tidak aman.

  • Host agar aplikasi membangun tautan dengan domain yang tepat.
  • X-Real-IP dan X-Forwarded-For agar alamat klien terbaca.
  • X-Forwarded-Proto agar aplikasi tahu koneksi aslinya HTTPS.

Jangan percaya header ini begitu saja dari internet. Pastikan hanya proxy yang boleh mengisinya, dan konfigurasikan aplikasi untuk membaca header dari alamat proxy yang dikenal.

Untuk aplikasi yang memakai beberapa domain, hindari menyalin blok besar. Gunakan include untuk bagian yang sama, tetapi jangan terlalu jauh sampai alur konfigurasi sulit dibaca. Keseimbangan antara ringkas dan jelas lebih penting daripada menghilangkan semua pengulangan.

WebSocket dan respons panjang

Aplikasi real-time membutuhkan koneksi yang tetap terbuka. Tambahkan header Upgrade dan Connection pada lokasi yang memakai WebSocket, lalu sesuaikan proxy_read_timeout. Tanpa itu, koneksi terputus setiap beberapa detik dan aplikasi terus mencoba menyambung ulang.

Untuk unduhan besar atau streaming, matikan buffering pada lokasi tertentu agar respons tidak tertahan di proxy. Sebaliknya, buffering tetap berguna untuk aplikasi biasa karena membantu klien lambat. Atur per lokasi, bukan global.

Batasi juga ukuran body dan waktu tunggu. Unggahan besar yang tidak dibatasi bisa menghabiskan memori dan disk. Waktu tunggu yang terlalu panjang membuat koneksi mati menggantung, sedangkan terlalu pendek memutus proses yang sebenarnya masih berjalan.

TLS dan pengalihan

Sertifikat dipasang di reverse proxy, bukan di setiap aplikasi. Pengalihan dari HTTP ke HTTPS cukup dilakukan sekali di blok port 80. Hati-hati dengan pengalihan berulang: jika aplikasi juga memaksa HTTPS tetapi tidak tahu skema aslinya, pengunjung bisa terjebak dalam loop.

Perbarui sertifikat secara otomatis dan uji pembaruan, bukan hanya pemasangan pertama. Untuk lingkungan internal, sertifikat yang tidak tepercaya akan membuat WebSocket dan API gagal tanpa pesan yang jelas.

Kesalahan yang sering ditemui

Galat 502 biasanya berarti aplikasi tidak berjalan atau port-nya salah, bukan masalah Nginx. Galat 413 muncul saat unggahan melebihi batas. Halaman yang tampil tanpa gaya sering disebabkan path aset yang mengarah ke domain lain atau campuran HTTP dan HTTPS.

Catat setiap aplikasi beserta port dan domainnya di satu dokumen. Saat menambah layanan baru, dokumen itu mencegah benturan port dan memudahkan pengecekan. Konfigurasi yang rapi dimulai dari inventaris yang rapi.

Simpan konfigurasi di repositori, uji dengan nginx -t, dan muat ulang dengan lembut. Satu server dengan reverse proxy yang rapi lebih mudah dirawat daripada lima aplikasi yang masing-masing membuka port sendiri.

Layanan yang berkaitan

Jika Anda ingin menerapkan panduan ini tanpa mengerjakan sendiri, tim Abyfine bisa membantu.

nginxreverse proxytlswebsocket
Bagikan
Kembali ke blog
A
Tim Abyfine

Tim teknis Abyfine Intermedia di Cilacap. Kami membangun dan merawat website, server, serta jaringan untuk sekolah, UMKM, dan instansi sejak 2004.

Baca juga

Artikel terkait

Masih seputar hosting & server.

Semua artikel

Lanjutkan dari sini

Panduan sudah dibaca. Sekarang waktunya diterapkan.

Ceritakan kondisi server, jaringan, atau website Anda. Kami bantu susun langkah yang realistis tanpa membeli perangkat berlebihan.