SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Self-Host Server VPN NetBird di VPS

Jalankan mesh VPN NetBird di satu VPS dengan DNS dan TLS, skrip quickstart yang dipatok, setup key untuk peer tanpa interaksi, serta perbandingan dengan Headscale.

Manfaat self-hosting server VPN NetBird

Self-hosting server VPN NetBird menempatkan control plane pada VPS milik Anda: komponen yang menyimpan daftar peer, menentukan mesin mana yang boleh mengakses mesin lain, dan membantu dua peer menemukan satu sama lain di balik NAT (network address translation). Tunnel itu sendiri tetap menggunakan WireGuard dan dienkripsi secara langsung di antara mesin Anda. Perubahannya adalah tidak ada perusahaan eksternal yang menyimpan inventaris perangkat atau alur login Anda. Pahami manfaat ini dengan jelas, karena control plane terkelola juga tidak pernah menyimpan key yang mengenkripsi trafik Anda, dan hal-hal yang sebenarnya dapat dilakukan coordination server jika disusupi lebih terbatas daripada yang diasumsikan banyak orang sebelum membacanya.

NetBird berada di antara dua konsep yang mungkin sudah Anda kenal. NetBird merupakan mesh overlay, sehingga peer terhubung satu sama lain dan tidak mengirim semua trafik melalui satu gateway. NetBird juga dapat di-self-host dari awal hingga akhir, sehingga menjadi alternatif untuk control server Tailscale yang dapat di-self-host, yaitu Headscale. Jika Anda baru pernah menjalankan tunnel dengan satu gateway, baca perbedaan antara WireGuard biasa dan mesh overlay terlebih dahulu, karena model mental tersebut membuat bagian lain dari halaman ini lebih mudah dipahami.

Jika yang sebenarnya Anda inginkan adalah satu server yang menjadi jalur keluar semua trafik Anda, mesh menyediakan lebih banyak komponen daripada yang diperlukan. VPN WireGuard biasa pada satu VPS atau exit node Tailscale dapat melakukan hal itu dengan lebih sedikit komponen yang harus dijalankan. Jika tujuannya adalah mengakses satu jaringan privat, bukan menghubungkan mesin satu sama lain, subnet router Tailscale pada VPS mengiklankan rentang jaringan tersebut ke tailnet yang sudah Anda miliki tanpa memerlukan stack di bawah ini.

Komponen yang sebenarnya dijalankan oleh stack

Tata letaknya baru-baru ini berubah, dan sebagian besar tulisan lama masih menjelaskan tata letak sebelumnya. Setelah diperiksa pada Oktober 2026 menggunakan v0.80.0 dan v0.76.2, yaitu rilis yang digunakan dalam panduan ini, skrip quickstart secara default menulis file Compose dengan tiga service.

  • netbird-server menangani management API, signal service, relay dengan STUN listener tertanam, dan identity provider tertanam. Pada rilis yang lebih lama, komponen-komponen ini berada dalam container terpisah, sedangkan identity provider merupakan instalasi Zitadel terpisah yang harus Anda build terlebih dahulu.
  • dashboard adalah konsol web admin.
  • traefik melakukan terminasi TLS (transport layer security) dan meminta sertifikat dari Let's Encrypt saat pertama kali dijalankan.

Dua service lainnya juga tersedia, tetapi tetap nonaktif kecuali Anda menyetujui prompt. Service NetBird Proxy memublikasikan service internal pada hostname publik. CrowdSec memfilter trafik yang bersifat abusif. Keduanya tidak diperlukan untuk membangun mesh yang berfungsi, dan keduanya menggunakan memori pada server kecil.

Jika Anda sebelumnya menggunakan wg-easy dalam satu container Docker, jumlah komponennya kini jauh lebih banyak. Sebagai gantinya, Anda mendapatkan access policy dan akun per pengguna, serta peer yang terhubung langsung satu sama lain, bukan melalui satu gateway.

Yang perlu disiapkan sebelum memulai

Nama domain publik bersifat wajib. Dashboard, API, dan relay semuanya menggunakan HTTPS pada port 443. Traefik mendapatkan sertifikat dari Let's Encrypt melalui challenge TLS-ALPN-01 yang dijawab pada port 443. Challenge ini memerlukan nama yang mengarah ke VPS ini dari Internet publik. Alamat IP langsung tidak akan berfungsi dalam alur ini.

