SSD Nodes Learn Hosting plans →
मार्गदर्शक Matt Connorद्वारे Matt Connor

NetBird VPN सर्व्हर स्वतःच्या VPS वर कसा सेट करावा

तुमच्या स्वतःच्या VPS वर NetBird VPN सर्व्हर सेटअप करण्याची संपूर्ण प्रक्रिया जाणून घ्या. यामध्ये DNS, TLS कॉन्फिगरेशन, सेटअप की आणि Headscale सोबतची तुलना सविस्तर दिली आहे.

NetBird VPN सर्व्हर स्वतः होस्ट केल्याने काय मिळते

NetBird VPN सर्व्हर स्वतः होस्ट केल्यामुळे कंट्रोल प्लेन तुमच्या मालकीच्या VPS वर राहते. यामध्ये पीअरची यादी (peer list) असते, कोणते मशीन कोणाशी संपर्क साधू शकते हे ठरवले जाते आणि NAT (network address translation) च्या मागे असलेल्या दोन पीअर्सना एकमेकांना शोधण्यास मदत केली जाते. टनेल स्वतः WireGuard चे असतात आणि ते थेट तुमच्या मशीन्समध्ये एनक्रिप्ट केलेले असतात. बदल एवढाच होतो की, कोणतीही बाह्य कंपनी तुमच्या उपकरणांची यादी किंवा लॉगिन प्रक्रिया नियंत्रित करत नाही. यामुळे तुम्हाला नक्की काय मिळते हे समजून घेणे महत्त्वाचे आहे, कारण होस्ट केलेल्या कंट्रोल प्लेनकडेही तुमचा ट्रॅफिक एनक्रिप्ट करणाऱ्या की (keys) नसतात आणि जर कोऑर्डिनेशन सर्व्हर कॉम्प्रमाइज झाला तर तो नक्की काय करू शकतो याची व्याप्ती बऱ्याच लोकांच्या कल्पनेपेक्षा कमी असते.

NetBird हे तुम्हाला कदाचित माहित असलेल्या दोन गोष्टींच्या मध्ये येते. हे एक मेश ओव्हरले (mesh overlay) आहे, त्यामुळे सर्व ट्रॅफिक एका गेटवेवरून पाठवण्याऐवजी पीअर्स एकमेकांशी थेट जोडले जातात. हे पूर्णपणे स्वतः होस्ट करता येते, ज्यामुळे याची तुलना Headscale, जो एक self-hosted Tailscale कंट्रोल सर्व्हर आहे याच्याशी केली जाते. जर तुम्ही आतापर्यंत फक्त सिंगल-गेटवे टनेल वापरले असेल, तर आधी plain WireGuard आणि मेश ओव्हरले मधील फरक वाचा, कारण तो दृष्टिकोन समजल्याशिवाय या पानावरील पुढील माहिती उपयुक्त ठरणार नाही.

जर तुम्हाला फक्त असा एक सर्व्हर हवा असेल ज्यातून तुमचा सर्व ट्रॅफिक बाहेर पडेल, तर मेश ही गरजेपेक्षा जास्त क्लिष्ट रचना आहे. एका VPS वर plain WireGuard VPN किंवा Tailscale exit node हे काम खूप कमी कष्टात करते. आणि जर तुमचे ध्येय मशीन्सना एकमेकांशी जोडण्याऐवजी फक्त एका खाजगी नेटवर्कपर्यंत पोहोचणे असेल, तर VPS वरील Tailscale subnet router खालील कोणतीही क्लिष्ट रचना न वापरता ती रेंज तुमच्या विद्यमान tailnet मध्ये समाविष्ट करतो.

प्रत्यक्षात हा stack काय चालवतो

ही रचना अलीकडे बदलली आहे आणि बहुतेक जुने लेख जुन्या रचनेचे वर्णन करतात. 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 होता; तो आधी तयार करावा लागत असे.
  • dashboard हे admin web console आहे.
  • traefik TLS (transport layer security) समाप्त करते आणि पहिल्यांदा सुरू होताना Let's Encrypt कडून certificate मागते.

