Di era digital saat ini, kebutuhan akan koneksi jaringan yang aman, cepat, dan privat menjadi hal yang sangat krusial. Baik untuk kebutuhan personal seperti mengakses server rumah (Home Lab), hingga kebutuhan korporasi untuk menghubungkan infrastruktur cloud dengan kantor cabang. Metode tradisional seperti membuka port forwarding di router atau menggunakan VPN konvensional (seperti OpenVPN) sering kali memiliki kelemahan dari sisi keamanan, kecepatan, serta kerumitan konfigurasi.
Untungnya, kini hadir teknologi modern yang berbasis Zero Trust Network Access (ZTNA) dan protokol WireGuard yang super cepat. Salah satu platform terbaik di kategori ini adalah Netbird. Dalam panduan komprehensif ini, kita akan membahas secara tuntas mengenai cara install netbird secara self-hosted di server Anda sendiri. Dengan melakukan self-hosting, Anda memiliki kendali penuh atas data dan koordinasi jaringan tanpa bergantung pada server pihak ketiga, 100% gratis, dan selesai dalam waktu kurang dari 10 menit!
—
Apa itu Netbird dan Mengapa Anda Menyukainya?
Netbird adalah platform jaringan overlay (overlay network) open-source yang memungkinkan Anda membuat jaringan privat virtual (mesh VPN) yang menghubungkan berbagai perangkat secara langsung (peer-to-peer) tanpa konfigurasi firewall yang rumit. Netbird menyembunyikan perangkat Anda dari internet publik dan menggunakan prinsip Zero Trust—artinya, tidak ada perangkat yang dipercaya secara default sebelum melewati autentikasi.
Berbeda dengan VPN tradisional yang menggunakan arsitektur Hub-and-Spoke (di mana semua lalu lintas data harus melewati satu server pusat yang menjadi bottleneck), Netbird menggunakan arsitektur Mesh Jaringan. Pada jaringan mesh, setiap perangkat berkomunikasi langsung satu sama lain menggunakan enkripsi WireGuard tingkat militer. Server Netbird (Management Server) hanya berfungsi sebagai “makelar” atau fasilitator untuk mempertemukan perangkat-perangkat tersebut (melalui teknik NAT Traversal/STUN/TURN).
Fitur Unggulan Netbird
- Koneksi Peer-to-Peer (P2P) Otomatis: Menggunakan protokol ICE/STUN/TURN untuk menembus NAT ganda dan firewall tanpa perlu membuka port pada router lokal Anda.
- Enkripsi WireGuard: Protokol VPN modern yang terkenal sangat cepat, ringan, dan ramah baterai untuk perangkat mobile dibandingkan OpenVPN atau IPsec.
- Access Control Lists (ACL): Aturan firewall granular yang memungkinkan Anda mengatur perangkat mana saja yang boleh saling berkomunikasi melalui dasbor web yang intuitif.
- Integrasi Identity Provider (IdP): Mendukung autentikasi Single Sign-On (SSO) menggunakan Google Workspace, Microsoft AD, Okta, Keycloak, Auth0, atau Zitadel.
- Rute Jaringan (Network Routes): Berfungsi sebagai subnet router untuk mengekspos jaringan lokal (LAN) di belakang sebuah peer ke seluruh jaringan Netbird tanpa harus menginstal client di setiap mesin lokal.
- MFA/2FA Support: Menambahkan lapisan keamanan ekstra saat perangkat ingin bergabung ke dalam jaringan mesh Anda.
—
Mengapa Memilih Cara Install Netbird Dibanding Tailscale?
Pertanyaan ini sangat sering diajukan oleh para penggiat IT. Tailscale adalah kompetitor utama Netbird yang juga sangat populer. Namun, Netbird memiliki beberapa keunggulan signifikan, terutama bagi Anda yang menyukai privasi total dan filosofi open-source:
Pertama, Netbird sepenuhnya open-source dari sisi client hingga dashboard manajemen kontrolnya. Tailscale, di sisi lain, menggunakan server koordinasi closed-source (meskipun ada alternatif open-source bernama Headscale, konfigurasinya cukup rumit dan tidak memiliki dasbor web resmi yang selengkap Netbird).
Kedua, proses integrasi Identity Provider (IdP) pada instalasi self-hosted Netbird jauh lebih fleksibel. Anda dapat mengintegrasikannya dengan server autentikasi lokal Anda seperti Keycloak atau Authentik, menjadikannya pilihan sempurna untuk lingkungan enterprise yang membutuhkan kepatuhan regulasi data yang ketat.
—
Persiapan Sebelum Memulai Instalasi
Sebelum kita masuk ke dalam panduan praktis cara install netbird, ada beberapa prasyarat (prerequisites) yang harus Anda persiapkan terlebih dahulu agar proses instalasi berjalan lancar tanpa hambatan:
- Virtual Private Server (VPS): Sebuah VPS dengan sistem operasi Linux (sangat direkomendasikan Ubuntu 22.04 LTS atau Debian 11/12). Spesifikasi minimal cukup 1 vCPU dan 1 GB RAM. Anda bisa menyewanya di provider lokal maupun global seperti DigitalOcean, Linode, atau Vultr.
- Nama Domain Aktif: Anda membutuhkan sebuah domain (misalnya:
domainku.com) atau subdomain (misalnya:netbird.domainku.com). Akses kontrol panel DNS domain Anda untuk membuat A Record yang mengarah ke IP publik VPS Anda. - Docker & Docker Compose: Netbird self-hosted didistribusikan menggunakan kontainer Docker. Pastikan Docker sudah terinstal di server Anda.
- Identity Provider (IdP): Netbird membutuhkan sistem autentikasi pengguna. Kita akan menggunakan Zitadel (karena sangat mudah di-deploy bersama Netbird) atau Auth0 (opsi cloud gratis yang sangat stabil). Dalam panduan ini, kita akan menggunakan skenario instalasi cepat Netbird yang memanfaatkan penyedia identitas default atau integrasi eksternal.
—
Langkah-Langkah Cara Install Netbird Self-Hosted
Di bagian ini, kita akan mempraktikkan proses instalasi Netbird secara self-hosted menggunakan script otomatis resmi dari Netbird yang menggabungkan seluruh komponen (Dashboard, Management Server, Signal Server, dan Coturn) ke dalam Docker Compose.
Langkah 1: Mengonfigurasi DNS Record
Langkah pertama yang wajib dilakukan adalah mengarahkan domain Anda ke IP VPS. Masuk ke penyedia domain Anda (Cloudflare, Niagahoster, dll.) dan buatlah DNS Record sebagai berikut:
- Type: A
- Name:
netbird(atau subdomain pilihan Anda) - IPv4 Address: [IP_Address_VPS_Anda]
- TTL: Auto / 3600
Pastikan propagasi DNS telah selesai. Anda bisa mengeceknya dengan menjalankan perintah ping netbird.domainku.com di terminal komputer Anda.
Langkah 2: Mempersiapkan Server dan Menginstal Docker
Hubungkan komputer Anda ke VPS menggunakan SSH:
ssh root@ip_vps_anda
Lakukan update sistem dan instalasi dependensi dasar yang diperlukan:
sudo apt update && sudo apt upgrade -y
sudo apt install curl git software-properties-common -y
Jika VPS Anda belum terinstal Docker dan Docker Compose, Anda dapat menginstalnya dengan script resmi di bawah ini:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
Periksa apakah Docker sudah berjalan dengan baik:
sudo systemctl status docker
Langkah 3: Mengunduh Script Instalasi Netbird
Netbird menyediakan script instalasi otomatis yang sangat memudahkan kita. Script ini akan mengonfigurasi file environment, mengunduh file Docker Compose, dan menyiapkan sertifikat SSL dari Let’s Encrypt secara otomatis.
Jalankan perintah berikut untuk mengunduh script installer Netbird:
curl -O https://raw.githubusercontent.com/netbirdio/netbird/main/infrastructure_files/setup.sh
chmod +x setup.sh
Langkah 4: Menjalankan Konfigurasi Awal Netbird
Kini saatnya menjalankan script konfigurasi. Script ini membutuhkan beberapa argumen, termasuk domain yang Anda gunakan dan konfigurasi Identity Provider. Pada contoh ini, kita akan menggunakan integrasi dengan Zitadel atau Auth0. Untuk kemudahan setup awal tanpa pusing mengonfigurasi IdP sendiri, Netbird menyediakan opsi integrasi otomatis.
Jalankan perintah setup berikut (ganti subdomain dan email sesuai milik Anda):
./setup.sh --domain netbird.domainku.com --email [email protected]
Script tersebut akan melakukan tugas-tugas berikut secara otomatis:
- Membuat direktori kerja baru di server Anda.
- Mengunduh file template
docker-compose.ymldan file konfigurasi. - Meminta sertifikat SSL gratis dari Let’s Encrypt untuk mengamankan komunikasi dashboard Netbird Anda.
- Menghasilkan kunci enkripsi acak untuk keamanan internal sistem Netbird.
Langkah 5: Mengonfigurasi Identity Provider (IdP)
Setelah menjalankan script, sistem akan meminta detail dari Identity Provider Anda. Jika Anda ingin menggunakan Auth0 (layanan gratis hingga 7.000 pengguna), Anda perlu mendaftar akun di Auth0, membuat aplikasi tipe “Regular Web Application”, lalu mengisi informasi berikut ke dalam file konfigurasi setup.env Netbird:
# Buka file setup.env menggunakan nano
nano setup.env
Sesuaikan variabel-variabel berikut berdasarkan data dari panel Auth0 Anda:
NETBIRD_AUTH_AUTHORITY="https://domain-auth0-anda.us.auth0.com/"
NETBIRD_AUTH_CLIENT_ID="Client_ID_Dari_Auth0"
NETBIRD_AUTH_AUDIENCE="https://netbird.domainku.com/"
NETBIRD_USE_ZITADEL=false
Simpan perubahan dengan menekan tombol CTRL + O, lalu tekan Enter, dan keluar dengan CTRL + X.
Langkah 6: Menjalankan Layanan Netbird dengan Docker Compose
Setelah konfigurasi selesai dan tersimpan dengan benar, kita hanya perlu menghidupkan seluruh stack kontainer Netbird menggunakan Docker Compose:
docker compose up -d
Perintah di atas akan mengunduh semua image Docker yang diperlukan (Management, Signal, Dashboard, Coturn) dan menjalankannya di latar belakang. Proses ini biasanya memakan waktu 1 hingga 3 menit tergantung kecepatan internet server Anda.
Untuk memastikan semua kontainer berjalan dengan status “Up”, jalankan perintah berikut:
docker compose ps
Selamat! Server Netbird Anda sekarang sudah aktif dan berjalan. Anda bisa membuka web browser dan mengakses domain Anda di https://netbird.domainku.com. Anda akan langsung diarahkan ke halaman login yang terintegrasi dengan Identity Provider yang Anda konfigurasikan sebelumnya.
—
Cara Menginstal dan Menghubungkan Perangkat Client ke Netbird
Setelah server kontrol (dashboard) Anda aktif, langkah selanjutnya adalah menghubungkan perangkat-perangkat Anda (laptop, smartphone, VPS lain) ke dalam jaringan mesh Netbird Anda.
1. Menginstal Client di OS Linux
Untuk menghubungkan server Linux lain ke jaringan Netbird Anda, jalankan satu baris perintah instalasi otomatis berikut:
curl -FSsl https://pkgs.netbird.io/install.sh | sh
Setelah proses instalasi selesai, jalankan perintah koneksi awal yang merujuk pada server self-hosted Anda:
netbird up --management-url https://netbird.domainku.com
Sistem akan menampilkan sebuah URL unik di terminal. Salin URL tersebut, buka di browser Anda, lalu lakukan login untuk mengautentikasi dan mendaftarkan perangkat Linux tersebut ke dalam jaringan Anda.
2. Menginstal Client di OS Windows
- Unduh file installer Windows resmi dari halaman rilis Netbird atau langsung klik tombol unduh di dashboard web Anda.
- Jalankan file installer
.exetersebut dan ikuti petunjuk instalasi hingga selesai. - Setelah terinstal, cari ikon Netbird di system tray (pojok kanan bawah layar).
- Klik kanan pada ikon Netbird, pilih menu Settings atau Advanced Settings.
- Masukkan URL management server self-hosted Anda:
https://netbird.domainku.compada kolom Management URL. - Klik Connect. Browser Anda secara otomatis akan terbuka dan meminta Anda melakukan login. Setelah sukses, Windows Anda telah terhubung ke jaringan mesh!
3. Menginstal Client di macOS
Anda dapat menginstal client Netbird di Mac menggunakan Homebrew:
brew install netbirdio/tap/netbird
netbird up --management-url https://netbird.domainku.com
Sama seperti di Linux, ikuti tautan autentikasi yang muncul di terminal untuk menyelesaikan proses integrasi perangkat Mac Anda.
4. Menginstal Client di Perangkat Android & iOS
Aplikasi Netbird sudah tersedia secara resmi di Google Play Store dan Apple App Store. Setelah mengunduh aplikasi:
- Buka aplikasi Netbird di smartphone Anda.
- Jangan langsung klik login. Ketuk ikon roda gigi (Settings) di bagian pojok kanan atas.
- Ubah alamat default server dengan memasukkan URL server Anda:
https://netbird.domainku.com. - Kembali ke halaman utama, lalu klik tombol Connect dan lakukan autentikasi menggunakan akun Anda.
—
Konfigurasi Tingkat Lanjut (Advanced Configurations)
Netbird tidak hanya berfungsi untuk menghubungkan perangkat secara direct-peer. Ada beberapa fitur luar biasa lainnya yang dapat Anda konfigurasikan setelah memahami cara install netbird dengan sukses.
1. Mengonfigurasi Subnet Routing (Network Routes)
Misalkan Anda memiliki sebuah server di rumah atau di kantor yang terhubung ke jaringan lokal (LAN) dengan IP 192.168.1.0/24. Anda ingin seluruh perangkat luar yang terhubung ke Netbird bisa mengakses semua perangkat di dalam LAN tersebut tanpa harus menginstal Netbird di setiap komputer kantor.
Hal ini dapat dicapai dengan mudah menggunakan fitur Network Routes di Netbird:
- Tentukan satu perangkat di dalam LAN Anda yang sudah terinstal Netbird untuk bertindak sebagai Routing Peer (Subnet Router).
- Buka dashboard web Netbird Anda di
https://netbird.domainku.com. - Masuk ke menu Network Routes > Klik Add Route.
- Isi nama rute (misalnya: “LAN Kantor”).
- Masukkan range IP lokal pada kolom Network Range, contoh:
192.168.1.0/24. - Pilih perangkat yang bertindak sebagai Routing Peer dari daftar drop-down.
- Aktifkan rute tersebut. Sekarang, semua peer di jaringan Netbird Anda dapat berkomunikasi dengan lancar ke seluruh IP di jaringan kantor Anda!
2. Menggunakan Fitur Exit Node (Mengarahkan Seluruh Traffic Internet)
Apakah Anda sedang berada di cafe dengan Wi-Fi publik yang tidak aman? Anda dapat menggunakan salah satu server VPS Netbird Anda sebagai Exit Node. Fitur ini akan mengalirkan seluruh trafik internet dari perangkat Anda (misalnya laptop atau HP) melewati VPS tersebut, mirip seperti layanan VPN komersial (ExpressVPN, NordVPN), namun menggunakan infrastruktur privat Anda sendiri.
Untuk mengaktifkannya, cukup tambahkan rute baru dengan range IP 0.0.0.0/0 (seluruh internet) dan pilih VPS Anda sebagai routing peer-nya.
—
Tips Keamanan untuk Netbird Self-Hosted
Menjalankan VPN self-hosted memberikan Anda kebebasan penuh, namun juga disertai tanggung jawab untuk menjaga keamanannya. Berikut adalah langkah-langkah praktis untuk memastikan instalasi Netbird Anda tetap aman dari serangan siber:
- Aktifkan Firewall (UFW) di VPS Anda: Hanya izinkan port yang benar-benar dibutuhkan oleh Netbird.
sudo ufw default deny incoming sudo ufw default allow outgoing sudo ufw allow 22/tcp sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw allow 3478/udp sudo ufw allow 49152:65535/udp sudo ufw enable - Rutin Melakukan Update Docker Image: Tim developer Netbird sangat aktif merilis pembaruan keamanan dan fitur baru. Lakukan update kontainer Anda setidaknya sebulan sekali:
docker compose pull docker compose up -d --remove-orphans - Gunakan Autentikasi Dua Faktor (2FA/MFA): Di sisi Identity Provider Anda (misalnya Auth0 atau Zitadel), pastikan Anda mewajibkan penggunaan autentikasi multi-faktor seperti Google Authenticator atau kunci fisik (Yubikey) bagi semua pengguna yang ingin terhubung ke jaringan Netbird Anda.
- Backup File Konfigurasi: Pastikan Anda membackup direktori tempat file
docker-compose.yml,setup.env, dan folder database diletakkan agar Anda dapat melakukan restorasi dengan cepat jika terjadi kegagalan server fisik.
—
Tabel Perbandingan: Netbird vs Tailscale vs VPN Tradisional
Untuk memudahkan Anda melihat keunggulan implementasi teknologi modern seperti Netbird, berikut adalah tabel perbandingan komparatif yang objektif:
| Fitur / Kriteria | Netbird (Self-Hosted) | Tailscale | OpenVPN (Tradisional) |
|---|---|---|---|
| Arsitektur Jaringan | Mesh P2P (WireGuard) | Mesh P2P (WireGuard) | Hub-and-Spoke (Centralized) |
| Sifat Lisensi | 100% Open-Source | Client open-source, server closed-source | Open-Source / Komersial |
| Batas Jumlah Perangkat | Tanpa batas (Sesuai VPS Anda) | Terbatas pada paket gratis (100 peers) | Bebas (Sesuai limit hardware) |
| Web Dashboard | Ada (Self-hosted dashboard gratis) | Ada (Tergantung cloud Tailscale) | Harus diinstal terpisah / Berbayar |
| Kemudahan NAT Traversal | Sangat Mudah (Otomatis) | Sangat Mudah (Otomatis) | Sangat Sulit (Butuh Port Forwarding) |
| Kecepatan & Latensi | Sangat Tinggi (Langsung antar peer) | Sangat Tinggi (Langsung antar peer) | Sedang (Harus memutar ke server VPN) |
—
Pertanyaan yang Sering Diajukan (FAQ)
Apakah Netbird benar-benar gratis jika di-install sendiri?
Ya, 100% gratis tanpa batasan fitur apapun. Seluruh codebase Netbird, baik sisi server maupun client, dilisensikan di bawah lisensi open-source BSD 3-Clause. Satu-satunya biaya yang Anda keluarkan adalah biaya sewa VPS (yang bisa Anda dapatkan mulai dari $3 – $5 per bulan).
Bagaimana jika koneksi peer-to-peer langsung (P2P) gagal terhubung?
Dalam skenario jaringan dengan firewall yang sangat ketat (misalnya di jaringan korporat atau ISP yang menggunakan Symmetric NAT), koneksi P2P langsung terkadang gagal terbentuk. Untuk mengatasi hal ini, Netbird secara otomatis akan mengalihkan lalu lintas data melalui server relay terenkripsi yang disebut TURN server (Coturn) yang sudah terpasang secara built-in dalam proses instalasi di atas. Koneksi Anda dijamin akan tetap terhubung!
Apakah data sensitif saya lewat ke server Netbird pusat?
Tidak. Saat Anda menerapkan cara install netbird secara self-hosted, server kontrol Anda sendiri yang menangani pertukaran kunci enkripsi. Lalu lintas data antar perangkat terenkripsi secara end-to-end langsung di perangkat pengirim dan hanya didekripsi di perangkat penerima menggunakan protokol WireGuard. Tidak ada pihak luar (termasuk tim pengembang Netbird) yang dapat membaca lalu lintas data Anda.
Dapatkah saya menggunakan Netbird tanpa domain publik?
Secara teknis, Anda bisa mengonfigurasinya menggunakan alamat IP publik VPS Anda secara langsung. Namun, hal ini sangat tidak direkomendasikan karena Netbird membutuhkan protokol HTTPS yang aman untuk mengamankan komunikasi dashboard dan token autentikasi. Layanan Let’s Encrypt tidak mengeluarkan sertifikat SSL untuk alamat IP biasa, sehingga Anda tetap memerlukan nama domain atau subdomain aktif.
—
Kesimpulan
Menginstal VPN mesh self-hosted yang aman kini tidak lagi membutuhkan keahlian administrasi jaringan tingkat dewa selama berjam-jam. Dengan mengikuti langkah-langkah dalam panduan cara install netbird di atas, Anda kini memiliki kontrol penuh atas infrastruktur jaringan privat Anda yang aman, cepat, dan modern berbasis WireGuard.
Netbird menawarkan solusi elegan yang menggabungkan kemudahan penggunaan ala Tailscale dengan transparansi dan kebebasan penuh dari platform open-source sejati. Baik untuk mengakses file di PC rumah saat bepergian, mengamankan komunikasi tim developer, atau menghubungkan puluhan server cloud, Netbird adalah pilihan masa kini yang tak tertandingi.
Tunggu apa lagi? Segera sewa VPS Anda, arahkan domain, jalankan script instalasi Netbird, dan rasakan kebebasan jaringan mesh modern hari ini!
