↓ Lewati ke konten utama
  1. Posts/

Cara Setup NetBird sebagai Alternatif Tailscale untuk Homelab

Noor Khafidzin
Penulis
Noor Khafidzin
Seorang homelab enthusiast yang terobsesi pada efisiensi sistem dan seni pemecahan masalah (troubleshooting).
Daftar isi

Pendahuluan
#

Anda sedang di kafe dengan laptop, lalu ingin membuka dashboard yang berjalan di server rumah. Jawaban lama untuk kebutuhan ini adalah port forward, dynamic DNS, dan satu aturan firewall yang nanti terlupakan. Jawaban yang lebih rapi adalah mesh VPN: setiap perangkat menghubungi keluar, dan tidak ada port yang terbuka ke internet.

Tailscale adalah nama pertama yang muncul saat orang mencari solusi semacam ini. NetBird mengerjakan hal yang sama, dan control plane-nya open source, jadi nanti Anda bisa pindah ke deployment mandiri tanpa mengubah cara perangkat terhubung.

Artikel ini menyiapkan NetBird untuk jaringan rumah. Ada server Ubuntu 24.04 atau lebih baru yang sekaligus menjadi gerbang ke seluruh LAN. Ada juga satu laptop dan satu ponsel Android. Server dan ponsel mendaftar memakai setup key, karena itu jalur yang saya rekomendasikan. Laptop memakai login SSO biasa supaya Anda bisa membandingkan keduanya.

Versi 30 detik: buat setup key, pasang NetBird di server, daftarkan dengan sudo netbird up --setup-key, lalu buat Network di dashboard yang membuka 192.168.1.0/24 lewat server tersebut. Tambahkan policy, pasang aplikasi Android, selesai.

Apa saja yang didapat dari free plan
#

Tutorial ini memakai cloud NetBird di app.netbird.io, jadi batasannya perlu diketahui sejak awal.

Item Free plan
Harga €0
Pengguna maksimal 5
Mesin 100
Fitur enkripsi peer-to-peer, Networks, SSO sosial dan MFA, access control, private DNS, Network Routes, NetBird SSH
Dukungan komunitas

Bagi homelab, 100 mesin jauh melebihi kebutuhan rak Proxmox dan beberapa ponsel. Batas pengguna yang perlu diperhatikan: semua perangkat yang login lewat SSO dihitung sebagai pengguna, jadi lima orang adalah plafon praktis untuk satu rumah. Paket berbayar mulai €6 per pengguna per bulan dan menambah identity provider enterprise, audit log, serta posture check perangkat.

Cara lain melewati batas itu adalah menjalankan control plane sendiri, dan NetBird mendukungnya. Pekerjaannya terpisah karena butuh database dan sertifikat sendiri, ditambah proses upgrade yang harus Anda urus, jadi artikel ini tetap di jalur cloud.

Catatan soal screenshot: gambar di artikel ini diambil dari deployment NetBird self-hosted, jadi nama peer berakhiran .netbird.selfhosted dan beberapa mesin di daftar peer berasal dari jaringan uji tersebut. Di NetBird Cloud, peer yang sama muncul dengan akhiran .netbird.cloud, dan pendaftaran memakai https://api.netbird.io:443. Menu dan semua langkah di bawah tetap sama.

Gambaran setup
#

Perangkat Peran Alamat
homeserver Ubuntu 24.04+, peer NetBird, routing peer untuk LAN 192.168.1.10
Laptop peer biasa, dipakai sebagai klien “di luar rumah” DHCP
Ponsel Android peer biasa, diuji lewat data seluler DHCP

Alamat pada tabel itu hanya contoh, jadi ganti 192.168.1.0/24 dan 192.168.1.10 sesuai jaringan Anda. Sisanya tidak berubah.

NetBird memberi setiap peer alamat di rentang 100.64.0.0/10 pada antarmuka wt0. Jaringan overlay itu terpisah dari LAN, dan karena itulah laptop bisa menghubungi 100.x.y.z dari mana saja sementara 192.168.1.10 tetap berarti server di rumah.

Langkah 1: buat akun dan setup key
#

Login ke app.netbird.io memakai Google, Microsoft, GitHub, atau tautan email. Perangkat pertama yang Anda tambahkan biasanya sekaligus membuat akun.

Setelah masuk, buka Settings → Setup Keys → Create Setup Key.

Dialog Create Setup Key dengan nama, tipe, masa berlaku, dan batas pemakaian terisi
Settings → Setup Keys → Create Setup Key

Isi seperti ini:

  • Nama: homelab-server
  • Tipe: reusable
  • Masa berlaku: 7 hari (dialog sudah mengisinya otomatis)
  • Batas pemakaian: 3
  • Auto-assign group: kosongkan dulu

