Panduan Mengkonfigurasi Perkhidmatan Proksi Terbalik Ngrok dalam ServBay

Ngrok ialah alat yang hebat yang membolehkan anda mendedahkan perkhidmatan web yang berjalan secara tempatan ke internet awam dengan selamat. Dengan integrasi Ngrok dalam ServBay, anda boleh mencipta terowong akses awam yang selamat untuk laman web pembangunan tempatan anda dengan mudah – sangat sesuai untuk demonstrasi projek, ujian Webhook, atau berkongsi hasil pembangunan dengan ahli pasukan luar. Panduan ini akan menerangkan secara terperinci cara mengkonfigurasi dan menggunakan perkhidmatan proksi terbalik Ngrok dalam ServBay.

Gambaran Keseluruhan

ServBay menawarkan sokongan terbina dalam untuk Ngrok, memudahkan proses pemasangan dan konfigurasi. Anda boleh mengurus terowong Ngrok secara terus melalui antara muka grafik ServBay, memetakan mana-mana laman web tempatan yang dihoskan ke URL awam sementara.

Senario Penggunaan

• Demonstrasi dengan Pelanggan: Persembahkan laman web pembangunan yang berjalan di komputer anda kepada pelanggan.
• Pembangunan Webhook: Uji perkhidmatan pihak ketiga yang memerlukan URL panggilan balik awam seperti gerbang pembayaran atau API.
• Ujian Aplikasi Mudah Alih: Benarkan peranti mudah alih mengakses API backend tempatan anda melalui URL awam.
• Pembangunan Kolaboratif: Berikan akses sementara ke persekitaran pembangunan tempatan kepada ahli pasukan.

Prasyarat

1. ServBay telah dipasang: Pastikan ServBay telah berjaya dipasang dan berjalan pada sistem macOS anda.
2. Akaun Ngrok: Anda memerlukan akaun Ngrok. Daftar akaun percuma atau berbayar di laman rasmi Ngrok.
3. Laman Web Tempatan: Pastikan sekurang-kurangnya satu laman web telah ditambah dan berjalan dalam ServBay, contohnya servbay.demo.

Langkah-langkah

1. Pasang Pakej Perisian Ngrok dalam ServBay

Sebelum menggunakan Ngrok buat kali pertama, anda perlu memasangnya dalam ServBay:

1. Buka aplikasi ServBay.
2. Di bar navigasi kiri, klik Packages (Perisian).
3. Cari atau temui Ngrok dalam senarai perisian.
4. Klik butang pemasangan di sebelah Ngrok.
5. Setelah pemasangan selesai, cuba hidupkan suis permulaan di sebelah kanan Ngrok. Pada tahap ini, kerana Ngrok belum dikonfigurasikan, perkhidmatan mungkin gagal dimulakan atau status menunjukkan ralat. Ini adalah perkara biasa dan konfigurasi akan dilakukan di langkah seterusnya.

2. Dapatkan Ngrok Authtoken Anda

Ngrok menggunakan Authtoken untuk mengesahkan akaun anda dan membenarkan penggunaan perkhidmatannya.

1. Pergi ke Ngrok Dashboard dan log masuk akaun Ngrok anda.

2. Dalam dashboard, cari Your Authtoken di menu navigasi kiri ("Getting Started" -> "Your Authtoken").

3. Salin Authtoken anda. Ia biasanya merupakan satu rentetan yang panjang – simpan dengan selamat.

   

3. Konfigurasi Ngrok dalam ServBay

Selepas mendapatkan Authtoken, kembali ke ServBay untuk konfigurasi:

1. Di bar navigasi kiri ServBay, klik Tunnel.

2. Dalam senarai perkhidmatan Tunnel, pilih ngrok.

   

3. Auth Token (Token Kebenaran):

   • Tampal Authtoken Ngrok yang anda salin ke dalam kotak input Auth Token.

4. Konfigurasikan Terowong (Domian Tempatan dan Domain Luar): ServBay membolehkan anda cipta terowong Ngrok untuk beberapa laman web tempatan.

   • Local Domain (Laman Tempatan):
     • Klik menu lungsur dan pilih laman web tempatan yang anda ingin dedahkan ke internet awam melalui Ngrok. Senarai ini akan dimuatkan secara automatik daripada laman web yang telah anda tambah dalam ServBay, seperti servbay.test atau servbay.demo.
   • External Domain (Domain Luar):
     • Untuk pengguna Ngrok percuma: Biarkan ruangan ini kosong. Ngrok akan secara automatik menghasilkan URL awam rawak yang berakhir dengan .ngrok-free.app (atau domain percuma lain yang disediakan Ngrok). ServBay akan mendapatkan dan memaparkan URL ini secara automatik selepas terowong berjaya dimulakan.
     • Untuk pengguna Ngrok berbayar: Jika anda telah menetapkan domain khusus atau domain reserved di akaun Ngrok, masukkan domain luar yang ingin anda gunakan di sini.

5. Tambah Terowong Baru:

   • Jika anda mahu cipta terowong untuk beberapa laman web tempatan, klik butang + di sebelah baris terowong sedia ada untuk tambah konfigurasi terowong baharu. Ulang langkah 4 untuk memilih laman tempatan dan tetapkan domain luar bagi terowong baharu.

