FAQ ServBay

Saat menggunakan lingkungan pengembangan web lokal ServBay, para developer mungkin menemui beberapa kendala. Dokumen ini bertujuan menjawab dua pertanyaan umum: cara melakukan upgrade ServBay Runtime dan cara mengatasi kendala akses situs lokal akibat penggunaan alat proxy seperti ClashX Pro.

Bagaimana Cara Upgrade ServBay Runtime?

ServBay Runtime adalah komponen inti dari ServBay yang sangat penting untuk menjaga stabilitas operasional ServBay dan layanan-layanan yang dikelolanya. Setiap kali tersedia versi terbaru, ServBay akan menampilkan pemberitahuan upgrade saat startup. Rutin memperbarui Runtime akan meningkatkan kinerja dan stabilitas ServBay serta memastikan kompatibilitasnya.

Untuk melakukan upgrade ServBay Runtime, ikuti langkah-langkah berikut:

1. Buka aplikasi ServBay.
2. Pada panel navigasi di sisi kiri jendela ServBay, pilih Paket > Layanan Umum.
3. Di panel kanan, temukan entri ServBay Runtime.
4. Jika tersedia pembaruan untuk ServBay Runtime, akan tampil notifikasi upgrade berwarna kuning atau tombol upgrade. Klik tombol upgrade berwarna kuning tersebut.
5. ServBay akan mulai mengunduh dan memasang versi Runtime terbaru. Harap tunggu hingga proses upgrade selesai dengan sabar.

Setelah upgrade selesai, ServBay Runtime akan berjalan dengan versi terbaru, sehingga menawarkan stabilitas dan kinerja yang lebih baik.

Mengapa Setelah Menggunakan ClashX Pro (atau Alat Proxy Lain) Situs Lokal ServBay Tidak Dapat Diakses?

Banyak developer menggunakan ServBay untuk kebutuhan pengembangan dan pengujian secara lokal, biasanya dengan mengonfigurasi domain khusus seperti servbay.demo, myproject.servbay.demo, dan seterusnya. Umumnya, domain-domain ini diarahkan ke alamat loopback lokal 127.0.0.1.

Saat Anda menggunakan ClashX Pro atau beberapa alat VPN/proxy lain (seperti Surge, Quantumult X, dll.), alat ini dapat memaksa proses resolusi semua domain melalui server proxy mereka dengan cara meredireksi atau mengintersepsi permintaan DNS. Tindakan ini melewati proses resolusi DNS sistem operasi dan pengaturan file hosts lokal (yang biasanya dijadikan acuan oleh domain lokal ServBay), sehingga domain lokal yang Anda konfigurasikan di ServBay tidak bisa diresolusikan ke IP lokal dan akhirnya situs lokal Anda menjadi tidak dapat diakses.

Untuk mengatasi masalah ini, Anda perlu menambahkan aturan pada alat proxy yang menandakan supaya domain lokal Anda tidak diproxy-kan atau permintaan DNS-nya tidak dicampuri. Pengaturan ini biasanya tersedia lewat fitur "bypass proxy", "ignore proxy", "whitelist" atau "exclude list".

Sebagai contoh, berikut langkah-langkah konfigurasi pada ClashX Pro:

1. Buka aplikasi ClashX Pro.

2. Temukan ikon ClashX Pro di menu bar macOS, klik, kemudian pilih Pengaturan Lainnya.

3. Di jendela pengaturan yang terbuka, navigasikan ke tab Umum.

4. Cari kotak isian bernama Abaikan pengaturan proxy untuk host dan domain berikut (atau nama serupa).

5. Tambahkan domain lokal Anda ke daftar ini. Guna mengakomodasi domain lokal umum ServBay, disarankan mencantumkan localhost, 127.0.0.1, serta domain spesifik atau wildcard domain yang Anda gunakan di ServBay. Misal, jika memakai akhiran domain .servbay.demo, tambahkan juga *.servbay.demo. Beberapa entri biasanya dipisahkan dengan koma , atau baris baru. Contoh konfigurasi:

   localhost, 127.0.0.1, *.servbay.demo, yourproject.servbay.demo

6. Simpan pengaturan dan, jika diminta oleh ClashX Pro, lakukan pemuatan ulang atau terapkan konfigurasi agar perubahan berlaku.

(Ilustrasi: Konfigurasi domain/host yang diabaikan oleh proxy di ClashX Pro)

Setelah konfigurasi selesai, ClashX Pro tidak akan lagi mengintervensi proses resolusi domain lokal tersebut, sehingga Anda dapat kembali mengakses situs ServBay secara normal. Jika masalah belum terselesaikan, pastikan domain tersebut juga sudah benar diatur pada pengaturan Website ServBay dan layanan pendukung seperti Caddy atau Nginx sudah berjalan dengan baik. Anda juga bisa menggunakan perintah terminal seperti ping yourproject.servbay.demo atau dig yourproject.servbay.demo untuk mendiagnosis proses resolusi domain.