Key reusable dengan batas pemakaian rendah adalah jalan tengah yang wajar. Key one-off memang lebih ketat, tetapi Anda akan mendaftarkan mesin kedua lebih cepat dari perkiraan dan harus membuat key baru. Tiga kali pakai cukup untuk server dan satu perangkat cadangan, dengan sisa satu untuk kesalahan.

Salin key saat muncul, karena NetBird tidak menampilkannya lagi secara lengkap.

Dua hal yang perlu diketahui sebelum Anda mengklik menu lain:

  • Peers → Add Peer → Generate Key juga bisa dipakai, tetapi cara itu membuat key one-off yang kedaluwarsa dalam 24 jam tanpa group. Halaman Settings memberi Anda kendali penuh atas semuanya.
  • Peer yang didaftarkan dengan setup key tidak terkena masa berlaku sesi login. Ini penting untuk server yang harus tetap terhubung berbulan-bulan tanpa ada orang membuka browser di mesin itu.

Langkah 2: pasang NetBird di Ubuntu
#

Skrip instalasi menangani repository, paket, dan unit systemd sekaligus:

curl -fsSL https://pkgs.netbird.io/install.sh | sh

Skrip ini mendeteksi distribusi dan arsitektur, menambahkan repository paket NetBird, lalu memasang netbird beserta service netbird. Di server tanpa layar, aplikasi desktop tidak diperlukan, jadi CLI sudah cukup.

Pastikan daemon-nya jalan:

sudo systemctl status netbird --no-pager

Kalau service masih inactive, nyalakan dan aktifkan:

sudo systemctl enable --now netbird

Sekarang daftarkan mesin dengan key dari langkah 1:

sudo netbird up --setup-key <SETUP-KEY>

Pakai sudo di sini. Klien menyimpan profil terpisah untuk tiap pengguna sistem operasi, dan peer yang didaftarkan sebagai root adalah yang dipakai service systemd. Mendaftar sebagai pengguna biasa akan membuat profil lain yang tidak disentuh service.

Periksa hasilnya:

sudo netbird status
ip addr show wt0

netbird status menampilkan alamat management server, IP NetBird peer, dan status koneksi. wt0 adalah antarmuka WireGuard, dan baris inet di sana berisi alamat 100.x yang dipakai peer lain.

Keluaran sudo netbird status yang menunjukkan Connected dan alamat peer 100.x
netbird status di server Ubuntu setelah pendaftaran

Kalau lebih suka apt daripada skrip instalasi
#

Paketnya juga tersedia di repository APT bertanda tangan:

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg -y
curl -sSL https://pkgs.netbird.io/debian/public.key | sudo gpg --dearmor --output /usr/share/keyrings/netbird-archive-keyring.gpg
echo 'deb [signed-by=/usr/share/keyrings/netbird-archive-keyring.gpg] https://pkgs.netbird.io/debian stable main' | sudo tee /etc/apt/sources.list.d/netbird.list
sudo apt-get update
sudo apt-get install netbird

Hasilnya sama. Pilih satu cara dan pakai terus, supaya proses upgrade nanti sesuai dengan cara paket itu dipasang.

Langkah 3: daftarkan laptop lewat SSO
#

Di mesin yang Anda pakai langsung dengan browser, login interaktif lebih sederhana daripada mengoper key. Pasang klien sesuai sistem operasi dari halaman unduhan, lalu jalankan:

netbird up

Perintah itu membuka jendela browser, Anda login dengan akun dashboard yang sama, lalu peer muncul di konsol. Di desktop, sudo tidak diperlukan.

Akunnya sama, jadi laptop masuk ke jaringan yang sama dengan server. Yang berbeda hanya cara pendaftaran, bukan jaringannya.

Halaman Peers dengan mesin yang terdaftar di jaringan uji ini
Halaman Peers; daftarnya bertambah saat mesin didaftarkan

Sampai di sini kedua mesin sudah bisa saling menghubungi lewat alamat 100.x, karena NetBird membuat policy default yang mengizinkan semua peer berkomunikasi dengan semua peer. Policy itu hanya alat bantu onboarding, dan nanti kita hapus setelah policy sungguhan tersedia.

Langkah 4: hubungkan ponsel Android
#

Pasang NetBird dari Play Store, atau ambil APK dari rilis GitHub proyek kalau Anda menghindari layanan Play.

Saat pertama dibuka, ketuk Continue untuk menerima management server bawaan. Setelah itu:

  1. Buka menu hamburger di kiri atas, pilih Change Server.
  2. Isi https://api.netbird.io:443.
  3. Pilih + Add this device with a setup key, lalu tempel key dari langkah 1.
  4. Ketuk Change, kemudian ketuk logo NetBird untuk terhubung.
  5. Izinkan permintaan koneksi VPN saat Android bertanya.
