Panduan Konfigurasi Perkhidmatan Proksi Terbalik Pinggy dalam ServBay

Pinggy ialah alat tembusan NAT yang ringan dan mudah digunakan, membantu anda mendedahkan perkhidmatan web tempatan dengan selamat ke internet awam dalam masa singkat. Melalui integrasi Pinggy, ServBay memudahkan pembangun macOS untuk mencipta terowong capaian awam—sesuai untuk demonstrasi kod, ujian API, atau berkongsi hasil pembangunan tempatan dengan rakan kolaborasi luar. Panduan ini akan memandu anda secara langkah demi langkah untuk mengkonfigurasi dan menggunakan perkhidmatan Pinggy dalam ServBay.

Ringkasan

ServBay dilengkapi dengan sokongan terbina bagi Pinggy, menjadikan pemasangan dan pengurusannya amat mudah. Anda boleh mengawal terowong Pinggy secara terus melalui antara muka grafik ServBay, memetakan laman web yang dihoskan secara tempatan kepada URL awam dan membolehkan akses luar.

Senario Penggunaan

• Demonstrasi pantas: Tunjukkan laman web atau aplikasi yang sedang dibangunkan dalam persekitaran macOS tempatan anda kepada klien atau rakan sekerja secara langsung.
• Ujian API & Webhook: Sediakan titik capaian awam sementara untuk perkhidmatan pihak ketiga yang memerlukan panggilan balik (seperti login sosial, antrian mesej, dsb.).
• Penyahpepijatan jauh: Mudahkan ahli pasukan jauh untuk mengakses dan menyahpepijat persekitaran pembangunan tempatan anda.
• Ujian pada peranti mudah alih: Benarkan peranti mudah alih mengakses perkhidmatan backend tempatan melalui URL awam.

Prasyarat

1. ServBay dipasang: Pastikan sistem macOS anda telah memasang serta menjalankan versi ServBay terkini.
2. Akaun Pinggy: Anda perlu mempunyai akaun Pinggy. Daftar di Laman Rasmi Pinggy. Pinggy menawarkan pelan percuma dan berbayar.
3. Laman web tempatan: Pastikan anda sudah mengkonfigurasi dan menjalankan sekurang-kurangnya satu laman web tempatan dalam ServBay, contohnya servbay.demo atau kirby.test.

Langkah-langkah

1. Pasang Pakej Pinggy dalam ServBay

Jika ini kali pertama anda menggunakan Pinggy dalam ServBay, pasang dulu pakej perisian ini:

1. Buka aplikasi ServBay.

2. Pada bar navigasi sebelah kiri, klik Pakej (Packages).

3. Cari atau tatal ke Pinggy dalam senarai pakej yang tersedia.

4. Klik butang pemasangan di sebelah Pinggy.

5. Selepas pemasangan selesai, anda boleh cuba mengklik suis permulaan di sebelah kanan Pinggy. Jika perkhidmatan gagal dimulakan atau status memaparkan ralat, ini adalah perkara biasa kerana Pinggy belum lagi dikonfigurasi. Kita akan selesaikan konfigurasi di langkah berikut.

   

2. Dapatkan Pinggy Access token anda

Pinggy menggunakan Access token untuk mengesahkan akaun anda dan mengaktifkan perkhidmatan terowong.

1. Layari Pinggy Dashboard dan log masuk menggunakan kelayakan anda.

2. Selepas log masuk, biasanya anda akan menemui Access token peribadi anda di bahagian "Access token" pada halaman utama dashboard.

3. Salin Access token ini. Ia adalah rentetan aksara; pastikan anda menyimpannya dengan selamat.

   

3. Konfigurasi Pinggy dalam ServBay

Setelah memperoleh Access token, kembali ke aplikasi ServBay untuk tetapan lanjut:

1. Pada bar navigasi kiri ServBay, pilih Tunnel.

2. Dalam senarai perkhidmatan Tunnel, klik Pinggy.

   

3. Auth Token (Token Kebenaran):

   • Tampal dengan tepat Access token yang anda salin dari dashboard Pinggy ke dalam ruang Auth Token.

4. Konfigurasikan terowong (Local Domain & External Domain): ServBay membenarkan anda mencipta terowong Pinggy untuk beberapa laman web tempatan yang dihoskan di ServBay.

   • Local Domain (Laman Web Tempatan):
     • Klik menu jatuh bawah dan pilih laman web tempatan yang ingin didedahkan ke internet awam melalui Pinggy, cth. thinkphp.test atau servbay.demo.
   • External Domain (Domain Luar):
     • Untuk pengguna Pinggy percuma: Biarkan ruang ini kosong. Pinggy secara automatik akan menjana URL awam rawak untuk terowong anda (kebiasaannya berakhir dengan .a.free.pinggy.link atau .pinggy.link). Selepas terowong berjaya dibina, ServBay akan memaparkan URL ini secara automatik.
     • Untuk pengguna Pinggy berbayar: Jika akaun Pinggy anda menyokong domain tersuai atau domain dijamin, masukkan nama domain luar yang ingin digunakan di ruang ini.

5. Tambah lebih banyak terowong:

   • Untuk tambahkan terowong bagi laman web tempatan lain, klik ikon + (tambah) di kanan entri terowong sedia ada dan ulangi langkah 4 untuk konfigurasi baharu.

