SSD Nodes Learn Hosting plans →

VPSలో NetBird VPN సర్వర్‌ను సెటప్ చేయడం ఎలా?

మీ స్వంత VPSలో NetBird VPNని హోస్ట్ చేసే విధానం ఇక్కడ ఉంది. DNS, TLS కాన్ఫిగరేషన్, సెటప్ కీలు మరియు Headscaleతో పోలికల గురించి పూర్తి వివరాలను ఈ గైడ్‌లో తెలుసుకోండి.

NetBird VPN సర్వర్‌ను self-host చేయడం వల్ల కలిగే ప్రయోజనాలు

NetBird VPN సర్వర్‌ను self-host చేయడం ద్వారా, కంట్రోల్ ప్లేన్‌ను మీ సొంత VPSపై ఉంచుకోవచ్చు: ఇది పీర్ల జాబితాను కలిగి ఉండి, ఏ యంత్రం దేనిని చేరుకోవాలో నిర్ణయిస్తుంది, మరియు NAT (network address translation) వెనుక ఉన్న రెండు పీర్లు ఒకదానికొకటి కనుగొనడంలో సహాయపడుతుంది. టన్నెల్స్ అన్నీ ఇప్పటికీ WireGuard ద్వారానే ఉంటాయి, ఇవి మీ యంత్రాల మధ్య నేరుగా ఎన్‌క్రిప్ట్ చేయబడతాయి. దీనివల్ల మారేది ఏమిటంటే, మీ పరికరాల జాబితాను లేదా మీ లాగిన్ ప్రక్రియను ఏ బయటి సంస్థా కలిగి ఉండదు. దీనివల్ల మీకు ఏమి లభిస్తుందో స్పష్టంగా తెలుసుకోండి, ఎందుకంటే హోస్ట్ చేయబడిన కంట్రోల్ ప్లేన్ కూడా మీ ట్రాఫిక్‌ను ఎన్‌క్రిప్ట్ చేసే కీలను కలిగి ఉండదు, మరియు ఒక కోఆర్డినేషన్ సర్వర్ రాజీ పడితే అది నిజంగా ఏమి చేయగలదు అనే అంశంపై ఉన్న పరిమితులు చాలామంది ఊహించిన దానికంటే తక్కువగానే ఉంటాయి.

NetBird మీకు ఇప్పటికే తెలిసిన రెండు విషయాల మధ్య ఉంటుంది. ఇది ఒక మెష్ ఓవర్‌లే, కాబట్టి పీర్లు ప్రతిదీ ఒకే గేట్‌వే ద్వారా పంపే బదులు ఒకదానికొకటి నేరుగా కనెక్ట్ అవుతాయి. ఇది ఎండ్-టు-ఎండ్ self-host చేయదగినది, ఇది Headscale, self-hosted Tailscale కంట్రోల్ సర్వర్ తో పోటీపడుతుంది. మీరు ఇప్పటివరకు కేవలం సింగిల్-గేట్‌వే టన్నెల్‌ను మాత్రమే నడిపినట్లయితే, ముందుగా సాధారణ WireGuard మరియు మెష్ ఓవర్‌లే మధ్య తేడాలను చదవండి, ఎందుకంటే ఆ అవగాహన ఉంటేనే ఈ పేజీలోని మిగిలిన సమాచారం మీకు ఉపయోగకరంగా ఉంటుంది.

మీకు నిజంగా కావాల్సింది మీ ట్రాఫిక్ అంతా బయటకు వెళ్లే ఒకే ఒక సర్వర్ అయితే, మెష్ అనేది ఆ పనికి అవసరమైన దానికంటే ఎక్కువ సంక్లిష్టమైనది. ఒక VPSపై సాధారణ WireGuard VPN లేదా Tailscale exit node తక్కువ శ్రమతో ఆ పనిని పూర్తి చేస్తాయి. ఒకవేళ మీ లక్ష్యం యంత్రాలను ఒకదానికొకటి అనుసంధానించడం కాకుండా, ఒక ప్రైవేట్ నెట్‌వర్క్‌ను చేరుకోవడం అయితే, VPSపై ఉన్న Tailscale subnet router ఆ నెట్‌వర్క్ పరిధిని మీకు ఇప్పటికే ఉన్న tailnet కి తెలియజేస్తుంది, దీనికి కింద పేర్కొన్న స్టాక్ ఏదీ అవసరం లేదు.

స్టాక్ వాస్తవంగా నడిపించే భాగాలు

లేఅవుట్ ఇటీవల మారింది. పాత వివరణల్లో ఎక్కువగా మునుపటి లేఅవుట్‌నే పేర్కొంటారు. October 2026లో v0.80.0తో, అలాగే ఈ గైడ్‌లో నిర్దేశించిన విడుదల v0.76.2తో తనిఖీ చేసినప్పుడు, quickstart script డిఫాల్ట్‌గా మూడు services కలిగిన Compose file ను రాస్తుంది.

  • netbird-server management API, signal service, embedded STUN listener కలిగిన relay, అలాగే embedded identity provider ను నిర్వహిస్తుంది. పాత releasesలో ఇవి వేర్వేరు containersగా ఉండేవి. Identity provider కోసం ముందుగా మీరు ప్రత్యేక Zitadel install ను build చేయాల్సి వచ్చేది.
  • dashboard admin web console.
  • traefik TLS (transport layer security) ను terminate చేసి, మొదటి start సమయంలో Let's Encrypt నుంచి certificate ను అభ్యర్థిస్తుంది.

