Panduan Konfigurasi Layanan Reverse Proxy Pinggy di ServBay

Pinggy adalah alat tunneling jaringan internal yang ringan dan mudah digunakan, yang membantu Anda mengekspos layanan web lokal dengan aman ke internet publik secara cepat. ServBay mengintegrasikan Pinggy untuk memberikan cara mudah bagi pengembang macOS membuat tunnel akses publik—cocok untuk demo kode, pengujian API, atau berbagi hasil pengembangan lokal dengan kolaborator eksternal. Panduan ini akan memandu Anda melalui seluruh proses konfigurasi dan penggunaan layanan Pinggy di ServBay.

Gambaran Umum

ServBay sudah terintegrasi dengan Pinggy, sehingga pemasangan dan pengelolaannya sangat sederhana. Anda dapat mengontrol tunnel Pinggy langsung dari antarmuka grafis ServBay, memetakan situs web lokal yang di-host di ServBay menjadi URL publik yang bisa diakses melalui internet.

Skenario Penggunaan

• Demo Cepat: Tampilkan secara instan situs atau aplikasi yang sedang Anda kembangkan di lingkungan macOS lokal kepada klien atau rekan kerja.
• Pengujian API & Webhook: Sediakan endpoint publik sementara untuk layanan pihak ketiga (seperti login sosial, message queue) yang membutuhkan callback ke internet.
• Debugging Jarak Jauh: Mempermudah anggota tim jarak jauh untuk mengakses dan melakukan debugging pada lingkungan pengembangan lokal Anda.
• Pengujian Perangkat Mobile: Izinkan perangkat mobile mengakses backend lokal Anda melalui URL publik.

Persyaratan

1. ServBay Sudah Terpasang: Pastikan macOS Anda telah terinstal dan menjalankan ServBay versi terbaru.
2. Akun Pinggy: Anda memerlukan akun Pinggy. Kunjungi Situs Resmi Pinggy untuk mendaftar. Pinggy menawarkan paket gratis dan berbayar.
3. Situs Lokal: Setidaknya harus ada satu situs web lokal yang telah dikonfigurasi dan berjalan di ServBay, misalnya servbay.demo atau kirby.test.

Langkah-langkah Operasional

1. Instal Paket Pinggy di ServBay

Jika ini adalah kali pertama Anda menggunakan Pinggy di ServBay, instal terlebih dahulu paketnya:

1. Buka aplikasi ServBay.

2. Di panel navigasi sebelah kiri, klik Paket (Packages).

3. Di daftar paket yang tersedia, cari atau temukan Pinggy.

4. Klik tombol instalasi di samping Pinggy.

5. Setelah instalasi selesai, Anda bisa mencoba menyalakan switch di sebelah kanan Pinggy. Jika layanan gagal mulai atau status tidak normal, itu wajar karena Pinggy belum dikonfigurasi. Kita akan melanjutkan pengaturannya pada langkah berikutnya.

   

2. Dapatkan Pinggy Access Token Anda

Pinggy menggunakan Access token untuk mengautentikasi akun Anda dan mengaktifkan layanan tunnel.

1. Kunjungi Dashboard Pinggy dan login menggunakan akun Anda.

2. Setelah berhasil login, pada halaman utama dashboard bagian "Access token", biasanya Anda bisa melihat Access token pribadi Anda.

3. Salin Access token tersebut. Ini berupa rangkaian karakter—pastikan untuk menyimpannya dengan aman.

   

3. Konfigurasi Pinggy di ServBay

Setelah mendapatkan Access token, kembali ke aplikasi ServBay untuk konfigurasi:

1. Di panel navigasi kiri ServBay, pilih Tunnel.

2. Di daftar layanan Tunnel, klik Pinggy.

   

3. Auth Token (Token Otorisasi):

   • Pada kotak input Auth Token, tempelkan dengan tepat Access token yang telah Anda salin dari dashboard Pinggy.

4. Konfigurasi Tunnel (Local Domain dan External Domain): ServBay memungkinkan Anda membuat tunnel Pinggy untuk beberapa situs lokal yang di-host di ServBay.

   • Local Domain (Situs Lokal):
     • Klik menu dropdown dan pilih situs web lokal yang ingin Anda ekpos ke publik melalui Pinggy, misal thinkphp.test atau servbay.demo.
   • External Domain (Domain Eksternal):
     • Untuk pengguna Pinggy Gratis: Biarkan kolom ini kosong. Pinggy akan otomatis menghasilkan URL publik acak untuk tunnel Anda (biasanya berakhiran .a.free.pinggy.link atau .pinggy.link). Setelah tunnel berhasil dibuat, ServBay akan langsung menampilkan URL ini di sini secara otomatis.
     • Untuk pengguna Pinggy Berbayar: Jika akun Pinggy Anda mendukung custom domain atau reserved domain, Anda bisa mengisi domain eksternal pilihan di kolom ini.

5. Menambah Tunnel Lain:

   • Untuk membuat tunnel bagi situs lokal lain, klik tombol + di kanan entri tunnel yang ada dan ulangi langkah 4 untuk konfigurasi tunnel baru.

6. Simpan Konfigurasi:

   • Setelah selesai mengonfigurasi semua tunnel, klik tombol Save (Simpan) di kanan bawah antarmuka.