6. Simpan Konfigurasi:

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

4. Mulakan & Sahkan Perkhidmatan Pinggy

1. Selepas menyimpan konfigurasi, ServBay akan cuba memulakan perkhidmatan Pinggy dengan tetapan baharu anda.
2. Perhatikan lampu penunjuk status di sebelah entri Pinggy dalam senarai Tunnel. Jika konfigurasi betul dan Pinggy berjaya berhubung dengan pelayannya, lampu penunjuk akan bertukar hijau—menandakan perkhidmatan berjalan dengan lancar.
3. Untuk setiap terowong yang berjaya dimulakan, ruang External Domain (jika dibiarkan kosong sebelum ini) kini akan memaparkan URL awam yang diperoleh dari Pinggy, seperti https://random-string.a.free.pinggy.link.
4. Sahkan capaian:
   • Klik ikon salin di sebelah domain luar untuk menyalin URL awam tersebut.
   • Atau, klik ikon pelayar (lazimnya berbentuk kompas atau glob) untuk membuka URL ini dalam pelayar web lalai anda.
   • Jika segalanya dikonfigurasi dengan betul, laman web tempatan anda kini boleh diakses melalui URL Pinggy tersebut.

5. Pengurusan Terowong Pinggy

Dalam antara muka konfigurasi Pinggy ServBay, pengurusan terowong adalah mudah:

• Salin domain luar: Klik ikon salin untuk mendapatkan URL awam secara pantas untuk dikongsi.
• Buka dalam pelayar: Klik ikon pelayar untuk ujian capaian segera.
• Tambah terowong: Klik ikon + untuk menambah terowong baharu.
• Padam terowong: Klik ikon - (tolak) untuk memadam konfigurasi terowong yang tidak diperlukan.
• Henti/Mula perkhidmatan: Gunakan suis di sebelah entri perkhidmatan Pinggy untuk menghentikan atau memulakan semua terowong Pinggy sekaligus.

Perhatian

• Ciri versi percuma Pinggy: Nama domain luar yang diberikan oleh Pinggy versi percuma adalah dinamik dan boleh berubah setiap kali perkhidmatan Pinggy atau terowong dimulakan semula. Versi percuma juga mungkin mempunyai had pada sambungan serentak, jalur lebar, dan tempoh penggunaan. Untuk domain kekal, prestasi tinggi atau fungsi lanjutan lain, pertimbangkan naik taraf ke pelan berbayar Pinggy.
• Kebergantungan perkhidmatan tempatan: Pastikan laman web tempatan yang dipilih dalam Local Domain telah dikonfigurasi dan berjalan dengan betul dalam ServBay (misalnya versi PHP berkaitan, pelayan web Caddy/Nginx berfungsi, konfigurasi sedia ada tiada ralat). Pinggy hanya bertanggungjawab untuk pemajuan trafik rangkaian.
• Firewall & Rangkaian: Pastikan firewall macOS anda atau perisian keselamatan lain tidak menyekat sambungan rangkaian apliksi ServBay atau klien Pinggy.
• Keselamatan HTTPS: Pinggy lazimnya menyediakan sokongan HTTPS untuk terowong, memastikan data dihantar dalam bentuk tersulit—amat penting untuk keselamatan aplikasi web moden.

Soalan Lazim (FAQ)

• S: Pinggy gagal dimulakan dan penunjuk status tidak hijau. Apa yang harus saya lakukan?
  • J: Semak semula Access token Pinggy yang dimasukkan, pastikan betul dan sah. Periksa juga sambungan internet anda. Semak log klien Pinggy (ikon log di sebelah perkhidmatan) untuk maklumat ralat terperinci.
• S: Saya pengguna percuma Pinggy. Mengapa bidang External Domain perlu dibiarkan kosong?
  • J: Inilah cara operasi standard untuk perkhidmatan percuma Pinggy. Anda tidak perlu tetapkan domain luar secara manual. Selepas terowong berjaya, ServBay akan memaparkan URL awam sementara yang diperoleh daripada pelayan Pinggy secara automatik.
• S: Apakah perbezaan antara Pinggy dan perkhidmatan terowong lain seperti Ngrok? Mana yang patut saya pilih?
  • J: Pinggy dan Ngrok sama-sama alat tembusan NAT yang cemerlang, namun mereka berbeza dari segi fungsi, had pelan percuma, harga berbayar, kerumitan konfigurasi, dan penempatan pelayan. Pinggy lebih terkenal kerana ringan dan mudah digunakan. Pilihan bergantung pada keperluan anda (protokol, domain tersuai, bajet) dan keutamaan peribadi. ServBay menyediakan sokongan untuk pelbagai alat, memberikan anda fleksibiliti maksimum.

Rumusan

Integrasi Pinggy dalam ServBay menawarkan penyelesaian mudah dan pantas untuk pembangun web di macOS berkongsi laman web pembangunan tempatan secara selamat ke internet awam. Melalui beberapa langkah konfigurasi ringkas, anda boleh mendedahkan persekitaran pembangunan untuk demonstrasi, ujian, dan kolaborasi dengan mudah. Sentiasa pastikan konfigurasi anda sepadan dengan jenis akaun Pinggy anda serta perkhidmatan web tempatan sentiasa beroperasi dengan baik agar dapat memanfaatkan sepenuhnya kelebihan Pinggy.