ఇంకా రెండు services ఉన్నాయి. Prompt వద్ద మీరు yes అని చెప్పకపోతే అవి నిలిపివేయబడి ఉంటాయి. NetBird Proxy service అంతర్గత services ను public hostnamesపై ప్రచురిస్తుంది. CrowdSec దుర్వినియోగ network traffic ను filter చేస్తుంది. పనిచేసే mesh నిర్మించడానికి ఈ రెండింటిలో ఏదీ అవసరం లేదు. చిన్న systemలో రెండూ memoryని వినియోగిస్తాయి.

మీరు ఒకే Docker containerలో wg-easy నుంచి వస్తుంటే, ఇది భాగాల సంఖ్యలో గణనీయమైన పెరుగుదల. దీనివల్ల access policies, ప్రతి userకు ప్రత్యేక accounts లభిస్తాయి. Peers ఒక gateway ద్వారా కాకుండా నేరుగా ఒకదానితో ఒకటి connect అవుతాయి.

మీరు ప్రారంభించే ముందు అవసరమైనవి

Public domain name తప్పనిసరి. Dashboard, API మరియు relay అన్నీ port 443పై HTTPS ద్వారా పనిచేస్తాయి. Traefik తన certificate ను Let's Encrypt నుంచి TLS-ALPN-01 challenge ద్వారా పొందుతుంది. ఈ challenge కు port 443పై సమాధానం ఇవ్వాలి. అందువల్ల public internet నుంచి ఈ VPS కు resolve అయ్యే name అవసరం. ఈ విధానంలో bare IP address పనిచేయదు.

ఒక A record సృష్టించి, netbird.example.com ను VPS public IPv4 address కు point చేయండి. ఏదైనా command అమలు చేయడానికి ముందు DNS propagation పూర్తయ్యే వరకు వేచి ఉండండి.

dig +short netbird.example.com

అది మీ server address ను చూపించాలి. DNS propagate కాకముందే installer ను అమలు చేస్తే మొదటి start సమయంలో certificate request విఫలమవుతుంది. విఫలమైన validations పదేపదే జరిగితే Let's Encrypt rate limits వర్తిస్తాయి. అప్పుడు మళ్లీ ప్రయత్నించే ముందు ఆ limit reset అయ్యే వరకు వేచి ఉండాలి.

Default setup కోసం internet నుంచి చేరుకోగలిగేలా ఉండాల్సిన ports రెండే: dashboard, API, signal, relay traffic మరియు certificate challenge కోసం TCP 443; STUN కోసం UDP 3478. TCP 80 స్థానికంగా ఖాళీగా ఉండాలి, ఎందుకంటే Traefik దానిపై bind అవుతుంది. అయితే అది public internet నుంచి చేరుకోగలిగేలా ఉండాల్సిన అవసరం లేదు. Port 80కు public access నిరోధిస్తే HTTP-to-HTTPS redirect మాత్రమే పనిచేయదు.

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

వీటిని మీ provider network firewallలో కూడా తెరవండి. చాలా VPS panelsలో ఇది ప్రత్యేక నియంత్రణగా ఉంటుంది. అందుకే server యొక్క స్వంత ufw status సరిగ్గా ఉన్నప్పటికీ connections తిరస్కరించబడవచ్చు.

STUN (session traversal utilities for NAT) ద్వారా ఒక peer కు తన NAT కేటాయించిన public address మరియు port తెలుస్తాయి. దాంతో రెండు peers direct tunnel కోసం ప్రయత్నించగలవు. UDP 3478ను block చేసినా peers TCP 443పై relay ద్వారా connect అవుతాయి. అందువల్ల ఏదీ విరిగిపోయినట్లు కనిపించకపోవచ్చు. Direct path కనుగొనలేని peers Connection type: Relayed ను చూపిస్తాయి. వాటి traffic peer-to-peerగా కాకుండా మీ VPS ద్వారా వెళ్తుంది. ఒకే LANలో ఉన్న peers మాత్రం తమ local addresses ఉపయోగించి నేరుగా connect అవగలవు.

Software పరంగా Dockerతో పాటు Compose v2 plugin అవసరం. అలాగే jq మరియు curl కూడా అవసరం. Script Docker, Compose మరియు jq కోసం తనిఖీ చేసి, వాటిలో ఏదైనా లేకపోతే ఆగిపోతుంది. ఇది curl కోసం తనిఖీ చేయకుండా దాన్ని ఉపయోగిస్తుంది. కాబట్టి ముందుగా దాన్ని install చేయండి. ఈ serverలో Docker కొత్తగా ఉంటే ముందుగా VPSలో Docker Compose పనిచేసేలా చేయడం చూడండి.