Buat satu A record, netbird.example.com yang mengarah ke alamat IPv4 publik VPS, lalu tunggu hingga record tersebut tersedia sebelum menjalankan apa pun.

dig +short netbird.example.com

Perintah tersebut harus menampilkan alamat server Anda. Menjalankan installer sebelum DNS selesai melakukan propagasi menyebabkan permintaan sertifikat gagal saat pertama kali dijalankan. Validasi yang gagal berulang kali juga dapat mencapai batas laju Let's Encrypt. Anda kemudian harus menunggu hingga batas tersebut tersedia kembali sebelum dapat mencoba lagi.

Pada konfigurasi default, hanya dua port yang harus dapat dijangkau dari Internet: TCP 443 untuk dashboard, API, trafik signal dan relay, serta challenge sertifikat; dan UDP 3478 untuk STUN. TCP 80 harus tersedia secara lokal karena digunakan oleh Traefik, tetapi tidak perlu dapat dijangkau dari Internet. Memblokir akses publik ke port 80 hanya mencegah pengalihan HTTP ke HTTPS.

sudo ufw allow 443/tcp
sudo ufw allow 3478/udp
sudo ufw reload
sudo ufw status

Buka port tersebut pada firewall jaringan provider Anda. Pada sebagian besar panel VPS, firewall ini merupakan kontrol terpisah. Karena itu, server yang konfigurasi ufw status-nya sendiri terlihat benar tetap dapat menolak koneksi.

STUN (session traversal utilities for NAT) memungkinkan peer mengetahui alamat publik dan port yang ditetapkan NAT-nya sendiri. Dengan demikian, dua peer dapat mencoba membuat tunnel langsung. Jika UDP 3478 diblokir, peer tetap dapat terhubung melalui relay pada TCP 443 sehingga tidak selalu terlihat ada masalah. Peer yang tidak dapat menemukan jalur langsung akan menampilkan Connection type: Relayed. Trafiknya melewati VPS Anda, bukan langsung dari satu peer ke peer lain. Peer pada LAN yang sama tetap dapat terhubung langsung menggunakan alamat lokalnya.

Pada sisi software, Anda memerlukan Docker dengan plugin Compose v2, serta jq dan curl. Script memeriksa Docker, Compose, dan jq, lalu berhenti jika salah satunya tidak tersedia. Script menggunakan curl tanpa memeriksa keberadaannya, jadi instal komponen tersebut terlebih dahulu. Jika Docker masih baru di server ini, siapkan Docker Compose agar berfungsi pada VPS terlebih dahulu.

Port jika Anda melewati reverse proxy bawaan

Tanpa Traefik, server gabungan tetap menangani management, signal, dan relay melalui satu backend HTTP sehingga daftar port hampir tidak bertambah. File Compose yang dibuat akan memublikasikan:

  • TCP 8080, dashboard, secara default terikat ke 127.0.0.1
  • TCP 8081, netbird-server, secara default terikat ke 127.0.0.1
  • UDP 3478, STUN, dipublikasikan secara langsung

Proxy Anda sendiri mengakhiri TLS pada TCP 443 dan meneruskan koneksi ke dua port lokal tersebut. STUN tidak pernah melewati proxy, sehingga UDP 3478 tetap harus dibuka pada firewall. Panduan yang mencantumkan port terpisah untuk management gRPC, signal gRPC, dan relay menjelaskan tata letak multi-container yang lebih lama.

Pilih opsi ini hanya jika server tersebut sudah mengakhiri TLS untuk layanan lain. Jika tidak, Traefik bawaan memerlukan lebih sedikit aturan dan mengurangi risiko kesalahan.

Instal NetBird server dengan skrip quickstart

One-liner yang didokumentasikan mengalirkan release terbaru langsung ke shell:

curl -fsSL https://github.com/netbirdio/netbird/releases/latest/download/getting-started.sh | bash

Tetapkan versinya. latest dapat berubah, sehingga perintah yang sama jika dijalankan dengan jarak dua minggu dapat menghasilkan dua instalasi yang berbeda. Tidak ada catatan di disk yang menunjukkan instalasi mana yang menulis konfigurasi Anda. Unduh release bertag, baca isinya, lalu jalankan.