आणखी दोन services उपलब्ध आहेत. Prompt वर होय असे सांगितल्याशिवाय त्या बंद राहतात. NetBird Proxy service internal services सार्वजनिक hostnames वर प्रकाशित करते. CrowdSec गैरवापर करणारा traffic फिल्टर करते. कार्यरत mesh तयार करण्यासाठी यापैकी कोणतीही service आवश्यक नाही. लहान server वर दोन्ही services memory वापरतात.

जर तुम्ही एका Docker container मधील wg-easy वरून येत असाल, तर parts ची संख्या लक्षणीय वाढते. त्याच्या बदल्यात access policies आणि प्रत्येक user साठी accounts मिळतात. तसेच peers एका gateway मार्फत न जाता थेट एकमेकांशी connect होतात.

सुरू करण्यापूर्वी आवश्यक गोष्टी

सार्वजनिक domain name आवश्यक आहे. Dashboard, API आणि relay हे सर्व port 443 वरील HTTPS वापरतात. Traefik ला Let's Encrypt कडून TLS-ALPN-01 challenge वापरून certificate मिळते. या challenge चे उत्तर port 443 वर दिले जाते. त्यासाठी सार्वजनिक इंटरनेटवरून या VPS कडे resolve होणारे नाव आवश्यक आहे. या प्रक्रियेत थेट IP address वापरता येत नाही.

एक A record तयार करा, netbird.example.com, आणि तो VPS च्या सार्वजनिक IPv4 address कडे निर्देशित करा. त्यानंतर काहीही चालवण्यापूर्वी DNS propagation पूर्ण होण्याची प्रतीक्षा करा.

dig +short netbird.example.com

यातून तुमच्या server चा address दिसला पाहिजे. DNS propagation पूर्ण होण्यापूर्वी installer चालवल्यास पहिल्याच start वेळी certificate request अयशस्वी होते. वारंवार अयशस्वी validations झाल्यास Let's Encrypt च्या rate limits लागू होतात. त्यामुळे पुन्हा प्रयत्न करण्यापूर्वी limit पुन्हा उपलब्ध होईपर्यंत प्रतीक्षा करावी लागते.

Default setup साठी इंटरनेटवरून फक्त दोन ports पोहोचण्यायोग्य असणे आवश्यक आहे: dashboard, API, signal आणि relay traffic तसेच certificate challenge साठी TCP 443; आणि STUN साठी UDP 3478. TCP 80 स्थानिक पातळीवर मोकळा असणे आवश्यक आहे, कारण Traefik तो bind करतो. मात्र तो सार्वजनिकरीत्या पोहोचण्यायोग्य असण्याची गरज नाही. Port 80 वरील सार्वजनिक प्रवेश रोखल्यास केवळ HTTP-to-HTTPS redirect बंद होतो.

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

हे ports तुमच्या provider च्या network firewall मध्येही उघडा. बहुतेक VPS panels मध्ये हा स्वतंत्र नियंत्रण स्तर असतो. त्यामुळे server वरील स्वतःचे ufw status योग्य दिसत असूनही connections नाकारले जाऊ शकतात.

STUN (session traversal utilities for NAT) मुळे peer ला त्याच्या NAT ने नियुक्त केलेला सार्वजनिक address आणि port समजतो. त्यामुळे दोन peers थेट tunnel सुरू करण्याचा प्रयत्न करू शकतात. UDP 3478 block केला तरी peers TCP 443 वरील relay द्वारे connect होतात. त्यामुळे काहीही बिघडल्याचे लगेच दिसत नाही. थेट path सापडत नसलेल्या peers कडे Connection type: Relayed दिसते. त्यांचा traffic peer-to-peer न जाता तुमच्या VPS मधून जातो. एकाच LAN वरील peers त्यांच्या local addresses वापरून अजूनही थेट connect होऊ शकतात.

