NetBird VPN سرور کو اپنے VPS پر کیسے ہوسٹ کریں
اپنے VPS پر NetBird VPN سیٹ اپ کرنے کا مکمل طریقہ کار۔ اس گائیڈ میں DNS، TLS کنفیگریشن، setup keys اور Headscale کے ساتھ موازنہ شامل ہے تاکہ آپ بغیر کسی رکاوٹ کے نیٹ ورک بنا سکیں۔
NetBird VPN سرور کو self-host کرنے کے فوائد
NetBird VPN سرور کو self-host کرنے سے control plane آپ کے اپنے VPS پر آ جاتا ہے: یہ وہ حصہ ہے جو peer list کو برقرار رکھتا ہے، یہ فیصلہ کرتا ہے کہ کون سی مشین کس تک رسائی حاصل کر سکتی ہے، اور NAT (network address translation) کے پیچھے موجود دو peers کو ایک دوسرے کو تلاش کرنے میں مدد کرتا ہے۔ ٹنلز اب بھی WireGuard ہی رہتی ہیں، جو براہ راست آپ کی مشینوں کے درمیان انکرپٹ ہوتی ہیں۔ تبدیلی یہ آتی ہے کہ کوئی بیرونی کمپنی آپ کی ڈیوائسز کی انوینٹری یا آپ کے لاگ ان کے عمل کو کنٹرول نہیں کرتی۔ اس بات کو واضح رکھیں کہ اس سے آپ کو کیا حاصل ہوتا ہے، کیونکہ ایک hosted control plane بھی کبھی وہ keys نہیں رکھتا جو آپ کے ٹریفک کو انکرپٹ کرتی ہیں، اور اگر coordination server compromised ہو جائے تو وہ درحقیقت کیا کر سکتا ہے اس کی فہرست اس سے کہیں مختصر ہے جتنا زیادہ تر لوگ اسے پڑھنے سے پہلے سمجھتے ہیں۔
NetBird ان دو چیزوں کے درمیان موجود ہے جنہیں آپ شاید پہلے سے جانتے ہوں۔ یہ ایک mesh overlay ہے، لہذا peers ایک گیٹ وے کے ذریعے سب کچھ بھیجنے کے بجائے ایک دوسرے سے براہ راست جڑتے ہیں۔ یہ end to end self-hostable بھی ہے، جو اسے Headscale، یعنی self-hosted Tailscale control server کے مقابلے میں کھڑا کرتا ہے۔ اگر آپ نے صرف ایک سنگل گیٹ وے ٹنل چلائی ہے، تو پہلے plain WireGuard اور mesh overlay کے درمیان فرق پڑھیں، کیونکہ یہی وہ ذہنی ماڈل ہے جو اس صفحے کے باقی حصے کو مفید بناتا ہے۔
اگر آپ درحقیقت ایک ایسا سرور چاہتے ہیں جہاں سے آپ کا تمام ٹریفک باہر نکلے، تو mesh اس کام کے لیے ضرورت سے زیادہ پیچیدہ ہے۔ ایک سنگل VPS پر plain WireGuard VPN یا Tailscale exit node یہ کام بہت کم محنت سے کر دیتے ہیں۔ اور اگر مقصد مشینوں کو ایک دوسرے سے جوڑنے کے بجائے کسی ایک پرائیویٹ نیٹ ورک تک رسائی حاصل کرنا ہو، تو VPS پر Tailscale subnet router اس رینج کو اس tailnet میں مشتہر کر دیتا ہے جو آپ کے پاس پہلے سے موجود ہے، بغیر نیچے دیے گئے کسی بھی stack کے۔
اس stack میں عملی طور پر کیا چلتا ہے
Layout حال ہی میں تبدیل ہوا ہے، اور زیادہ تر پرانی تحریریں پرانے layout کو بیان کرتی ہیں۔ اکتوبر 2026 میں v0.80.0 اور اس guide میں مقرر کردہ release v0.76.2 کے خلاف جانچنے پر معلوم ہوا کہ quickstart script default طور پر تین services والی Compose file لکھتی ہے۔
netbird-servermanagement API، signal service، embedded STUN listener کے ساتھ relay، اور embedded identity provider چلاتا ہے۔ پرانی releases میں یہ الگ containers تھے، جبکہ identity provider الگ Zitadel installation تھا جسے آپ کو پہلے بنانا پڑتا تھا۔dashboardadmin web console ہے۔traefikTLS (transport layer security) terminate کرتا ہے اور پہلی بار start ہونے پر Let's Encrypt سے certificate طلب کرتا ہے۔
دو مزید services بھی موجود ہیں، لیکن prompt پر ہاں کہنے تک بند رہتی ہیں۔ NetBird Proxy service internal services کو public hostnames پر publish کرتی ہے۔ CrowdSec نقصان دہ traffic کو filter کرتا ہے۔ کام کرنے والا mesh بنانے کے لیے ان میں سے کوئی بھی ضروری نہیں، اور دونوں چھوٹے server پر memory استعمال کرتے ہیں۔
اگر آپ ایک Docker container میں wg-easy سے آ رہے ہیں تو یہ components کی تعداد میں نمایاں اضافہ ہے۔ اس کے بدلے آپ کو 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 پر دیا جاتا ہے، اس لیے ایسا name درکار ہے جو public internet سے اس VPS کی طرف resolve ہو۔ اس عمل میں صرف IP address کام نہیں کرے گا۔
ایک A record بنائیں، netbird.example.com، جو VPS کے public IPv4 address کی طرف point کرے، اور کوئی بھی کام کرنے سے پہلے اس کے فعال ہونے کا انتظار کریں۔
dig +short netbird.example.comاس command سے آپ کے server کا address ظاہر ہونا چاہیے۔ DNS کے propagate ہونے سے پہلے installer چلانے سے پہلی start پر certificate request ناکام ہو جاتی ہے۔ بار بار ناکام validations سے آپ Let's Encrypt کی rate limits تک پہنچ سکتے ہیں۔ پھر دوبارہ کوشش کرنے سے پہلے limit کے بحال ہونے کا انتظار کرنا پڑے گا۔
Default setup میں internet سے صرف دو ports تک رسائی ضروری ہے: dashboard، API، signal اور relay traffic، نیز certificate challenge کے لیے TCP 443؛ اور STUN کے لیے UDP 3478۔ TCP 80 مقامی طور پر خالی ہونا چاہیے کیونکہ Traefik اس پر bind ہوتا ہے، لیکن اسے public طور پر قابل رسائی ہونا ضروری نہیں۔ port 80 تک public رسائی روکنے سے صرف 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 میں یہ الگ control ہوتا ہے۔ اسی وجہ سے ایسا server بھی connections قبول نہیں کرتا جس کا اپنا ufw status درست نظر آتا ہو۔
STUN (session traversal utilities for NAT) کے ذریعے peer کو وہ public address اور port معلوم ہوتا ہے جو اس کے اپنے NAT نے assign کیا ہے، تاکہ دو peers direct tunnel بنانے کی کوشش کر سکیں۔ UDP 3478 کو block کرنے پر بھی peers relay کے ذریعے TCP 443 پر connect ہو جاتے ہیں، اس لیے بظاہر کوئی خرابی نظر نہیں آتی۔ جو peers direct path تلاش نہیں کر سکتے، ان پر Connection type: Relayed ظاہر ہوتا ہے، اور ان کا traffic peer-to-peer جانے کے بجائے آپ کے VPS سے گزرتا ہے۔ ایک ہی LAN پر موجود peers اپنے local addresses استعمال کرتے ہوئے اب بھی direct connect کر سکتے ہیں۔
Software کے لحاظ سے آپ کو Docker کے ساتھ Compose v2 plugin، اور jq اور curl درکار ہیں۔ Script Docker، Compose اور jq کی موجودگی check کرتی ہے اور ان میں سے کوئی چیز missing ہو تو رک جاتی ہے۔ یہ curl کو check کیے بغیر استعمال کرتی ہے، اس لیے اسے پہلے install کریں۔ اگر اس box پر 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 terminate کرتا ہے اور ان دونوں local ports کو requests forward کرتا ہے۔ STUN proxy سے نہیں گزرتا، اس لیے دونوں صورتوں میں UDP 3478 firewall پر open رہتا ہے۔ وہ guides جو management gRPC، signal gRPC اور relay کے لیے الگ ports درج کرتی ہیں، پرانے multi-container layout کی وضاحت کرتی ہیں۔
یہ انتخاب صرف اس وقت کریں جب box پہلے ہی کسی اور service کے لیے TLS terminate کر رہا ہو۔ ورنہ 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اس کے بجائے اسے pin کریں۔ latest تبدیل ہوتا رہتا ہے، اس لیے دو ہفتے کے وقفے سے چلایا گیا یہی command دو مختلف installations بناتا ہے، اور disk پر یہ ریکارڈ نہیں رہتا کہ آپ کی configuration کس release نے لکھی تھی۔ 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.shscript پہلے domain پوچھتی ہے:
Enter the domain you want to use for NetBird (e.g. netbird.my-domain.com):پھر یہ پوچھتی ہے کہ TLS کیسے handle کیا جائے گا:
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 پر print کرتا ہے۔ یہ اس host پر درست ہے جس پر پہلے سے proxy چل رہا ہو، لیکن نئے host پر غلط ہے۔ اس کے بعد option 0 email address پوچھتا ہے، جسے Traefik آپ کے Let's Encrypt account کے ساتھ register کرتا ہے۔ Prompt اب بھی اسے certificate notifications کے لیے address کہتا ہے، لیکن Let's Encrypt نے June 4, 2025 کو expiry emails بھیجنا بند کر دیا تھا۔ اس لیے renewal کے مسائل آپ کے inbox کے بجائے Traefik log میں ظاہر ہوں گے۔
پہلی installation پر NetBird Proxy service کے لیے no منتخب کریں۔ اسے ایک اضافی DNS record درکار ہوتا ہے: ایک wildcard *.netbird.example.com CNAME جو netbird.example.com کی طرف point کرے۔ عام mesh کے لیے اس کا کوئی فائدہ نہیں۔ CrowdSec prompt صرف اس وقت ظاہر ہوتا ہے جب proxy enabled ہو، اس لیے proxy سے انکار کرنے پر یہ بھی skip ہو جاتا ہے۔ دونوں بعد میں شامل کیے جا سکتے ہیں۔
script موجودہ directory میں یہ files لکھتی ہے: docker-compose.yml، config.yaml جس کا mode 600 ہوتا ہے، اور dashboard.env۔ Bundled Traefik کے ساتھ یہ traefik-dynamic.yaml اور proxy.env صرف اسی وقت شامل کرتی ہے جب آپ NetBird Proxy enable کریں۔ اس directory کو ایسی state سمجھیں جسے محفوظ رکھنا ضروری ہے، کیونکہ config.yaml میں وہ key موجود ہوتی ہے جو store میں data کو encrypt کرتی ہے۔ اسے کھو دینا ایسی چیز نہیں جسے reinstall کرنے سے درست کیا جا سکے۔
docker compose ps
docker compose logs -f netbird-serverہر service کو running پڑھنا چاہیے، اور server log کو restart loop میں جانے کے بجائے مستحکم ہو جانا چاہیے۔ Certificate کو الگ monitor کریں:
docker compose logs traefik | grep -i acmeACME (automatic certificate management environment) وہ protocol ہے جسے Traefik certificate حاصل کرنے کے لیے استعمال کرتا ہے۔ یہاں errors کی تقریباً ہمیشہ وجہ DNS یا بند port 443 ہوتی ہے۔
پہلا ایڈمن اکاؤنٹ بنائیں
https://netbird.example.com کھولیں۔ ایک نئی تنصیب (fresh install) پر یہ لاگ ان فارم کے بجائے سیٹ اپ کے صفحے پر لے جاتا ہے۔ ایک ای میل ایڈریس، نام اور پاس ورڈ درج کریں، پھر Create Account پر کلک کریں۔ یہ پہلا ایڈمن بن جاتا ہے، اور صفحہ خود بخود لاگ ان فارم پر ری ڈائریکٹ ہو جاتا ہے۔
یہ اکاؤنٹ NetBird کے اپنے یوزر اسٹور میں رہتا ہے، جو netbird-server کنٹینر میں ایمبیڈڈ شناخت فراہم کرنے والے (identity provider) کے ذریعے چلتا ہے۔ اس میں کوئی بیرونی چیز شامل نہیں ہے۔ یہ ایک سال پہلے کے سیلف ہوسٹڈ NetBird سے سب سے بڑی تبدیلی ہے، جب ایک فعال تنصیب کا مطلب یہ ہوتا تھا کہ پہلے Zitadel یا Keycloak کو کھڑا کیا جائے اور کسی بھی چیز کے شروع ہونے سے پہلے چار OIDC (OpenID Connect) ویلیوز کو setup.env میں کاپی کیا جائے۔
اگر آپ کو سیٹ اپ صفحے کے بجائے براؤزر سرٹیفکیٹ کی وارننگ ملے، تو اس کا مطلب ہے کہ سرٹیفکیٹ جاری نہیں ہوا۔ مزید آگے بڑھنے سے پہلے اسے ٹھیک کریں، کیونکہ ڈیش بورڈ اسی ہوسٹ نیم پر API سے بات کرتا ہے اور خراب سرٹیفکیٹ کے پیچھے الجھا دینے والے طریقوں سے ناکام ہو جاتا ہے۔
اپنے پہلے پیئر (peer) کو شامل کریں
کسی بھی Linux مشین پر کلائنٹ انسٹال کریں، بشمول خود VPS کے اگر آپ اسے نیٹ ورک (mesh) میں شامل کرنا چاہتے ہیں:
curl -fsSL https://pkgs.netbird.io/install.sh | shDebian اور Ubuntu پر یہ اسکرپٹ NetBird کی پیکیج ریپوزٹری کو کنفیگر کرتا ہے اور پھر apt کے ذریعے کلائنٹ انسٹال کرتا ہے، لہذا پیکیج مینیجر بہرحال اس کا انتظام سنبھال لیتا ہے۔ اگر آپ کو اسکرپٹ کو براہ راست شیل میں پائپ کرنے پر اعتراض ہے، تو اسے پہلے curl -fsSL -o install.sh https://pkgs.netbird.io/install.sh کے ساتھ محفوظ کریں اور sh install.sh چلانے سے پہلے اسے پڑھ لیں۔ بہرحال، تصدیق کریں کہ کیا انسٹال ہوا ہے:
apt-cache policy netbirdnetbird کمانڈ لائن کلائنٹ اور ڈیمن (daemon) ہے۔ netbird-ui ڈیسک ٹاپ ٹرے ایپ ہے، اور ہیڈلیس (headless) سرور کو اس کی ضرورت نہیں ہوتی۔
اب کلائنٹ کو اپنے سرور کی طرف پوائنٹ کریں:
sudo netbird up --management-url https://netbird.example.comاگر آپ --management-url کو حذف کر دیں گے تو کلائنٹ NetBird کی ہوسٹڈ سروس کے ساتھ رجسٹر ہو جائے گا، کیونکہ یہ کمپائلڈ ڈیفالٹ ہے۔ کمانڈ پھر بھی کامیاب ہو جائے گی، مشین کو ایڈریس بھی مل جائے گا، لیکن آپ کا سیلف ہوسٹڈ ڈیش بورڈ خالی رہے گا۔ یہ غلطی تقریباً ہر کسی سے ایک بار ضرور ہوتی ہے۔
کمانڈ لاگ ان مکمل کرنے کے لیے براؤزر میں کھولنے کے لیے ایک URL پرنٹ کرتی ہے۔ اس کے بعد:
netbird status
ip addr show wt0netbird status سے چار لائنیں پڑھیں: Management: Connected، Signal: Connected، ایک Relays: لائن جو ہر دستیاب ریلے (relay) کی اطلاع دیتی ہے، اور اوورلے رینج میں ایک NetBird IP:۔ wt0 وہ WireGuard انٹرفیس ہے جو NetBird بناتا ہے، اور اس پر وہی ایڈریس ہونا چاہیے۔
غیر مداخلتی طور پر دوسری مشین شامل کرنے کے لیے setup key
ایسی مشین کے لیے browser login کام نہیں کرتا جس پر browser موجود نہ ہو اور جس کے سامنے کوئی شخص نہ ہو۔ setup key ایک pre-authentication token ہے جو interactive مرحلے کے بغیر مشین کو register کرتا ہے۔ اسے dashboard میں Settings → Setup Keys کے تحت بنائیں۔
اس کی دو اقسام ہیں۔ one-off key بالکل ایک مشین کی authentication کرتی ہے اور پھر استعمال ہو جاتی ہے۔ reusable key متعدد مشینیں register کرتی ہے، اور اس میں زیادہ سے زیادہ تعداد کی اختیاری حد بھی مقرر کی جا سکتی ہے۔ دونوں کے لیے اختیاری 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 وہی نام اختیار کرتی ہے جو مشین خود استعمال کرتی ہے، اور ubuntu نام والی entries کا پورا fleet کسی کے لیے مفید نہیں ہوتا۔
containers اور مختصر مدت کے build agents کے لیے key بناتے وقت اسے ephemeral نشان زد کریں۔ ephemeral key سے register کی گئی peers اس وقت خودکار طور پر remove ہو جاتی ہیں جب وہ 10 منٹ سے زیادہ offline رہیں۔ اس سے peer list میں غیر فعال entries جمع نہیں ہوتیں۔
setup keys کے ذریعے منصوبہ بندی کرنے سے پہلے ایک حد سمجھ لیں: key کی expiry یا revocation نئی registrations روک دیتی ہے، لیکن اس key سے پہلے register کی گئی مشینوں کو disconnect نہیں کرتی۔ کسی مشین کا access ختم کرنے کے لیے اس peer کو remove کرنا ہوگا۔
کیا آپ کو اب بھی الگ identity provider کی ضرورت ہے؟
چھوٹی تنصیب کے لیے نہیں۔ built-in user store dashboard سے بنائے گئے accounts کو manage کرتا ہے، اور چند افراد کے لیے یہ کافی ہے۔
جب آپ کے پاس پہلے سے external identity provider موجود ہو اور آپ users کی دوسری فہرست نہیں رکھنا چاہتے ہوں، تو اسے استعمال کریں۔ NetBird ہر ایسے provider کو قبول کرتا ہے جو OIDC protocol استعمال کرتا ہو۔ اپنے provider میں confidential OIDC client register کریں، پھر NetBird dashboard میں اس کا name، client ID، client secret اور جہاں ضروری ہو issuer شامل کریں۔ NetBird آپ کو ایک redirect URL دے گا، جسے provider میں واپس paste کرنا ہوگا۔ Google، Microsoft Entra ID، Okta، Zitadel، Keycloak، Authentik اور Pocket ID کے لیے named integrations موجود ہیں؛ دیگر تمام providers کو generic OIDC کے طور پر شامل کیا جاتا ہے۔ اگر آپ پہلے ہی Authentik کو اپنے self-hosted single sign-on کے طور پر چلا رہے ہیں تو یہی طریقہ ایک کے بجائے ایک ہی account list برقرار رکھتا ہے۔
provider شامل کرنے کے بعد local login دستیاب رہتا ہے، اور configured providers login page پر ظاہر ہوتے ہیں۔ ایک local admin account کو strong password کے ساتھ برقرار رکھیں۔ اس طرح OIDC configuration خراب ہونے کی صورت میں بھی آپ کے پاس login کرنے کا راستہ موجود رہے گا۔
NetBird یا Headscale: آپ کو کون سا control plane چلانا چاہیے؟
دونوں ایک ہی dependency ختم کرتے ہیں: hosted control server، جس سے آپ کے clients بصورت دیگر رابطہ کرتے رہتے۔ تاہم، دونوں projects کی ساخت ایک جیسی نہیں ہے۔
Headscale، Tailscale control server کو دوبارہ implement کرتا ہے، اور آپ official Tailscale clients ہی استعمال کرتے رہتے ہیں۔ اس میں official web console نہیں ہے۔ آپ config file کے ساتھ headscale command سے users اور pre-authentication keys manage کرتے ہیں۔ Community web interfaces موجود ہیں، لیکن وہ project کا حصہ نہیں ہیں۔ یہ ان لوگوں کے لیے موزوں ہے جو اپنی state کو files میں رکھنا اور اپنی تبدیلیاں version control میں manage کرنا چاہتے ہیں۔
NetBird مکمل پروڈکٹ فراہم کرتا ہے: اپنا client، اپنا dashboard، ایک embedded identity provider، اور browser میں ترمیم کی جانے والی access policies۔ اس کا مطلب ہے کہ آپ کے VPS پر زیادہ اجزا چلتے ہیں، لیکن ایسے ساتھی کو یہ نظام دینا کہیں آسان ہے جو کبھی terminal نہیں کھولے گا۔ اگر آپ واقعی NetBird کا موازنہ Headscale کے بجائے hosted Tailscale سے کر رہے ہیں تو دونوں اندرونی طور پر WireGuard چلاتے ہیں۔ اس لیے NetBird بمقابلہ Tailscale کا موازنہ میں ان کا اصل فرق بیان کیا گیا ہے: control plane کون چلاتا ہے، access rules کیسے لکھی جاتی ہیں، اور relays network traffic کیسے منتقل کرتے ہیں۔
اگر آپ پہلے ہی Tailscale clients استعمال کر رہے ہیں یا ممکنہ حد تک چھوٹا control plane چاہتے ہیں تو Headscale چلائیں۔ اگر کئی لوگوں کو peers manage کرنے ہیں اور آپ خود console اور SSO assemble نہیں کرنا چاہتے تو NetBird چلائیں۔ کسی ایک کا انتخاب حتمی کرنے سے پہلے دیکھیں کہ Tailscale کا free plan حقیقت میں کیا فراہم کرتا ہے، کیونکہ چھ users تک محدود non-commercial group hosted control plane کے لیے کچھ ادا نہیں کرتا؛ ابتدا میں user devices کی تعداد unlimited اور 50 tagged resources دستیاب ہوتے ہیں، اس لیے ممکن ہے کہ control plane خود چلانے کی کوئی وجہ نہ ہو۔ اس حد سے آگے bill machines کی تعداد کے بجائے لوگوں کی تعداد کے ساتھ بڑھتا ہے، اس لیے معلوم کریں کہ Tailscale آپ کے group سے کتنی فیس لے گا تاکہ اس رقم کا VPS اور اس stack پر صرف ہونے والے وقت کے مقابلہ میں جائزہ لیا جا سکے۔
یہ کتنے چھوٹے VPS پر چل سکتا ہے؟
دستاویزی کم از کم ضرورت 1 CPU اور 2 GB میموری ہے۔ 2 GB خریدیں۔
چھوٹے سرور پر تین چیزیں چھوڑنا محفوظ ہے۔ NetBird Proxy سروس کو مسترد کریں۔ یہ اندرونی سروسز کو public hostnames پر شائع کرنے کے لیے ہے اور peers کے باہم connect ہونے سے اس کا کوئی تعلق نہیں۔ CrowdSec کو چھوڑ دیں۔ اسکرپٹ اسے صرف proxy کے ساتھ پیش کرتا ہے، اور exposed سرور پر اسے پہلے دن کے بجائے بعد میں شامل کرنا زیادہ مناسب ہے۔ netbird_data volume میں default SQLite store برقرار رکھیں۔ PostgreSQL پر صرف اس وقت منتقل ہوں جب deployment کو متعدد machines پر تقسیم کریں یا واقعی concurrency کا مسئلہ پیش آئے۔ دستاویزات کے مطابق یہ migration بعد میں کی جا سکتی ہے۔
Relay وہ واحد component ہے جسے آپ ہٹا نہیں سکتے۔ اگر دو peers کا NAT ہر destination کے لیے مختلف port مقرر کرے تو وہ کبھی direct tunnel قائم نہیں کر سکیں گے۔ اس لیے relay ہی وہ واحد راستہ ہے جو انہیں کام کرنے دیتا ہے۔ اسے disable کرنے سے memory بہت کم بچتی ہے، لیکن connections اس طرح ٹوٹتے ہیں کہ وجہ تلاش کرنا مشکل ہو جاتی ہے۔
جب ایک سرور کافی نہ رہے تو سب سے پہلے relays کو اس سرور سے منتقل کریں۔ Standalone relay NB_LISTEN_ADDRESS، NB_EXPOSED_ADDRESS، NB_AUTH_SECRET اور NB_ENABLE_STUN کے ساتھ چلتا ہے۔ Shared secret relay اور main server دونوں پر یکساں ہونا چاہیے، ورنہ 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 کھلا ہونے سے یہاں مدد نہیں ملتی۔ Loop میں دوبارہ کوشش کرنے سے پہلے اصل وجہ درست کریں، کیونکہ Let's Encrypt فی hostname، فی account، فی گھنٹہ صرف پانچ ناکام authorizations کی اجازت دیتا ہے۔ اس حد کے دوبارہ دستیاب ہونے تک مسلسل کوشش کرنے سے آپ مزید retries نہیں کر سکیں گے۔
Client کہتا ہے کہ connection قائم ہو گیا ہے، لیکن Dashboard خالی ہے۔ Client نے NetBird کی hosted service کے ساتھ register کیا ہے، کیونکہ --management-url موجود نہیں تھا۔ netbird status --detail چلائیں اور Management: والی line پڑھیں۔ اس میں اس server کا نام ہوتا ہے جس سے client حقیقت میں رابطہ کر رہا ہے۔ 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 بھی دکھاتا ہے۔ اس سے معلوم ہوتا ہے کہ کوشش کہاں تک پہنچی۔ بعض networks میں relayed واحد دستیاب نتیجہ ہوتا ہے، اور اس میں کوئی خرابی نہیں ہوتی۔
ایک peer شامل ہو جاتا ہے، لیکن کسی چیز تک رسائی نہیں کر پاتا۔ Mesh میں شامل ہونا اس بات کی ضمانت نہیں کہ دو peers ایک دوسرے سے بات کر سکتے ہیں۔ اس کا فیصلہ access policies کرتی ہیں، اور جس group کے ساتھ کوئی policy منسلک نہ ہو وہ کسی چیز تک رسائی نہیں پاتا۔ 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 میں جمع کرتا ہے۔
بیک اپس اور اپ گریڈز
پوری تنصیب کے لیے دو چیزیں بنیادی ہیں: وہ directory جس میں docker-compose.yml اور config.yaml موجود ہیں، اور وہ Docker volume جس میں database اور encryption keys موجود ہیں۔ دونوں کا ایک ساتھ بیک اپ لیں۔ config.yaml میں وہ key موجود ہوتی ہے جو store کے حساس data کو encrypt کرتی ہے، اس لیے اس کے بغیر 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 -dCompose volume names کے آغاز میں project directory کا نام شامل کرتا ہے، اس لیے netbird_data کے طور پر documented volume عموماً netbird_netbird_data کے نام سے ظاہر ہوتا ہے۔ پہلے docker volume ls چلائیں اور اس کے output میں دیا گیا نام استعمال کریں، ورنہ اوپر دیا گیا docker run خاموشی سے ایک empty volume بنا دے گا اور کچھ بھی archive نہیں کرے گا۔ Archives کو VPS سے باہر رکھیں۔ اگر آپ کے پاس پہلے سے backup tool موجود ہے تو restic یا BorgBackup offsite backup سنبھال لیتا ہے۔
Server کو upgrade کرنے کے لیے image pull کریں اور container دوبارہ بنائیں:
docker compose pull
docker compose up -d
docker compose psاس پر انحصار کرنے سے پہلے docker compose config | grep image: چلائیں۔ latest پڑھنے والے کسی بھی tag کو version پر pin کریں۔ وجہ وہی ہے جس کی بنا پر آپ نے install script کو pin کیا تھا: آپ کو معلوم ہونا چاہیے کہ کیا چل رہا ہے، اور upgrade میں خرابی آنے پر واپس جانے کے لیے ایک version موجود ہونا چاہیے۔ Clients کو اسی package manager کے ذریعے upgrade کریں جس سے وہ install کیے گئے تھے۔
FAQ
کیا NetBird کو self-host کرنے کے لیے مجھے اپنا identity provider درکار ہے؟
نہیں۔ موجودہ releases میں built-in user store شامل ہے، اس لیے آپ پہلے admin account کو browser میں https://netbird.example.com پر بناتے ہیں اور اس کے بعد dashboard سے users شامل کرتے ہیں۔ External OIDC provider اختیاری ہے۔ آپ اسے بعد میں name، client ID، client secret اور، جہاں ضروری ہو، issuer کے ساتھ شامل کر سکتے ہیں۔ وہ guides جو NetBird سے پہلے Zitadel یا Keycloak deploy کرنے کو کہتی ہیں، اب ایسے setup کی وضاحت کرتی ہیں جس کی ضرورت نہیں رہی۔ ان پر عمل کرنے سے آپ کو چلانے کے لیے ایک اضافی service مل جاتی ہے۔
میرے تمام peers Connection type: Relayed کیوں دکھا رہے ہیں؟
Direct connections قائم نہیں ہو رہیں، اس لیے traffic آپ کے VPS پر موجود relay سے گزر رہا ہے۔ عام وجہ UDP 3478 کا blocked ہونا ہے۔ یہ STUN port ہے جسے peers اپنا public address اور port دریافت کرنے کے لیے استعمال کرتے ہیں۔ اسے VPS firewall اور provider کے الگ network firewall، دونوں پر کھولیں۔ پھر دوبارہ netbird status --detail چلائیں اور Direct: line پڑھیں۔ اگر دونوں peers ایسے NAT کے پیچھے ہوں جو ہر destination کے لیے مختلف port مختص کرتا ہے تو relayed متوقع نتیجہ ہے اور configuration میں کوئی خرابی نہیں۔
میرے client نے connect کیا، لیکن dashboard میں کوئی peer نہیں دکھ رہا۔ کیا ہوا؟
Client نے آپ کے server کے بجائے NetBird کی hosted service کے ساتھ register کیا۔ ایسا اس وقت ہوتا ہے جب --management-url شامل نہ ہو۔ netbird status --detail، Management: line پر اس server کا نام دکھاتا ہے جس سے client رابطہ کر رہا ہے۔ 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 سے manage کرتے ہیں، اس کا کوئی official web console نہیں ہے، اور یہ official Tailscale clients کو چلاتا ہے۔ NetBird اسی stack میں اپنا client، admin dashboard اور identity provider integration فراہم کرتا ہے۔ Headscale چلانے کے لیے چھوٹا ہے اور اپنی state files میں محفوظ رکھتا ہے۔ NetBird ان لوگوں کے لیے زیادہ آسان ہے جو terminal استعمال نہیں کریں گے۔
self-hosted NetBird server کے لیے کس سائز کا VPS درکار ہے؟
دستاویزی minimum 1 CPU اور 2 GB memory ہے، اور خریدنے کے لیے 2 GB ہی مناسب مقدار ہے۔ Install کے دوران optional proxy service کو مسترد کریں۔ اس سے CrowdSec prompt بھی skip ہو جائے گا۔ جب تک واقعی PostgreSQL کی ضرورت نہ ہو، default SQLite store استعمال کرتے رہیں۔