Bundled reverse proxyను ఉపయోగించకపోతే ports

Traefik లేకుండా కూడా combined server management, signal మరియు relay trafficను ఒకే HTTP backendపై నిర్వహిస్తుంది. అందువల్ల ports జాబితా చాలా తక్కువగా మాత్రమే పెరుగుతుంది. Generated Compose file ఇవి publish చేస్తుంది:

  • TCP 8080, dashboard; defaultగా 127.0.0.1కు bind అవుతుంది
  • TCP 8081, netbird-server; defaultగా 127.0.0.1కు bind అవుతుంది
  • UDP 3478, STUN; నేరుగా publish అవుతుంది

మీ స్వంత proxy TCP 443పై TLS termination చేసి, ఆ రెండు local portsకు forward చేస్తుంది. STUN proxy ద్వారా ఎప్పుడూ వెళ్లదు. కాబట్టి ఏ విధంగానైనా UDP 3478 firewallలో openగా ఉంచాలి. Management gRPC, signal gRPC మరియు relay కోసం వేర్వేరు ports చూపించే guides పాత multi-container layout గురించి వివరిస్తాయి.

ఇతర సేవ కోసం ఈ server ఇప్పటికే TLS termination చేస్తున్నప్పుడు మాత్రమే ఈ ఎంపికను ఉపయోగించండి. లేకపోతే bundled Traefikలో rules తక్కువగా ఉంటాయి, తప్పులు కూడా తక్కువగా జరుగుతాయి.

quickstart script తో NetBird server ను ఇన్‌స్టాల్ చేయడం

డాక్యుమెంటేషన్‌లోని one-liner తాజా release ను నేరుగా shell కు పంపుతుంది:

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

దానికి బదులుగా నిర్దిష్ట release ను pin చేయండి. latest మారుతూ ఉంటుంది. అందువల్ల రెండు వారాల వ్యవధిలో అదే command ను అమలు చేస్తే రెండు వేర్వేరు installs ఏర్పడతాయి. మీ config ను ఏ release రాసిందో disk లో ఎక్కడా నమోదు కాదు. Tagged release ను download చేసి, చదివి, తరువాత run చేయండి.

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

మొదట script domain ను అడుగుతుంది:

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

తరువాత 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):

[0] ను ఎంచుకోండి. Options 2 నుంచి 4 వరకు config snippet ను రాసి, మిగిలిన wiring ను మీకు వదిలేస్తాయి. Option 5 Compose file, dashboard.env మరియు config.yaml ను రాసి, setup documentation ను terminal లో ప్రదర్శిస్తుంది. ఇప్పటికే proxy నడుస్తున్న server పై ఇది సరైనది. కొత్త server పై ఇది సరైన ఎంపిక కాదు. ఆ తరువాత Option 0 email address ను అడుగుతుంది. ఆ address ను Traefik మీ Let's Encrypt account తో register చేస్తుంది. Prompt ఇప్పటికీ దాన్ని certificate notifications కోసం address గా పేర్కొంటుంది. అయితే Let's Encrypt June 4, 2025 నుంచి expiry emails పంపడం నిలిపివేసింది. అందువల్ల renewal సమస్యలు మీ inbox లో కాకుండా Traefik log లో కనిపిస్తాయి.

మొదటి install సమయంలో NetBird Proxy service కు no అని ఎంచుకోండి. దీనికి మరో DNS record అవసరం. అది wildcard *.netbird.example.com CNAME అయి netbird.example.com వైపు చూపాలి. సాధారణ mesh కోసం ఇది ఏ పనీ చేయదు. Proxy enable చేసినప్పుడు మాత్రమే CrowdSec prompt కనిపిస్తుంది. అందువల్ల proxy ను నిరాకరిస్తే CrowdSec కూడా దాటవేయబడుతుంది. రెండింటినీ తరువాత జోడించవచ్చు.

Script ప్రస్తుత directory లో ఈ ఫైళ్లను రాస్తుంది: docker-compose.yml, mode 600 తో config.yaml, మరియు dashboard.env. Bundled Traefik తో NetBird Proxy ను enable చేసినప్పుడు మాత్రమే traefik-dynamic.yaml మరియు proxy.env కూడా జోడించబడతాయి. ఆ directory ను మీరు భద్రపరచాల్సిన state గా పరిగణించండి. ఎందుకంటే data store ను encrypt చేసే key ను config.yaml కలిగి ఉంటుంది. ఇది పోతే reinstall చేయడం ద్వారా సమస్య పరిష్కారం కాదు.

docker compose ps
docker compose logs -f netbird-server

ప్రతి service running ను చదవాలి. Server log loop లో restart కాకుండా స్థిరపడాలి. Certificate ను విడిగా monitor చేయండి:

docker compose logs traefik | grep -i acme