Software च्या बाजूने तुम्हाला Compose v2 plugin असलेले Docker, तसेच jq आणि curl आवश्यक आहेत. Script Docker, Compose आणि jq तपासते. यापैकी काही missing असल्यास script थांबते. ते curl वापरते, पण त्याची उपलब्धता तपासत नाही. त्यामुळे ते आधी install करा. या server वर Docker नवीन असल्यास, आधी VPS वर Docker Compose कार्यरत करा.

Bundled reverse proxy वगळल्यास ports

Traefik शिवाय combined server management, signal आणि relay हे एकाच HTTP backend वर चालवतो. त्यामुळे ports ची यादी फारशी वाढत नाही. तयार होणारी Compose file पुढील ports 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 कडे forwarding करतो. STUN proxy मधून जात नाही. त्यामुळे कोणतीही रचना वापरली तरी UDP 3478 firewall मध्ये open ठेवावे लागते. Management gRPC, signal gRPC आणि relay साठी स्वतंत्र ports दाखवणाऱ्या मार्गदर्शकांमध्ये जुनी multi-container रचना वर्णन केलेली असते.

हा पर्याय फक्त server वर इतर कोणत्यातरी सेवेसाठी आधीच TLS termination होत असल्यास निवडा. अन्यथा bundled Traefik मुळे कमी rules आणि कमी चुका होतात.

NetBird सर्व्हर quickstart script ने स्थापित करा

दस्तऐवजीकरणातील one-liner नवीनतम release थेट shell मध्ये pipe करतो:

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

त्याऐवजी version pin करा. latest बदलत राहतो. त्यामुळे दोन आठवड्यांच्या अंतराने तीच command चालवल्यास दोन वेगळे installs तयार होतात आणि तुमची configuration कोणत्या आवृत्तीने लिहिली हे 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 configuration snippet लिहितात आणि उर्वरित wiring तुमच्यावर सोपवतात. Option 5 Compose file, dashboard.env आणि config.yaml लिहितो आणि setup documentation terminal वर दाखवतो. Proxy आधीपासून चालू असलेल्या server वर हा पर्याय योग्य आहे; नव्याने तयार केलेल्या server वर तो योग्य नाही. त्यानंतर option 0 email address विचारतो. Traefik हा address तुमच्या 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 साठी नकार द्या. त्यासाठी आणखी एक DNS record आवश्यक असतो: wildcard *.netbird.example.com CNAME, जो netbird.example.com कडे निर्देश करतो. साध्या mesh साठी त्याचा उपयोग होत नाही. Proxy enabled केल्यानंतरच 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 समजा, कारण config.yaml मध्ये store मधील data encrypt करणारी key असते. ती हरवल्यास 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) हा Traefik certificate मिळवण्यासाठी वापरत असलेला protocol आहे. येथील errors जवळजवळ नेहमी DNS किंवा बंद port 443 मुळे होतात.

पहिले ॲडमिन खाते तयार करा

https://netbird.example.com उघडा. नवीन इन्स्टॉलेशनवर, लॉगिन फॉर्मऐवजी हे थेट सेटअप पेजवर जाते. एक ईमेल पत्ता, नाव आणि पासवर्ड प्रविष्ट करा, त्यानंतर Create Account वर क्लिक करा. हे पहिले ॲडमिन खाते बनते आणि पेज लॉगिन फॉर्मवर रिडायरेक्ट होते.

हे खाते NetBird च्या स्वतःच्या युजर स्टोअरमध्ये असते, जे netbird-server कंटेनरमध्ये एम्बेड केलेल्या आयडेंटिटी प्रोव्हायडरद्वारे चालते. यामध्ये बाह्य कशाचाही समावेश नसतो. एका वर्षापूर्वीच्या सेल्फ-होस्टेड NetBird च्या तुलनेत हा सर्वात मोठा बदल आहे; तेव्हा काम करणारी इन्स्टॉलेशन मिळवण्यासाठी आधी Zitadel किंवा Keycloak उभे करावे लागत असे आणि कोणतीही गोष्ट सुरू होण्यापूर्वी चार OIDC (OpenID Connect) व्हॅल्यूज setup.env मध्ये कॉपी कराव्या लागत असत.

