Konfigurasi Happ di Mac: dari instalasi hingga routing trafik

Instalasi Happ di macOS

Happ adalah klien berbasis kernel Xray yang di Mac bekerja baik sebagai aplikasi biasa dengan proxy sistem maupun sebagai terowongan jaringan penuh. Unduh versi untuk macOS, pindahkan aplikasi ke folder "Applications", lalu jalankan. Saat pertama kali dijalankan, macOS mungkin menampilkan peringatan Gatekeeper bahwa program diunduh dari internet — buka "System Settings → Privacy & Security" dan konfirmasikan peluncuran dengan tombol "Open Anyway".

Untuk kerja yang stabil disarankan macOS 12 Monterey ke atas — pada versi yang lebih lama sebagian API jaringan yang digunakan Happ untuk mode TUN tidak tersedia. Klien bekerja sama baiknya di Mac dengan prosesor Apple Silicon (M1–M4) maupun pada model dengan chip Intel; tidak perlu mencari build terpisah untuk setiap arsitektur, karena versi universal secara otomatis memilih kode yang sesuai.

Setelah instalasi, ada baiknya langsung mengizinkan Happ berjalan otomatis saat login ke sistem dan menampilkan ikon di menu bar. Ini praktis: koneksi, pergantian server, dan perubahan mode selalu mudah dijangkau, sehingga Anda tidak perlu membuka jendela aplikasi setiap kali.

Kunci dan langganan: cara terhubung

Akses ke server diberikan oleh bot Telegram layanan. Buat kunci uji coba, resmi, atau berbayar di bot — sebagai balasan Anda akan menerima baris langganan (tautan berformat happ:// atau https://) atau konfigurasi server tersendiri. Anda tidak perlu menyalin konfigurasi panjang secara manual di Mac: langganan akan mengambil daftar server terbaru sendiri dan memperbaruinya saat ada perubahan di sisi layanan.

Cara tercepat menambahkan kunci adalah menyalin tautan langganan dan di Happ menekan "Add from clipboard": aplikasi akan mengenali isi clipboard dan mengimpor profil secara otomatis. Jika Anda membuka tautan happ:// langsung di macOS, sistem akan menawarkan untuk meneruskannya ke Happ melalui deep-link, dan profil ditambahkan dengan satu klik.

Setelah impor, daftar server akan muncul di jendela utama. Pilih node dengan ping terendah, tekan "Connect", dan tunggu hingga indikator menjadi aktif. Langganan cukup ditambahkan sekali — saat memperpanjang kunci di bot, tidak perlu memasang ulang apa pun, klien akan mengambil pembaruan sendiri.

Mode proxy dan mode TUN: mana yang dipilih

Di macOS, Happ menawarkan dua cara yang secara fundamental berbeda untuk melewatkan trafik. Mode proxy menjalankan proxy SOCKS/HTTP lokal dan mendaftarkannya di pengaturan jaringan sistem. Melaluinya berjalan permintaan aplikasi yang menghormati proxy sistem — terutama browser. Ini mode yang ringan: tidak memerlukan hak administrator dan tidak menyentuh trafik program yang bekerja di luar proxy.

Mode TUN (juga disebut mode terowongan sistem) membuat antarmuka jaringan virtual utun dan menangkap trafik pada level seluruh sistem. Dalam hal ini, melalui terowongan berjalan bukan hanya browser, tetapi juga aplikasi pesan, klien desktop, terminal, dan layanan latar belakang. Untuk mengaktifkan TUN, Happ akan sekali meminta pemasangan helper istimewa dan konfirmasi tindakan dengan kata sandi administrator — ini adalah perilaku standar macOS untuk aplikasi yang mengelola tumpukan jaringan.

Aturan praktis: jika Anda perlu agar "semuanya bekerja" untuk seluruh aplikasi, aktifkan TUN. Jika tugasnya spesifik — hanya membuka akses di browser tanpa menyentuh sistem lainnya — mode proxy sudah cukup. Anda dapat beralih antar mode secara langsung tanpa menghapus langganan dan tanpa mengubah server yang dipilih.

Routing dan split tunneling

Kernel Xray di dalam Happ mendukung routing yang fleksibel: Anda dapat menetapkan aturan trafik mana yang melewati server dan mana yang langsung. Di Mac, ini paling sering digunakan untuk split tunneling: misalnya, situs perbankan dan lokal dilewatkan di luar terowongan, sedangkan sisanya melalui server yang dipilih. Aturan dibangun berdasarkan domain, subnet IP, dan zona geografis.

Daftar routing (routing lists) siap pakai membebaskan Anda dari menyebutkan ratusan domain secara manual. Dengan menghubungkan daftar semacam itu, Anda mendapatkan kumpulan aturan yang sudah dikonfigurasi — misalnya, "sumber daya lokal secara langsung" atau "blokir domain iklan dan pelacak". Daftar diperbarui, sehingga aturan tetap relevan tanpa campur tangan Anda.

Secara khusus di macOS, opsi melewati trafik jaringan lokal sangat berguna: permintaan ke printer, NAS, dan perangkat lain di jaringan rumah harus berjalan langsung, jika tidak, perangkat tersebut akan berhenti terdeteksi. Di pengaturan routing, biarkan rentang privat (10.0.0.0/8, 192.168.0.0/16 dan sejenisnya) di luar terowongan — ini adalah praktik standar dan aman.

Optimasi dan masalah umum di Mac

Jika setelah mengaktifkan TUN internet hilang di semua aplikasi, hal pertama yang harus diperiksa adalah bahwa helper istimewa telah terpasang dan Happ memiliki izin untuk mengubah konfigurasi jaringan di "Privacy & Security". Pencabutan izin ini adalah penyebab paling umum terowongan aktif tetapi trafik tidak lewat. Memasang ulang helper dari pengaturan aplikasi biasanya menyelesaikan masalah.

Saat kecepatan lambat, coba ganti server ke yang lebih dekat secara geografis dan perhatikan transport koneksi. Node dengan protokol penyamaran modern berbasis kernel Xray biasanya memberi hasil stabil pada kanal yang tidak stabil, sedangkan node publik yang penuh kelebihan beban turun kecepatannya pada jam sibuk. Ping dan beban server terlihat langsung di daftar.

Jika browser mengabaikan koneksi dalam mode proxy, periksa bahwa di dalamnya tidak diatur proxy sendiri atau ekstensi yang mencegat jaringan — hal itu menimpa pengaturan sistem. Dan agar Happ tidak terputus saat Mac masuk mode tidur, aktifkan koneksi otomatis saat mulai dan penahanan terowongan; dengan begitu, setelah laptop bangun, koneksi akan pulih sendiri.