Menetapkan Proksi Terbalik di ServBay: Pemetaan Laman Web Intranet atau Jauh ke Tempatan untuk Pembangunan & Nyahpepijat

ServBay ialah persekitaran pembangunan web tempatan yang direka khusus untuk macOS, mengintegrasikan pelbagai persekitaran bahasa (PHP, Node.js, Python, Go, Java) serta pangkalan data seperti MySQL, PostgreSQL, MongoDB, dan Redis. Selain daripada mengehoskan projek kod tempatan secara langsung, ServBay turut menyediakan fungsi proksi terbalik yang berkuasa. Melalui proksi terbalik, anda boleh memetakan laman web yang terletak di intranet, mesin maya, kontena atau malah pelayan jauh ke persekitaran ServBay tempatan anda, memudahkan proses pembangunan, nyahpepijat dan akses.

Panduan ini menerangkan secara terperinci cara menyediakan proksi terbalik di ServBay, membantu anda memproksi laman web di intranet atau alamat rangkaian lain ke sistem tempatan untuk pengurusan berpusat dan pembangunan serta nyahpepijat yang efisien.

Ringkasan

Proksi terbalik menerima permintaan daripada klien (contohnya pelayar web anda) dan meneruskannya ke satu atau lebih pelayan belakang (dalam kes ini, laman web intranet atau jauh yang anda ingin proksikan). ServBay menggunakan pelayan web terbina dalamnya (Caddy atau Nginx) untuk menyediakan fungsi ini.

Dalam senario pembangunan tempatan, kelebihan utama menetapkan proksi terbalik ialah:

• Akses berpusat: Akses semua sumber dalaman atau luaran melalui nama domain ServBay tempatan; tidak perlu mengingat alamat IP dan port yang rumit.
• Konfigurasi SSL yang dipermudahkan: Manfaatkan pengurusan SSL ServBay (ServBay CA atau ACME) untuk menawarkan akses HTTPS walaupun laman web belakang hanya menyokong HTTP.
• Nyahpepijat tempatan: Nyahpepijat aplikasi web intranet atau jauh dengan mudah melalui pelayar tempatan.
• Mengelak sekatan rangkaian: Dalam sesetengah keadaan, akses sumber intranet syarikat atau rangkaian terhad lebih mudah dari persekitaran pembangunan tempatan (selagi ServBay boleh sampai ke alamat sasaran).

Prasyarat

Sebelum anda mula menetapkan proksi terbalik, pastikan syarat-syarat berikut dipenuhi:

1. ServBay telah dipasang dan berjalan: Pastikan aplikasi ServBay telah dipasang dengan betul di sistem macOS anda dan sedang berjalan.
2. Laman web sasaran boleh diakses: Laman web intranet atau jauh yang ingin anda proksikan sudah dirangkaikan dan boleh diakses secara langsung oleh komputer macOS yang menjalankan ServBay (sama ada melalui IP/domain dan port). Contohnya, jika anda ingin mengakses 192.168.1.100:8080, pastikan macOS anda boleh melakukan ping ke 192.168.1.100 dan mengakses 192.168.1.100:8080.

Langkah Menambah Laman Web Proksi Terbalik

Berikut adalah langkah terperinci untuk mengkonfigurasi laman web proksi terbalik dalam ServBay:

Langkah 1: Buka Antara Muka Pengurusan ServBay

Cari ikon ServBay dalam folder aplikasi macOS anda, dan klik dua kali untuk melancarkan aplikasi.

Langkah 2: Navigasi ke Pengurusan Laman Web

Selepas pelancaran, anda akan lihat antara muka utama ServBay. Di menu navigasi sebelah kiri, klik pada Laman Web. Anda akan dibawa ke halaman pengurusan laman web, di mana anda boleh mengurus semua laman web tempatan dan proksi terbalik.

Langkah 3: Tambah Laman Web Baharu

Di bahagian bawah halaman pengurusan laman web, cari dan klik butang +. Selepas klik, borang baharu akan dipaparkan di sebelah kanan untuk anda konfigurasi laman web yang ingin ditambah.

Langkah 4: Konfigurasi Tetapan Proksi Terbalik Laman Web