जर तुम्हाला सेटअप पेजऐवजी ब्राउझर सर्टिफिकेट वॉर्निंग दिसत असेल, तर सर्टिफिकेट इश्यू झालेले नाही. पुढे जाण्यापूर्वी ते दुरुस्त करा, कारण डॅशबोर्ड त्याच होस्टनेमद्वारे API शी संवाद साधतो आणि चुकीच्या सर्टिफिकेटमुळे गोंधळात टाकणाऱ्या त्रुटी निर्माण होतात.

तुमचा पहिला पीअर जोडा

कोणत्याही Linux मशीनवर क्लायंट इंस्टॉल करा, जर तुम्हाला तो मेशमध्ये हवा असेल तर VPS वर देखील हे करता येईल:

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 इंटरफेस आहे आणि त्यावर तोच पत्ता असणे आवश्यक आहे.

दुसरे मशीनला setup key वापरून unattended पद्धतीने जोडा

ज्या मशीनवर browser उपलब्ध नाही आणि तिच्यासमोर कोणीही उपस्थित नाही, अशा मशीनसाठी browser login कार्यरत होत नाही. setup key हा pre-authentication token आहे. तो interactive step शिवाय मशीनची नोंदणी करतो. तो dashboard मधील Settings → Setup Keys येथे तयार करा.

setup key चे दोन प्रकार आहेत. one-off key ने नेमक्या एका मशीनचे authentication होते आणि त्यानंतर तो वापरलेला मानला जातो. reusable key ने अनेक मशीनची नोंदणी करता येते. त्यासाठी कमाल संख्येची optional मर्यादा सेट करता येते. दोन्ही प्रकारांसाठी optional expiry सेट करता येते. तसेच नवीन peer आपोआप एखाद्या group मध्ये जोडता येतो. त्यामुळे त्या group चे access rules मशीन दिसताच लागू होतात.

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

--hostname dashboard मध्ये दिसणारे नाव सेट करते. ते दिले नाही, तर peer ला मशीनने स्वतःसाठी दिलेले नाव मिळते. सर्व entries चे नाव ubuntu असे असल्यास त्यातून कोणालाही उपयोग होत नाही.

containers आणि अल्पकाळासाठी चालणाऱ्या build agents साठी key तयार करताना त्याला ephemeral म्हणून चिन्हांकित करा. ephemeral key वापरून नोंदणी केलेले peers 10 मिनिटांपेक्षा जास्त काळ offline राहिल्यानंतर आपोआप काढले जातात. त्यामुळे peer list मध्ये निष्क्रिय entries साचत नाहीत.

setup keys वापरण्यापूर्वी एक मर्यादा समजून घ्या: key ची expiry झाल्यास किंवा तो revoke केल्यास नवीन registrations थांबतात. त्या key ने आधीच नोंदणी केलेल्या मशीनचे connection disconnect होत नाही. एखाद्या मशीनचा access काढण्यासाठी तो peer काढावा लागतो.

तुम्हाला अजूनही स्वतंत्र identity provider आवश्यक आहे का?

लहान install साठी नाही. Dashboard मधून तयार केलेल्या accounts साठी built-in user store पुरेसा असतो. काही मोजक्या लोकांसाठी ते पर्याप्त आहे.