ACME (automatic certificate management environment) అనేది certificate పొందడానికి Traefik ఉపయోగించే protocol. ఇక్కడ కనిపించే errors దాదాపు ఎల్లప్పుడూ DNS సమస్య లేదా మూసి ఉన్న port 443 వల్లే వస్తాయి.

మొదటి అడ్మిన్ ఖాతాను సృష్టించడం

https://netbird.example.comని తెరవండి. కొత్తగా ఇన్‌స్టాల్ చేసినప్పుడు, ఇది లాగిన్ ఫారమ్‌కు బదులుగా సెటప్ పేజీకి దారి తీస్తుంది. ఒక ఈమెయిల్ అడ్రస్, పేరు మరియు పాస్‌వర్డ్‌ను నమోదు చేసి, ఆపై Create Account పై క్లిక్ చేయండి. అదే మొదటి అడ్మిన్ ఖాతా అవుతుంది, ఆ తర్వాత పేజీ లాగిన్ ఫారమ్‌కు రీడైరెక్ట్ అవుతుంది.

ఈ ఖాతా NetBird సొంత యూజర్ స్టోర్‌లో ఉంటుంది, ఇది netbird-server కంటైనర్‌లో పొందుపరచబడిన ఐడెంటిటీ ప్రొవైడర్ ద్వారా పనిచేస్తుంది. ఇందులో బయటి సేవలేవీ ఉండవు. ఒక సంవత్సరం క్రితం ఉన్న self-hosted NetBird తో పోలిస్తే ఇది అతిపెద్ద మార్పు; అప్పట్లో ఒక ఇన్‌స్టాలేషన్ పనిచేయాలంటే ముందుగా Zitadel లేదా Keycloak ను ఏర్పాటు చేసి, ఏదైనా ప్రారంభించే ముందు నాలుగు OIDC (OpenID Connect) విలువలను setup.env లో కాపీ చేయాల్సి ఉండేది.

సెటప్ పేజీకి బదులుగా బ్రౌజర్‌లో సర్టిఫికేట్ హెచ్చరిక కనిపిస్తే, సర్టిఫికేట్ జారీ కాలేదని అర్థం. దీనిని ముందుగా సరిచేయండి, ఎందుకంటే డాష్‌బోర్డ్ అదే హోస్ట్‌నేమ్ ద్వారా API తో కమ్యూనికేట్ అవుతుంది మరియు తప్పు సర్టిఫికేట్ ఉన్నప్పుడు గందరగోళంగా విఫలమవుతుంది.

మీ మొదటి పీర్‌ను జాయిన్ చేయండి

మీరు మెష్‌లో చేర్చాలనుకుంటున్న VPS తో సహా, ఏదైనా Linux మెషీన్‌లో క్లయింట్‌ను ఇన్‌స్టాల్ చేయండి:

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

Debian మరియు Ubuntu లలో, ఆ స్క్రిప్ట్ NetBird యొక్క ప్యాకేజీ రిపోజిటరీని కాన్ఫిగర్ చేసి, ఆపై apt ద్వారా క్లయింట్‌ను ఇన్‌స్టాల్ చేస్తుంది, కాబట్టి ప్యాకేజీ మేనేజర్ దానిని నియంత్రిస్తుంది. ఒక స్క్రిప్ట్‌ను నేరుగా షెల్‌లోకి పైప్ చేయడం మీకు ఇష్టం లేకపోతే, దానిని ముందుగా curl -fsSL -o install.sh https://pkgs.netbird.io/install.sh తో సేవ్ చేసి, రన్ చేసే ముందు sh install.sh తో చదవండి. ఏది ఏమైనా, ఏమి ఇన్‌స్టాల్ అయ్యిందో నిర్ధారించుకోండి:

apt-cache policy netbird

netbird అనేది కమాండ్ లైన్ క్లయింట్ మరియు డెమోన్. netbird-ui అనేది డెస్క్‌టాప్ ట్రే యాప్, హెడ్‌లెస్ సర్వర్‌కు దీని అవసరం ఉండదు.

ఇప్పుడు క్లయింట్‌ను మీ సర్వర్ వైపు మళ్లించండి:

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

--management-url ని వదిలేస్తే, క్లయింట్ NetBird యొక్క హోస్టెడ్ సర్వీస్‌తో రిజిస్టర్ అవుతుంది, ఎందుకంటే అది డిఫాల్ట్‌గా సెట్ చేయబడి ఉంటుంది. కమాండ్ విజయవంతమవుతుంది, మెషీన్‌కు ఒక అడ్రస్ వస్తుంది, కానీ మీ సెల్ఫ్-హోస్టెడ్ డాష్‌బోర్డ్ ఖాళీగానే ఉంటుంది. చాలామంది ఈ పొరపాటు చేస్తుంటారు.

లాగిన్ పూర్తి చేయడానికి బ్రౌజర్‌లో ఓపెన్ చేయాల్సిన URL ను ఈ కమాండ్ ప్రింట్ చేస్తుంది. ఆ తర్వాత:

netbird status
ip addr show wt0

netbird status నుండి నాలుగు లైన్లను చదవండి: Management: Connected, Signal: Connected, అందుబాటులో ఉన్న ప్రతి రిలేను రిపోర్ట్ చేసే Relays: లైన్, మరియు ఓవర్‌లే పరిధిలో ఉన్న NetBird IP:. wt0 అనేది NetBird సృష్టించే WireGuard ఇంటర్‌ఫేస్, ఇది అదే అడ్రస్‌ను కలిగి ఉండాలి.

బ్రౌజర్ లేకుండా, దాని ముందు ఎవరూ లేకుండా ఉన్న యంత్రానికి బ్రౌజర్ login పనిచేయదు. Setup key అనేది interactive దశ లేకుండా యంత్రాన్ని register చేసే pre-authentication token. Dashboard లో Settings → Setup Keys కింద దీన్ని సృష్టించండి.

ఇందులో రెండు రకాలు ఉన్నాయి. One-off key ఖచ్చితంగా ఒక యంత్రాన్ని authenticate చేసి, తరువాత వినియోగించబడుతుంది. Reusable key అనేక యంత్రాలను register చేస్తుంది; ఎన్ని యంత్రాలకు అనుమతించాలో optional limit కూడా పెట్టవచ్చు. రెండింటికీ optional expiry ఉంటుంది. కొత్త peer ను group కు స్వయంచాలకంగా assign చేయవచ్చు. అందువల్ల ఆ group కు ఉన్న access rules యంత్రం కనిపించిన వెంటనే వర్తిస్తాయి.

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

--hostname dashboard లో చూపించే పేరును సెట్ చేస్తుంది. దీన్ని ఇవ్వకపోతే peer కు యంత్రం తనకు తానే ఇచ్చుకున్న పేరు వస్తుంది. Fleet లోని అన్ని entries కు ubuntu అనే పేరు ఉంటే ఎవరికీ ఉపయోగం ఉండదు.

Containers మరియు స్వల్పకాలం మాత్రమే నడిచే build agents కోసం key సృష్టించే సమయంలో దాన్ని ephemeral గా గుర్తించండి. Ephemeral key తో register అయిన peers 10 minutes కంటే ఎక్కువసేపు offline గా ఉంటే స్వయంచాలకంగా తొలగించబడతాయి. దీంతో peer list లో పనిచేయని entries పేరుకుపోవు.

Setup keys ఆధారంగా ప్రణాళిక రూపొందించే ముందు ఒక పరిమితిని గుర్తుంచుకోండి: key expiry కావడం లేదా revoke చేయడం కొత్త registrations ను ఆపుతుంది. అయితే ఆ key తో ఇప్పటికే register అయిన యంత్రాలను disconnect చేయదు. యంత్రానికి access తొలగించాలంటే ఆ peer ను తొలగించాలి.

ప్రత్యేక identity provider ఇంకా అవసరమా?

చిన్న install కోసం అవసరం లేదు. Dashboard నుంచి సృష్టించిన accounts ను built-in user store నిర్వహిస్తుంది. కొద్దిమంది users కోసం ఇది సరిపోతుంది.

మీ వద్ద ఇప్పటికే external identity provider ఉంటే, రెండో users జాబితాను నిర్వహించాల్సిన అవసరం లేకుండా దాన్ని ఉపయోగించవచ్చు. OIDC మాట్లాడే ఏ provider నైనా NetBird అంగీకరిస్తుంది. మీ provider లో confidential OIDC client ను నమోదు చేయండి. తరువాత name, client ID, client secret మరియు అవసరమైతే issuer తో దాన్ని NetBird dashboard లో జోడించండి. Provider లో తిరిగి నమోదు చేయడానికి NetBird మీకు redirect URL ఇస్తుంది. Google, Microsoft Entra ID, Okta, Zitadel, Keycloak, Authentik మరియు Pocket ID కోసం named integrations ఉన్నాయి. ఇతర providers ను generic OIDC గా జోడించవచ్చు. మీరు ఇప్పటికే self-hosted single sign-on గా Authentik నడుపుతున్నట్లయితే, రెండు account lists కు బదులుగా ఒకే account list ను కొనసాగించడానికి ఇదే సరైన మార్గం.

Provider ను జోడించిన తర్వాత కూడా local login అందుబాటులో ఉంటుంది. Configure చేసిన ప్రతి provider login page లో కనిపిస్తుంది. బలమైన password తో ఒక local admin account ను ఉంచండి. OIDC configuration విఫలమైనా, దాని ద్వారా మీరు ఇంకా login చేయగలుగుతారు.

NetBird లేదా Headscale: మీరు ఏ control plane ను నడపాలి?

రెండూ ఒకే dependency ను తొలగిస్తాయి: లేకపోతే మీ clients సంప్రదించే hosted control server ను. అయితే ఇవి ఒకే రకమైన project లు కావు.