mkdir -p ~/netbird
cd ~/netbird
curl -fsSL -o getting-started.sh \
  https://github.com/netbirdio/netbird/releases/download/v0.76.2/getting-started.sh
less getting-started.sh
bash getting-started.sh

Skrip terlebih dahulu meminta domain:

Enter the domain you want to use for NetBird (e.g. netbird.my-domain.com):

Kemudian skrip menanyakan cara menangani TLS:

Which reverse proxy will you use?
  [0] Traefik (recommended - automatic TLS, included in Docker Compose)
  [1] Existing Traefik (labels for external Traefik instance)
  [2] Nginx (generates config template)
  [3] Nginx Proxy Manager (generates config + instructions)
  [4] External Caddy (generates Caddyfile snippet)
  [5] Other/Manual (displays setup documentation)
Enter choice [0-5] (default: 0):

Pilih [0]. Opsi 2 hingga 4 menulis potongan konfigurasi dan menyerahkan pengaturannya kepada Anda. Opsi 5 menulis file Compose, dashboard.env, dan config.yaml, lalu menampilkan dokumentasi penyiapan di terminal. Opsi tersebut tepat untuk server yang sudah menjalankan proxy, tetapi tidak tepat untuk server baru. Opsi 0 kemudian meminta alamat email yang digunakan Traefik untuk mendaftarkan akun Anda pada Let's Encrypt. Prompt masih menyebutnya sebagai alamat untuk notifikasi sertifikat, tetapi Let's Encrypt berhenti mengirim email kedaluwarsa pada June 4, 2025. Karena itu, masalah renewal muncul di log Traefik, bukan di inbox Anda.

Pada instalasi pertama, jawab tidak untuk service NetBird Proxy. Service ini memerlukan satu DNS record tambahan, yaitu wildcard *.netbird.example.com CNAME yang mengarah ke netbird.example.com, dan tidak memberikan manfaat untuk mesh biasa. Prompt CrowdSec hanya muncul setelah proxy diaktifkan, sehingga menolak proxy juga melewati prompt tersebut. Keduanya dapat ditambahkan nanti.

Skrip menulis ke direktori saat ini: docker-compose.yml, config.yaml dengan mode 600, dan dashboard.env. Dengan Traefik yang disertakan, skrip menambahkan traefik-dynamic.yaml dan proxy.env hanya jika Anda mengaktifkan NetBird Proxy. Perlakukan direktori tersebut sebagai state yang harus dipertahankan karena config.yaml menyimpan key yang mengenkripsi data di store. Kehilangan key tersebut tidak dapat diperbaiki dengan reinstall.

docker compose ps
docker compose logs -f netbird-server

Setiap service seharusnya membaca running, dan log server seharusnya stabil, bukan restart berulang. Pantau sertifikat secara terpisah:

docker compose logs traefik | grep -i acme

ACME (automatic certificate management environment) adalah protokol yang digunakan Traefik untuk memperoleh sertifikat. Error pada tahap ini hampir selalu disebabkan oleh DNS atau port 443 yang tertutup.

Buat akun admin pertama

Buka https://netbird.example.com. Pada instalasi baru, alamat ini menampilkan halaman penyiapan, bukan formulir login. Masukkan alamat email, nama, dan kata sandi, lalu klik Create Account. Akun tersebut menjadi admin pertama, kemudian halaman dialihkan ke formulir login.

Akun tersebut disimpan di penyimpanan pengguna milik NetBird sendiri, yang dijalankan oleh identity provider di dalam container netbird-server. Tidak ada komponen eksternal yang digunakan. Ini merupakan perubahan terbesar dibandingkan NetBird self-hosted setahun lalu. Saat itu, instalasi yang berfungsi mengharuskan Anda menyiapkan Zitadel atau Keycloak terlebih dahulu, lalu menyalin empat nilai OIDC (OpenID Connect) ke setup.env sebelum layanan apa pun dapat berjalan.

Jika browser menampilkan peringatan sertifikat, bukan halaman penyiapan, berarti sertifikat gagal diterbitkan. Perbaiki masalah tersebut sebelum melanjutkan. Dashboard berkomunikasi dengan API melalui hostname yang sama dan dapat gagal dengan cara yang membingungkan jika sertifikat bermasalah.