तुमच्याकडे आधीपासून external identity provider असेल आणि users ची दुसरी यादी ठेवायची नसेल, तेव्हा external identity provider वापरा. NetBird OIDC शी सुसंगत कोणताही provider स्वीकारतो. तुमच्या provider मध्ये confidential OIDC client नोंदवा. त्यानंतर name, client ID, client secret आणि आवश्यक असल्यास issuer देऊन तो NetBird dashboard मध्ये जोडा. NetBird तुम्हाला provider मध्ये परत paste करण्यासाठी redirect URL देतो. Google, Microsoft Entra ID, Okta, Zitadel, Keycloak, Authentik आणि Pocket ID साठी named integrations उपलब्ध आहेत. इतर कोणताही provider generic OIDC म्हणून जोडा. तुम्ही आधीच self-hosted single sign-on म्हणून Authentik चालवत असाल, तर दोन स्वतंत्र account lists ऐवजी एकच account list ठेवण्यासाठी हा योग्य मार्ग आहे.

Provider जोडल्यानंतर local login उपलब्ध राहतो. Configured केलेला प्रत्येक provider login page वर दिसतो. Strong password असलेले एक local admin account ठेवा. OIDC configuration मध्ये बिघाड झाला तरी login करण्याचा मार्ग उपलब्ध राहतो.

NetBird किंवा Headscale: कोणते control plane चालवावे?

दोन्ही पर्याय समान dependency काढून टाकतात: hosted control server, ज्याच्याशी तुमचे clients अन्यथा संपर्क साधत राहिले असते. मात्र हे दोन्ही प्रकल्प एकाच स्वरूपाचे नाहीत.

Headscale हे Tailscale control server ची पुनर्रचना करते आणि तुम्ही अधिकृत Tailscale clients वापरत राहता. यासाठी अधिकृत web console नाही. Config file विरुद्ध headscale command वापरून users आणि pre-authentication keys व्यवस्थापित कराव्या लागतात. Community web interfaces उपलब्ध आहेत; मात्र त्या या प्रकल्पाचा भाग नाहीत. तुमची state files मध्ये ठेवायची आणि बदल version control मध्ये व्यवस्थापित करायचे असतील, तर ही रचना योग्य ठरते.

NetBird संपूर्ण उत्पादन संच वितरित करते: त्याचा स्वतःचा client, स्वतःचे dashboard, embedded 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 च्या free plan मध्ये प्रत्यक्षात काय समाविष्ट आहे ते तपासा. सहा users मध्ये बसणाऱ्या non-commercial group साठी hosted control plane विनामूल्य असतो. सुरुवातीला unlimited user devices आणि 50 tagged resources मिळतात. त्यामुळे control plane स्वतः चालवण्याची गरज कदाचित नसू शकते. ही मर्यादा ओलांडल्यानंतरचा खर्च machines च्या संख्येऐवजी लोकांच्या संख्येनुसार वाढतो. म्हणून Tailscale तुमच्या group कडून किती शुल्क आकारेल हे मोजणे उपयुक्त ठरेल. त्या रकमेची तुलना VPS आणि या stack च्या व्यवस्थापनासाठी लागणाऱ्या वेळेच्या खर्चाशी करता येईल.

ही सेवा चालवण्यासाठी VPS किती लहान असू शकतो?

दस्तऐवजात दिलेली किमान आवश्यकता 1 CPU आणि 2 GB memory आहे. 2 GB memory असलेला VPS घ्या.

लहान सर्व्हरवर तीन गोष्टी वगळणे सुरक्षित आहे. NetBird Proxy service नाकारता येते. ही service internal services सार्वजनिक hostnames वर प्रकाशित करण्यासाठी आहे; peers एकमेकांशी connect होण्यासाठी तिची आवश्यकता नाही. CrowdSec वगळा. Script ही service फक्त proxy सोबत सुचवते. Exposed server वर ती नंतर जोडणे योग्य आहे; पहिल्याच दिवशी जोडण्याची गरज नाही. netbird_data volume मधील default SQLite store कायम ठेवा. Deployment अनेक machines वर विभागल्यावर किंवा प्रत्यक्ष concurrency ची समस्या आल्यावरच PostgreSQL वापरा. यासाठी नंतर migration करता येते, असे documentation मध्ये नमूद केले आहे.