Headscale, Tailscale control server ను మళ్లీ అమలు చేస్తుంది. మీరు అధికారిక Tailscale clients నే ఉపయోగించడం కొనసాగిస్తారు. అధికారిక web console లేదు. Config file తో పాటు headscale command ద్వారా users మరియు pre-authentication keys ను నిర్వహిస్తారు. Community web interfaces అందుబాటులో ఉన్నాయి. అవి project లో భాగం కావు. తమ state ను files లో ఉంచి, మార్పులను version control లో నిర్వహించాలనుకునే వారికి ఈ విధానం అనుకూలంగా ఉంటుంది.

NetBird పూర్తి ఉత్పత్తి సముదాయాన్ని అందిస్తుంది: దాని స్వంత client, దాని స్వంత dashboard, అంతర్నిర్మిత identity provider, అలాగే browserలో సవరించగల access policies ఇందులో ఉంటాయి. దీనివల్ల మీ VPSపై నిర్వహించాల్సిన భాగాలు పెరుగుతాయి. Terminalను ఎప్పటికీ తెరవని సహచరుడికి ఈ వ్యవస్థను అప్పగించడం మాత్రం చాలా సులభమవుతుంది. మీరు Headscaleతో కాకుండా hosted Tailscaleతో NetBirdను నిజంగా పోలుస్తుంటే, రెండూ అంతర్గతంగా WireGuardనే ఉపయోగిస్తాయి. అందువల్ల NetBird మరియు Tailscale పోలిక వాటి వాస్తవ తేడాలను వివరిస్తుంది: control planeను ఎవరు నిర్వహిస్తారు, access rulesను ఎలా రాస్తారు, relays network trafficను ఎలా మోస్తాయి.

మీరు ఇప్పటికే Tailscale clients పై ఆధారపడి ఉంటే లేదా సాధ్యమైనంత చిన్న control plane కావాలనుకుంటే Headscale ను నడపండి. అనేక మంది peers ను నిర్వహించాల్సి ఉంటే, అదనపు భాగాలను కలపకుండా console మరియు SSO కావాలనుకుంటే NetBird ను నడపండి. ఏదో ఒకదాన్ని ఎంచుకునే ముందు Tailscale ఉచిత plan వాస్తవంగా ఏమి అందిస్తుందో చూడండి. ఆరు users లోపు ఉండే non-commercial group కోసం hosted control plane కు ఎలాంటి చెల్లింపు ఉండదు. ప్రారంభంలో unlimited user devices మరియు 50 tagged resources కూడా లభిస్తాయి. అందువల్ల దాన్ని స్వయంగా నడపాల్సిన అవసరం లేకపోవచ్చు. ఆ పరిమితిని దాటిన తర్వాత బిల్లు machines సంఖ్యపై కాకుండా people సంఖ్యపై పెరుగుతుంది. కాబట్టి మీ group కోసం Tailscale ఎంత charge చేస్తుందో లెక్కించడం ద్వారా, ఈ stack కోసం అయ్యే VPS ఖర్చు మరియు మీ సమయంతో పోల్చడానికి ఒక మొత్తం లభిస్తుంది.

ఈ పని చేయడానికి ఎంత చిన్న VPS సరిపోతుంది?

డాక్యుమెంట్‌లో పేర్కొన్న కనిష్ఠ అవసరం 1 CPU మరియు 2 GB memory. 2 GB VPS కొనండి.

చిన్న సర్వర్‌లో మూడు అంశాలను సురక్షితంగా వదిలివేయవచ్చు. NetBird Proxy service ను ఎంచుకోకండి. ఇది internal services ను public hostnames పై ప్రచురించడానికి ఉపయోగపడుతుంది. Peers పరస్పరం connect కావడానికి దీనితో సంబంధం లేదు. CrowdSec ను కూడా skip చేయండి. Script దీన్ని proxy తో పాటు మాత్రమే అందిస్తుంది. మొదటి రోజే అమలు చేయడం కంటే, తరువాత exposed box పై జోడించడం మంచిది. netbird_data volume లోని default SQLite store ను అలాగే ఉంచండి. Deployment ను అనేక machines పై విభజించినప్పుడు లేదా నిజమైన concurrency సమస్య ఎదురైనప్పుడు మాత్రమే PostgreSQL కు మారండి. ఈ migration ను తరువాత చేయవచ్చని documentation లో పేర్కొన్నారు.

Relay ను మాత్రం తొలగించలేరు. NAT ప్రతి destination కు వేర్వేరు port కేటాయించే రెండు peers ఎప్పటికీ direct tunnel ను ఏర్పాటు చేయలేవు. అందువల్ల అవి పనిచేయడానికి relay మాత్రమే మార్గం. దీన్ని disable చేయడం వల్ల memory చాలా తక్కువగా మాత్రమే ఆదా అవుతుంది. కానీ connections trace చేయడం కష్టంగా ఉండే విధంగా విఫలమవుతాయి.

