Mengatur Reverse Proxy di ServBay: Memetakan Situs Intranet atau Remote ke Lokal untuk Pengembangan & Debugging

ServBay adalah lingkungan pengembangan Web lokal yang dirancang khusus untuk macOS, terintegrasi dengan berbagai bahasa pemrograman seperti PHP, Node.js, Python, Go, Java, serta database seperti MySQL, PostgreSQL, MongoDB, dan Redis. Selain untuk hosting kode proyek lokal, ServBay juga menawarkan fitur reverse proxy yang powerful. Melalui reverse proxy, Anda dapat dengan mudah memetakan situs web yang terletak di dalam jaringan intranet, virtual machine, container, bahkan server remote ke lingkungan ServBay lokal Anda, sehingga proses pengembangan, debugging, dan akses menjadi lebih sederhana.

Dokumen ini akan menjelaskan secara detail bagaimana mengatur reverse proxy di ServBay, membantu Anda memproxy situs dari intranet atau alamat yang dapat diakses lainnya ke lokal untuk manajemen terpusat dan pengembangan/debugging yang efisien.

Ringkasan

Server reverse proxy menerima permintaan dari klien (seperti browser Anda) dan meneruskannya ke satu atau beberapa server backend—dalam hal ini situs intranet atau remote yang ingin Anda proxy. ServBay memanfaatkan server Web internalnya (Caddy atau Nginx) untuk mewujudkan fitur ini.

Dalam skenario pengembangan lokal, keunggulan utama reverse proxy meliputi:

• Satu Titik Akses Terpusat: Akses semua sumber daya internal maupun eksternal melalui domain lokal ServBay, tanpa harus mengingat alamat IP atau port yang rumit.
• Konfigurasi SSL Mudah: Manfaatkan fitur manajemen SSL ServBay (seperti ServBay CA atau ACME) untuk menyediakan akses HTTPS ke situs proxy, meskipun situs backend hanya mendukung HTTP.
• Debugging Lokal Mudah: Lakukan proses debug aplikasi web remote atau intranet langsung melalui browser di komputer Anda.
• Melewati Batasan Jaringan: Dalam beberapa kasus, Anda dapat mengakses sumber daya perusahaan atau jaringan terbatas secara lokal (selama mesin ServBay dapat terhubung ke alamat tujuan).

Persyaratan Awal

Sebelum mulai mengatur reverse proxy, pastikan Anda telah memenuhi syarat berikut:

1. ServBay Sudah Terpasang & Berjalan: Pastikan aplikasi ServBay sudah terinstall dan aktif di sistem macOS Anda.
2. Situs Target Dapat Diakses: Situs web intranet atau remote yang ingin Anda proxy harus sudah berjalan normal dan mesin macOS yang menjalankan ServBay dapat langsung mengakses IP/domain dan port situs tersebut melalui jaringan. Contoh: Jika target adalah 192.168.1.100:8080, pastikan macOS Anda bisa ping ke 192.168.1.100 dan bisa mengunjungi 192.168.1.100:8080.

Langkah-langkah Menambahkan Situs Reverse Proxy

Berikut adalah langkah-langkah detail untuk mengonfigurasi situs reverse proxy di ServBay:

Langkah 1: Buka Antarmuka Manajemen ServBay

Temukan ikon ServBay pada folder aplikasi macOS Anda, lalu klik dua kali untuk menjalankan aplikasi.

Langkah 2: Navigasi ke Manajemen Situs

Setelah ServBay aktif, Anda akan melihat tampilan utama. Pada menu navigasi sebelah kiri, klik Website. Ini akan membawa Anda ke halaman manajemen situs ServBay, tempat Anda dapat mengelola semua situs lokal maupun reverse proxy.

Langkah 3: Tambahkan Situs Baru

Di bagian bawah halaman manajemen situs, cari dan klik tombol +. Setelah diklik, bagian kanan akan menampilkan formulir baru untuk mengonfigurasi situs.