4. Memulai dan Verifikasi Layanan Pinggy

1. Setelah menyimpan konfigurasi, ServBay akan mencoba memulai layanan Pinggy menggunakan pengaturan baru Anda.
2. Lihat indikator status di daftar Tunnel di samping entri Pinggy. Jika pengaturannya benar dan Pinggy berhasil terkoneksi ke servernya, indikator tersebut akan berubah hijau, artinya layanan sedang berjalan.
3. Untuk tiap tunnel yang berhasil dijalankan, kolom External Domain (jika sebelumnya kosong) sekarang akan menampilkan URL publik yang diberikan oleh Pinggy, seperti https://random-string.a.free.pinggy.link.
4. Verifikasi Akses:
   • Klik ikon salin di samping domain eksternal untuk menyalin URL publik tersebut.
   • Atau klik ikon browser (biasanya berbentuk kompas atau globe) untuk langsung membuka URL di peramban web default Anda.
   • Jika pengaturannya benar, Anda dapat mengakses situs lokal Anda melalui URL Pinggy tersebut.

5. Mengelola Tunnel Pinggy

Pada antarmuka konfigurasi Pinggy di ServBay, Anda dapat mengelola tunnel Anda dengan mudah:

• Salin Domain Eksternal: Klik ikon salin untuk menyalin URL publik dan membagikannya.
• Buka di Browser: Klik ikon browser untuk melakukan tes akses dengan cepat.
• Tambahkan Tunnel: Klik ikon + untuk mengonfigurasi tunnel baru.
• Hapus Tunnel: Klik ikon - untuk menghapus konfigurasi tunnel yang tidak diperlukan lagi.
• Hentikan/Mulai Layanan: Anda dapat menonaktifkan atau mengaktifkan layanan tunnel Pinggy secara global melalui switch di samping entri layanan Pinggy.

Catatan Penting

• Fitur Versi Gratis Pinggy: Domain eksternal yang diberikan pada versi gratis Pinggy bersifat dinamis dan bisa berubah setiap kali layanan atau tunnel di-restart. Versi gratis juga memiliki keterbatasan jumlah koneksi simultan, bandwidth, dan waktu pemakaian. Jika menginginkan domain tetap, performa lebih tinggi, atau fitur premium lain, pertimbangkan upgrade ke paket berbayar Pinggy.
• Ketergantungan Layanan Lokal: Pastikan situs lokal yang dipilih pada Local Domain sudah dikonfigurasi dengan benar dan sedang berjalan di ServBay (misal, versi PHP terkait, server web seperti Caddy/Nginx sudah aktif, dan konfigurasi situs tepat). Pinggy hanya bertanggung jawab pada penerusan lalu lintas jaringan.
• Firewall dan Jaringan: Pastikan firewall macOS Anda atau software keamanan pihak ketiga tidak memblokir koneksi jaringan ServBay/Pinggy Client.
• Keamanan HTTPS: Pinggy biasanya mendukung HTTPS untuk tunnelnya sehingga transmisi data tetap terenkripsi—ini penting demi keamanan aplikasi web modern.

FAQ (Pertanyaan yang Sering Diajukan)

• Q: Layanan Pinggy gagal dinyalakan, indikator status tidak hijau. Apa yang harus saya lakukan?
  • A: Periksa ulang apakah Access token Pinggy Anda sudah diinput dengan benar. Pastikan koneksi internet berfungsi normal. Cek juga log Pinggy Client (ikon log di samping layanan) untuk menemukan pesan error yang lebih spesifik.
• Q: Saya pengguna Pinggy gratis, kenapa kolom External Domain harus dikosongkan?
  • A: Ini memang prosedur standar untuk layanan Pinggy gratis. Anda tidak perlu mengisi domain eksternal secara manual—setelah tunnel terkoneksi, ServBay akan otomatis mengambil dan menampilkan URL publik sementara dari server Pinggy di kolom tersebut.
• Q: Apa perbedaan Pinggy dengan layanan tunnel lain seperti Ngrok? Mana yang sebaiknya saya pilih?
  • A: Pinggy dan Ngrok sama-sama alat tunneling jaringan internal yang bagus, tapi memiliki perbedaan fitur, batasan paket gratis, harga berbayar, tingkat kesulitan konfigurasi, serta lokasi server. Pinggy terkenal lebih ringan dan mudah digunakan. Pilih sesuai kebutuhan Anda (misal dukungan protokol tertentu, kebutuhan custom domain, anggaran) dan preferensi pribadi. ServBay mendukung beberapa alat serupa dengan fleksibilitas tinggi untuk Anda.

Ringkasan

Fitur Pinggy terintegrasi di ServBay merupakan solusi praktis bagi pengembang web macOS untuk membagikan situs lokal secara aman ke internet. Hanya dengan beberapa langkah konfigurasi, Anda sudah bisa mengekspos lingkungan pengembangan lokal untuk demo, pengujian, dan kolaborasi dengan mudah dan aman. Pastikan Anda mengatur sesuai tipe akun Pinggy yang dimiliki dan situs web lokal Anda selalu dalam keadaan sehat agar bisa memaksimalkan kemudahan yang ditawarkan Pinggy.