NetBird VPN server zelf hosten op een VPS
Host uw eigen NetBird mesh VPN op een VPS. Leer hoe u DNS, TLS en setup keys configureert voor unattended peers en ontdek de verschillen tussen NetBird en Headscale.
Wat het zelf hosten van de NetBird VPN-server u oplevert
Door de NetBird VPN-server zelf te hosten, plaatst u het control plane op een VPS die uw eigendom is: het onderdeel dat de lijst met peers bijhoudt, bepaalt welke machine welke mag bereiken en helpt twee peers elkaar te vinden achter NAT (network address translation). De tunnels zelf blijven WireGuard, waarbij de versleuteling rechtstreeks tussen uw machines plaatsvindt. Het verschil is dat geen enkel extern bedrijf uw apparaatoverzicht of uw inlogproces beheert. Wees u bewust van wat dit u oplevert, aangezien een gehost control plane ook nooit de sleutels bezit die uw verkeer versleutelen, en wat een coördinatieserver daadwerkelijk kan doen als deze gecompromitteerd is een kortere lijst is dan de meeste mensen aannemen voordat ze dit lezen.
NetBird bevindt zich tussen twee concepten die u wellicht al kent. Het is een mesh-overlay, waardoor peers verbinding met elkaar maken in plaats van al het verkeer via één gateway te sturen. Het is ook volledig zelf te hosten, wat het vergelijkbaar maakt met Headscale, de zelf-gehoste Tailscale-controlserver. Als u voorheen alleen een tunnel met één gateway heeft gebruikt, lees dan eerst het verschil tussen standaard WireGuard en een mesh-overlay, omdat dat mentale model de rest van deze pagina nuttig maakt.
Als u eigenlijk één server wilt waar al uw verkeer via naar buiten gaat, dan is een mesh meer techniek dan nodig is voor die taak. Een standaard WireGuard VPN op een enkele VPS of een Tailscale exit node doet dat met veel minder beheer. En als het doel is om één privénetwerk te bereiken in plaats van machines met elkaar te verbinden, dan adverteert een Tailscale subnet router op een VPS dat bereik naar een tailnet dat u al heeft, zonder de volledige stack hieronder te hoeven installeren.
Wat de stack daadwerkelijk uitvoert
De lay-out is onlangs gewijzigd en de meeste oudere handleidingen beschrijven de oude situatie. Gecontroleerd in oktober 2026 tegen v0.80.0 en tegen v0.76.2, de release waar deze handleiding aan vasthoudt; het quickstart-script schrijft standaard een Compose-bestand met drie services.
netbird-serverbevat de management-API, de signal-service, de relay met een ingebouwde STUN-listener en een ingebouwde identity provider. In oudere releases waren dit afzonderlijke containers en was de identity provider een aparte Zitadel-installatie die u eerst moest bouwen.dashboardis de admin-webconsole.traefikhandelt TLS (transport layer security) af en vraagt bij de eerste start een certificaat aan bij Let's Encrypt.
Er bestaan nog twee services die uitgeschakeld blijven, tenzij u bij een prompt bevestigend antwoordt. De NetBird Proxy-service publiceert interne services op publieke hostnamen. CrowdSec filtert schadelijk verkeer. Geen van beide is nodig om een werkend mesh-netwerk op te bouwen, en beide verbruiken geheugen op een kleine server.
Als u overstapt van wg-easy in een enkele Docker-container, is dit een toename in het aantal onderdelen. Wat u hiervoor terugkrijgt zijn toegangsbeleid, accounts per gebruiker en peers die rechtstreeks met elkaar verbinden in plaats van via één gateway.
Wat u nodig hebt voordat u begint
Een publieke domeinnaam is niet optioneel. Het dashboard, de API en de relay gebruiken allemaal HTTPS op poort 443. Traefik haalt het certificaat op bij Let's Encrypt met de TLS-ALPN-01-challenge. Die wordt op poort 443 afgehandeld en vereist een naam die vanaf het openbare internet naar deze VPS verwijst. Een los IP-adres werkt in deze opzet niet.
Maak één A-record, netbird.example.com, dat verwijst naar het openbare IPv4-adres van de VPS. Wacht totdat dit record beschikbaar is voordat u iets uitvoert.
dig +short netbird.example.comDit moet het adres van uw server afdrukken. Als u het installatieprogramma uitvoert voordat DNS-propagatie is voltooid, mislukt de certificaataanvraag bij de eerste start. Herhaalde mislukte validaties kunnen bovendien tegen de rate limits van Let's Encrypt aanlopen. U moet dan wachten totdat de limiet weer beschikbaar is voordat u opnieuw kunt proberen.
Voor de standaardconfiguratie moeten slechts twee poorten vanaf het internet bereikbaar zijn: TCP 443 voor het dashboard, de API, signal- en relay-verkeer en de certificaatchallenge, en UDP 3478 voor STUN. TCP 80 moet lokaal vrij zijn omdat Traefik deze poort bindt, maar de poort hoeft niet publiek bereikbaar te zijn. Publieke toegang tot poort 80 blokkeren voorkomt alleen de redirect van HTTP naar HTTPS.
sudo ufw allow 443/tcp
sudo ufw allow 3478/udp
sudo ufw reload
sudo ufw statusOpen deze poorten ook in de netwerkfirewall van uw provider. In de meeste VPS-beheerpanelen is dit een afzonderlijke instelling. Daardoor kan een server waarvan de eigen ufw status correct lijkt, toch verbindingen blijven weigeren.
STUN (session traversal utilities for NAT) zorgt ervoor dat een peer het openbare adres en de poort leert die door zijn eigen NAT zijn toegewezen. Twee peers kunnen daardoor een directe tunnel proberen op te zetten. Als u UDP 3478 blokkeert, maken peers nog steeds verbinding via de relay op TCP 443. Daardoor lijkt er niets defect. Peers die geen direct pad kunnen vinden, tonen Connection type: Relayed. Hun verkeer loopt dan via uw VPS in plaats van rechtstreeks tussen de peers. Peers op hetzelfde LAN kunnen nog steeds rechtstreeks verbinding maken met hun lokale adressen.
Aan de softwarekant hebt u Docker met de Compose v2-plugin nodig, plus jq en curl. Het script controleert op Docker, Compose en jq en stopt als een daarvan ontbreekt. Het gebruikt curl zonder daarop te controleren. Installeer dat daarom eerst. Als Docker nieuw is op deze server, volg dan eerst Docker Compose werkend krijgen op de VPS.
Poorten als u de meegeleverde reverse proxy overslaat
Zonder Traefik gebruikt de gecombineerde server nog steeds één HTTP-backend voor beheer, signal en relay. De lijst met poorten wordt daardoor nauwelijks langer. Het gegenereerde Compose-bestand publiceert:
- TCP 8080, het dashboard, standaard gebonden aan 127.0.0.1
- TCP 8081,
netbird-server, standaard gebonden aan 127.0.0.1 - UDP 3478, STUN, rechtstreeks gepubliceerd
Uw eigen proxy handelt TLS af op TCP 443 en stuurt verkeer door naar die twee lokale poorten. STUN loopt nooit via de proxy. UDP 3478 moet daarom in beide gevallen op de firewall open blijven. Handleidingen die afzonderlijke poorten voor management gRPC, signal gRPC en de relay vermelden, beschrijven de oudere indeling met meerdere containers.
Kies deze optie alleen als de server TLS al voor iets anders afhandelt. In andere gevallen vereist de meegeleverde Traefik minder regels en ontstaan er minder fouten.
De NetBird-server installeren met het quickstart-script
De gedocumenteerde one-liner pipe de nieuwste release direct naar een shell:
curl -fsSL https://github.com/netbirdio/netbird/releases/latest/download/getting-started.sh | bashPin de versie in plaats daarvan. latest wijzigt, waardoor hetzelfde commando dat met twee weken tussenpozen wordt uitgevoerd twee verschillende installaties oplevert, en er op de schijf niets wordt vastgelegd dat aangeeft welke versie uw configuratie heeft geschreven. Download een getagde release, lees deze door en voer hem vervolgens uit.
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.shHet script vraagt eerst om het domein:
Enter the domain you want to use for NetBird (e.g. netbird.my-domain.com):Vervolgens vraagt het hoe TLS moet worden afgehandeld:
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):Kies [0]. Opties 2 tot en met 4 schrijven een configuratiefragment en laten de verdere afhandeling aan u over, en optie 5 schrijft het Compose-bestand, dashboard.env en config.yaml, en print de installatiedocumentatie naar de terminal. Dat is correct op een server die al een proxy draait en onjuist op een nieuwe server. Optie 0 vraagt vervolgens om een e-mailadres, dat Traefik registreert bij uw Let's Encrypt-account. De prompt noemt dit nog steeds een adres voor certificaatmeldingen, maar Let's Encrypt is op 4 juni 2025 gestopt met het versturen van e-mails over verloopdata, dus problemen met vernieuwing verschijnen in de Traefik-log in plaats van in uw inbox.
Zeg nee tegen de NetBird Proxy-service bij een eerste installatie. Deze vereist nog een DNS-record, een wildcard *.netbird.example.com CNAME die verwijst naar netbird.example.com, en het voegt niets toe aan een standaard mesh. De CrowdSec-prompt verschijnt pas zodra de proxy is ingeschakeld, dus het weigeren van de proxy slaat deze ook over. Beide kunnen later worden toegevoegd.
Het script schrijft naar de huidige map: docker-compose.yml, config.yaml met modus 600, en dashboard.env. Met de meegeleverde Traefik voegt het traefik-dynamic.yaml en proxy.env alleen toe wanneer u de NetBird Proxy inschakelt. Behandel die map als status die u moet bewaren, omdat config.yaml de sleutel bevat die gegevens in de opslag versleutelt. Het verliezen hiervan is niet iets dat een herinstallatie oplost.
docker compose ps
docker compose logs -f netbird-serverElke service moet running kunnen lezen en de serverlog moet stabiliseren in plaats van in een lus opnieuw op te starten. Monitor het certificaat afzonderlijk:
docker compose logs traefik | grep -i acmeACME (automatic certificate management environment) is het protocol dat Traefik gebruikt om het certificaat te verkrijgen. Fouten hier zijn bijna altijd te wijten aan DNS of een gesloten poort 443.
Het eerste beheerdersaccount aanmaken
Open https://netbird.example.com. Bij een nieuwe installatie verschijnt er een configuratiepagina in plaats van een inlogformulier. Voer een e-mailadres, een naam en een wachtwoord in en klik op Create Account. Dit wordt de eerste beheerder en de pagina leidt door naar het inlogformulier.
Dit account bevindt zich in de eigen gebruikersdatabase van NetBird, die wordt aangestuurd door een identiteitsprovider die is ingebed in de netbird-server-container. Er is geen externe partij bij betrokken. Dit is de grootste verandering ten opzichte van de zelfgehoste NetBird van een jaar geleden, toen een werkende installatie betekende dat u eerst Zitadel of Keycloak moest opzetten en vier OIDC (OpenID Connect)-waarden in setup.env moest kopiëren voordat er überhaupt iets werkte.
Als u een certificaatwaarschuwing van de browser krijgt in plaats van de configuratiepagina, dan is het certificaat niet uitgegeven. Los dit op voordat u verdergaat, omdat het dashboard via dezelfde hostnaam met de API communiceert en op onduidelijke wijze faalt achter een ongeldig certificaat.
Uw eerste peer toevoegen
Installeer de client op elke Linux-machine, inclusief de VPS zelf als u deze in het mesh-netwerk wilt opnemen:
curl -fsSL https://pkgs.netbird.io/install.sh | shOp Debian en Ubuntu configureert dat script de pakketrepository van NetBird en installeert vervolgens de client via apt, zodat de pakketbeheerder het beheer overneemt. Als u het doorsturen van een script naar een shell onveilig vindt, sla het dan eerst op met curl -fsSL -o install.sh https://pkgs.netbird.io/install.sh en lees het door voordat u sh install.sh uitvoert. Controleer in ieder geval wat er is geïnstalleerd:
apt-cache policy netbirdnetbird is de command-line client en de daemon. netbird-ui is de desktop-tray-applicatie; een headless server heeft hier geen nut voor.
Verwijs de client nu naar uw server:
sudo netbird up --management-url https://netbird.example.comLaat --management-url weg en de client registreert zich bij de gehoste dienst van NetBird, omdat dit de standaardinstelling is in de gecompileerde code. Het commando slaagt nog steeds, de machine krijgt nog steeds een adres, en uw zelfgehoste dashboard blijft leeg. Dit overkomt bijna iedereen een keer.
Het commando toont een URL die u in een browser moet openen om het inloggen te voltooien. Daarna:
netbird status
ip addr show wt0Lees vier regels uit netbird status: Management: Connected, Signal: Connected, een Relays:-regel die alle beschikbare relays rapporteert, en een NetBird IP: in het overlay-bereik. wt0 is de WireGuard-interface die NetBird aanmaakt, en deze zou hetzelfde adres moeten dragen.
Een tweede machine zonder toezicht registreren met een setup key
Inloggen via een browser werkt niet voor een machine zonder browser en zonder iemand die deze bedient. Een setup key is een pre-authenticatietoken waarmee u een machine zonder de interactieve stap registreert. Maak een setup key in het dashboard via Settings → Setup Keys.
Er zijn twee typen. Een eenmalige key authenticeert precies één machine en wordt daarna verbruikt. Met een herbruikbare key kunt u meerdere machines registreren, eventueel met een limiet voor het aantal machines. Voor beide typen kunt u optioneel een vervaldatum instellen. Beide typen kunnen de nieuwe peer automatisch aan een groep toewijzen, zodat de toegangsregels van die groep direct van toepassing zijn zodra de machine verschijnt.
sudo netbird up --setup-key <SETUP-KEY> \
--management-url https://netbird.example.com \
--hostname build-runner-01--hostname stelt de naam in die in het dashboard wordt weergegeven. Zonder deze optie gebruikt de peer de naam die de machine zelf opgeeft. Een lijst met vermeldingen die allemaal ubuntu heten, is niet bruikbaar.
Stel de key bij het maken in als ephemeral voor containers en kortlevende build agents. Peers die met een ephemeral key zijn geregistreerd, worden automatisch verwijderd zodra ze langer dan 10 minuten offline zijn. Zo blijven niet meer actieve vermeldingen uit de peerlijst.
Houd rekening met één beperking voordat u setup keys in uw ontwerp opneemt: wanneer een key verloopt of wordt ingetrokken, worden nieuwe registraties gestopt. Machines die al met deze key zijn geregistreerd, worden niet verbroken. Als u de toegang van een machine wilt verwijderen, moet u die peer verwijderen.
Hebt u nog een afzonderlijke identity provider nodig?
Voor een kleine installatie niet. De ingebouwde gebruikersopslag verwerkt accounts die u vanuit het dashboard aanmaakt. Dat is voldoende voor een klein aantal gebruikers.
U hebt een externe identity provider nodig als u die al gebruikt en geen tweede gebruikerslijst wilt beheren. NetBird accepteert elke provider die OIDC ondersteunt. Registreer een vertrouwelijke OIDC-client bij uw provider. Voeg deze daarna in het NetBird-dashboard toe met een naam, client-ID, clientgeheim en, indien vereist, issuer. NetBird geeft u een redirect-URL die u bij de provider invoert. Er zijn benoemde integraties voor Google, Microsoft Entra ID, Okta, Zitadel, Keycloak, Authentik en Pocket ID. Alle andere providers voegt u toe als generieke OIDC-provider. Als u Authentik al gebruikt als self-hosted single sign-on, voorkomt deze optie dat u twee accountlijsten moet beheren.
Lokale aanmelding blijft beschikbaar nadat u een provider hebt toegevoegd. Elke geconfigureerde provider verschijnt op de aanmeldpagina. Behoud één lokaal admin-account met een sterk wachtwoord. Als de OIDC-configuratie defect raakt, kunt u zich daarmee nog steeds aanmelden.
NetBird of Headscale: welk control plane moet u draaien?
Beide verwijderen dezelfde afhankelijkheid: de gehoste control server waar uw clients anders verbinding mee zouden maken. Het zijn echter projecten met een verschillende opzet.
Headscale is een herimplementatie van de Tailscale control server, waarbij u de officiële Tailscale-clients blijft gebruiken. Er is geen officiële webconsole. U beheert gebruikers en pre-authentication keys met het headscale-commando op basis van een configuratiebestand. Er bestaan webinterfaces van de community, maar deze maken geen deel uit van het project. Dit is geschikt voor gebruikers die hun status in bestanden willen bijhouden en wijzigingen in versiebeheer willen vastleggen.
NetBird levert het volledige product: een eigen client, een eigen dashboard, een ingebouwde identityprovider en toegangsbeleid dat u in een browser bewerkt. Daardoor draaien er meer onderdelen op uw VPS. Het beheer is wel veel eenvoudiger over te dragen aan een collega die nooit een terminal zal openen. Als u NetBird daadwerkelijk vergelijkt met de gehoste versie van Tailscale en niet met Headscale, gebruiken beide onderliggend WireGuard. Daarom behandelt de vergelijking tussen NetBird en Tailscale waar de oplossingen daadwerkelijk verschillen: wie het control plane beheert, hoe toegangsregels worden opgesteld en hoe relays netwerkverkeer doorsturen.
Draai Headscale als u al gebruikmaakt van Tailscale-clients of als u het kleinst mogelijke control plane wilt. Draai NetBird als meerdere personen peers moeten beheren en u een console en SSO wilt zonder deze zelf te hoeven samenstellen. Voordat u voor een van beide kiest, controleer wat het gratis abonnement van Tailscale daadwerkelijk dekt. Een niet-commerciële groep van maximaal zes gebruikers betaalt niets voor een gehost control plane, inclusief onbeperkte apparaten per gebruiker en 50 getagde resources, waardoor er mogelijk geen reden is om zelf een server te draaien. Boven die limiet stijgen de kosten op basis van het aantal personen in plaats van het aantal machines. Daarom geeft het berekenen van de kosten van Tailscale voor uw groep u een bedrag om af te wegen tegen de kosten van de VPS en de uren die dit beheer u kost.
Hoe klein mag een VPS zijn om dit te draaien?
Het gedocumenteerde minimum is 1 CPU en 2 GB geheugen. Koop 2 GB.
Drie zaken kunnen veilig worden weggelaten op een kleine server. Wijs de NetBird Proxy-service af; deze dient om interne services op publieke hostnames te publiceren en heeft niets te maken met het verbinden van peers. Sla CrowdSec over, dat het script alleen aanbiedt in combinatie met de proxy en dat later aan een blootgestelde server kan worden toegevoegd in plaats van op de eerste dag. Behoud de standaard SQLite-opslag in het netbird_data-volume en stap pas over op PostgreSQL wanneer u de implementatie over meerdere machines verdeelt of tegen echte gelijktijdigheid aanloopt; dit staat gedocumenteerd als een migratie die u later kunt uitvoeren.
De relay is het enige onderdeel dat u niet kunt weglaten. Twee peers waarvan de NAT voor elke bestemming een andere poort toewijst, zullen nooit een directe tunnel opzetten, dus de relay is het enige pad waardoor ze überhaupt kunnen werken. Het uitschakelen ervan bespaart nauwelijks geheugen en verbreekt verbindingen op een manier die lastig te achterhalen is.
Wanneer één server niet langer volstaat, zijn relays het eerste onderdeel dat u verplaatst. Een zelfstandige relay draait met NB_LISTEN_ADDRESS, NB_EXPOSED_ADDRESS, NB_AUTH_SECRET en NB_ENABLE_STUN. Het gedeelde geheim moet identiek zijn op de relay en op de hoofdserver, anders slagen clients er niet in om zich erbij te authenticeren.
Foutmodi en wat u zult zien
Het dashboard toont een certificaatwaarschuwing. Traefik heeft geen certificaat verkregen. Voer docker compose logs traefik | grep -i acme uit. Er zijn twee oorzaken. Ofwel verwijst dig +short netbird.example.com nog niet naar deze VPS, of TCP 443 is ergens tussen Let's Encrypt en de container geblokkeerd, meestal door de netwerkfirewall van de provider in plaats van op ufw. De challenge wordt beantwoord op 443, dus een open poort 80 helpt hier niet. Los de oorzaak op voordat u het opnieuw probeert in een lus, omdat Let's Encrypt slechts vijf mislukte autorisaties per hostnaam per account per uur toestaat. Een lus zorgt ervoor dat u wordt uitgesloten van nieuwe pogingen totdat die limiet is verstreken.
De client meldt dat deze verbonden is, maar het dashboard is leeg. De client is geregistreerd bij de gehoste dienst van NetBird omdat --management-url ontbrak. Voer netbird status --detail uit en lees de regel Management:, die de server benoemt waarmee daadwerkelijk contact wordt gemaakt. Als u Management: Connected to https://api.netbird.io:443 ziet, betekent dit dat de verbinding naar de cloud gaat. Voer sudo netbird down uit en daarna opnieuw sudo netbird up --management-url https://netbird.example.com.
Elke peer toont Connection type: Relayed. Er worden geen directe tunnels gevormd, waardoor al het verkeer via uw VPS verloopt en er een extra hop aan latentie wordt toegevoegd. Controleer UDP 3478 op de VPS-firewall en op de firewall van de provider, aangezien STUN ervoor zorgt dat een peer zijn eigen publieke adres en poort leert kennen. netbird status --detail toont ook Direct: false en de ICE (interactive connectivity establishment) kandidaat-types voor elke peer, wat laat zien hoe ver de poging is gekomen. Op sommige netwerken is relayed de enige beschikbare uitkomst en is er niets mis.
Een peer sluit zich aan maar kan niets bereiken. Deel uitmaken van het mesh-netwerk betekent niet dat twee peers met elkaar kunnen praten. Toegangsbeleid bepaalt dit, en een groep waaraan geen beleid is gekoppeld, bereikt niets. Controleer het beleid in het dashboard voordat u begint met het debuggen van routes en firewalls.
netbird status rapporteert een daemon-probleem. De service draait niet. Gebruik sudo netbird service status en sudo netbird service start. Client-logs bevinden zich op /var/log/netbird/client.log. Voor zaken die u niet kunt plaatsen, verzamelt netbird debug bundle --anonymize --system-info logs, status, routes, DNS-instellingen en de firewall-status in één archief.
Back-ups en upgrades
Twee onderdelen zijn bepalend voor de volledige installatie: de directory met docker-compose.yml en config.yaml, en het Docker-volume met de database en de encryptiesleutels. Maak van beide samen een back-up. config.yaml bevat de sleutel waarmee gevoelige gegevens in de opslag worden versleuteld. Met alleen een kopie van de database kunt u versleutelde installatiesleutels en API-tokens daarom niet herstellen.
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 -dCompose voorziet volum namen van de naam van de projectdirectory. Het volume dat als netbird_data is gedocumenteerd, verschijnt daarom meestal als netbird_netbird_data. Voer eerst docker volume ls uit en gebruik de naam die de opdracht afdrukt. Anders mislukt docker run stilzwijgend doordat een leeg volume wordt aangemaakt en er niets wordt gearchiveerd. Bewaar de archieven niet op de VPS. Als u al een back-uptool gebruikt, kunnen restic of BorgBackup het externe deel verzorgen.
Een upgrade van de server bestaat uit pullen en opnieuw aanmaken:
docker compose pull
docker compose up -d
docker compose psVoer eerst docker compose config | grep image: uit voordat u daarop vertrouwt. Elke tag met de waarde latest moet u vastzetten op een versie. Dat is om dezelfde reden belangrijk als het vastzetten van het installatiescript: u wilt weten wat er draait en u wilt kunnen teruggaan naar een versie als een upgrade problemen veroorzaakt. Clients werkt u bij via de package manager waarmee u ze hebt geïnstalleerd.
FAQ
Heb ik mijn eigen identity provider nodig om NetBird zelf te hosten?
Nee. Huidige releases bevatten een ingebouwde gebruikersopslag. U maakt het eerste beheerdersaccount aan in de browser op https://netbird.example.com en voegt daarna gebruikers toe via het dashboard. Een externe OIDC-provider is optioneel. U kunt die later toevoegen met een naam, client-ID, client secret en, indien vereist, een issuer. Handleidingen waarin staat dat u Zitadel of Keycloak vóór NetBird moet implementeren, beschrijven een configuratie die niet langer vereist is. Als u die volgt, moet u een extra service beheren.
Waarom tonen al mijn peers Connection type: Relayed?
Er worden geen rechtstreekse verbindingen opgebouwd. Het verkeer loopt daarom via de relay op uw VPS. De gebruikelijke oorzaak is dat UDP 3478 is geblokkeerd. Dit is de STUN-poort die peers gebruiken om hun eigen openbare adres en poort te bepalen. Open deze poort in de firewall van de VPS en in de afzonderlijke netwerkfirewall van uw provider. Voer daarna netbird status --detail opnieuw uit en lees de regel Direct:. Als beide peers zich achter NAT bevinden dat per bestemming een andere poort toewijst, is relayed het verwachte resultaat en is de configuratie niet fout.
Mijn client is verbonden, maar het dashboard toont geen peers. Wat is er gebeurd?
De client heeft zich geregistreerd bij de gehoste service van NetBird in plaats van bij uw server. Dit gebeurt wanneer --management-url is weggelaten. netbird status --detail toont op de regel Management: met welke server de client communiceert. Een waarde zoals https://api.netbird.io:443 bevestigt dit. Voer sudo netbird down en daarna sudo netbird up --management-url https://netbird.example.com uit. De peer verschijnt vervolgens in uw dashboard.
Waarin verschilt zelfgehoste NetBird van Headscale?
Beide vervangen een gehoste control server door een server die u zelf beheert. Headscale is alleen een control plane. U beheert deze met de opdracht headscale en een configuratiebestand. Er is geen officiële webconsole en Headscale gebruikt de officiële Tailscale-clients. NetBird levert in dezelfde stack een eigen client, een beheerdersdashboard en integratie met identity providers. Headscale is kleiner om te beheren en bewaart de status in bestanden. NetBird is eenvoudiger te gebruiken voor mensen die geen terminal willen gebruiken.
Welke omvang moet een VPS voor een zelfgehoste NetBird-server hebben?
Het gedocumenteerde minimum is 1 CPU en 2 GB geheugen. 2 GB is daarom de aanbevolen hoeveelheid om te kiezen. Sla de optionele proxyservice tijdens de installatie over. Daarmee slaat u ook de prompt voor CrowdSec over. Gebruik de standaard SQLite-opslag totdat u PostgreSQL daadwerkelijk nodig hebt.