Hubungkan Apple TV ke firewall dengan perangkat lunak pfSense®

Kapan pengaturan ini cocok

Gunakan pengaturan ini saat Apple TV berada jauh dari rumah, misalnya di penginapan liburan, dan perlu terhubung kembali ke firewall yang menjalankan perangkat lunak pfSense.

Panduan ini tidak membahas cara mengirim lalu lintas Apple TV di rumah melalui klien VPN di firewall. Pengaturan tersebut tidak memerlukan WaveSocket.

Anda memerlukan:

• Apple TV dengan aplikasi WaveSocket, yang terhubung menggunakan konfigurasi WireGuard dan tidak menyertakan layanan VPN
• akses administrator ke firewall dan alamat WAN yang dapat dijangkau oleh Apple TV
• paket WireGuard; dokumentasi Netgate® menyarankan agar Anda memperbarui ke versi terbaru perangkat lunak pfSense Plus atau pfSense CE sebelum memasangnya
• ponsel atau komputer di jaringan yang sama dengan Apple TV untuk transfer

Dalam contoh Netgate, Anda menulis sendiri konfigurasi Apple TV berdasarkan pengaturan terowongan dan rekan, lalu menempelkannya ke WaveSocket.

Siapkan server WireGuard

Langkah-langkah ini mengikuti contoh akses jarak jauh WireGuard dalam dokumentasi Netgate.

1. Pasang paket WireGuard dari tab Available Packages di System → Packages.
2. Di VPN → WireGuard → Tunnels, tambahkan terowongan. Aktifkan terowongan tersebut, atur port listen (51820 dalam contoh), buat kunci antarmuka, beri alamat seperti 10.6.210.1/24, lalu pilih Save Tunnel.
3. Di Firewall → Rules, pada tab WAN, tambahkan aturan Pass untuk UDP ke alamat WAN pada port listen. Pada tab WireGuard, tambahkan aturan yang mengizinkan lalu lintas terowongan. Simpan setiap aturan dan pilih Apply Changes.

Jika alamat WAN Anda berubah, siapkan Services → Dynamic DNS dan gunakan nama host tersebut sebagai titik akhir.

Buat klien Apple TV

1. Buat pasangan kunci untuk Apple TV, misalnya dengan wg genkey | tee /dev/stderr | wg pubkey di konsol atau shell SSH pada firewall. Perintah ini menampilkan kunci pribadi, lalu kunci publik, tanpa menyimpan file apa pun. Contoh Netgate menyebutkan bahwa kunci tidak dapat dipakai ulang antarklien.
2. Di VPN → WireGuard → Peers, tambahkan rekan untuk terowongan tersebut. Aktifkan Dynamic Endpoint, tempel kunci publik Apple TV, lalu atur Allowed IPs ke alamat terowongannya, seperti 10.6.210.2/32.
3. Simpan rekan tersebut dan terapkan perubahannya.

Tulis konfigurasi klien

Ganti placeholder berikut dengan nilai Anda sendiri:

• APPLE_TV_PRIVATE_KEY: kunci pribadi Apple TV yang Anda buat di bagian sebelumnya
• FIREWALL_TUNNEL_PUBLIC_KEY: kunci publik terowongan di VPN → WireGuard → Tunnels
• vpn.example.com: alamat WAN atau nama host DDNS Anda
• 10.6.0.0/24: jaringan rumah Anda

Address menggunakan alamat IP yang sama dengan Allowed IPs milik rekan (10.6.210.2), tetapi dengan mask terowongan (/24), seperti pada contoh di bawah.

[Interface]
PrivateKey = APPLE_TV_PRIVATE_KEY
Address = 10.6.210.2/24

[Peer]
PublicKey = FIREWALL_TUNNEL_PUBLIC_KEY
AllowedIPs = 10.6.210.1/32, 10.6.0.0/24
Endpoint = vpn.example.com:51820

Contoh ini hanya mengirim lalu lintas untuk terowongan dan satu jaringan rumah melalui VPN. Untuk mengirim semua lalu lintas IPv4, atur AllowedIPs = 0.0.0.0/0 dan tambahkan DNS = 10.6.210.1 ke bagian [Interface]. IPv6 memerlukan alamat terowongannya sendiri dan ::/0; lihat rute dan jaringan rumah Anda.

