Zhorief Tunnel · v0.4

Dokumentasi developer

Referensi teknis untuk menginstal CLI, membuka tunnel, mengatur akses, dan mengobservasi traffic.

📑 Lompat cepat ke bab:

Pengenalan Mulai cepat Instalasi Autentikasi Tunnel Mode akses Tim & RBAC Observabilitas Referensi CLI Keamanan Troubleshooting

Introduction

Apa itu Zhorief Tunnel?

Zhorief Tunnel adalah jembatan aman dari localhost ke internet yang dirancang untuk workflow developer modern. Jalankan satu perintah, lalu bagikan API, webhook, dashboard internal, atau aplikasi yang sedang Anda bangun melalui URL HTTPS—tanpa membuka port router, memiliki IP publik, atau mengubah konfigurasi jaringan.

Di balik URL yang sederhana, Zhorief Tunnel menyatukan konektivitas, autentikasi, observabilitas, dan kolaborasi dalam satu control plane. Hasilnya bukan sekadar tunnel yang “bisa diakses”, tetapi endpoint pengembangan yang mudah diperiksa, dikendalikan, dan dihentikan kapan saja.

100% GRATIS

Seluruh fitur Zhorief Tunnel saat ini dapat digunakan tanpa biaya.

Tidak ada paket berbayar atau fitur yang dikunci. Gunakan untuk belajar, membangun produk, menguji webhook, dan berkolaborasi bersama tim.

LOCALHOST→SECURE EDGE→HTTPS PUBLIC URL

Kenapa menggunakan Zhorief Tunnel?

Satu perintah, langsung online

Publikasikan port lokal dengan cihuy tunnel 3000. Agent hanya membuat koneksi keluar, sehingga Anda tidak perlu mengubah router atau membuka inbound port.

HTTPS sebagai standar

Setiap tunnel memperoleh endpoint HTTPS yang siap dibagikan untuk demo, callback OAuth, pengujian mobile, dan integrasi pihak ketiga.

Debug request tanpa menebak

Request Inspector merekam method, header, payload, status, dan durasi. Request yang gagal dapat diputar ulang dari dashboard atau CLI.

Akses yang dapat dikendalikan

Pilih mode public, team, atau private. Tambahkan Basic Auth, IP allowlist, rate limit, dan masa berlaku sesuai risiko endpoint.

Dibangun untuk tim

RBAC memisahkan peran owner, admin, developer, dan viewer. Service token berscope membantu otomasi CI/CD tanpa membagikan sesi pengguna.

Webhook lebih aman

Preset Midtrans, Xendit, Stripe, GitHub, dan WhatsApp membantu memvalidasi signature, sementara redaction engine menyamarkan data sensitif pada log.

Fitur untuk workflow developer

Project manifest: jalankan beberapa service sekaligus dengan cihuy up.
Background mode: pertahankan tunnel tanpa membiarkan terminal utama terbuka.
QR mobile testing: buka hasil development langsung dari perangkat mobile.
Health diagnostics: gunakan cihuy doctor untuk memeriksa DNS, HTTPS, API, dan konektivitas relay.
Dashboard observability: pantau traffic, uptime, sesi, perangkat, dan audit trail dari satu tempat.
Remote control: cabut perangkat atau hentikan tunnel aktif secara terpusat saat terjadi insiden.

Filosofi Zhorief Tunnel: pengalaman lokal tetap secepat development, sementara endpoint yang keluar ke internet tetap memiliki kontrol yang layak untuk digunakan bersama tim.

Mulai cepat

Instal CLI.
Jalankan cihuy login untuk menghubungkan perangkat.
Pastikan aplikasi lokal sudah berjalan.
Buka tunnel ke port aplikasi.

cihuy login
cihuy tunnel 3000 --name my-app --access public

Instalasi

Windows PowerShell

irm https://tunnel.zhorief.com/install.ps1 | iex

Linux

curl -fsSL https://tunnel.zhorief.com/install.sh | sh

macOS Intel / Apple Silicon

curl -fsSL https://tunnel.zhorief.com/install.sh | sh

Installer mendeteksi platform, mengunduh CLI beserta runtime FRP, memverifikasi checksum binary, lalu menambahkannya ke PATH.

cihuy version

Autentikasi perangkat

cihuy login

CLI membuat kode perangkat sekali pakai dan membuka halaman /login dengan kode yang sudah terisi. Masukkan email, selesaikan verifikasi, lalu biarkan terminal tetap aktif sampai perangkat terhubung.

Beranda publik berada di /. Setelah berhasil masuk, pengelolaan tunnel, perangkat, dan tim tersedia di /dashboard. Tautan login dari versi CLI lama yang masih mengarah ke beranda akan diteruskan secara aman ke halaman login.

cihuy whoami
cihuy status
cihuy logout

Kode perangkat bersifat sementara dan hanya boleh dimasukkan pada halaman login resmi. Jangan membagikan kode, OTP, cookie sesi, atau token kepada siapa pun.

Membuat tunnel

Subdomain otomatis

cihuy tunnel 3000

Deteksi service lokal

cihuy tunnel --detect