Relay हा वगळता न येणारा एकमेव component आहे. दोन peers साठी NAT प्रत्येक destination साठी वेगळा port देत असेल, तर ते direct tunnel कधीही स्थापित करू शकणार नाहीत. त्यामुळे ते कार्यरत ठेवणारा relay हाच एकमेव मार्ग असतो. Relay बंद केल्याने memory फारच कमी वाचते; मात्र connections अशा प्रकारे खंडित होतात की त्याचे कारण शोधणे कठीण जाते.

एक server पुरेसा राहात नसेल, तर सर्वप्रथम relay वेगळ्या server वर हलवा. Standalone relay NB_LISTEN_ADDRESS, NB_EXPOSED_ADDRESS, NB_AUTH_SECRET आणि NB_ENABLE_STUN वापरून चालवता येतो. Relay आणि main server वर shared secret एकसारखा असणे आवश्यक आहे. अन्यथा clients त्यावर authenticate करू शकत नाहीत.

अपयशाच्या स्थिती आणि त्यात दिसणारे परिणाम

डॅशबोर्डमध्ये प्रमाणपत्राची चेतावणी दिसते. Traefik ला प्रमाणपत्र मिळालेले नाही. docker compose logs traefik | grep -i acme चालवा. याची दोन कारणे असू शकतात. एकतर dig +short netbird.example.com अद्याप या VPS कडे निर्देश करत नाही, किंवा Let's Encrypt आणि कंटेनर यांच्या दरम्यान कुठेतरी TCP 443 बंद आहे. हे सहसा ufw वर नसून provider च्या network firewall वर बंद असते. Challenge चे उत्तर 443 वर दिले जाते. त्यामुळे port 80 उघडा असणे येथे उपयोगी ठरत नाही. पुन्हा पुन्हा प्रयत्न करण्यापूर्वी कारण दुरुस्त करा. Let's Encrypt प्रत्येक hostname आणि account साठी दर तासाला फक्त पाच अपयशी authorizations अनुमत करते. मर्यादा पुन्हा उपलब्ध होईपर्यंत loop मुळे पुढील प्रयत्न करता येत नाहीत.

Client कनेक्ट झाल्याचे सांगतो, पण डॅशबोर्ड रिकामा आहे. --management-url उपलब्ध नसल्यामुळे client NetBird च्या hosted service वर register झाला. netbird status --detail चालवा आणि Management: ओळ वाचा. त्या ओळीत client प्रत्यक्षात कोणत्या server शी संवाद साधत आहे ते नमूद केलेले असते. Management: Connected to https://api.netbird.io:443 दिसत असल्यास client cloud कडे गेला आहे. sudo netbird down चालवा आणि त्यानंतर पुन्हा sudo netbird up --management-url https://netbird.example.com चालवा.

प्रत्येक peer Connection type: Relayed दाखवतो. कोणतेही direct tunnel तयार होत नाहीत. त्यामुळे सर्व traffic तुमच्या VPS मधून जातो आणि latency मध्ये एक hop वाढतो. VPS वरील firewall आणि provider च्या firewall वर UDP 3478 तपासा. STUN मुळे peer ला स्वतःचा public address आणि port समजतो. netbird status --detail प्रत्येक peer साठी Direct: false तसेच ICE (interactive connectivity establishment) candidate types देखील दाखवते. त्यावरून प्रयत्न कितपत पुढे गेला ते समजते. काही network वर relayed हाच उपलब्ध एकमेव परिणाम असतो. अशा वेळी काहीही चुकीचे नसते.

Peer जोडला जातो, पण कोणत्याही ठिकाणी पोहोचू शकत नाही. Mesh मध्ये असणे म्हणजे दोन peer एकमेकांशी संवाद साधू शकतात असे नाही. हे access policies ठरवतात. ज्या group ला कोणतीही policy जोडलेली नसते, त्या group मधून कुठेही पोहोचता येत नाही. Routes आणि firewalls तपासण्यास सुरुवात करण्यापूर्वी डॅशबोर्डमधील 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 मध्ये संकलित करते.