ఒక box ఇక సరిపోనప్పుడు, మొదట relays ను దాని నుంచి వేరుచేయాలి. Standalone relay NB_LISTEN_ADDRESS, NB_EXPOSED_ADDRESS, NB_AUTH_SECRET మరియు NB_ENABLE_STUN తో నడుస్తుంది. Relay మరియు main server పై shared secret ఒకేలా ఉండాలి. లేకపోతే clients దానికి authenticate కాలేవు.

లోపాల పరిస్థితులు, మీరు చూసే విషయాలు

Dashboard లో certificate warning కనిపిస్తుంది. Traefik certificate పొందలేదు. docker compose logs traefik | grep -i acme ను అమలు చేయండి. దీనికి రెండు కారణాలు ఉండవచ్చు. dig +short netbird.example.com ఇంకా ఈ VPS కు resolve కావడం లేదు, లేదా Let's Encrypt మరియు container మధ్య ఎక్కడో TCP 443 మూసి ఉంది. సాధారణంగా ఇది ufw లో కాకుండా provider యొక్క network firewall లో ఉంటుంది. Challenge 443 పై సమాధానం పొందుతుంది. కాబట్టి port 80 తెరిచి ఉండటం ఇక్కడ ఉపయోగపడదు. మళ్లీ మళ్లీ retry చేయడానికి ముందు కారణాన్ని సరిచేయండి. ప్రతి hostname మరియు account కు గంటకు ఐదు విఫలమైన authorizations మాత్రమే Let's Encrypt అనుమతిస్తుంది. ఆ పరిమితి మళ్లీ అందుబాటులోకి వచ్చే వరకు loop మిమ్మల్ని retry చేయకుండా నిరోధిస్తుంది.

Client తాను connect అయ్యిందని చెబుతుంది, కానీ dashboard ఖాళీగా ఉంటుంది. --management-url అందుబాటులో లేకపోవడం వల్ల client NetBird యొక్క hosted service తో register అయింది. netbird status --detail ను అమలు చేసి, అది వాస్తవంగా మాట్లాడుతున్న server పేరును చూపించే Management: line ను చదవండి. Management: Connected to https://api.netbird.io:443 కనిపిస్తే అది cloud కు వెళ్లిందని అర్థం. sudo netbird down ను అమలు చేసి, తరువాత మళ్లీ sudo netbird up --management-url https://netbird.example.com ను అమలు చేయండి.

ప్రతి peer Connection type: Relayed ను చూపిస్తుంది. Direct tunnels ఏర్పడటం లేదు. అందువల్ల మొత్తం traffic మీ VPS మీదుగా వెళ్తుంది, latencyలో ఒక hop అదనంగా చేరుతుంది. VPS firewall మరియు provider firewall రెండింటిలోనూ UDP 3478 ను పరిశీలించండి. Peer తన public address మరియు port తెలుసుకోవడానికి STUN ఉపయోగపడుతుంది. netbird status --detail ప్రతి peer కోసం Direct: false మరియు ICE (interactive connectivity establishment) candidate types ను కూడా చూపిస్తుంది. దీని ద్వారా ప్రయత్నం ఎంతవరకు జరిగిందో తెలుస్తుంది. కొన్ని networks లో relayed మాత్రమే సాధ్యమవుతుంది. అప్పుడు ఎలాంటి లోపం ఉండదు.

ఒక peer join అయినా ఏదీ reach కాలేకపోతుంది. Mesh లో ఉండటం వల్ల రెండు peers పరస్పరం మాట్లాడగలవని అర్థం కాదు. దాన్ని access policies నిర్ణయిస్తాయి. Policy జతచేయని group ఏ resource ను చేరుకోలేను. Routes మరియు firewalls debugging ప్రారంభించే ముందు dashboard లో policy ను పరిశీలించండి.

netbird status daemon సమస్యను నివేదిస్తుంది. Service నడుస్తుండదు. sudo netbird service status మరియు sudo netbird service start ను ఉపయోగించండి. Client logs /var/log/netbird/client.log వద్ద ఉంటాయి. ఏదైనా సమస్యను ఎక్కడ ఉంచాలో అర్థం కాకపోతే, netbird debug bundle --anonymize --system-info logs, status, routes, DNS settings మరియు firewall state ను ఒకే archive లో సేకరిస్తుంది.

బ్యాకప్‌లు మరియు అప్‌గ్రేడ్‌లు

మొత్తం install కు రెండు అంశాలు కీలకం: docker-compose.yml మరియు config.yaml ఉన్న directory, అలాగే database మరియు encryption keys ఉన్న Docker volume. వీటిని కలిసి బ్యాకప్ చేయండి. Store లోని sensitive data ను encrypt చేసే key config.yaml లో ఉంటుంది. అందువల్ల database copy మాత్రమే ఉంటే encrypted setup keys మరియు API tokens ను పునరుద్ధరించలేరు.

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 volume names కు project directory పేరును prefix గా జతచేస్తుంది. అందువల్ల netbird_data గా documentation లో చూపిన volume సాధారణంగా netbird_netbird_data గా కనిపిస్తుంది. ముందుగా docker volume ls ను run చేసి, అది చూపించే పేరును ఉపయోగించండి. లేకపోతే docker run విఫలమైందని తెలియజేయకుండా ఖాళీ volume ను సృష్టించి, ఏదీ archive చేయదు. Archives ను VPS వెలుపల ఉంచండి. ఇప్పటికే backup tool ఉంటే, offsite భాగాన్ని restic లేదా BorgBackup నిర్వహిస్తుంది.