Bergabung dengan peer pertama Anda

Instal client pada mesin Linux mana pun, termasuk VPS itu sendiri jika Anda ingin memasukkannya ke dalam mesh:

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

Pada Debian dan Ubuntu, skrip tersebut mengonfigurasi repositori paket NetBird, lalu menginstal client melalui apt. Dengan demikian, package manager tetap mengelola client tersebut. Jika Anda tidak ingin menyalurkan skrip langsung ke shell, simpan terlebih dahulu dengan curl -fsSL -o install.sh https://pkgs.netbird.io/install.sh dan baca isinya sebelum menjalankan sh install.sh. Apa pun pilihannya, konfirmasikan komponen yang terpasang:

apt-cache policy netbird

netbird adalah client command line dan daemon. netbird-ui adalah aplikasi desktop tray, dan server headless tidak memerlukannya.

Sekarang arahkan client ke server Anda:

sudo netbird up --management-url https://netbird.example.com

Abaikan --management-url jika tidak ingin melakukannya, dan client akan mendaftar ke layanan hosted NetBird karena itu adalah default yang sudah dikompilasi. Perintah tersebut tetap berhasil, mesin tetap memperoleh alamat, dan dashboard self-hosted Anda tetap kosong. Kesalahan ini hampir selalu terjadi setidaknya sekali.

Perintah tersebut menampilkan URL yang harus dibuka di browser untuk menyelesaikan login. Setelah itu:

netbird status
ip addr show wt0

Baca empat baris dari netbird status: Management: Connected, Signal: Connected, baris Relays: yang melaporkan semua relay yang tersedia, dan NetBird IP: dalam rentang overlay. wt0 adalah interface WireGuard yang dibuat NetBird, dan interface tersebut seharusnya menggunakan alamat yang sama.

Mendaftarkan mesin kedua tanpa pengawasan menggunakan setup key

Login melalui browser tidak dapat digunakan untuk mesin yang tidak memiliki browser dan tidak ada orang di depannya. Setup key adalah token pr autentikasi yang mendaftarkan mesin tanpa langkah interaktif. Buat setup key di dashboard melalui Settings → Setup Keys.

Ada dua jenis setup key. One-off key mengautentikasi tepat satu mesin, lalu tidak dapat digunakan lagi. Reusable key dapat mendaftarkan banyak mesin, dengan batas jumlah opsional. Keduanya dapat memiliki masa berlaku opsional. Keduanya juga dapat secara otomatis menambahkan peer baru ke suatu grup, sehingga aturan akses pada grup tersebut langsung berlaku saat mesin muncul.

sudo netbird up --setup-key <SETUP-KEY> \
  --management-url https://netbird.example.com \
  --hostname build-runner-01

--hostname menetapkan nama yang ditampilkan di dashboard. Tanpa parameter ini, peer menggunakan nama yang diberikan oleh mesin tersebut. Sekumpulan entri yang semuanya bernama ubuntu tidak membantu siapa pun.

Untuk container dan build agent yang berumur pendek, tandai key sebagai ephemeral saat membuatnya. Peer yang didaftarkan dengan ephemeral key akan dihapus secara otomatis setelah offline selama lebih dari 10 menit. Dengan demikian, entri yang sudah tidak aktif tidak menumpuk dalam daftar peer.

Pahami satu batasan ini sebelum mengandalkan setup key: masa berlaku yang berakhir atau pencabutan key menghentikan pendaftaran baru, tetapi tidak memutus koneksi mesin yang sudah terdaftar dengan key tersebut. Untuk menghapus akses suatu mesin, hapus peer tersebut.

Apakah Anda masih memerlukan identity provider terpisah?

Untuk instalasi kecil, tidak. Penyimpanan pengguna bawaan menangani akun yang dibuat dari dashboard, dan itu sudah cukup untuk beberapa pengguna.

