NetBird VPN server-ஐ VPS-ல் self-host செய்வது எப்படி?
NetBird mesh VPN-ஐ உங்கள் சொந்த VPS-ல் நிறுவுவதற்கான முழுமையான வழிகாட்டி. DNS, TLS அமைப்பு, setup keys மற்றும் Headscale உடனான ஒப்பீடு ஆகியவற்றை உள்ளடக்கிய விரிவான தொழில்நுட்ப கட்டுரை.
NetBird VPN server-ஐ நீங்களே self-host செய்வதால் கிடைக்கும் பயன்கள்
NetBird VPN server-ஐ நீங்களே self-host செய்யும்போது, அதன் control plane உங்கள் கட்டுப்பாட்டில் உள்ள VPS-ல் இயங்கும். இதுவே peer பட்டியல், எந்த machine எந்த machine-ஐ அணுகலாம் என்ற முடிவுகள், மற்றும் NAT (network address translation)-க்கு பின்னால் உள்ள இரண்டு peers-ஐ ஒன்றோடொன்று இணைத்தல் போன்ற பணிகளைச் செய்கிறது. தரவுப் பரிமாற்றத்திற்கான tunnels எப்போதும் WireGuard மூலமே அமையும், இவை உங்கள் machine-களுக்கு இடையே நேரடியாக encrypt செய்யப்படும். இதில் மாறுவது என்னவென்றால், உங்கள் சாதனங்களின் பட்டியல் அல்லது login விவரங்களை எந்த வெளி நிறுவனமும் வைத்திருக்காது. இதனால் உங்களுக்குக் கிடைக்கும் பயன் என்ன என்பதைத் தெளிவாகப் புரிந்துகொள்ளுங்கள், ஏனெனில் hosted control plane-ல் கூட உங்கள் traffic-ஐ encrypt செய்யும் keys இருக்காது. மேலும், ஒரு coordination server-ல் பாதிப்பு ஏற்பட்டால் அதனால் என்ன செய்ய முடியும் என்பது பலரும் நினைப்பதை விட மிகக் குறைவானதே.
NetBird உங்களுக்கு ஏற்கனவே தெரிந்த இரண்டு தொழில்நுட்பங்களுக்கு இடையில் அமைகிறது. இது ஒரு mesh overlay, எனவே அனைத்து traffic-ஐயும் ஒரே gateway வழியாக அனுப்பாமல், peers நேரடியாக ஒன்றோடொன்று இணைக்கப்படுகின்றன. இது முழுமையாக self-host செய்யக்கூடியது, எனவே இது Headscale, the self-hosted Tailscale control server-க்கு மாற்றாக அமைகிறது. நீங்கள் இதுவரை ஒரே ஒரு gateway கொண்ட tunnel-ஐ மட்டுமே பயன்படுத்தியிருந்தால், முதலில் plain WireGuard மற்றும் mesh overlay-க்கு இடையிலான வேறுபாடு என்பதைப் படியுங்கள், ஏனெனில் அந்த அடிப்படை புரிதல் இருந்தால் மட்டுமே இந்தப் பக்கத்தில் உள்ள தகவல்கள் பயனுள்ளதாக இருக்கும்.
உங்கள் அனைத்து traffic-ம் வெளியேறும் வகையில் ஒரே ஒரு server மட்டும் போதும் என்றால், mesh என்பது அந்த வேலைக்குத் தேவையானதை விட அதிகப்படியான தொழில்நுட்பமாகும். A plain WireGuard VPN on a single VPS அல்லது a Tailscale exit node ஆகியவற்றை மிகக் குறைந்த முயற்சியில் அமைக்கலாம். ஒருவேளை உங்கள் நோக்கம் machine-களை ஒன்றோடொன்று இணைப்பதற்குப் பதிலாக, ஒரு private network-ஐ மட்டும் அணுகுவதாக இருந்தால், a Tailscale subnet router on a VPS மூலம் அந்த network range-ஐ உங்கள் tailnet-ல் சேர்க்கலாம்; இதற்கு கீழே உள்ள எந்த சிக்கலான அமைப்புகளும் தேவையில்லை.
இந்த stack உண்மையில் எதை இயக்குகிறது
இதன் அமைப்பு சமீபத்தில் மாற்றப்பட்டது, பழைய கட்டுரைகள் பெரும்பாலானவை பழைய அமைப்பையே விவரிக்கின்றன. அக்டோபர் 2026-ல் v0.80.0 மற்றும் இந்த வழிகாட்டி பரிந்துரைக்கும் v0.76.2 ஆகிய பதிப்புகளுடன் சரிபார்க்கப்பட்டது; இதன் quickstart script இயல்பாகவே மூன்று services கொண்ட Compose கோப்பை உருவாக்குகிறது.
netbird-serverமேலாண்மை API, signal service, உட்பொதிக்கப்பட்ட STUN listener கொண்ட relay மற்றும் உட்பொதிக்கப்பட்ட identity provider ஆகியவற்றை இயக்குகிறது. பழைய பதிப்புகளில் இவை தனித்தனி containers-ஆக இருந்தன, மேலும் identity provider என்பது நீங்கள் முதலில் உருவாக்க வேண்டிய தனி Zitadel நிறுவலாக இருந்தது.dashboardஎன்பது நிர்வாகத்திற்கான web console ஆகும்.traefikTLS (transport layer security)-ஐ முடிவுக்குக் கொண்டுவருகிறது (terminate) மற்றும் முதல்முறை தொடங்கும் போது Let's Encrypt-லிருந்து certificate-ஐக் கோருகிறது.
மேலும் இரண்டு services உள்ளன, ஆனால் நீங்கள் கேட்கும் போது 'yes' என்று கூறினால் மட்டுமே அவை இயங்கும். NetBird Proxy service உள்நாட்டு சேவைகளை பொதுவான hostnames-ல் வெளியிடுகிறது. CrowdSec தவறான traffic-ஐ வடிகட்டுகிறது. ஒரு mesh-ஐ உருவாக்க இவை இரண்டும் தேவையில்லை, மேலும் இவை சிறிய server-களில் கூடுதல் நினைவகத்தை (memory) எடுத்துக்கொள்ளும்.
நீங்கள் wg-easy in a single Docker container-லிருந்து வருகிறீர்கள் என்றால், இது அதிகப்படியான பாகங்களைக் கொண்ட ஒரு மாற்றமாகும். இது உங்களுக்கு access policies, பயனர் வாரியான கணக்குகள் மற்றும் ஒரு gateway வழியாகச் செல்லாமல் நேரடியாக ஒன்றோடொன்று இணைக்கும் peers ஆகிய வசதிகளை வழங்குகிறது.
தொடங்குவதற்கு முன் உங்களுக்குத் தேவையானவை
ஒரு பொது டொமைன் பெயர் (public domain name) கட்டாயமானது. Dashboard, API மற்றும் relay ஆகிய அனைத்தும் 443-வது port-ல் HTTPS மூலம் இயங்குகின்றன. Traefik, Let's Encrypt-லிருந்து TLS-ALPN-01 challenge மூலம் certificate-ஐப் பெறுகிறது; இதற்கு 443-வது port-ல் பதில் அளிக்கப்பட வேண்டும். இந்த port, பொது இணையத்திலிருந்து உங்கள் VPS-ஐச் சென்றடையும் வகையில் ஒரு டொமைன் பெயருடன் இணைக்கப்பட்டிருக்க வேண்டும். வெறும் IP முகவரி மட்டும் இந்தச் செயல்பாட்டிற்குப் போதாது.
ஒரு A record-ஐ உருவாக்கி, netbird.example.com அதை உங்கள் VPS-ன் பொது IPv4 முகவரிக்குச் சுட்டிக்காட்டவும். எதையும் தொடங்குவதற்கு முன் DNS propagation முடிவடையும் வரை காத்திருக்கவும்.
dig +short netbird.example.comமேலே உள்ள கட்டளை உங்கள் server-ன் முகவரியைக் காட்ட வேண்டும். DNS propagation முடிவதற்கு முன்பே installer-ஐ இயக்கினால், முதல் தொடக்கத்திலேயே certificate கோரிக்கை தோல்வியடையும். மீண்டும் மீண்டும் தோல்வியடையும் validation-களால் Let's Encrypt rate limits-ல் சிக்க நேரிடும்; இதனால் மீண்டும் முயற்சி செய்ய நீண்ட நேரம் காத்திருக்க வேண்டியிருக்கும்.
இயல்பான அமைப்பிற்கு (default setup) இணையத்திலிருந்து இரண்டு ports மட்டுமே அணுகக்கூடியதாக இருக்க வேண்டும்: Dashboard, API, signal, relay traffic மற்றும் certificate challenge ஆகியவற்றிற்காக TCP 443, மற்றும் STUN-க்காக UDP 3478. Traefik-ஆல் TCP 80 பயன்படுத்தப்படுவதால், அது local-ஆக காலியாக இருக்க வேண்டும், ஆனால் அது பொது இணையத்தில் அணுகக்கூடியதாக இருக்க வேண்டிய அவசியமில்லை. TCP 80-ஐ பொது அணுகலுக்குத் தடுப்பது HTTP-to-HTTPS redirect-ஐ மட்டுமே பாதிக்கும்.
sudo ufw allow 443/tcp
sudo ufw allow 3478/udp
sudo ufw reload
sudo ufw statusஉங்கள் provider-ன் network firewall-லும் இந்த ports-ஐத் திறந்து வைக்கவும். பெரும்பாலான VPS control panel-களில் இது தனி அமைப்பாக இருக்கும். உங்கள் server-ன் ufw status சரியாக இருந்தாலும், இணைப்புகள் கிடைக்காமல் போவதற்கு இதுவே முக்கிய காரணமாக இருக்கலாம்.
STUN (session traversal utilities for NAT) என்பது, ஒரு peer தனது NAT வழங்கிய பொது முகவரி மற்றும் port-ஐ அறிந்துகொள்ள உதவும் வழியாகும். இதன் மூலம் இரண்டு peers நேரடியாக tunnel அமைக்க முயற்சிக்கும். UDP 3478-ஐத் தடுத்தால், peers TCP 443-ல் உள்ள relay வழியாக இணைப்பை ஏற்படுத்திக்கொள்ளும், எனவே எதுவும் பழுதடைந்தது போலத் தெரியாது. நேரடிப் பாதையைக் கண்டறிய முடியாத peers Connection type: Relayed என்று காட்டும், மேலும் அவற்றின் traffic peer-to-peer-ஆகச் செல்லாமல் உங்கள் VPS வழியாகச் செல்லும். ஒரே LAN-ல் உள்ள peers தங்கள் local முகவரிகளைப் பயன்படுத்தி நேரடியாக இணைக்க முடியும்.
Software பக்கத்தில், உங்களுக்கு Docker உடன் Compose v2 plugin, மற்றும் jq, curl ஆகியவை தேவை. இந்த script Docker, Compose மற்றும் jq ஆகியவற்றைச் சரிபார்க்கும்; ஏதேனும் ஒன்று இல்லையென்றாலும் நிறுத்திவிடும். இது curl-ஐப் பயன்படுத்தும், ஆனால் அதைச் சரிபார்க்காது, எனவே அதை முதலில் நிறுவவும். இந்த server-ல் Docker புதியது என்றால், முதலில் VPS-ல் Docker Compose-ஐச் செயல்படுத்துவது எப்படி என்பதைப் பார்க்கவும்.
bundled reverse proxy-ஐத் தவிர்க்க விரும்பினால் தேவையான ports
Traefik இல்லாமல், ஒருங்கிணைந்த server-ஆனது management, signal மற்றும் relay ஆகியவற்றை ஒரே HTTP backend-ல் வைத்திருக்கும், எனவே port பட்டியல் பெரிதாக மாறாது. உருவாக்கப்படும் Compose file பின்வருவனவற்றை வெளியிடுகிறது (publish):
- TCP 8080, dashboard, இயல்பாக 127.0.0.1-ல் இணைக்கப்பட்டுள்ளது
- TCP 8081,
netbird-server, இயல்பாக 127.0.0.1-ல் இணைக்கப்பட்டுள்ளது - UDP 3478, STUN, நேரடியாக வெளியிடப்படுகிறது
உங்கள் சொந்த proxy, TCP 443-ல் TLS-ஐ முடித்து (terminate) அந்த இரண்டு local ports-க்கும் forward செய்யும். STUN ஒருபோதும் proxy வழியாகச் செல்லாது, எனவே UDP 3478 எந்தச் சூழலிலும் firewall-ல் திறந்தே இருக்க வேண்டும். Management gRPC, signal gRPC மற்றும் relay ஆகியவற்றிற்குத் தனித்தனி ports-ஐக் குறிப்பிடும் வழிகாட்டிகள், பழைய multi-container அமைப்பைக் குறிப்பவை.
உங்கள் server ஏற்கனவே வேறொரு சேவைக்காக TLS-ஐ முடிக்கும் நிலையில் இருந்தால் மட்டும் இதைத் தேர்ந்தெடுக்கவும். இல்லையெனில், bundled Traefik-ஐப் பயன்படுத்துவதே குறைவான விதிகள் மற்றும் குறைவான தவறுகளுக்கு வழிவகுக்கும்.
Quickstart script மூலம் NetBird server-ஐ நிறுவுதல்
ஆவணப்படுத்தப்பட்ட ஒற்றை வரி கட்டளை (one-liner), சமீபத்திய release-ஐ நேரடியாக shell-க்கு அனுப்புகிறது:
curl -fsSL https://github.com/netbirdio/netbird/releases/latest/download/getting-started.sh | bashஅதற்கு பதிலாக, ஒரு குறிப்பிட்ட பதிப்பைப் பயன்படுத்தவும் (pinning). latest அடிக்கடி மாறுவதால், இரண்டு வார இடைவெளியில் ஒரே கட்டளையை இயக்கினால் இரண்டு வெவ்வேறு நிறுவல்கள் கிடைக்கும்; எந்தப் பதிப்பு உங்கள் config-ஐ உருவாக்கியது என்பது வட்டில் பதிவாகாது. ஒரு tagged release-ஐத் தரவிறக்கம் செய்து, அதைச் சரிபார்த்து, பின் இயக்கவும்.
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]-ஐத் தேர்ந்தெடுக்கவும். விருப்பங்கள் 2 முதல் 4 வரை ஒரு config snippet-ஐ எழுதி, இணைப்புகளை உங்களிடம் விட்டுவிடும். விருப்பம் 5, Compose file, dashboard.env மற்றும் config.yaml ஆகியவற்றை எழுதி, setup ஆவணங்களை terminal-ல் காட்டும். ஏற்கனவே proxy இயங்கும் server-ல் இது சரியாக இருக்கும், ஆனால் புதிய server-ல் இது தவறானது. விருப்பம் 0, ஒரு மின்னஞ்சல் முகவரியைக் கேட்கும்; இதை Traefik உங்கள் Let's Encrypt கணக்கில் பதிவு செய்யும். certificate அறிவிப்புகளுக்கான முகவரி என்று prompt இன்னும் கூறினாலும், ஜூன் 4, 2025 முதல் Let's Encrypt காலாவதி மின்னஞ்சல்களை அனுப்புவதை நிறுத்திவிட்டது. எனவே, புதுப்பித்தல் சிக்கல்கள் உங்கள் inbox-க்கு வராமல், Traefik log-ல் மட்டுமே தெரியும்.
முதல் நிறுவலில் NetBird Proxy service-க்கு 'no' என்று பதிலளிக்கவும். இதற்கு ஒரு கூடுதல் DNS record தேவைப்படும், அதாவது netbird.example.com-ஐச் சுட்டிக்காட்டும் ஒரு wildcard *.netbird.example.com CNAME. சாதாரண mesh அமைப்புக்கு இது தேவையில்லை. Proxy-ஐ இயக்கினால் மட்டுமே CrowdSec prompt தோன்றும், எனவே proxy-ஐத் தவிர்த்தால் இதையும் தவிர்க்கலாம். இரண்டையும் பிறகு தேவைப்படும்போது சேர்த்துக்கொள்ளலாம்.
இந்த script தற்போதைய directory-ல் கோப்புகளை எழுதும்: docker-compose.yml, 600 mode-ல் config.yaml, மற்றும் dashboard.env. Traefik-உடன் சேர்த்து, NetBird Proxy-ஐ இயக்கும்போது மட்டுமே traefik-dynamic.yaml மற்றும் proxy.env சேர்க்கப்படும். அந்த directory-ஐ மிக முக்கியமான தரவாகக் கருதவும், ஏனெனில் config.yaml-ல் தான் store-ல் உள்ள தரவை encrypt செய்யும் key உள்ளது. அதை இழந்துவிட்டால், மீண்டும் நிறுவுவதால் மட்டும் சரி செய்ய முடியாது.
docker compose ps
docker compose logs -f netbird-serverஒவ்வொரு service-ம் running-ஐ வாசிக்க வேண்டும், மேலும் server log மீண்டும் மீண்டும் restart ஆகாமல் நிலையாக இருக்க வேண்டும். Certificate-ஐத் தனியாகக் கண்காணிக்கவும்:
docker compose logs traefik | grep -i acmeACME (automatic certificate management environment) என்பது Traefik certificate-ஐப் பெறப் பயன்படுத்தும் protocol ஆகும். இதில் ஏற்படும் பிழைகள் பெரும்பாலும் DNS அல்லது மூடப்பட்ட port 443 காரணமாகவே இருக்கும்.
முதல் நிர்வாகி கணக்கை உருவாக்குதல்
https://netbird.example.com-ஐத் திறக்கவும். புதிய நிறுவலில், இது login படிவத்திற்குப் பதிலாக setup பக்கத்திற்குச் செல்லும். மின்னஞ்சல் முகவரி, பெயர் மற்றும் கடவுச்சொல்லை உள்ளிட்டு, Create Account என்பதைக் கிளிக் செய்யவும். இதுவே முதல் நிர்வாகி கணக்காகும், அதன் பிறகு பக்கம் login படிவத்திற்குத் திருப்பிவிடப்படும்.
இந்தக் கணக்கு netbird-server container-ல் உள்ளமைக்கப்பட்ட identity provider மூலம் இயங்கும் NetBird-ன் சொந்த பயனர் சேமிப்பகத்தில் (user store) இருக்கும். இதில் வெளிப்புறத் தொடர்புகள் எதுவும் இல்லை. ஒரு வருடத்திற்கு முன்பு இருந்த self-hosted NetBird-ல் இருந்து இதுவே மிகப்பெரிய மாற்றமாகும்; அப்போது ஒரு நிறுவலைச் செயல்படுத்த, முதலில் Zitadel அல்லது Keycloak-ஐ நிறுவி, நான்கு OIDC (OpenID Connect) மதிப்புகளை setup.env-ல் நகலெடுத்தால் மட்டுமே எதையும் தொடங்க முடியும்.
setup பக்கத்திற்குப் பதிலாக browser certificate எச்சரிக்கை வந்தால், certificate வழங்கப்படவில்லை என்று அர்த்தம். இதைச் சரிசெய்த பின்னரே அடுத்த கட்டத்திற்குச் செல்லவும், ஏனெனில் dashboard அதே hostname வழியாக API-உடன் தொடர்பு கொள்கிறது, தவறான certificate இருந்தால் அது குழப்பமான முறையில் தோல்வியடையும்.
உங்கள் முதல் peer-ஐ இணைக்கவும்
Mesh-ல் சேர்க்க விரும்பினால், VPS உட்பட எந்தவொரு Linux machine-லும் client-ஐ நிறுவவும்:
curl -fsSL https://pkgs.netbird.io/install.sh | shDebian மற்றும் Ubuntu-வில், அந்த script NetBird-ன் package repository-ஐ configure செய்து, apt மூலம் client-ஐ நிறுவுகிறது. எனவே, package manager-ன் கட்டுப்பாட்டிலேயே அது இருக்கும். ஒரு script-ஐ நேரடியாக shell-க்கு அனுப்புவது (piping) உங்களுக்கு விருப்பமில்லை என்றால், அதை முதலில் curl -fsSL -o install.sh https://pkgs.netbird.io/install.sh மூலம் சேமித்து, பின் sh install.sh மூலம் இயக்குவதற்கு முன்பு படித்துப் பார்க்கவும். எதுவாக இருந்தாலும், என்ன நிறுவப்பட்டது என்பதை உறுதிப்படுத்தவும்:
apt-cache policy netbirdnetbird என்பது command line client மற்றும் daemon ஆகும். netbird-ui என்பது desktop tray app ஆகும்; headless server-க்கு இதன் தேவை இல்லை.
இப்போது client-ஐ உங்கள் server-ஐ நோக்கிச் சுட்டிக்காட்டவும்:
sudo netbird up --management-url https://netbird.example.com--management-url-ஐத் தவிர்த்தால், client NetBird-ன் hosted service-உடன் பதிவு செய்யும்; ஏனெனில் அதுவே compiled-in default ஆகும். இந்த command வெற்றிகரமாக இயங்கும், machine-க்கு ஒரு முகவரியும் கிடைக்கும், ஆனால் உங்கள் self-hosted dashboard காலியாகவே இருக்கும். இது பலருக்கும் ஏற்படும் பொதுவான தவறு.
இந்த command login-ஐ முடிக்க browser-ல் திறக்க வேண்டிய ஒரு URL-ஐக் காட்டும். அதற்குப் பிறகு:
netbird status
ip addr show wt0netbird status-லிருந்து நான்கு வரிகளைப் படிக்கவும்: Management: Connected, Signal: Connected, கிடைக்கக்கூடிய அனைத்து relay-களையும் காட்டும் ஒரு Relays: வரி, மற்றும் overlay range-ல் உள்ள ஒரு NetBird IP:. wt0 என்பது NetBird உருவாக்கும் WireGuard interface ஆகும்; அது அதே முகவரியைக் கொண்டிருக்க வேண்டும்.
setup key-ஐப் பயன்படுத்தி இரண்டாவது machine-ஐ unattended முறையில் இணைத்தல்
Browser இல்லாத மற்றும் யாரும் முன்னால் இல்லாத ஒரு machine-க்கு browser login வேலை செய்யாது. Setup key என்பது ஒரு pre-authentication token ஆகும்; இது interactive படிநிலை இல்லாமலேயே ஒரு machine-ஐப் பதிவு செய்ய உதவுகிறது. Dashboard-ல் Settings → Setup Keys பகுதிக்குச் சென்று ஒன்றை உருவாக்கவும்.
இதில் இரண்டு வகைகள் உள்ளன. One-off key என்பது சரியாக ஒரு machine-ஐ மட்டும் authenticate செய்யும், அதன் பிறகு அது செலவிடப்பட்டுவிடும். Reusable key பல machine-களைப் பதிவு செய்யும், இதில் எத்தனை machine-கள் இணையலாம் என்பதற்கான வரம்பை விருப்பத்தேர்வாக அமைக்கலாம். இரண்டிற்கும் expiry காலத்தை விருப்பத்தேர்வாக அமைக்கலாம், மேலும் இரண்டிலும் புதிய peer-ஐ ஒரு group-ல் தானாகவே சேர்க்க முடியும். இதனால், அந்த machine இணைந்த கணத்திலேயே அந்த group-க்கான access rules அதற்குப் பொருந்தும்.
sudo netbird up --setup-key <SETUP-KEY> \
--management-url https://netbird.example.com \
--hostname build-runner-01--hostname என்பது dashboard-ல் காட்டப்படும் பெயரை அமைக்கிறது. இதைத் தவிர்த்தால், அந்த machine தனக்குத்தானே என்ன பெயர் வைத்துள்ளதோ அதையே peer எடுத்துக்கொள்ளும்; ubuntu என்ற பெயரில் பல entries இருப்பது யாருக்கும் உதவாது.
Containers மற்றும் குறுகிய காலம் இயங்கும் build agents-க்கு, key-ஐ உருவாக்கும்போது அதை ephemeral என mark செய்யவும். Ephemeral key மூலம் பதிவு செய்யப்பட்ட peers, 10 நிமிடங்களுக்கு மேல் offline-ல் இருந்தால் தானாகவே நீக்கப்படும். இது peer பட்டியலில் தேவையற்ற dead entries சேர்வதைத் தவிர்க்கும்.
Setup keys-ஐப் பயன்படுத்தத் திட்டமிடும் முன் கவனிக்க வேண்டிய ஒரு வரம்பு: ஒரு key-ஐ காலாவதியாக்குவது அல்லது ரத்து செய்வது புதிய பதிவுகளை மட்டுமே தடுக்கும்; ஏற்கனவே அந்த key மூலம் பதிவு செய்த machine-களின் இணைப்பை அது துண்டிக்காது. ஒரு machine-ன் access-ஐ நீக்க வேண்டுமென்றால், அந்த peer-ஐ நீக்க வேண்டும்.
தனி அடையாள வழங்குநர் (identity provider) இன்னும் தேவைப்படுகிறதா?
சிறிய நிறுவல்கள் என்றால், தேவையில்லை. உள்ளமைக்கப்பட்ட பயனர் சேமிப்பகம் (built-in user store) dashboard மூலம் உருவாக்கப்படும் கணக்குகளைக் கையாளும்; இது ஒரு சில நபர்களுக்குப் போதுமானது.
உங்களிடம் ஏற்கனவே ஒரு அடையாள வழங்குநர் இருந்து, இரண்டாவது பயனர் பட்டியலைப் பராமரிக்க விரும்பவில்லை என்றால், உங்களுக்கு வெளிப்புற அடையாள வழங்குநர் தேவைப்படும். OIDC-ஐ ஆதரிக்கும் எந்தவொரு வழங்குநரையும் NetBird ஏற்கும். உங்கள் வழங்குநரில் ஒரு confidential OIDC client-ஐப் பதிவு செய்யவும். பின்னர், NetBird dashboard-ல் பெயர், client ID, client secret மற்றும் தேவைப்படும் இடங்களில் issuer ஆகியவற்றைச் சேர்க்கவும். NetBird உங்களுக்கு ஒரு redirect URL-ஐ வழங்கும்; அதை உங்கள் வழங்குநரில் உள்ளிட வேண்டும். Google, Microsoft Entra ID, Okta, Zitadel, Keycloak, Authentik மற்றும் Pocket ID ஆகியவற்றுக்குத் தனிப்பட்ட ஒருங்கிணைப்புகள் உள்ளன. மற்றவை அனைத்தும் generic OIDC ஆகச் சேர்க்கப்படும். நீங்கள் ஏற்கனவே Authentik-ஐ உங்கள் self-hosted single sign-on ஆக பயன்படுத்துகிறீர்கள் என்றால், இரண்டு கணக்கு பட்டியல்களுக்குப் பதிலாக ஒரே பட்டியலைப் பராமரிக்க இந்த வழிமுறையே சிறந்தது.
வழங்குநர் ஒருவரைச் சேர்த்த பிறகும் உள்ளூர் உள்நுழைவு (local login) வசதி இருக்கும். கட்டமைக்கப்பட்ட அனைத்து வழங்குநர்களும் உள்நுழைவுப் பக்கத்தில் தோன்றும். வலுவான கடவுச்சொல்லுடன் ஒரு உள்ளூர் நிர்வாகக் கணக்கை (local admin account) எப்போதும் வைத்திருங்கள். OIDC கட்டமைப்பில் ஏதேனும் பிழை ஏற்பட்டாலும், இந்த கணக்கு மூலம் நீங்கள் உள்ளே நுழைய முடியும்.
NetBird அல்லது Headscale: நீங்கள் எந்த control plane-ஐ இயக்க வேண்டும்?
இரண்டுமே ஒரே மாதிரியான சார்புநிலையை (dependency) நீக்குகின்றன; அதாவது, உங்கள் clients தகவல்களை அனுப்பும் hosted control server-ஐ இவை நீக்குகின்றன. ஆனால் இவை இரண்டும் ஒரே மாதிரியான திட்டங்கள் அல்ல.
Headscale என்பது Tailscale control server-ன் மறு உருவாக்கம் ஆகும். நீங்கள் அதிகாரப்பூர்வ Tailscale clients-ஐயே தொடர்ந்து பயன்படுத்தலாம். இதில் அதிகாரப்பூர்வ web console கிடையாது. நீங்கள் users மற்றும் pre-authentication keys-ஐ ஒரு config file-ஐப் பயன்படுத்தி headscale கட்டளை மூலம் நிர்வகிக்க வேண்டும். சமூகத்தால் உருவாக்கப்பட்ட web interfaces இருந்தாலும், அவை இந்தத் திட்டத்தின் ஒரு பகுதி அல்ல. தங்கள் தரவுகளைக் கோப்புகளாக வைத்திருக்கவும், மாற்றங்களை version control-ல் கையாளவும் விரும்புவோருக்கு இது ஏற்றது.
NetBird முழு product-ஐயும் வழங்குகிறது: அதன் சொந்த client, அதன் சொந்த dashboard, embedded identity provider, மேலும் browser-ல் திருத்தக்கூடிய access policies ஆகியவை இதில் அடங்கும். இதனால் உங்கள் VPS-ல் நிர்வகிக்க வேண்டிய components அதிகரிக்கும். Terminal-ஐ ஒருபோதும் திறக்கப் போவதில்லாத colleague-க்கு நிர்வாகப் பொறுப்பை ஒப்படைப்பதும் மிகவும் எளிதாக இருக்கும். நீங்கள் Headscale-க்கு பதிலாக hosted Tailscale உடன் NetBird-ஐ உண்மையில் ஒப்பிடுகிறீர்கள் என்றால், இரண்டும் அடிப்படையில் WireGuard-ஐ இயக்குகின்றன. எனவே, NetBird vs Tailscale ஒப்பீடு அவற்றின் உண்மையான வேறுபாடுகளை விளக்குகிறது: control plane-ஐ யார் இயக்குகிறார்கள், access rules எவ்வாறு எழுதப்படுகின்றன, relays எவ்வாறு traffic-ஐ கடத்துகின்றன என்பவை.
நீங்கள் ஏற்கனவே Tailscale clients-ல் முதலீடு செய்திருந்தால் அல்லது மிகச்சிறிய control plane-ஐ விரும்பினால் Headscale-ஐப் பயன்படுத்தவும். பல நபர்கள் peers-ஐ நிர்வகிக்க வேண்டும் மற்றும் console, SSO ஆகியவற்றை நீங்களே உருவாக்காமல் நேரடியாகப் பெற விரும்பினால் NetBird-ஐப் பயன்படுத்தவும். எதைத் தேர்ந்தெடுப்பதற்கு முன்பும், Tailscale-ன் இலவசத் திட்டம் எதை உள்ளடக்கியது என்பதைச் சரிபார்க்கவும். ஏனெனில், ஆறு பயனர்களுக்குள் இருக்கும் வணிகம் சாராத குழுக்களுக்கு hosted control plane-க்குக் கட்டணம் ஏதுமில்லை. இதில் வரம்பற்ற பயனர் சாதனங்கள் மற்றும் தொடக்கத்திற்கு 50 tagged resources வழங்கப்படுகின்றன, எனவே இவர்களுக்குத் தனியாக control plane-ஐ இயக்க வேண்டிய அவசியம் இருக்காது. இந்த வரம்பைத் தாண்டும்போது, இயந்திரங்களின் எண்ணிக்கையை விட நபர்களின் எண்ணிக்கையைப் பொறுத்தே கட்டணம் உயரும். எனவே, Tailscale உங்கள் குழுவிற்கு எவ்வளவு கட்டணம் வசூலிக்கும் என்பதைக் கணக்கிட்டு, அந்தத் தொகையை உங்கள் VPS செலவு மற்றும் இதற்காக நீங்கள் செலவிடும் நேரத்துடன் ஒப்பிட்டுப் பார்க்கவும்.
எவ்வளவு சிறிய VPS-ல் இதை இயக்க முடியும்?
ஆவணப்படுத்தப்பட்ட குறைந்தபட்சத் தேவை 1 CPU மற்றும் 2 GB memory ஆகும். 2 GB-ஐத் தேர்ந்தெடுக்கவும்.
சிறிய server-ல் மூன்று விஷயங்களைத் தவிர்ப்பது பாதுகாப்பானது. NetBird Proxy service-ஐத் தவிர்க்கவும்; இது internal services-ஐ public hostnames-ல் வெளியிட மட்டுமே பயன்படுகிறது, peers இணைப்பிற்கும் இதற்கும் தொடர்பில்லை. CrowdSec-ஐத் தவிர்க்கவும்; இது proxy-உடன் மட்டுமே வழங்கப்படுகிறது, மேலும் இதைத் தொடக்கத்திலேயே நிறுவுவதை விட, பின்னர் தேவைப்படும்போது சேர்த்துக்கொள்வது சிறந்தது. SQLite store-ஐ netbird_data volume-ல் இயல்பாகவே வைத்திருக்கவும்; நீங்கள் deployment-ஐப் பல machines-க்கு பிரிக்கும்போது அல்லது அதிக concurrency ஏற்படும்போது மட்டும் PostgreSQL-க்கு மாறவும். இது பின்னர் செய்யக்கூடிய migration முறையாக ஆவணப்படுத்தப்பட்டுள்ளது.
Relay என்பது நீங்கள் தவிர்க்க முடியாத ஒரு component ஆகும். NAT மூலம் ஒவ்வொரு destination-க்கும் வெவ்வேறு port-ஐ ஒதுக்கும் இரண்டு peers-க்கு இடையே நேரடி tunnel-ஐ உருவாக்க முடியாது; எனவே, அவை செயல்படுவதற்கு relay மட்டுமே ஒரே வழியாகும். இதை முடக்குவதால் மிகக் குறைந்த memory மட்டுமே மிச்சமாகும், ஆனால் இது கண்டறிய கடினமான இணைப்புச் சிக்கல்களை உருவாக்கும்.
ஒரு server போதுமானதாக இல்லாதபோது, முதலில் relay-ஐ வேறொரு server-க்கு மாற்ற வேண்டும். ஒரு standalone relay-ஐ NB_LISTEN_ADDRESS, NB_EXPOSED_ADDRESS, NB_AUTH_SECRET மற்றும் NB_ENABLE_STUN ஆகியவற்றுடன் இயக்கலாம். Relay மற்றும் main server ஆகிய இரண்டிலும் shared secret ஒரே மாதிரியாக இருக்க வேண்டும், இல்லையெனில் clients-ஆல் authenticate செய்ய முடியாது.
தோல்வி முறைகள் மற்றும் நீங்கள் காண்பவை
Dashboard ஒரு certificate எச்சரிக்கையைக் காட்டுகிறது. Traefik ஒரு certificate-ஐப் பெறவில்லை. docker compose logs traefik | grep -i acme-ஐ இயக்கவும். இதற்கு இரண்டு காரணங்கள் உள்ளன. ஒன்று, dig +short netbird.example.com இன்னும் இந்த VPS-ஐக் குறிக்கவில்லை, அல்லது Let's Encrypt மற்றும் container-க்கு இடையே TCP 443 port எங்காவது மூடப்பட்டுள்ளது. இது பெரும்பாலும் ufw-ல் அல்லாமல், provider-ன் network firewall-ல் நடக்கும். இந்த challenge 443 port-ல் தான் பதிலளிக்கப்படும், எனவே port 80 திறந்திருப்பது இங்கு உதவாது. மீண்டும் மீண்டும் முயற்சிக்கும் முன் காரணத்தைச் சரிசெய்யவும். ஏனெனில், Let's Encrypt ஒரு மணி நேரத்திற்கு ஒரு hostname-க்கு ஐந்து தோல்வியுற்ற authorizations-ஐ மட்டுமே அனுமதிக்கிறது. தொடர்ந்து முயற்சித்தால், அந்த வரம்பு முடியும் வரை உங்களால் மீண்டும் முயல முடியாது.
Client இணைக்கப்பட்டுவிட்டதாகக் கூறுகிறது, ஆனால் dashboard காலியாக உள்ளது. --management-url விடுபட்டதால், client NetBird-ன் hosted service-ல் பதிவு செய்துள்ளது. netbird status --detail-ஐ இயக்கி, Management: வரியைப் படிக்கவும். அது தற்போது எந்த server-உடன் பேசுகிறது என்பதைக் காட்டும். 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-ஐக் காட்டுகிறது. நேரடி tunnels உருவாகவில்லை, எனவே அனைத்து traffic-உம் உங்கள் VPS வழியாகச் செல்கிறது, இது latency-ஐ அதிகரிக்கிறது. VPS firewall மற்றும் provider firewall-ல் UDP 3478-ஐச் சரிபார்க்கவும். ஏனெனில், ஒரு peer தனது சொந்த public address மற்றும் port-ஐ அறிந்துகொள்ள STUN பயன்படுகிறது. netbird status --detail கட்டளை Direct: false மற்றும் ஒவ்வொரு peer-க்கான ICE (interactive connectivity establishment) candidate வகைகளையும் அச்சிடும். இது முயற்சி எந்த நிலை வரை சென்றது என்பதைக் காட்டும். சில network-களில் relayed மட்டுமே சாத்தியம், அதில் தவறு ஏதுமில்லை.
ஒரு peer இணைகிறது, ஆனால் எதையும் அணுக முடியவில்லை. mesh-ல் இருப்பது என்பது இரண்டு peers பேசிக்கொள்ள முடியும் என்று அர்த்தமல்ல. Access policies தான் அதைத் தீர்மானிக்கின்றன. எந்தக் கொள்கையும் (policy) இணைக்கப்படாத group எதையும் அணுக முடியாது. routes மற்றும் firewalls-ஐ debug செய்வதற்கு முன், 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 நிலை ஆகியவற்றை ஒரே archive-ஆகச் சேகரிக்கும்.
காப்புப்பிரதிகள் மற்றும் மேம்படுத்தல்கள்
முழு நிறுவலையும் இரண்டு விஷயங்கள் மட்டுமே தீர்மானிக்கின்றன: docker-compose.yml மற்றும் config.yaml ஆகியவற்றை உள்ளடக்கிய கோப்பகம் (directory), மற்றும் தரவுத்தளம் (database) மற்றும் குறியாக்க சாவிகளை (encryption keys) கொண்ட Docker volume. இவை இரண்டையும் ஒன்றாக காப்புப்பிரதி எடுக்கவும். config.yaml-ல் தரவு சேமிப்பகத்தில் உள்ள முக்கியமான தகவல்களை குறியாக்கம் செய்யும் சாவி உள்ளது; எனவே, இந்த சாவி இல்லாமல் எடுக்கப்படும் தரவுத்தள நகல், குறியாக்கம் செய்யப்பட்ட 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 -dCompose, volume பெயர்களுக்கு முன்னால் project கோப்பகத்தின் பெயரைச் சேர்க்கும், எனவே netbird_data என்று ஆவணப்படுத்தப்பட்ட volume பொதுவாக netbird_netbird_data என்ற பெயரில் தோன்றும். முதலில் docker volume ls கட்டளையை இயக்கி, அது காட்டும் பெயரைப் பயன்படுத்தவும்; இல்லையெனில், மேலே உள்ள docker run கட்டளை, காலியான volume-ஐ உருவாக்கி எதையும் காப்புப்பிரதி எடுக்காமல் தோல்வியடையும். காப்புப்பிரதி கோப்புகளை VPS-ல் வைக்க வேண்டாம். உங்களிடம் ஏற்கனவே காப்புப்பிரதி கருவி இருந்தால், restic அல்லது BorgBackup மூலம் அவற்றை வெளியக சேமிப்பகத்திற்கு (offsite) மாற்றலாம்.
server-ஐ மேம்படுத்துவது என்பது ஒரு pull மற்றும் recreate செயல்முறையாகும்:
docker compose pull
docker compose up -d
docker compose psஅதைச் செய்வதற்கு முன், docker compose config | grep image: கட்டளையை இயக்கவும். latest என்று இருக்கும் எந்தவொரு tag-ம் ஒரு குறிப்பிட்ட பதிப்பிற்கு (version) மாற்றப்பட வேண்டும்; நிறுவல் script-ஐ நீங்கள் குறிப்பிட்ட பதிப்பிற்கு மாற்றிய அதே காரணத்திற்காக இது செய்யப்படுகிறது: எது இயங்குகிறது என்பதை நீங்கள் அறிந்திருக்க வேண்டும், மேலும் மேம்படுத்தலில் சிக்கல் ஏற்பட்டால் பழைய பதிப்பிற்குத் திரும்ப உங்களுக்கு ஒரு வழி தேவை. Clients-கள் தங்களை நிறுவிய package manager மூலமாகவே மேம்படுத்திக்கொள்ளும்.
FAQ
NetBird-ஐ self-host செய்ய எனக்கு சொந்தமாக identity provider தேவையா?
தேவையில்லை. தற்போதைய releases-ல் உள்ளமைக்கப்பட்ட (built-in) user store உள்ளது. எனவே, நீங்கள் உலாவியில் https://netbird.example.com முகவரியில் முதல் admin கணக்கை உருவாக்கி, அதன் பிறகு dashboard மூலம் பயனர்களைச் சேர்த்துக்கொள்ளலாம். ஒரு external OIDC provider என்பது விருப்பத்தேர்வு மட்டுமே; அதைத் தேவைப்படும்போது பெயர், client ID, client secret மற்றும் issuer விவரங்களுடன் பின்னர் சேர்த்துக்கொள்ளலாம். NetBird-க்கு முன்னதாக Zitadel அல்லது Keycloak-ஐ deploy செய்யச் சொல்லும் வழிகாட்டிகள், தற்போது தேவையில்லாத ஒரு அமைப்பையே விவரிக்கின்றன; அவற்றைப் பின்பற்றுவது கூடுதல் சேவையை இயக்க வேண்டிய தேவையற்ற சுமையை உங்களுக்கு ஏற்படுத்தும்.
எனது peers அனைத்தும் ஏன் Connection type: Relayed என்று காட்டுகின்றன?
நேரடி இணைப்புகள் (direct connections) உருவாகவில்லை, எனவே traffic உங்கள் VPS-ல் உள்ள relay வழியாகச் செல்கிறது. இதற்குப் பொதுவான காரணம் UDP 3478 port தடுக்கப்பட்டிருப்பதுதான்; இது peers தங்கள் சொந்த public address மற்றும் port-ஐக் கண்டறியப் பயன்படுத்தும் STUN port ஆகும். இதை உங்கள் VPS firewall மற்றும் உங்கள் provider-ன் network firewall-ல் திறந்துவிட்டு, மீண்டும் netbird status --detail கட்டளையை இயக்கி, Direct: வரியைப் பார்க்கவும். இரு peers-ம் வெவ்வேறு destination-களுக்கு வெவ்வேறு port-களை ஒதுக்கும் NAT-க்கு பின்னால் இருக்கும்போது, relayed என்பது எதிர்பார்க்கப்படும் முடிவே; இதில் எந்தத் தவறும் இல்லை.
எனது client இணைந்துவிட்டது, ஆனால் dashboard-ல் peers தெரியவில்லை. என்ன நடந்தது?
--management-url விடுபட்டதால், client உங்கள் server-க்கு பதிலாக NetBird-ன் hosted service-ல் பதிவு செய்துள்ளது. netbird status --detail கட்டளை அது எந்த server-உடன் பேசுகிறது என்பதை Management: வரியில் காட்டும்; எனவே https://api.netbird.io:443 போன்ற மதிப்பு இருந்தால் அது உறுதி செய்யப்படுகிறது. 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 கட்டளை மற்றும் ஒரு config file மூலம் நிர்வகிக்கிறீர்கள்; இதில் அதிகாரப்பூர்வ web console கிடையாது, மேலும் இது அதிகாரப்பூர்வ Tailscale client-களை இயக்குகிறது. NetBird அதன் சொந்த client, admin dashboard மற்றும் identity provider integration ஆகியவற்றை ஒரே stack-ல் வழங்குகிறது. Headscale-ஐ இயக்குவது எளிது மற்றும் அது தனது நிலையை (state) கோப்புகளில் வைத்திருக்கும். Terminal பயன்படுத்த விரும்பாதவர்களுக்கு NetBird-ஐக் கொடுப்பது எளிது.
Self-hosted NetBird server-க்கு எவ்வளவு பெரிய VPS தேவை?
ஆவணப்படுத்தப்பட்ட குறைந்தபட்சத் தேவை 1 CPU மற்றும் 2 GB memory ஆகும், எனவே 2 GB-ஐத் தேர்ந்தெடுக்கவும். நிறுவலின் போது விருப்பத்தேர்வாக வரும் proxy service-ஐத் தவிர்க்கவும் (இது CrowdSec prompt-ஐயும் தவிர்க்கும்), மேலும் உங்களுக்கு PostgreSQL தேவைப்படும் வரை default SQLite store-லேயே இருக்கவும்.