बॅकअप आणि अपग्रेड

संपूर्ण इंस्टॉलेशनसाठी दोन गोष्टी महत्त्वाच्या आहेत: docker-compose.yml आणि config.yaml असलेली directory, तसेच database आणि encryption keys असलेला Docker volume. या दोन्हींचा एकत्रित बॅकअप घ्या. Store मधील संवेदनशील data encrypt करणारी key config.yaml मध्ये असते. त्यामुळे ही key नसलेली 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 नावांना project directory चा prefix लावते. त्यामुळे netbird_data म्हणून दस्तऐवजीकरण केलेला volume साधारणपणे netbird_netbird_data असा दिसतो. प्रथम docker volume ls चालवा आणि त्यातून दिसणारे नाव वापरा. अन्यथा docker run silently रिकामा volume तयार करेल आणि काहीही archive करणार नाही. Archives VPS च्या बाहेर ठेवा. तुमच्याकडे आधीपासून backup tool असल्यास, restic किंवा BorgBackup offsite बॅकअपचा भाग हाताळू शकते.

Server चे अपग्रेड pull आणि recreate या दोन टप्प्यांत होते:

docker compose pull
docker compose up -d
docker compose ps

यावर अवलंबून राहण्यापूर्वी docker compose config | grep image: चालवा. latest दर्शविणारा कोणताही tag version ला pin करा. Install script pin करण्यामागचे हेच कारण आहे: कोणते version चालू आहे हे तुम्हाला माहीत असावे आणि अपग्रेडमध्ये समस्या आल्यास मागे जाण्यासाठी निश्चित version उपलब्ध असावे. Clients ज्या package manager ने install केले आहेत, त्याच package manager द्वारे upgrade करा.

FAQ

NetBird स्वयं-host करण्यासाठी मला माझा स्वतःचा identity provider आवश्यक आहे का?

नाही. सध्याच्या releases मध्ये built-in user store समाविष्ट आहे. त्यामुळे https://netbird.example.com येथे browser मध्ये पहिला admin account तयार करता येतो आणि त्यानंतर dashboard मधून users जोडता येतात. External 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 वर तो उघडा. त्यानंतर netbird status --detail पुन्हा चालवा आणि Direct: line वाचा. दोन्ही peers अशा NAT च्या मागे असतील, ज्यामुळे प्रत्येक destination साठी वेगळा port दिला जातो, तर relayed हा अपेक्षित परिणाम आहे. Configuration मध्ये कोणतीही चूक नाही.

माझा client connect झाला, पण dashboard मध्ये peers दिसत नाहीत. काय झाले?

--management-url नसल्यामुळे client तुमच्या server ऐवजी NetBird च्या hosted service वर register झाला. netbird status --detail ज्या server शी client संवाद साधत आहे तो 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 ऐवजी तुम्ही चालवलेला control server वापरतात. Headscale हा फक्त control plane आहे. तो headscale command आणि config file वापरून manage केला जातो. त्यासाठी अधिकृत web console नाही. तो official Tailscale clients नियंत्रित करतो. NetBird मध्ये त्याचा स्वतःचा client, admin dashboard आणि identity provider integration एकाच stack मध्ये उपलब्ध असतात. Headscale चालवणे सोपे आहे आणि त्याची state files मध्ये ठेवली जाते. Terminal वापरणार नसलेल्या users ना NetBird देणे सोपे आहे.

self-hosted NetBird server साठी कोणत्या आकाराचा VPS आवश्यक आहे?

दस्तऐवजीकरणानुसार किमान आवश्यकता 1 CPU आणि 2 GB memory आहे. त्यामुळे 2 GB असलेला VPS घ्या. Install करताना optional proxy service नाकारल्यास CrowdSec prompt देखील वगळला जातो. जोपर्यंत PostgreSQL ची खरोखर आवश्यकता भासत नाही, तोपर्यंत default SQLite store वापरा.

हा लेख उपयुक्त होता का?