Langkah 4: Atur Pengaturan Reverse Proxy Situs

Pada formulir situs baru, isi informasi penting berikut untuk mendefinisikan perilaku reverse proxy:

1. Nama (Name): Beri nama yang mudah dikenali untuk situs reverse proxy Anda. Contoh: Internal Backend Proxy.
2. Domain: Masukkan domain yang ingin Anda gunakan untuk mengakses situs proxy secara lokal, contoh: backend.servbay.demo atau proxy.to.local. ServBay biasanya akan secara otomatis menambahkan domain pengembangan lokal ini ke file hosts sistem Anda, sehingga diarahkan ke 127.0.0.1 atau ::1.
3. Protokol (Protocol): Pilih protokol yang didukung situs. Umumnya pilih HTTP/HTTPS untuk mendukung dua-duanya. ServBay akan menangani SSL sesuai pengaturan Anda.
4. Metode Permintaan Sertifikat SSL (SSL Certificate Request Method):
   • ServBay CA (disarankan untuk pengembangan lokal): ServBay akan secara otomatis menghasilkan dan mengelola sertifikat SSL menggunakan CA internalnya. Agar HTTPS tidak memunculkan peringatan sertifikat, Anda harus mempercayai sertifikat root ServBay CA di browser atau sistem Anda.
   • ACME (Let's Encrypt): Pilih jika domain Anda bersifat publik dan dapat diakses dari Internet untuk mendapatkan sertifikat SSL gratis dari Let's Encrypt.
   • Manual: Jika sudah punya file sertifikat SSL sendiri (.crt, .key, .ca-bundle), pilih opsi ini untuk upload & atur manual. Untuk pengembangan lokal dan proxy ke intranet, sangat disarankan memakai ServBay CA.
5. Tipe Website: Pilih Reverse Proxy. Ini adalah pengaturan penting agar fungsi proxy berjalan.
6. Target Proxy: Masukkan alamat akses lengkap situs intranet atau remote yang ingin Anda proxy. Bisa berupa format IP:Port atau URL lengkap dengan protokol.
   • Contoh 1 (IP:Port): 192.168.1.100:8080
   • Contoh 2 (URL dengan protokol): http://192.168.1.100:8080
   • Contoh 3 (Nama host intranet): backend.internal:8443 (servbay harus bisa resolve nama host ini)
   • Contoh 4 (URL remote): https://api.example.com Pastikan alamat yang dimasukkan di sini bisa diakses langsung dari mesin ServBay.

Langkah 5: Simpan Konfigurasi

Setelah semua informasi terisi lengkap, klik tombol Add di bagian bawah formulir. ServBay akan otomatis menyimpan pengaturan Anda dan membuat aturan reverse proxy yang relevan pada server Web (Caddy atau Nginx).

Jika sukses, situs reverse proxy baru akan muncul di daftar website.

Langkah 6: Akses Situs Reverse Proxy

Setelah konfigurasi selesai, Anda sudah dapat mengakses situs intranet atau remote tadi melalui domain yang Anda tentukan pada Langkah 4 (misal, proxy.to.local atau backend.servbay.demo) melalui browser.

Jika memakai ServBay CA dan memilih HTTPS, kemungkinan browser Anda akan menampilkan peringatan sertifikat pada akses pertama (jika root CA belum dipercaya).

Langkah 7: Operasi Cepat Website

ServBay menyediakan tombol operasi cepat untuk setiap situs yang memudahkan pengelolaan, antara lain:

1. Buka Root Directory di IDE: Untuk situs reverse proxy fitur ini biasanya tidak relevan karena tidak ada folder lokal.
2. Buka Situs di Browser: Membuka situs secara cepat di browser default Anda.
3. Lihat Log Website: Lihat catatan akses dan error log dari server Web ServBay (Caddy/Nginx)—sangat berguna untuk debugging.
4. Pause/Start Website: Aktifkan/nonaktifkan konfigurasi reverse proxy sementara.
5. Hapus Situs: Hapus konfigurasi reverse proxy dari ServBay.

FAQ & Solusi Masalah

Q: Situs tidak dapat diakses, browser menampilkan error.

• Cek Status ServBay: Pastikan ServBay berjalan, dan server Web (Caddy/Nginx) sudah hidup.
• Cek Resolusi Domain: Cek kembali domain yang Anda masukkan di browser sudah benar dan sudah resolve ke IP lokal ServBay (ServBay biasanya otomatis mengubah file hosts, tetapi sebaiknya dicek manual juga).
• Periksa Log Website ServBay: Klik "Lihat Log" pada daftar situs untuk melihat log server Web ServBay. Di sini Anda bisa mencari info permintaan klien, upaya koneksi ke target proxy, atau pesan error lain—cara tercepat untuk menemukan masalah.
• Periksa Firewall/Security Software: Pastikan firewall macOS atau aplikasi keamanan tidak menghalangi ServBay mendengarkan port 80/443, atau memblokir koneksi ServBay ke target proxy.

Q: Mesin ServBay bisa akses target proxy, tapi akses via domain ServBay di browser tetap error.

• Cek Format Target Proxy: Pastikan alamat "Target Proxy" di ServBay sudah benar dan mesin ServBay memang bisa langsung mengaksesnya. Tes ping/curl dari terminal ServBay misal curl [alamat target] untuk uji koneksi.
• Cek Konfigurasi Server Target: Beberapa server backend mengecek header Host. ServBay secara default meneruskan header Host dari klien ke backend. Jika server backend Anda butuh header Host khusus (misal domain intranet tertentu) sedangkan Anda memakai domain berbeda di ServBay, bisa terjadi masalah. Pada pengaturan lanjutan ServBay, Anda bisa menyesuaikan pengiriman header (perlu edit manual Caddyfile atau Nginx config, di luar UI dasar).
• Cek Firewall Server Target: Walau mesin ServBay bisa mengakses IP & port target, server target bisa saja hanya menerima koneksi dari IP tertentu (contoh internal only). Pastikan mesin ServBay diizinkan di firewall target.

Q: Akses HTTPS via reverse proxy muncul peringatan sertifikat.

• Memakai ServBay CA: Ini memang normal, karena ServBay CA adalah lembaga sertifikasi privat yang tidak dipercaya secara default oleh browser. Anda perlu menginstal dan mempercayai sertifikat root ServBay CA pada sistem operasi atau browser Anda (instal langsung melalui menu "Setting").
• Memakai ACME (Let's Encrypt): Pastikan domain sudah resolve ke IP ServBay dan proses request sertifikat ACME sudah dilakukan melalui panel manajemen SSL ServBay. Cek log ServBay untuk detail error selama proses ACME.

Q: Bagaimana memproxy ke target dengan header/cookie khusus?

Konfigurasi reverse proxy dasar ServBay akan meneruskan sebagian besar info permintaan klien. Untuk skenario kompleks—misal menambah header request custom, mengubah header response, mengatur cookie khusus, atau rewrite path—Anda harus masuk ke pengaturan lanjutan, edit manual Caddyfile/Nginx untuk membuat aturan reverse proxy yang lebih detail. Anda perlu memahami syntax konfigurasi Caddy atau Nginx untuk tujuan ini.

Kesimpulan

Dengan fitur reverse proxy di ServBay, Anda dapat dengan mudah mengintegrasikan situs Web dari intranet, VM, container, atau server remote ke lingkungan pengembangan lokal Anda. Fitur ini tidak hanya menghadirkan akses terpusat dan praktis, tetapi juga menyederhanakan proses debugging dan pengaturan SSL. Ikuti langkah-langkah di atas untuk dapat dengan cepat mengatur dan memakai proxy situs melalui ServBay. Ditambah dengan fitur log dan troubleshooting yang kuat, Anda bisa memastikan situs proxy tetap berjalan lancar dan peningkatan efisiensi pengembangan Anda.