Hubungkan Apple TV ke firewall OPNsense

Kapan pengaturan ini cocok

Gunakan pengaturan ini saat Apple TV berada jauh dari rumah, misalnya di penginapan liburan, dan perlu terhubung kembali ke rumah melalui firewall yang menjalankan OPNsense®. OPNsense menyebutnya pengaturan Road Warrior.

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 dan alamat WAN yang dapat dijangkau oleh Apple TV
• OPNsense 24.1.6 atau yang lebih baru: WireGuard sudah menjadi bawaan sejak 24.1, dan generator rekan memiliki bidang DNS sejak 24.1.6
• ponsel atau komputer di jaringan yang sama dengan Apple TV untuk transfer

Tombol Save dan opsi Store private key on this firewall yang disebutkan di bawah memerlukan OPNsense 26.7.3 atau yang lebih baru. Pada versi yang lebih lama, gunakan tombol tanda centang di samping Store and generate next; dengan begitu, kunci pribadi tidak pernah disimpan.

Siapkan server WireGuard

Langkah-langkah ini mengikuti panduan WireGuard Road Warrior dari OPNsense.

1. Di VPN → WireGuard → Instances, tambahkan instans. Gunakan ikon roda gigi untuk membuat kuncinya, atur port listen seperti 51820 dan alamat terowongan seperti 10.10.10.1/24, lalu simpan instans tersebut.
2. Aktifkan Enable WireGuard, yang ditampilkan di bawah daftar Instances dan Peers, lalu pilih Apply.
3. Di Firewall → Rules → WAN, tambahkan aturan Pass untuk UDP ke alamat WAN pada port listen.
4. Di Interfaces → Assignments, tetapkan perangkat WireGuard (misalnya wg1). Buka antarmuka baru tersebut, aktifkan, simpan, lalu pilih Apply changes. Kemudian mulai ulang WireGuard: nonaktifkan lalu aktifkan kembali Enable WireGuard, dan pilih Apply setiap kali.
5. Tambahkan aturan firewall pada antarmuka tersebut yang mengizinkan Apple TV menjangkau jaringan atau perangkat yang Anda pilih. Panduan OPNsense menjelaskan kapan Source NAT keluar dan pemuatan ulang DNS Unbound diperlukan.

Jika alamat WAN Anda berubah-ubah, pasang plugin os-ddclient dari System → Firmware → Plugins dan siapkan di Services → Dynamic DNS.

Buat klien Apple TV

1. Buka VPN → WireGuard → Peer generator dan pilih instans Anda.
2. Masukkan Endpoint: alamat publik atau nama DNS Anda beserta portnya, seperti vpn.example.com:51820.
3. Beri nama rekan, misalnya Apple TV, dan periksa Address yang diusulkan. Allowed IPs mengusulkan semua lalu lintas (0.0.0.0/0,::/0), kecuali jika instans menyimpan nilainya sendiri (26.7.3 atau yang lebih baru). Untuk hanya menjangkau jaringan rumah Anda, masukkan jaringan terowongan dan jaringan rumah, seperti 10.10.10.0/24, 192.168.1.0/24. Server DNS apa pun yang Anda atur harus berada di dalam jaringan-jaringan tersebut.
4. Agar OPNsense menangani pencarian nama, atur DNS Servers ke alamat terowongan, seperti 10.10.10.1. Selama terhubung, WaveSocket menggunakan alamat ini sebagai DNS terowongan, sehingga Unbound di OPNsense harus menjawab kueri dari jaringan terowongan.
5. Salin seluruh teks dari bidang Config. Lalu pilih Save, kemudian Apply.

Salin teks tersebut sebelum menyimpan. Kecuali Anda mengaktifkan Store private key on this firewall, OPNsense hanya menyimpan kunci publik dan tidak dapat membuat ulang konfigurasi di kemudian hari. Buat rekan baru jika Anda kehilangan konfigurasi tersebut.

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. Di OPNsense, VPN → WireGuard → Status menampilkan handshake terakhir rekan tersebut.

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 handshake. Periksa aturan WAN, dan pastikan titik akhir mengarah ke alamat publik Anda saat ini.
• Beberapa aplikasi tidak termuat. Jika handshake berhasil tetapi beberapa aplikasi macet atau hanya termuat sebagian, tinjau MTU dan aturan Normalization (MSS clamping) di panduan OPNsense. Di WaveSocket, putuskan sambungan dan sesuaikan MTU di Edit profil. Jika konfigurasi tidak memiliki baris MTU, WaveSocket menggunakan 1280.
• Di balik NAT tingkat operator atau router lain. Keduanya dapat memblokir koneksi masuk. Mintalah alamat IP publik kepada penyedia internet Anda, atau teruskan port di router yang berada di antara OPNsense dan internet. Dokumentasi OPNsense tidak membahas kasus ini.

Untuk rute dan jaringan yang tumpang tindih, lihat rute dan jaringan rumah Anda.

Langkah-langkah ini didasarkan pada dokumentasi OPNsense yang telah dipublikasikan, sebagaimana diperiksa pada 16 Oktober 2026, bukan pada pengujian yang dilakukan WaveSocket sendiri dengan OPNsense. Label menu dapat berubah antarversi; jika demikian, ikuti dokumentasi terbaru. OPNsense® adalah merek dagang terdaftar milik pemiliknya. WaveSocket adalah aplikasi independen yang tidak berafiliasi dengan atau disetujui oleh proyek OPNsense atau Deciso B.V.