Anda memerlukan identity provider eksternal jika sudah memilikinya dan tidak ingin mengelola daftar pengguna kedua. NetBird menerima provider apa pun yang mendukung OIDC. Daftarkan klien OIDC rahasia di provider Anda, lalu tambahkan klien tersebut di dashboard NetBird menggunakan nama, client ID, client secret, dan, jika diperlukan, issuer. NetBird akan memberikan URL pengalihan untuk ditempelkan kembali di provider. Integrasi khusus tersedia untuk Google, Microsoft Entra ID, Okta, Zitadel, Keycloak, Authentik, dan Pocket ID. Provider lainnya dapat ditambahkan sebagai OIDC generik. Jika Anda sudah menjalankan Authentik sebagai single sign-on yang di-host sendiri, gunakan metode ini agar Anda dapat mempertahankan satu daftar akun, bukan dua.

Login lokal tetap tersedia setelah Anda menambahkan provider, dan setiap provider yang dikonfigurasi akan muncul di halaman login. Pertahankan satu akun admin lokal dengan password yang kuat. Jika konfigurasi OIDC bermasalah, Anda tetap memiliki akses untuk masuk.

NetBird atau Headscale: control plane mana yang sebaiknya Anda jalankan?

Keduanya menghilangkan dependensi yang sama, yaitu control server terkelola yang jika tidak digunakan akan dihubungi klien Anda. Namun, bentuk kedua proyek ini berbeda.

Headscale mengimplementasikan ulang control server Tailscale, dan Anda tetap menggunakan klien Tailscale resmi. Tidak ada konsol web resmi. Anda mengelola pengguna dan pre-authentication key dengan perintah headscale terhadap file konfigurasi. Antarmuka web dari komunitas tersedia, tetapi bukan bagian dari proyek ini. Pendekatan tersebut sesuai bagi Anda yang ingin menyimpan state dalam file dan mengelola perubahannya melalui version control.

NetBird merilis seluruh produknya: client sendiri, dashboard sendiri, identity provider tertanam, serta access policy yang dapat diedit melalui browser. Ini berarti lebih banyak komponen yang harus dijalankan pada VPS Anda, tetapi jauh lebih mudah dikelola oleh rekan kerja yang tidak akan membuka terminal. Jika Anda benar-benar membandingkan NetBird dengan Tailscale terkelola, bukan dengan Headscale, keduanya menggunakan WireGuard di lapisan dasar. Karena itu, perbandingan NetBird vs Tailscale menjelaskan perbedaan sebenarnya: siapa yang menjalankan control plane, bagaimana aturan akses ditulis, dan bagaimana relay meneruskan traffic.

Jalankan Headscale jika Anda sudah menggunakan klien Tailscale atau menginginkan control plane sekecil mungkin. Jalankan NetBird jika beberapa orang perlu mengelola peer dan Anda menginginkan konsol serta SSO tanpa harus merakitnya sendiri. Sebelum memilih salah satunya, periksa cakupan sebenarnya dari paket gratis Tailscale, karena grup nonkomersial yang terdiri atas maksimal enam pengguna tidak membayar apa pun untuk control plane terkelola, dengan perangkat pengguna tanpa batas dan 50 resource bertanda yang tersedia sejak awal, sehingga mungkin tidak memiliki alasan untuk menjalankan control plane sendiri. Setelah batas tersebut terlampaui, biaya bertambah berdasarkan jumlah orang, bukan jumlah mesin. Karena itu, hitung biaya Tailscale untuk grup Anda agar Anda memiliki angka pembanding dengan biaya VPS dan waktu yang diperlukan untuk mengelola stack ini.

Seberapa kecil VPS yang dapat menjalankan ini?

Minimum yang didokumentasikan adalah 1 CPU dan memori 2 GB. Gunakan 2 GB.

Ada tiga komponen yang aman untuk tidak digunakan pada server kecil. Jangan pilih layanan NetBird Proxy. Layanan ini digunakan untuk memublikasikan layanan internal pada hostname publik dan tidak berkaitan dengan koneksi antarpasangan. Lewati CrowdSec. Skrip hanya menawarkannya bersama proxy, dan komponen ini lebih baik ditambahkan nanti pada server yang terekspos daripada sejak hari pertama. Pertahankan penyimpanan SQLite default dalam volume netbird_data. Gunakan PostgreSQL hanya jika deployment dibagi ke beberapa mesin atau terjadi konkurensi nyata. Dokumentasi menjelaskan bahwa migrasi tersebut dapat dilakukan nanti.