Impor di Apple TV

1. Di Apple TV, buka WaveSocket dan pilih Profil → Tambah profil VPN → Unggah dari browser, lalu pilih Mulai sesi unggah. Jika VPN sedang terhubung, putuskan sambungan terlebih dahulu.
2. Di ponsel atau komputer yang berada di jaringan yang sama dengan Apple TV, pindai kode QR di TV atau buka alamat yang ditampilkan. Masukkan kode yang ditampilkan di TV ke bidang Kode 4 digit.
3. Di bagian Metode impor, pilih Tempel teks konfigurasi, tempel konfigurasi lengkapnya, lalu pilih Kirim ke Apple TV.
4. Tinjau profil di Apple TV. Pilih Ubah nama untuk memberinya nama yang jelas, misalnya VPN Rumah, lalu pilih Simpan profil.

Gunakan jaringan tepercaya untuk transfer. Jika Apple TV berada di jaringan bersama, seperti Wi-Fi di penginapan liburan, impor profil di rumah sebelum Anda membawa Apple TV ke sana. Panduan impor menjelaskan mengapa jaringan tersebut harus tepercaya.

Hubungkan dan periksa

Lakukan koneksi saat Apple TV berada di jaringan di luar rumah Anda. Pengujian dari dalam jaringan rumah Anda mungkin tidak menunjukkan apakah akses jarak jauh berfungsi.

WaveSocket memilih profil yang disimpan dan membuka Koneksi. Pilih Sambungkan. Saat pertama kali, izinkan Apple TV menambahkan konfigurasi VPN. Cari Server terverifikasi dan waktu terkini di samping Usia handshake peer terlama, lalu buka layanan rumah yang Anda kenal melalui alamatnya.

Jika titik akhirnya berupa nama host DDNS, WaveSocket menyelesaikan nama host tersebut sebelum terhubung dan memeriksanya lagi selama terhubung; lihat DNS & alamat server.

Setiap fitur WaveSocket gratis selama tiga menit per koneksi, sehingga Anda dapat mencoba pengaturan ini sebelum memilih akses seumur hidup WaveSocket, yang menghilangkan batas waktu tersebut.

Jika tidak dapat terhubung

• Tidak ada terowongan. Pastikan Enable aktif di VPN → WireGuard → Settings.
• Tidak ada handshake. Pastikan kunci publik rekan merupakan pasangan dari kunci pribadi Apple TV, dan PublicKey di konfigurasi klien adalah kunci publik terowongan. Periksa aturan WAN, dan pastikan titik akhir diselesaikan ke alamat WAN Anda saat ini.
• Tidak ada internet dengan terowongan penuh. Pastikan Firewall → NAT → Outbound menerjemahkan jaringan terowongan (10.6.210.0/24) ke alamat WAN. Jika pencarian nama gagal, periksa Services → DNS Resolver → Access Lists.
• Terputus saat menganggur. Jika ada firewall lain di antara Apple TV dan internet, tambahkan PersistentKeepalive = 25 ke bagian [Peer]. Untuk profil yang sudah disimpan, putuskan sambungan dan atur PersistentKeepalive di Edit profil.

Langkah-langkah ini didasarkan pada dokumentasi Netgate yang telah dipublikasikan, sebagaimana diperiksa pada 16 Oktober 2026, bukan pada pengujian yang dilakukan WaveSocket sendiri dengan perangkat lunak pfSense. Label menu dapat berubah antarversi; jika demikian, ikuti dokumentasi terbaru. pfSense® adalah merek terdaftar milik Electric Sheep Fencing LLC (“ESF”) dan tidak boleh digunakan tanpa izin tertulis yang tegas dari ESF sebelumnya. Netgate® adalah merek terdaftar milik Rubicon Communications LLC dan tidak boleh digunakan tanpa izin tertulis yang tegas dari Rubicon Communications LLC sebelumnya. WaveSocket adalah aplikasi independen. Baik situs ini maupun aplikasinya tidak berafiliasi dengan atau disetujui oleh ESF atau Rubicon Communications LLC.