Aplikasi Android setelah terhubung, menampilkan nama peer dan status Connected
NetBird di Android, terdaftar dengan setup key dan terhubung lewat data seluler

Mengganti server akan menghapus konfigurasi aplikasi yang ada, dan itu tidak masalah pada instalasi baru. Kalau Anda melewati setup key, aplikasi akan meminta login lewat browser, dan cara itu juga berfungsi. Key dipakai supaya ponsel tidak perlu bolak-balik membuka browser setiap kali memasang ulang.

Sekarang uji dengan Wi-Fi dimatikan, lalu buka browser di ponsel dan akses layanan apa pun di 192.168.1.10. Hasilnya belum bisa dibuka, karena belum ada yang memberi tahu NetBird bahwa LAN di belakang server bisa dijangkau.

Langkah 5: buat group
#

Group adalah label untuk peer dan resource, dan policy menunjuk ke group, bukan ke mesin satu per satu. Itulah yang membuat aturan tetap mudah dibaca nanti.

Buka Access Control → Groups dan buat dua group:

Group Anggota
remote-devices laptop, ponsel Android
homelab server Ubuntu

Taruh server di group sendiri sejak sekarang, karena group itu dibutuhkan kalau nanti Anda ingin menjangkau layanan yang berjalan langsung di server. Policy untuk layanan semacam itu berbeda jenis dari policy untuk LAN di belakang server.

Access Control → Groups dengan homelab, jellyfin-only, dan group remote-devices yang baru
Halaman Groups dari jaringan uji

Kalau ingin mesin baru otomatis masuk group, edit setup key lalu isi Auto-assign groups. Pengaturan itu hanya berlaku untuk peer yang didaftarkan setelah perubahan, jadi peer yang sudah ada tetap diatur manual.

Langkah 6: buka LAN dengan Network
#

Untuk menggantikan VPN site-to-site konvensional, buka Networking → Network Routing → Networks, lalu tambahkan Network bernama Home LAN.

Di dalamnya, tambahkan resource:

  • Nama: home-lan
  • Alamat: 192.168.1.0/24
  • Resource group: home-lan-resources (buat di dialog yang sama)

Setelah itu tetapkan server Ubuntu sebagai routing peer untuk Network ini.

Dialog Add Network dengan resource Home LAN dan server sebagai routing peer
Network dengan satu resource /24 dan server sebagai routing peer

Sekarang policy aksesnya, di tab Access Control pada dialog resource atau di Access Control → Policies:

  • Source: remote-devices
  • Destination: home-lan-resources
  • Protocol: ALL
  • Port: pemilih port nonaktif selama protocol masih ALL

Tidak ada yang bisa dijangkau sampai policy ini ada. Itu memang perilaku yang diinginkan, dan di sinilah bedanya dengan fitur Routes lama yang membuka semua akses bila tidak diberi ACL group. Routes sendiri sekarang deprecated untuk semua kebutuhan selain exit node, jadi Networks adalah jalur yang dipakai.

Resource /24 praktis karena semua perangkat di LAN langsung terjangkau tanpa membuka dashboard lagi. Cakupannya juga lebar. Kalau ada satu host yang lebih sensitif, misalnya mesin penyimpanan backup, tambahkan host itu sebagai resource /32 dengan group sendiri dan policy yang lebih sempit. Keduanya bisa dipakai bersamaan.

Editor policy dengan remote-devices sebagai source dan home-lan-resources sebagai destination
Policy yang mengizinkan remote-devices menjangkau LAN rumah

Masquerade aktif secara default pada routing peer. Trafik dari ponsel tiba di LAN dengan alamat server sebagai sumber, jadi router tidak perlu tahu rute balik dan tidak ada perangkat LAN yang perlu memasang NetBird.

Langkah 7: hapus policy default tanpa memutus akses
#

Policy default yang mengizinkan semua ke semua masih aktif. Sebelum menghapusnya, pastikan akses yang Anda butuhkan sudah tercakup.

Trafik Policy yang dibutuhkan
Ponsel dan laptop ke perangkat LAN di belakang server Policy Network dari langkah 6
Ponsel dan laptop ke layanan yang berjalan di server itu sendiri Policy peer-to-peer: remote-devices → homelab
Server ke laptop, misalnya untuk mengirim backup Policy peer-to-peer dengan arah sebaliknya

Baris kedua yang sering terlewat. Policy resource Network mengatur trafik yang melewati routing peer. Dashboard, daemon SSH, atau file share yang berjalan di routing peer itu sendiri termasuk input chain peer tersebut, dan butuh policy peer-to-peer dengan group server sebagai destination. Buat policy itu sebelum menghapus policy default.

Setelah itu buka Access Control → Policies, pilih aturan default All ke All, lalu hapus.

Langkah 8: uji dari luar rumah
#