Relay adalah satu-satunya komponen yang tidak dapat dihapus. Dua peer yang NAT-nya menetapkan port berbeda untuk setiap tujuan tidak akan pernah berhasil membuat tunnel langsung. Karena itu, relay adalah satu-satunya jalur yang memungkinkan koneksi tersebut berfungsi. Menonaktifkannya hanya menghemat sedikit memori dan menyebabkan koneksi terputus dengan cara yang sulit dilacak.

Jika satu server tidak lagi mencukupi, relay adalah komponen pertama yang sebaiknya dipindahkan. Relay mandiri berjalan dengan NB_LISTEN_ADDRESS, NB_EXPOSED_ADDRESS, NB_AUTH_SECRET dan NB_ENABLE_STUN. Shared secret harus identik pada relay dan server utama. Jika tidak, klien gagal melakukan autentikasi ke relay tersebut.

Mode kegagalan dan hal yang akan terlihat

Dasbor menampilkan peringatan sertifikat. Traefik tidak memperoleh sertifikat. Jalankan docker compose logs traefik | grep -i acme. Ada dua penyebab. dig +short netbird.example.com mungkin belum mengarah ke VPS ini, atau TCP 443 tertutup di suatu titik antara Let's Encrypt dan container, biasanya pada firewall jaringan provider, bukan pada ufw. Challenge dijawab melalui 443, sehingga port 80 yang terbuka tidak membantu dalam kasus ini. Perbaiki penyebabnya sebelum mencoba kembali dalam loop, karena Let's Encrypt hanya mengizinkan lima otorisasi yang gagal untuk setiap hostname, akun, dan jam. Jika melebihi batas tersebut, Anda tidak dapat mencoba lagi sampai kuota terisi kembali.

Client menyatakan bahwa koneksi berhasil, tetapi dasbor kosong. Client terdaftar pada layanan hosted NetBird karena --management-url tidak ada. Jalankan netbird status --detail dan baca baris Management:, yang menunjukkan server tujuan koneksi sebenarnya. Jika terlihat Management: Connected to https://api.netbird.io:443, berarti client terhubung ke cloud. Jalankan sudo netbird down, lalu jalankan sudo netbird up --management-url https://netbird.example.com lagi.

Setiap peer menampilkan Connection type: Relayed. Tidak ada tunnel langsung yang terbentuk, sehingga semua trafik melewati VPS dan menambah latensi satu hop. Periksa UDP 3478 pada firewall VPS dan firewall provider, karena STUN memungkinkan peer mengetahui alamat publik dan portnya sendiri. netbird status --detail juga menampilkan Direct: false serta jenis kandidat ICE (interactive connectivity establishment) untuk setiap peer. Informasi ini menunjukkan sejauh mana upaya koneksi berlangsung. Pada beberapa jaringan, relayed adalah satu-satunya hasil yang tersedia dan hal itu bukan masalah.

Peer bergabung tetapi tidak dapat menjangkau apa pun. Berada dalam mesh tidak berarti dua peer dapat saling berkomunikasi. Kebijakan akses menentukan hal tersebut, dan group tanpa kebijakan terpasang tidak dapat menjangkau apa pun. Periksa kebijakan pada dasbor sebelum mulai memeriksa route dan firewall.

netbird status melaporkan masalah daemon. Service tidak sedang berjalan. Gunakan sudo netbird service status dan sudo netbird service start. Log client berada di /var/log/netbird/client.log. Untuk masalah yang belum dapat ditentukan, netbird debug bundle --anonymize --system-info mengumpulkan log, status, route, pengaturan DNS, dan status firewall ke dalam satu arsip.

Pencadangan dan upgrade

Dua hal menopang seluruh instalasi: direktori yang berisi docker-compose.yml dan config.yaml, serta Docker volume yang menyimpan database dan kunci enkripsi. Cadangkan keduanya secara bersamaan. config.yaml menyimpan kunci yang mengenkripsi data sensitif di dalam penyimpanan, sehingga salinan database tanpa kunci tersebut tidak dapat memulihkan kunci setup dan token API yang terenkripsi.

docker volume ls
docker compose down
sudo tar czf netbird-config.tgz -C ~ netbird
docker run --rm -v netbird_netbird_data:/data -v "$PWD":/backup \
  alpine tar czf /backup/netbird-data.tgz -C /data .