Agent memeriksa port development pada 127.0.0.1 dan ::1. Jika beberapa service ditemukan, pilih target yang ingin dipublikasikan.

Subdomain tetap

cihuy tunnel 8000 --name ssbo-api --access public

URL lokal

cihuy tunnel http://localhost:5173

Hostname loopback dipertahankan dan agent otomatis memilih listener IPv4 atau IPv6 yang aktif. Target LAN dan internet ditolak.

Masa berlaku dan rate limit

cihuy tunnel 3000 --name demo --access public --expires 3600 --rate-limit 600

--expires menggunakan satuan detik. Tunnel public berlaku maksimal 8 jam, sedangkan sesi lainnya maksimal 24 jam.

cihuy list
cihuy stop ssbo-api

Mode akses

Public

Dapat diakses tanpa autentikasi. Gunakan untuk webhook, callback, pengujian mobile, atau demo sementara.

Team

Hanya pemilik dan anggota tim yang telah terautentikasi.

Private

Hanya pemilik tunnel yang dapat mengakses endpoint.

cihuy tunnel 3000 --access public
cihuy tunnel 3000 --access team --team TEAM_ID
cihuy tunnel 3000 --access private

Tim dan RBAC

Buat tim melalui menu Tim & RBAC, lalu gunakan ID tim melalui flag --team.

Peran	Hak akses
Owner	Mengelola tim, anggota, peran, dan tunnel.
Admin	Mengelola anggota dan menghentikan tunnel milik tim.
Developer	Membuat dan menjalankan tunnel milik tim.
Viewer	Melihat dan mengakses tunnel tanpa dapat menjalankannya.

Observabilitas dan audit

Dashboard menampilkan ringkasan traffic, koneksi aktif, request, uptime, masa berlaku, dan kesehatan tunnel sesuai hak akses pengguna.

Audit trail mencatat aktivitas penting seperti siklus hidup tunnel, pencabutan perangkat, serta perubahan tim dan peran. Informasi operasional yang sensitif tidak ditampilkan pada dokumentasi publik.

Referensi CLI

Perintah	Kegunaan
`cihuy login`	Hubungkan perangkat.
`cihuy tunnel PORT`	Jalankan tunnel HTTP.
`cihuy list`	Tampilkan tunnel milik akun atau tim.
`cihuy stop ID`	Hentikan tunnel.
`cihuy status`	Periksa koneksi API dan status autentikasi.
`cihuy whoami`	Tampilkan identitas, perangkat, dan tim.
`cihuy doctor`	Diagnostik kesehatan jaringan & relay engine.
`cihuy logout`	Hapus kredensial lokal.

Flag tunnel & simulasi jaringan (Chaos Testing)

--name <subdomain>
--access <public|team|private>
--team <team-id>
--region <jakarta>
--expires <seconds>
--ttl <duration> (30m, 1h, 2h, 1d)
--rate-limit <requests-per-minute>
--latency <duration> (e.g. 200ms, 800ms, 1s)
--throttle <edge|3g-slow|3g|4g-slow|4g|wifi-slow>
--chaos <percentage> (e.g. 5%, 10% fault injection)

Keamanan

Agent didistribusikan sebagai single binary standalone dan hanya membuat koneksi keluar dari perangkat.
Target otomatis dibatasi ke listener loopback lokal; target jaringan lain ditolak secara bawaan.
Setiap perangkat memiliki kredensial yang terpisah dan dapat dicabut.
Tunnel terproteksi menerapkan kebijakan fail-closed ketika identitas pengunjung tidak dapat diverifikasi.
Tunnel public mendukung masa berlaku dan rate limit untuk membatasi paparan.
Gunakan Request Inspector hanya untuk data uji; jangan kirim kredensial produksi, data pribadi, atau rahasia melalui tunnel pengembangan.

Gunakan hanya domain resmi melalui HTTPS dan jangan lanjutkan jika browser menampilkan peringatan sertifikat. Tim dukungan tidak pernah meminta OTP, token, cookie sesi, atau isi kredensial Anda.

Pemecahan masalah

FRP menampilkan “page not found”

Hostname belum terdaftar pada relay. Pastikan proses tunnel tetap berjalan dan terminal menampilkan konfirmasi registrasi.

Antivirus / Windows Defender

Agent cihuy menggunakan arsitektur in-process single binary. Tidak ada lagi runtime eksternal frpc.exe yang di-drop ke direktori AppData. Jika Anda meng-upgrade dari versi lama, Anda dapat menghapus cache lama di %APPDATA%\cihuy-tunnel\bin.

macOS memblokir executable

Buka System Settings → Privacy & Security, lalu izinkan binary yang checksum-nya telah diverifikasi.

Linux menampilkan permission denied

chmod +x ~/.local/bin/cihuy
mount | grep noexec

Autentikasi gagal

Buat device code baru dengan cihuy login. Kode sebelumnya mungkin sudah digunakan atau kedaluwarsa. Pastikan dashboard diakses melalui HTTPS.

Aplikasi lokal tidak merespons

curl http://127.0.0.1:3000
cihuy status