Server ను upgrade చేయడం అంటే pull చేసి recreate చేయడం:

docker compose pull
docker compose up -d
docker compose ps

దానిపై ఆధారపడే ముందు docker compose config | grep image: ను run చేయండి. latest ను చూపించే ఏ tag అయినా version కు pin చేయాలి. Install script ను pin చేసిన కారణమే ఇది కూడా: ప్రస్తుతం ఏది నడుస్తుందో తెలుసుకోవాలి, అలాగే upgrade సరిగ్గా పనిచేయకపోతే తిరిగి ఉపయోగించగల version ఉండాలి. Clients ను install చేసిన package manager ద్వారానే upgrade చేయండి.

FAQ

self-hosted NetBird కోసం నాకు స్వంత identity provider అవసరమా?

అవసరం లేదు. ప్రస్తుత releases లో built-in user store ఉంటుంది. అందువల్ల browser లో https://netbird.example.com వద్ద మొదటి admin account ను సృష్టించి, తరువాత dashboard నుంచి users ను జోడించవచ్చు. బాహ్య OIDC provider ఐచ్ఛికం. అవసరమైతే name, client ID, client secret మరియు అవసరమైన సందర్భంలో issuer తో తరువాత జోడించవచ్చు. NetBird కు ముందు Zitadel లేదా Keycloak deploy చేయాలని చెప్పే guides ఇప్పుడు అవసరం లేని setup ను వివరిస్తున్నాయి. వాటిని అనుసరిస్తే నిర్వహించాల్సిన అదనపు service ఒకటి పెరుగుతుంది.

నా peers అందరికీ Connection type: Relayed ఎందుకు కనిపిస్తోంది?

Direct connections ఏర్పడటం లేదు. అందువల్ల traffic మీ VPS లోని relay ద్వారా వెళ్తోంది. సాధారణ కారణం UDP 3478 block కావడం. Peers తమ public address మరియు port ను కనుగొనడానికి ఉపయోగించే STUN port ఇదే. VPS firewall లో మరియు మీ provider యొక్క ప్రత్యేక network firewall లో దీనిని open చేయండి. తరువాత మళ్లీ netbird status --detail అమలు చేసి, Direct: line ను పరిశీలించండి. రెండు peers కూడా ప్రతి destination కు వేర్వేరు port కేటాయించే NAT వెనుక ఉంటే, relayed అనేది ఆశించిన ఫలితం. ఆ సందర్భంలో configuration లో తప్పు లేదు.

నా client connect అయింది, కానీ dashboard లో peers కనిపించడం లేదు. ఏమైంది?

--management-url ఇవ్వకుండా ఉంచినప్పుడు client మీ server కు బదులుగా NetBird hosted service తో register అవుతుంది. netbird status --detail అది సంప్రదిస్తున్న server ను Management: line లో చూపిస్తుంది. అందులో https://api.netbird.io:443 వంటి value కనిపిస్తే అది దీనిని నిర్ధారిస్తుంది. sudo netbird down అమలు చేసి, తరువాత sudo netbird up --management-url https://netbird.example.com అమలు చేయండి. అప్పుడు peer మీ dashboard లో కనిపిస్తుంది.

self-hosted NetBird, Headscale కంటే ఎలా భిన్నంగా ఉంటుంది?

రెండూ hosted control server స్థానంలో మీరు నిర్వహించే server ను ఉపయోగిస్తాయి. Headscale control plane మాత్రమే. దాన్ని headscale command మరియు config file తో నిర్వహించాలి. దీనికి official web console లేదు. ఇది official Tailscale clients ను నియంత్రిస్తుంది. NetBird తన స్వంత client, admin dashboard మరియు identity provider integration ను ఒకే stack లో అందిస్తుంది. Headscale ను నిర్వహించడం చిన్నది మరియు దాని state files లో ఉంటుంది. Terminal ఉపయోగించని వ్యక్తులకు NetBird ను అందించడం సులభం.

self-hosted NetBird server కు ఎలాంటి పరిమాణం ఉన్న VPS అవసరం?

Documentation ప్రకారం కనీస అవసరం 1 CPU మరియు 2 GB memory. కొనుగోలు చేయాల్సిన పరిమాణం 2 GB. Install సమయంలో optional proxy service ను నిరాకరించండి. దీనివల్ల CrowdSec prompt కూడా దాటవేయబడుతుంది. నిజంగా PostgreSQL అవసరం ఏర్పడే వరకు default SQLite store ను ఉపయోగించండి.

ఈ వ్యాసం ఉపయోగకరంగా ఉందా?