docker compose up -d

Compose menambahkan awalan direktori proyek pada nama volume, sehingga volume yang didokumentasikan sebagai netbird_data biasanya muncul sebagai netbird_netbird_data. Jalankan docker volume ls terlebih dahulu dan gunakan nama yang ditampilkan, atau perintah docker run di atas akan gagal secara diam-diam dengan membuat volume kosong dan tidak mengarsipkan apa pun. Simpan arsip di luar VPS. Jika Anda sudah memiliki alat pencadangan, restic atau BorgBackup dapat menangani pencadangan ke lokasi di luar server.

Upgrade server dilakukan dengan pull lalu recreate:

docker compose pull
docker compose up -d
docker compose ps

Sebelum mengandalkan konfigurasi tersebut, jalankan docker compose config | grep image:. Tag apa pun yang bertuliskan latest harus dikunci ke versi tertentu, dengan alasan yang sama seperti saat Anda mengunci versi skrip instalasi: Anda perlu mengetahui apa yang sedang berjalan, dan memerlukan versi untuk dikembalikan jika upgrade menimbulkan masalah. Client di-upgrade melalui package manager yang digunakan untuk menginstalnya.

FAQ

Apakah saya memerlukan identity provider sendiri untuk melakukan self-hosting NetBird?

Tidak. Rilis saat ini menyertakan penyimpanan pengguna bawaan. Anda dapat membuat akun admin pertama melalui browser di https://netbird.example.com, lalu menambahkan pengguna dari dashboard. OIDC provider eksternal bersifat opsional dan dapat ditambahkan nanti dengan nama, client ID, client secret, dan, jika diperlukan, issuer. Panduan yang meminta Anda men-deploy Zitadel atau Keycloak sebelum NetBird menjelaskan konfigurasi yang tidak lagi diperlukan. Jika diikuti, panduan tersebut menambah satu service yang harus Anda operasikan.

Mengapa semua peer saya menampilkan Connection type: Relayed?

Koneksi langsung tidak terbentuk, sehingga trafik melewati relay pada VPS Anda. Penyebab yang umum adalah UDP 3478 diblokir. Port tersebut digunakan peer oleh STUN untuk menemukan alamat dan port publiknya sendiri. Buka port tersebut pada firewall VPS dan firewall jaringan terpisah milik provider Anda. Setelah itu, jalankan kembali netbird status --detail dan baca baris Direct:. Jika kedua peer berada di balik NAT yang menetapkan port berbeda untuk setiap tujuan, status relayed merupakan hasil yang diharapkan dan tidak menunjukkan kesalahan konfigurasi.

Client saya berhasil terhubung, tetapi dashboard tidak menampilkan peer. Apa yang terjadi?

Client terdaftar pada hosted service NetBird, bukan pada server Anda. Hal ini terjadi jika --management-url tidak disertakan. netbird status --detail menampilkan server yang digunakan client pada baris Management:. Nilai seperti https://api.netbird.io:443 mengonfirmasi hal tersebut. Jalankan sudo netbird down, lalu sudo netbird up --management-url https://netbird.example.com. Setelah itu, peer akan muncul di dashboard Anda.

Apa perbedaan NetBird self-hosted dan Headscale?

Keduanya menggantikan control server hosted dengan server yang Anda operasikan sendiri. Headscale hanya menyediakan control plane. Anda mengelolanya dengan perintah headscale dan file konfigurasi. Headscale tidak memiliki konsol web resmi dan mengendalikan Tailscale client resmi. NetBird menyediakan client sendiri, dashboard admin, dan integrasi identity provider dalam satu stack. Headscale lebih kecil untuk dioperasikan dan menyimpan statusnya dalam file. NetBird lebih mudah digunakan oleh orang yang tidak akan menggunakan terminal.

VPS dengan ukuran berapa yang diperlukan untuk server NetBird self-hosted?

Minimum yang didokumentasikan adalah 1 CPU dan memori 2 GB. Jadi, gunakan spesifikasi 2 GB. Tolak proxy service opsional saat instalasi. Langkah ini juga melewati prompt CrowdSec. Gunakan penyimpanan SQLite default sampai Anda benar-benar memerlukan PostgreSQL.

Apakah artikel ini bermanfaat?