Paano i-self-host ang NetBird VPN server sa VPS
I-set up ang NetBird mesh VPN sa isang VPS gamit ang DNS at TLS, pinned quickstart script, setup keys para sa unattended peers, at paghahambing sa Headscale.
Ano ang nakukuha mo sa pag-self-host ng NetBird VPN server
Sa pag-self-host ng NetBird VPN server, inilalagay mo ang control plane sa VPS na pagmamay-ari mo. Ito ang bahaging naglalaman ng listahan ng mga peer, nagpapasya kung aling machine ang maaaring maka-access sa alin, at tumutulong sa dalawang peer na mahanap ang isa’t isa sa likod ng NAT (network address translation). WireGuard pa rin ang ginagamit para sa mismong tunnel, at direktang naka-encrypt ang mga ito sa pagitan ng iyong mga machine. Ang nagbabago ay wala nang external na kumpanyang may hawak ng inventory ng iyong device o ng proseso ng pag-login mo. Dapat malinaw kung ano ang naibibigay nito, dahil hindi rin hawak ng hosted control plane ang mga key na nag-e-encrypt sa traffic mo, at mas maikli ang listahan ng mga aktuwal na magagawa ng coordination server kapag na-breach ito kaysa sa karaniwang inaakala ng mga tao bago nila ito basahin.
Nasa pagitan ang NetBird ng dalawang bagay na maaaring alam mo na. Mesh overlay ito, kaya direktang kumokonekta ang mga peer sa isa’t isa sa halip na ipadala ang lahat sa isang gateway. Maaari rin itong i-self-host end to end, kaya maihahambing ito sa Headscale, ang self-hosted Tailscale control server. Kung single-gateway tunnel lamang ang dati mong pinapatakbo, basahin muna ang pagkakaiba ng plain WireGuard at mesh overlay, dahil ang modelong ito ang tutulong para maging kapaki-pakinabang ang natitirang bahagi ng page na ito.
Kung ang aktuwal mong kailangan ay isang server na doon lalabas ang lahat ng traffic mo, mas maraming component ang mesh kaysa sa kailangan ng ganitong setup. Magagawa iyon ng plain WireGuard VPN sa isang VPS o Tailscale exit node nang mas kaunti ang kailangang patakbuhin. Kung ang layunin naman ay ma-access ang isang private network sa halip na pagdugtungin ang mga machine sa isa’t isa, maaaring i-advertise ng Tailscale subnet router sa isang VPS ang range na iyon sa isang tailnet na mayroon ka na, nang hindi kailangan ang stack sa ibaba.
Ang aktuwal na mga component na tumatakbo
Kamakailan ay nagbago ang layout, at karamihan sa mga lumang guide ay naglalarawan pa rin ng dating layout. Sinuri ito noong October 2026 gamit ang v0.80.0 at ang v0.76.2, ang release na ginagamit ng guide na ito. Bilang default, nagsusulat ang quickstart script ng Compose file na may tatlong serbisyo.
netbird-serverang naglalaman ng management API, signal service, relay na may embedded STUN listener, at embedded identity provider. Sa mga mas lumang release, magkakahiwalay na container ang mga ito, at hiwalay na Zitadel install ang identity provider na kailangan mo munang i-build.dashboardang admin web console.traefikang nagte-terminate ng TLS (transport layer security) at humihingi ng certificate sa Let's Encrypt sa unang pagsisimula.
May dalawa pang serbisyo, pero naka-off ang mga ito maliban kung sumagot ka ng yes sa isang prompt. Ang NetBird Proxy service ang nagpa-publish ng mga internal service sa public hostname. Sinasala ng CrowdSec ang abusive traffic. Hindi kailangan ang alinman sa mga ito para makabuo ng gumaganang mesh, at parehong kumokonsumo ng memory sa maliit na server.
Kung galing ka sa wg-easy sa iisang Docker container, mas marami ang component dito. Ang kapalit nito ay access policies at mga account para sa bawat user, pati mga peer na direktang kumokonekta sa isa't isa sa halip na dumaan sa iisang gateway.
Mga kailangan bago magsimula
Hindi opsyonal ang isang public domain name. HTTPS sa port 443 ang ginagamit ng dashboard, API, at relay, at kinukuha ng Traefik ang certificate nito mula sa Let's Encrypt gamit ang TLS-ALPN-01 challenge. Sinasagot ang challenge sa port 443, kaya kailangan ng pangalan na nagre-resolve sa VPS na ito mula sa public internet. Hindi gagana ang plain IP address sa setup na ito.
Gumawa ng isang A record, netbird.example.com na tumuturo sa public IPv4 address ng VPS, at hintayin itong mag-propagate bago ka magpatakbo ng anuman.
dig +short netbird.example.comDapat i-print nito ang address ng server mo. Kapag pinatakbo ang installer bago mag-propagate ang DNS, mabibigo ang certificate request sa unang pagsisimula. Ang paulit-ulit na nabigong validation ay maaari ring umabot sa rate limit ng Let's Encrypt. Kailangan mong hintaying maibalik ang limit bago muling sumubok.
Dalawang port lamang ang kailangang maabot mula sa internet para sa default setup: TCP 443 para sa dashboard, API, signal at relay traffic, at certificate challenge; at UDP 3478 para sa STUN. Kailangang malaya sa lokal na server ang TCP 80 dahil bina-bind ito ng Traefik, pero hindi ito kailangang maabot mula sa public internet. Kapag hinarangan ang public access sa port 80, mapipigilan lamang ang HTTP-to-HTTPS redirect.
sudo ufw allow 443/tcp
sudo ufw allow 3478/udp
sudo ufw reload
sudo ufw statusBuksan din ang mga ito sa network firewall ng iyong provider. Hiwa-hiwalay na control ito sa karamihan ng VPS panel. Ito ang dahilan kung bakit maaaring tumanggi pa ring tumanggap ng connection ang isang server kahit mukhang tama ang sarili nitong ufw status.
Ang STUN (session traversal utilities for NAT) ang ginagamit ng isang peer upang malaman ang public address at port na itinalaga ng sarili nitong NAT. Dahil dito, maaaring subukan ng dalawang peer ang direktang tunnel. Kapag hinarangan ang UDP 3478, makakakonekta pa rin ang mga peer sa pamamagitan ng relay sa TCP 443, kaya maaaring walang halatang sira. Ipinapakita ang Connection type: Relayed sa mga peer na hindi makahanap ng direktang path. Dumadaan ang traffic ng mga ito sa VPS mo sa halip na direktang peer to peer. Maaari pa ring direktang kumonekta ang mga peer sa parehong LAN gamit ang kanilang mga lokal na address.
Sa software side, kailangan mo ng Docker na may Compose v2 plugin, pati ng jq at curl. Sinusuri ng script kung naroon ang Docker, Compose, at jq, at hihinto ito kapag may nawawala. Ginagamit nito ang curl nang hindi muna sinusuri kung naka-install ito, kaya i-install muna iyon. Kung bago ang Docker sa server na ito, ihanda muna ang Docker Compose sa VPS.
Mga port kapag hindi gagamitin ang bundled reverse proxy
Kung walang Traefik, ginagamit pa rin ng combined server ang isang HTTP backend para sa management, signal, at relay, kaya bahagya lamang nadaragdagan ang listahan ng port. Ipinapublish ng nabuong Compose file ang mga sumusunod:
- TCP 8080, ang dashboard, na naka-bind sa 127.0.0.1 bilang default
- TCP 8081,
netbird-server, na naka-bind sa 127.0.0.1 bilang default - UDP 3478, STUN, na direktang ipinapublish
Ang sarili mong proxy ang nagte-terminate ng TLS sa TCP 443 at nagpapasa ng traffic sa dalawang lokal na port na iyon. Hindi dumadaan ang STUN sa proxy, kaya nananatiling bukas sa firewall ang UDP 3478 sa alinmang setup. Inilalarawan ng mga guide na naglilista ng magkakahiwalay na port para sa management gRPC, signal gRPC, at relay ang mas lumang multi-container layout.
Piliin lamang ito kapag ang server ay nagte-terminate na ng TLS para sa ibang serbisyo. Kung hindi, mas kaunti ang rules at mas kaunti ang posibleng pagkakamali kapag ginagamit ang bundled Traefik.
I-install ang NetBird server gamit ang quickstart script
Direktang ipinapasa ng dokumentadong one-liner ang pinakabagong release sa shell:
curl -fsSL https://github.com/netbirdio/netbird/releases/latest/download/getting-started.sh | bashI-pin ang release sa halip. Nagbabago ang latest, kaya magkaibang install ang nalilikha ng parehong command kapag dalawang linggo ang pagitan ng pagpapatakbo nito, at walang file sa disk na nagtatala kung alin ang sumulat sa configuration mo. Mag-download ng tagged release, basahin ito, saka patakbuhin.
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.shUnang hinihingi ng script ang domain:
Enter the domain you want to use for NetBird (e.g. netbird.my-domain.com):Pagkatapos, tinatanong nito kung paano hahawakan ang 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):Piliin ang [0]. Ang mga option 2 hanggang 4 ay sumusulat ng config snippet at iniiwan sa iyo ang pag-wire nito, habang isinusulat ng option 5 ang Compose file, dashboard.env at config.yaml, at ipinapakita sa terminal ang setup documentation. Tama ito sa server na mayroon nang proxy, pero hindi tama sa bagong server. Pagkatapos, humihingi ang option 0 ng email address na irerehistro ng Traefik sa iyong Let's Encrypt account. Tinatawag pa rin ito ng prompt na address para sa certificate notifications, pero tumigil na ang Let's Encrypt sa pagpapadala ng expiry email noong June 4, 2025. Kaya sa Traefik log mo makikita ang mga problema sa renewal, hindi sa inbox.
Tumanggi sa NetBird Proxy service sa unang install. Nangangailangan ito ng isa pang DNS record: isang wildcard *.netbird.example.com CNAME na tumuturo sa netbird.example.com. Wala itong silbi para sa simpleng mesh. Lumalabas lamang ang CrowdSec prompt kapag naka-enable ang proxy, kaya malalaktawan din ito kapag tinanggihan mo ang proxy. Maaari mong idagdag ang dalawang ito sa ibang pagkakataon.
Sumusulat ang script sa kasalukuyang directory: docker-compose.yml, config.yaml na may mode 600, at dashboard.env. Kapag kasama ang Traefik, idinadagdag nito ang traefik-dynamic.yaml at proxy.env kapag pinagana mo lamang ang NetBird Proxy. Ituring ang directory na iyon bilang state na dapat mong panatilihin, dahil nasa config.yaml ang key na nag-e-encrypt ng data sa store. Hindi malulutas ng reinstall ang pagkawala nito.
docker compose ps
docker compose logs -f netbird-serverDapat basahin ng bawat service ang running, at dapat tumigil sa pag-restart nang paulit-ulit ang server log. Hiwalay na i-monitor ang certificate:
docker compose logs traefik | grep -i acmeAng ACME (automatic certificate management environment) ang protocol na ginagamit ng Traefik para kumuha ng certificate. Halos palaging DNS issue o saradong port 443 ang sanhi ng mga error dito.
Gumawa ng unang admin account
Buksan ang https://netbird.example.com. Sa bagong install, mapupunta ito sa setup page sa halip na login form. Maglagay ng email address, pangalan, at password, pagkatapos ay i-click ang Create Account. Ito ang magiging unang admin, at magre-redirect ang page sa login form.
Nasa sariling user store ng NetBird ang account na ito, na pinapagana ng identity provider na naka-embed sa netbird-server container. Walang external na component na kasali. Ito ang pinakamalaking pagbabago kumpara sa self-hosted NetBird noong nakaraang taon. Noon, kailangan munang mag-set up ng Zitadel o Keycloak at maglagay ng apat na OIDC (OpenID Connect) value sa setup.env bago pa man magsimula ang installation.
Kung browser certificate warning ang makita mo sa halip na setup page, hindi na-issue ang certificate. Ayusin muna ito bago magpatuloy. Nakikipag-ugnayan ang dashboard sa API gamit ang parehong hostname, kaya nagkakaroon ng hindi malinaw na mga error kapag may problema ang certificate.
Sumali sa iyong unang peer
I-install ang client sa anumang Linux machine, kabilang ang VPS mismo kung gusto mo itong isama sa mesh:
curl -fsSL https://pkgs.netbird.io/install.sh | shSa Debian at Ubuntu, kino-configure ng script na iyon ang package repository ng NetBird at pagkatapos ay ini-install ang client sa pamamagitan ng apt. Kaya package manager pa rin ang namamahala rito sa alinmang paraan. Kung hindi ka komportable sa pag-pipe ng script sa shell, i-save muna ito gamit ang curl -fsSL -o install.sh https://pkgs.netbird.io/install.sh at basahin bago patakbuhin ang sh install.sh. Sa alinmang paraan, kumpirmahin kung ano ang na-install:
apt-cache policy netbirdAng netbird ang command line client at daemon. Ang netbird-ui ang desktop tray app, at walang silbi ito sa isang headless server.
Ngayon, ituro ang client sa iyong server:
sudo netbird up --management-url https://netbird.example.comAlisin ang --management-url at magre-register ang client sa hosted service ng NetBird dahil iyon ang naka-compile na default. Magtatagumpay pa rin ang command, magkakaroon pa rin ng address ang machine, at mananatiling walang laman ang iyong self-hosted dashboard. Halos lahat ay nalilinlang nito kahit isang beses.
Magpi-print ang command ng URL na bubuksan sa browser upang makumpleto ang login. Pagkatapos nito:
netbird status
ip addr show wt0Basahin ang apat na linya mula sa netbird status: Management: Connected, Signal: Connected, isang linyang Relays: na nag-uulat ng bawat available na relay, at isang NetBird IP: sa overlay range. Ang wt0 ang WireGuard interface na ginagawa ng NetBird, at dapat nitong gamitin ang parehong address.
Sumali ng pangalawang machine nang walang manual na pag-setup
Hindi gumagana ang browser login para sa machine na walang browser at walang taong nasa harap nito. Ang setup key ay isang pre-authentication token na nagrerehistro ng machine nang hindi kailangan ang interactive na hakbang. Gumawa nito sa dashboard sa Settings → Setup Keys.
May dalawang uri. Ang one-off key ay nag-a-authenticate ng eksaktong isang machine at pagkatapos ay nagagamit na. Ang reusable key ay nagrerehistro ng maraming machine, at maaari kang magtakda ng maximum na bilang. Pareho silang maaaring lagyan ng expiry, at parehong maaaring awtomatikong magtalaga ng bagong peer sa isang group. Dahil dito, agad na nalalapat ang access rules ng group kapag lumitaw ang machine.
sudo netbird up --setup-key <SETUP-KEY> \
--management-url https://netbird.example.com \
--hostname build-runner-01Itinatakda ng --hostname ang pangalang ipinapakita sa dashboard. Kung wala ito, gagamitin ng peer ang pangalang itinatalaga ng machine sa sarili nito. Walang naitutulong ang fleet ng mga entry na pare-parehong pinangalanang ubuntu.
Para sa mga container at panandaliang build agent, itakda bilang ephemeral ang key kapag ginagawa ito. Awtomatikong inaalis ang mga peer na nakarehistro gamit ang ephemeral key kapag offline na sila nang mahigit 10 minuto. Dahil dito, hindi naiipon ang mga patay na entry sa peer list.
May isang limitasyong dapat maunawaan bago umasa sa setup keys: kapag nag-expire o na-revoke ang key, pinipigilan lamang nito ang mga bagong registration. Hindi nito dini-disconnect ang mga machine na dati nang nag-register gamit ang key. Para alisin ang access ng isang machine, alisin ang peer nito.
Kailangan mo pa ba ng hiwalay na identity provider?
Para sa maliit na deployment, hindi. Pinangangasiwaan ng built-in user store ang mga account na ginawa mula sa dashboard, at sapat na iyon para sa kaunting user.
Kailangan mo ng external identity provider kung mayroon ka na nito at ayaw mong magpanatili ng pangalawang listahan ng mga user. Tumatanggap ang NetBird ng anumang provider na gumagamit ng OIDC. Mag-register ng confidential OIDC client sa iyong provider, pagkatapos ay idagdag ito sa NetBird dashboard gamit ang pangalan, client ID, client secret at, kung kinakailangan, issuer. Ibibigay sa iyo ng NetBird ang redirect URL na dapat mong i-paste pabalik sa provider. May mga pinangalanang integration para sa Google, Microsoft Entra ID, Okta, Zitadel, Keycloak, Authentik at Pocket ID. Ang iba pang provider ay maaaring idagdag bilang generic OIDC. Kung nagpapatakbo ka na ng Authentik bilang iyong self-hosted single sign-on, ito ang paraan para manatili sa iisang listahan ng account sa halip na dalawa.
Mananatiling available ang local login pagkatapos mong magdagdag ng provider, at lalabas sa login page ang bawat naka-configure na provider. Magpanatili ng isang local admin account na may matibay na password. Kung masira ang OIDC configuration, magkakaroon ka pa rin ng paraan para makapasok.
NetBird o Headscale: aling control plane ang dapat mong patakbuhin?
Pareho nilang inaalis ang parehong dependency: ang hosted control server na kung hindi ay kokontakin ng iyong mga client. Magkaiba ang anyo at saklaw ng mga project na ito.
Muling ipinapatupad ng Headscale ang Tailscale control server, at patuloy mong ginagamit ang official Tailscale clients. Walang official web console. Pinamamahalaan mo ang users at pre-authentication keys gamit ang headscale command laban sa isang config file. May mga community web interface, pero hindi bahagi ng project ang mga ito. Nababagay ito sa mga gustong nasa files ang kanilang state at nasa version control ang kanilang mga pagbabago.
Ang NetBird ay naglalabas ng buong produkto: sarili nitong client, sarili nitong dashboard, naka-embed na identity provider, at access policies na ine-edit sa browser. Mas marami itong moving parts sa iyong VPS, pero mas kaunti ang trabahong kailangang ipasa sa isang kasamahan na hindi naman magbubukas ng terminal. Kung talagang pinagpipilian mo ang NetBird at hosted Tailscale, sa halip na NetBird at Headscale, parehong gumagamit ang mga ito ng WireGuard sa ilalim. Kaya saklaw ng paghahambing ng NetBird at Tailscale kung saan talaga sila nagkakaiba: kung sino ang nagpapatakbo ng control plane, kung paano isinusulat ang access rules, at kung paano dinadala ng mga relay ang network traffic.
Patakbuhin ang Headscale kung gumagamit ka na ng Tailscale clients o gusto mo ng pinakamaliit na control plane. Patakbuhin ang NetBird kung maraming tao ang kailangang mamahala ng peers at gusto mo ng console at SSO nang hindi bumubuo ng sarili mong solution. Bago ka pumili sa dalawa, tingnan ang aktuwal na saklaw ng libreng plan ng Tailscale, dahil walang babayaran ang isang non-commercial group na kasya sa anim na users para sa hosted control plane, na may unlimited user devices at 50 tagged resources sa simula, at maaaring wala itong dahilan para magpatakbo ng sarili nito. Kapag lumampas dito, lumalaki ang bayarin batay sa bilang ng tao at hindi sa bilang ng machine, kaya ang pagkalkula kung magkano ang sisingilin ng Tailscale sa iyong group ay magbibigay sa iyo ng halagang maihahambing sa gastos ng VPS at sa oras na kakailanganin ng stack na ito.
Gaano kaliit ang VPS na kayang magpatakbo nito?
Ang documented minimum ay 1 CPU at 2 GB ng memory. Bumili ng 2 GB.
May tatlong bagay na ligtas alisin sa maliit na server. Huwag piliin ang NetBird Proxy service. Ginagamit ito upang i-publish ang mga internal service sa public hostname, at wala itong kinalaman sa pagkonekta ng mga peer. Laktawan ang CrowdSec. Iniaalok lamang ito ng script kasabay ng proxy, at mas mainam itong idagdag sa exposed server sa susunod kaysa sa unang araw. Panatilihin ang default na SQLite store sa netbird_data volume. Lumipat lamang sa PostgreSQL kapag hinati mo ang deployment sa maraming machine o nakaranas ka ng aktuwal na concurrency. Nakadokumento ang migration na ito bilang isang hakbang na maaari mong gawin sa ibang pagkakataon.
Ang relay ang component na hindi mo maaaring alisin. Kung ang NAT ng dalawang peer ay nagtatalaga ng magkakaibang port para sa bawat destination, hindi sila kailanman makapagtatatag ng direct tunnel. Samakatuwid, ang relay lamang ang path na nagpapagana sa koneksyon nila. Napakaliit ng memory na matitipid sa pag-disable nito, ngunit masisira nito ang mga koneksyon sa paraang mahirap i-trace.
Kapag hindi na sapat ang isang server, ang relay ang unang dapat ilipat dito. Tumatakbo ang standalone relay gamit ang NB_LISTEN_ADDRESS, NB_EXPOSED_ADDRESS, NB_AUTH_SECRET at NB_ENABLE_STUN. Dapat magkapareho ang shared secret sa relay at sa main server. Kung hindi, mabibigo ang mga client na mag-authenticate dito.
Mga failure mode at kung ano ang makikita mo
May certificate warning sa dashboard. Hindi nakakuha ng certificate ang Traefik. Patakbuhin ang docker compose logs traefik | grep -i acme. May dalawang posibleng sanhi. Maaaring hindi pa tumuturo ang dig +short netbird.example.com sa VPS na ito, o sarado ang TCP 443 sa pagitan ng Let's Encrypt at ng container, karaniwan sa network firewall ng provider at hindi sa ufw. Sa port 443 sinasagot ang challenge, kaya hindi makatutulong ang bukas na port 80. Ayusin muna ang sanhi bago paulit-ulit na mag-retry, dahil pinapayagan lamang ng Let's Encrypt ang limang nabigong authorization bawat hostname, bawat account, bawat oras. Kung magpapatuloy ang loop, hindi ka makakapag-retry hanggang maibalik ang limit.
Sinasabi ng client na nakakonekta ito pero walang laman ang dashboard. Nag-register ang client sa hosted service ng NetBird dahil wala ang --management-url. Patakbuhin ang netbird status --detail at basahin ang linyang Management:, na nagsasabi kung saang server ito aktuwal na kumokonekta. Kapag nakita ang Management: Connected to https://api.netbird.io:443, nangangahulugan itong sa cloud ito pumunta. Patakbuhin ang sudo netbird down, pagkatapos ay patakbuhin muli ang sudo netbird up --management-url https://netbird.example.com.
Lahat ng peer ay nagpapakita ng Connection type: Relayed. Walang direktang tunnel na nabubuo, kaya dumadaan ang lahat ng traffic sa VPS at nadaragdagan ang latency ng isang hop. Suriin ang UDP 3478 sa firewall ng VPS at sa firewall ng provider, dahil ginagamit ang STUN upang malaman ng peer ang sarili nitong public address at port. Ipinapakita rin ng netbird status --detail ang Direct: false at ang mga uri ng ICE (interactive connectivity establishment) candidate para sa bawat peer. Ipinakikita nito kung gaano kalayo ang narating ng pagtatangka. Sa ilang network, relayed lamang ang posibleng resulta at walang mali sa configuration.
Sumasali ang isang peer pero hindi ito makakonekta sa anuman. Hindi nangangahulugang maaaring mag-usap ang dalawang peer dahil nasa mesh sila. Access policy ang nagtatakda nito, at walang maaabot ang grupong walang naka-attach na policy. Suriin ang policy sa dashboard bago mag-debug ng routes at firewall.
Nag-uulat ang netbird status ng problema sa daemon. Hindi tumatakbo ang service. Gamitin ang sudo netbird service status at sudo netbird service start. Nasa /var/log/netbird/client.log ang mga log ng client. Para sa problemang hindi mo matukoy, kinokolekta ng netbird debug bundle --anonymize --system-info ang mga log, status, routes, DNS settings, at firewall state sa isang archive.
Mga backup at upgrade
Dalawang bagay ang kailangang isama para sa buong installation: ang directory na naglalaman ng docker-compose.yml at config.yaml, at ang Docker volume na naglalaman ng database at mga encryption key. I-back up ang mga ito nang magkasama. Nilalaman ng config.yaml ang key na nag-e-encrypt ng sensitibong data sa store, kaya hindi mare-recover ng database copy lamang ang mga naka-encrypt na setup key at API token.
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 -dNina-prefix ng Compose ang mga pangalan ng volume gamit ang project directory, kaya ang volume na nakadokumento bilang netbird_data ay karaniwang lumalabas bilang netbird_netbird_data. Patakbuhin muna ang docker volume ls at gamitin ang pangalang ipinapakita nito. Kung hindi, tahimik na gagawa ang docker run ng walang-lamang volume at walang maa-archive. Itago ang mga archive sa labas ng VPS. Kung mayroon ka nang backup tool, ang restic o BorgBackup ang bahala sa offsite na bahagi.
Ang pag-upgrade ng server ay binubuo ng pull at recreate:
docker compose pull
docker compose up -d
docker compose psBago ka umasa rito, patakbuhin ang docker compose config | grep image:. Anumang tag na may latest ay dapat i-pin sa isang version. Pareho ito ng dahilan kung bakit naka-pin ang install script: kailangan mong malaman kung ano ang tumatakbo, at kailangan mong magkaroon ng version na maibabalikan kapag nagkaproblema ang upgrade. Nag-a-upgrade ang mga client gamit ang package manager na nag-install sa mga ito.
FAQ
Kailangan ko ba ng sarili kong identity provider para sa self-hosted na NetBird?
Hindi. May built-in user store ang mga kasalukuyang release, kaya maaari mong likhain ang unang admin account sa browser sa https://netbird.example.com at pagkatapos ay magdagdag ng mga user mula sa dashboard. Opsyonal ang external OIDC provider at maaari itong idagdag sa ibang pagkakataon gamit ang name, client ID, client secret, at, kung kinakailangan, issuer. Ang mga guide na nagsasabing kailangan mong mag-deploy ng Zitadel o Keycloak bago ang NetBird ay naglalarawan ng setup na hindi na kinakailangan. Kapag sinunod mo ang mga ito, madaragdagan ka ng isang buong service na kailangan mong patakbuhin.
Bakit Connection type: Relayed ang ipinapakita sa lahat ng peer ko?
Hindi nabubuo ang mga direct connection, kaya dumadaan ang traffic sa relay sa VPS mo. Karaniwang sanhi nito ang naka-block na UDP 3478. Ito ang STUN port na ginagamit ng mga peer upang tuklasin ang sarili nilang public address at port. Buksan ito sa firewall ng VPS at sa hiwalay na network firewall ng provider mo. Pagkatapos, patakbuhin ulit ang netbird status --detail at basahin ang linyang Direct:. Kapag ang parehong peer ay nasa likod ng NAT na nag-a-assign ng ibang port para sa bawat destination, inaasahan ang relayed na resulta at walang maling configuration.
Nakakonekta ang client ko pero walang peer na ipinapakita ang dashboard. Ano ang nangyari?
Nag-register ang client sa hosted service ng NetBird sa halip na sa server mo. Nangyayari ito kapag hindi isinama ang --management-url. Ipinapakita ng netbird status --detail ang server na kinokonekta nito sa linyang Management:, kaya kinukumpirma ito ng halagang gaya ng https://api.netbird.io:443. Patakbuhin ang sudo netbird down, pagkatapos ay sudo netbird up --management-url https://netbird.example.com, at lalabas ang peer sa dashboard mo.
Paano naiiba ang self-hosted na NetBird sa Headscale?
Parehong pinapalitan ng mga ito ang hosted control server ng server na ikaw ang nagpapatakbo. Control plane lamang ang Headscale. Pinamamahalaan mo ito gamit ang command na headscale at isang config file. Wala itong opisyal na web console, at pinapatakbo nito ang mga opisyal na Tailscale client. Kasama naman sa iisang stack ng NetBird ang sarili nitong client, admin dashboard, at integration para sa identity provider. Mas maliit patakbuhin ang Headscale at inilalagay nito ang state sa mga file. Mas madaling ibigay ang NetBird sa mga taong hindi gagamit ng terminal.
Anong laki ng VPS ang kailangan ng self-hosted na NetBird server?
Ang documented minimum ay 1 CPU at 2 GB na memory, at 2 GB ang dapat bilhin. Tanggihan ang optional proxy service habang nag-i-install. Nilalaktawan din nito ang CrowdSec prompt. Manatili sa default na SQLite store hanggang sa tunay mong kailanganin ang PostgreSQL.