Dalam borang laman web baharu, isikan maklumat penting berikut untuk mendefinisikan tingkah laku proksi terbalik:

1. Nama (Name): Masukkan nama mudah kenal pasti untuk laman web proksi terbalik anda. Contoh: Internal Backend Proxy.
2. Domain: Masukkan nama domain untuk akses tempatan, contohnya backend.servbay.demo atau proxy.to.local. ServBay akan menambah domain ini ke fail hosts sistem secara automatik agar merujuk ke 127.0.0.1 atau ::1.
3. Protokol (Protocol): Pilih protokol yang disokong oleh laman web, biasanya HTTP/HTTPS. ServBay akan mengurus SSL secara automatik berdasarkan konfigurasi.
4. Kaedah Permohonan Sijil SSL (SSL Certificate Request Method):
   • ServBay CA (disyorkan untuk pembangunan tempatan): ServBay akan menggunakan CA terbina dalam untuk menjana dan mengurus sijil SSL secara automatik untuk domain anda. Anda perlu mempercayai CA ServBay dalam pelayar atau sistem bagi mengelakkan amaran sijil.
   • ACME (Let's Encrypt): Jika domain anda adalah domain awam yang boleh diakses melalui Internet, pilih pilihan ini untuk memohon sijil SSL percuma.
   • Manual: Jika anda sudah mempunyai fail sijil SSL (.crt, .key, .ca-bundle), pilih ini untuk muat naik dan konfigurasi secara manual. Pilihan ServBay CA adalah amat disarankan untuk pembangunan tempatan dan proksi sumber intranet.
5. Jenis Laman Web (Website Type): Pilih Proksi Terbalik (Reverse Proxy)—ini adalah tetapan utama untuk mengaktifkan ciri proksi.
6. Sasaran Proksi (Proxy Target): Masukkan alamat penuh laman web intranet atau jauh yang ingin diproksi. Boleh berupa IP:Port atau URL lengkap.
   • Contoh 1 (IP:Port): 192.168.1.100:8080
   • Contoh 2 (URL lengkap): http://192.168.1.100:8080
   • Contoh 3 (hostname intranet): backend.internal:8443 (dengan syarat host boleh dirujuk oleh ServBay)
   • Contoh 4 (URL jauh): https://api.example.com Pastikan alamat yang dimasukkan boleh dicapai terus oleh komputer ServBay.

Langkah 5: Selesai dan Simpan Konfigurasi

Setelah semua maklumat diisi, klik butang Tambah (Add) di bahagian bawah borang. ServBay akan menyimpan konfigurasi anda dan menjana aturan proksi terbalik bagi pelayan webnya (Caddy atau Nginx).

Jika berjaya, laman web proksi terbalik baharu anda akan terpapar dalam senarai laman web.

Langkah 6: Akses Laman Web Proksi Terbalik

Setelah selesai, anda boleh melayari laman web intranet atau jauh yang telah diproksi dengan menaip domain yang ditetapkan pada Langkah 4 (contoh: proxy.to.local atau backend.servbay.demo) di pelayar web anda.

Jika anda menggunakan ServBay CA dan HTTPS, anda mungkin perlu mengesahkan/menambah kepercayaan pada sijil akar ServBay CA apabila melayari buat pertama kali (jika belum ditandatangani sebagai dipercayai).

Langkah 7: Operasi Pantas Laman Web

ServBay menyediakan butang tindakan pantas bagi setiap laman untuk kemudahan pengurusan:

1. Buka direktori akar laman dengan IDE: Untuk proksi terbalik, fungsi ini mungkin tidak berguna kerana tiada akar direktori di tempatan.
2. Buka laman dalam pelayar: Membuka laman ini secara terus dalam pelayar lalai.
3. Lihat log laman: Paparan log akses & ralat pelayan web (Caddy/Nginx) untuk laman ini, amat berguna untuk nyahpepijat.
4. Jeda/Aktifkan laman: Mengaktifkan atau menyahaktifkan konfigurasi proksi terbalik secara sementara.
5. Padam laman: Mengalih keluar konfigurasi proksi terbalik ini dari ServBay.

Soalan Lazim & Penyelesaian (FAQ)

S: Laman web tidak boleh diakses, pelayar memaparkan ralat.

• Periksa status ServBay: Pastikan ServBay dan pelayan web (Caddy/Nginx) sedang berjalan.
• Periksa resolusi domain: Sahkan domain yang ditaip dalam pelayar adalah betul dan telah diarahkan ke IP tempatan ServBay (biasanya dikendalikan ServBay secara automatik; boleh disemak dalam fail hosts).
• Lihat log laman ServBay: Klik "Lihat Log" dalam senarai laman untuk mendapatkan maklumat butiran. Di sini terdapat log permintaan klien, percubaan sambungan ke sasaran proksi serta ralat, sangat berguna untuk mencari punca masalah.
• Periksa firewall/perisian keselamatan: Pastikan firewall macOS anda atau sebarang perisian keselamatan tidak menghalang ServBay daripada mendengar pada port 80/443 atau menyambung ke alamat proksi sasaran.

S: Mesin ServBay boleh akses sasaran, tetapi akses melalui domain ServBay dari pelayar gagal.

• Periksa format sasaran proksi: Pastikan alamat "Sasaran Proksi" dikonfigurasi dengan betul dalam ServBay, dan komputer ServBay benar-benar boleh mengakses alamat tersebut. Cuba gunakan curl [alamat sasaran proksi] di terminal ServBay untuk menguji.
• Periksa konfigurasi pelayan belakang: Sesetengah pelayan belakang memeriksa nilai Host. ServBay secara lalai akan meneruskan nilai Host asal dari permintaan klien. Jika pelayan anda memerlukan kepala Host tertentu (contohnya domain intranet) dan anda mengakses dengan domain berlainan, ini boleh menyebabkan isu. Dalam konfigurasi lanjutan ServBay, anda boleh melaras penerusan kepala (mungkin perlu sunting manual Caddyfile/Nginx, di luar skop UI asas).
• Periksa firewall pelayan sasaran: Meskipun komputer ServBay boleh ping alamat IP & port, firewall pelayan sasaran mungkin hanya membenarkan sambungan dari IP tertentu (contohnya julat intranet). Pastikan komputer ServBay diberi kebenaran.

S: Amaran sijil muncul apabila akses HTTPS ke laman proksi terbalik.

• Menggunakan ServBay CA: Ini adalah tingkah laku biasa kerana ServBay CA ialah CA persendirian dan tidak dipercayai secara lalai oleh pelayar. Anda perlu menambah kepercayaan pada sijil akar ServBay CA dalam sistem atau pelayar. Anda boleh memasangnya melalui tetapan ServBay.
• Menggunakan ACME (Let's Encrypt): Pastikan domain telah diagihkan dengan betul ke IP komputer ServBay dan permohonan sijil SSL dari ServBay berjaya diselesaikan. Semak log ServBay untuk maklumat lanjut mengenai permohonan ACME.

S: Bagaimana memproksi ke sasaran yang memerlukan header atau cookie tertentu?

Konfigurasi asas proksi terbalik ServBay biasanya meneruskan kebanyakan data permintaan klien. Untuk senario lebih kompleks—menambah header permintaan khusus, mengubah balasan header, memproses cookie tertentu, menulis semula path dan lain-lain—anda mungkin perlu mengubah konfigurasi lanjutan, seperti menyunting fail Caddyfile atau Nginx ServBay secara manual untuk menambah aturan proksi terperinci. Ini memerlukan pengetahuan tentang sintaks konfigurasi Caddy atau Nginx.

Rumusan

Dengan fungsi proksi terbalik ServBay, anda boleh dengan mudah mengintegrasikan laman web dari intranet, mesin maya, kontena ataupun pelayan jauh ke persekitaran pembangunan tempatan anda. Ini bukan sahaja menyediakan akses berpusat yang mudah, malah memudahkan nyahpepijat serta konfigurasi SSL. Ikuti langkah-langkah dalam panduan ini untuk konfigurasi pantas dan mula menggunakan tapak proksi terbalik anda. Digabungkan dengan fungsi paparan log dan tip penyelesaian masalah canggih ServBay, anda boleh memastikan operasi laman proksi lancar dan meningkatkan produktiviti pembangunan secara signifikan.