6. Simpan Konfigurasi:

   • Selepas selesai semua konfigurasi, klik butang Save (Simpan) di penjuru kanan bawah.

4. Mulakan dan Sahkan Perkhidmatan Ngrok

1. Selepas menyimpan konfigurasi, ServBay akan cuba memulakan perkhidmatan Ngrok dengan tetapan baharu.
2. Perhatikan penunjuk status di sebelah perkhidmatan ngrok. Jika konfigurasi betul dan servis Ngrok berjaya disambungkan, lampu penunjuk akan menjadi hijau, menandakan servis sedang berjalan.
3. Untuk setiap entri terowong yang berjaya dimulakan, medan External Domain (jika sebelumnya dibiarkan kosong) kini akan memaparkan URL awam yang diberikan oleh Ngrok.
4. Sahkan Akses:
   • Klik ikon salin di sebelah domain luar untuk menyalin URL tersebut.
   • Atau klik ikon pelayar (selalunya ikon kompang atau bumi) untuk membuka URL awam tersebut di pelayar utama anda.
   • Jika semuanya berjaya, anda sekarang boleh mengakses laman web tempatan anda melalui URL Ngrok.

5. Uruskan Terowong Ngrok

Dalam antara muka konfigurasi Ngrok ServBay:

• Salin Domain Luar: Klik ikon salin untuk memudahkan perkongsian.
• Buka di Pelayar: Klik ikon pelayar untuk ujian pantas.
• Tambah Terowong: Klik ikon +.
• Buang Terowong: Klik ikon - untuk mengalih keluar konfigurasi terowong yang tidak diperlukan.
• Hentikan Perkhidmatan: Klik suis di sebelah entri perkhidmatan ngrok untuk menghentikan servis Ngrok sepenuhnya. Klik sekali lagi untuk cuba memulakan semula.

Perkara Perlu Diberi Perhatian

• Had Versi Ngrok Percuma: Domain luar yang dijana oleh versi percuma Ngrok adalah dinamik; ia mungkin berubah setiap kali perkhidmatan Ngrok atau terowong dimulakan semula. Versi percuma juga mengehadkan bilangan sambungan, jalur lebar dan tempoh penggunaan. Untuk domain tetap dan fungsi lanjutan, pertimbangkan untuk menaik taraf ke pelan berbayar Ngrok.
• Status Perkhidmatan Tempatan: Pastikan laman web yang anda pilih di Local Domain benar-benar sedang berjalan dalam ServBay (contohnya, versi PHP berkaitan dan pelayan web Nginx/Apache telah dimulakan dan laman dikonfigurasikan dengan betul). Ngrok hanya meneruskan trafik, ia tidak memulakan atau membetulkan perkhidmatan tempatan anda.
• Firewall: Pastikan firewall macOS anda atau mana-mana perisian keselamatan pihak ketiga tidak menyekat sambungan rangkaian ServBay atau Ngrok.
• HTTPS: Secara lalai, Ngrok membekalkan sokongan HTTPS pada terowong – sangat membantu untuk pembangunan dan ujian web moden.

Soalan Lazim (FAQ)

• S: Perkhidmatan Ngrok gagal dimulakan, penunjuk status merah atau oren. Apa perlu buat?
  • J: Semak semula sama ada Ngrok Authtoken anda telah dimasukkan dengan betul. Seterusnya, sahkan sambungan internet anda dan pastikan anda boleh mengakses laman web rasmi Ngrok. Periksa log Ngrok (ikon log di bahagian kanan servis) untuk maklumat ralat yang lebih terperinci.
• S: Saya pengguna Ngrok percuma, kenapa medan External Domain kosong atau dipaparkan "Leave blank if you're a free user"?
  • J: Ini adalah normal. Pengguna percuma tidak perlu mengisi ruangan ini. Apabila terowong berjaya dimulakan, ServBay akan secara automatik mendapatkan URL awam rawak yang diperuntukkan untuk anda dari Ngrok dan memaparkannya di sini.
• S: Bolehkah saya menggunakan Ngrok dan perkhidmatan terowong lain (seperti frp, Cloudflared) serentak?
  • J: ServBay membenarkan pemasangan dan konfigurasi pelbagai perkhidmatan terowong. Secara umumnya, anda boleh memilih untuk mengaktifkan satu atau lebih mengikut keperluan. Namun, menjalankan terowong ganda untuk laman web tempatan yang sama mungkin menyebabkan konflik atau konfigurasi menjadi kompleks – sila berhati-hati dan pastikan anda memahami perutean rangkaian.

Rumusan

Integrasi Ngrok dalam ServBay sangat memudahkan pembangun web mendedahkan persekitaran pembangunan tempatan di macOS ke internet awam. Sama ada untuk demonstrasi pantas, ujian integrasi Webhook, atau perkongsian dengan rakan kerjasama, fungsi Ngrok dalam ServBay menyediakan penyelesaian yang mudah dan efisien. Sentiasa konfigurasikan domain luar mengikut jenis akaun Ngrok anda (percuma atau berbayar) dan pastikan perkhidmatan tempatan anda berfungsi dengan baik.