Matikan Wi-Fi di ponsel dan pakai data seluler. Lalu:

  1. Buka aplikasi NetBird dan pastikan statusnya Connected.
  2. Dari terminal laptop, jalankan netbird networks ls untuk melihat rute yang diterima klien.
  3. Ping server: ping 192.168.1.10.
  4. Buka salah satu web UI di LAN lewat alamatnya, misalnya http://192.168.1.10:8080.

netbird status -d di klien menunjukkan routing peer mana yang membawa tiap rute. Kalau rutenya terdaftar tetapi tidak ada jawaban, penyebabnya hampir selalu policy atau layanan yang hanya mendengarkan di localhost.

Keluaran netbird networks ls di laptop yang menampilkan rute Home LAN
Rute yang diterima laptop dari Network Home LAN

Opsional: pakai server sebagai exit node
#

Exit node mengirim seluruh trafik internet perangkat lewat koneksi rumah. Berguna saat Anda ingin memakai IP rumah, Pi-hole, atau jaringan yang hanya mengizinkan satu titik keluar. Imbalannya kecepatan: laju upload rumah menjadi plafon untuk semua yang dilakukan ponsel.

Langkahnya:

  1. Buka Peers, pilih peer yang akan menjadi exit node. Mesin kecil yang selalu menyala sudah cukup, dan host itu tidak harus sama dengan routing peer untuk LAN.
  2. Klik Add Exit Node.
  3. Tetapkan group remote-devices sebagai distribution group.
  4. Biarkan Auto Apply aktif kalau Anda ingin perangkat yang terhubung langsung memakainya, atau matikan supaya pengguna memilih sendiri dari menu klien.
Rute exit node dengan distribution group remote-devices
Rute exit node yang dilayani sebuah routing peer

Dua hal yang perlu dicek setelah itu:

  • DNS. Tambahkan nameserver dengan match domain ALL, supaya kueri DNS ikut masuk terowongan dan tidak bocor ke jaringan lokal.
  • Block LAN access. Rute 0.0.0.0/0 cocok dengan semua trafik, termasuk LAN milik routing peer itu sendiri. Kalau peer tersebut juga melayani Network dari langkah 6, jangan aktifkan Block LAN access di mesin itu, karena opsi tersebut memutus rute LAN yang dilayani peer yang sama. Block LAN access lebih tepat dipakai pada exit node khusus yang tidak mengerjakan hal lain.

Rute exit node adalah satu-satunya kasus yang masih memakai model Routes lama, bukan Networks. Itu detail di dashboard, bukan alasan untuk menghindari fiturnya.

Kalau ada masalah
#

Gejala Penyebab yang paling sering Perbaikan
netbird status menunjukkan Disconnected daemon berhenti, atau setup key kedaluwarsa sebelum dipakai sudo systemctl restart netbird, lalu daftar ulang dengan key baru
Peer terhubung tetapi LAN tidak menjawab policy belum ada, atau group tujuan belum menempel ke resource Cek ulang group source dan destination di policy
Layanan di server sendiri tidak terjangkau policy Network hanya mencakup forward chain, bukan layanan peer itu sendiri Tambahkan policy peer-to-peer dengan group homelab sebagai destination
Resource domain tidak resolve routing peer tidak bisa me-resolve nama tersebut Tambahkan nameserver untuk group routing peer, atau pakai resource IP
Android terhubung tetapi tidak ada yang terbuka exit node dipilih tanpa entri DNS, atau policy belum ada Tambahkan DNS ALL, lalu buka ulang aplikasi
Semua akses mati setelah policy default dihapus belum ada policy peer-to-peer pengganti Buat ulang policy default sementara, lalu tambahkan aturan yang hilang

Catatan keamanan
#

Perlakukan setup key seperti kata sandi jaringan Anda. Cabut key di Settings → Setup Keys setelah semua perangkat terdaftar, dan ketahui bahwa pencabutan key tidak memutus mesin yang sudah memakainya. Kalau ada laptop hilang, hapus peer-nya.

Hapus policy semua ke semua lebih awal. Inti model Network adalah akses yang eksplisit, dan membiarkan aturan izin menyeluruh membuat semuanya kembali terbuka.

Utamakan resource /32 untuk hal yang sensitif, dan pisahkan exit node dari routing peer kalau memungkinkan. Exit node dengan Block LAN access yang aktif adalah batas yang lebih bersih daripada satu mesin yang mengerjakan dua pekerjaan sekaligus.

Penutup
#

Bagian yang benar-benar penting cuma sedikit: satu setup key, satu instalasi, satu Network, satu policy. Sisanya merapikan dashboard.

Setelah ini berjalan, langkah berikutnya yang wajar adalah memindahkan control plane ke server sendiri. NetBird dirancang untuk itu, dan konfigurasi klien di perangkat Anda hampir tidak berubah.

Terkait


Muat Komentar