אירוח עצמי של שרת NetBird VPN על גבי VPS: מדריך מלא
למדו כיצד להקים שרת NetBird על VPS עצמאי. המדריך כולל הגדרות DNS ו-TLS, שימוש ב-setup keys לחיבור אוטומטי, הסבר על סקריפט ההתקנה המהירה והשוואה מול Headscale.
מה מעניק לך אירוח עצמי של שרת ה-VPN מסוג NetBird
אירוח עצמי של שרת ה-NetBird VPN מעביר את מישור הבקרה (control plane) לשרת VPS שבבעלותך: זהו הרכיב שמחזיק את רשימת ה-peers, מחליט איזה מחשב רשאי לתקשר עם איזה, ומסייע לשני peers למצוא זה את זה מאחורי NAT (תרגום כתובות רשת). המנהרות עצמן נותרות מבוססות WireGuard, ומוצפנות ישירות בין המחשבים שלך. השינוי הוא ששום חברה חיצונית אינה מחזיקה במלאי המכשירים שלך או בתהליך ההתחברות שלך. חשוב להבין מה זה מקנה לך, שכן גם במישור בקרה מנוהל (hosted), הספק אינו מחזיק במפתחות שמצפינים את התעבורה שלך, ו-מה שרת תיאום יכול לעשות בפועל אם הוא נפרץ הוא רשימה מצומצמת יותר ממה שרוב האנשים מניחים לפני שהם קוראים על כך.
NetBird ממוקם בין שני דברים שאולי כבר מוכרים לך. זהו mesh overlay, כך ש-peers מתחברים זה לזה במקום להעביר את כל התעבורה דרך gateway יחיד. הוא גם ניתן לאירוח עצמי מקצה לקצה, מה שמעמיד אותו מול Headscale, שרת הבקרה לאירוח עצמי של Tailscale. אם הרצת בעבר רק מנהרה עם gateway יחיד, קרא תחילה את ההבדל בין WireGuard פשוט לבין mesh overlay, כיוון שהמודל המחשבתי הזה הוא מה שהופך את שאר הדף הזה לשימושי.
אם מה שאתה באמת רוצה הוא שרת יחיד שדרכו יוצאת כל התעבורה שלך, mesh הוא מנגנון מורכב יותר ממה שהמשימה דורשת. VPN מבוסס WireGuard פשוט על VPS יחיד או exit node של Tailscale עושים זאת עם הרבה פחות תחזוקה. ואם המטרה היא גישה לרשת פרטית אחת במקום קישור מחשבים זה לזה, subnet router של Tailscale על גבי VPS מפרסם את טווח הכתובות הזה ל-tailnet שכבר יש לך, ללא צורך בכל ה-stack המפורט להלן.
מה ה-stack מריץ בפועל
מבנה המערכת השתנה לאחרונה, ורוב המדריכים הישנים מתארים את המבנה הקודם. נכון לאוקטובר 2026, בבדיקה מול גרסה v0.80.0 ומול גרסה v0.76.2 (הגרסה שעליה מקובע מדריך זה), סקריפט ה-quickstart יוצר קובץ Compose עם שלושה שירותים כברירת מחדל.
netbird-serverמריץ את ה-management API, את שירות ה-signal, את ה-relay עם STUN listener מוטמע, וספק זהות (identity provider) מוטמע. בגרסאות ישנות יותר, אלו היו מכולות נפרדות וספק הזהות היה התקנת Zitadel נפרדת שהיה עליך לבנות תחילה.dashboardהוא ממשק הניהול הוובי.traefikמבצע TLS termination ומבקש תעודה מ-Let's Encrypt בעלייה הראשונה.
קיימים שני שירותים נוספים שנשארים כבויים אלא אם תאשר זאת בהנחיה (prompt). שירות ה-NetBird Proxy מפרסם שירותים פנימיים תחת שמות מארח ציבוריים. CrowdSec מסנן תעבורה עוינת. אף אחד מהם אינו נדרש כדי לבנות mesh תקין, ושניהם צורכים זיכרון בשרת קטן.
אם הגעת מ-wg-easy במכולת Docker יחידה, מדובר בקפיצה במספר הרכיבים. מה שאתה מקבל בתמורה הוא מדיניות גישה, חשבונות לכל משתמש, וצמתים (peers) שמתחברים ישירות זה לזה במקום דרך gateway יחיד.
דרישות קדם
שם מתחם (domain name) ציבורי הוא הכרחי. לוח הבקרה, ה-API וה-relay פועלים כולם על HTTPS בפורט 443, ו-Traefik מנפיק את התעודה מ-Let's Encrypt באמצעות אתגר TLS-ALPN-01. אתגר זה נענה בפורט 443, ולכן נדרש שם מתחם שמצביע על ה-VPS מהאינטרנט הציבורי. כתובת IP חשופה לא תעבוד בתהליך זה.
צרו רשומת A אחת, netbird.example.com, המצביעה על כתובת ה-IPv4 הציבורית של ה-VPS, והמתינו לסיום ההפצה לפני הרצת כל פעולה.
dig +short netbird.example.comהפקודה חייבת להציג את כתובת השרת שלכם. הרצת תוכנית ההתקנה לפני שרשומות ה-DNS הופצו תגרום לכשל בבקשת התעודה בהפעלה הראשונה. ניסיונות אימות חוזרים ונכשלים יובילו לחריגה ממכסות (rate limits) של Let's Encrypt, מה שיחייב אתכם להמתין עד לאיפוס המכסה לפני שתוכלו לנסות שוב.
עבור הגדרת ברירת המחדל, רק שני פורטים צריכים להיות נגישים מהאינטרנט: TCP 443 עבור לוח הבקרה, ה-API, תעבורת ה-signal וה-relay, וכן עבור אתגר התעודה; ופורט UDP 3478 עבור STUN. פורט TCP 80 חייב להיות פנוי מקומית כיוון ש-Traefik מאזין לו, אך אין צורך שהוא יהיה נגיש מהאינטרנט. חסימת גישה ציבורית לפורט 80 רק תמנע את ההפניה האוטומטית מ-HTTP ל-HTTPS.
sudo ufw allow 443/tcp
sudo ufw allow 3478/udp
sudo ufw reload
sudo ufw statusפתחו פורטים אלו גם ב-firewall של ספק השרתים שלכם. זהו רכיב ניהול נפרד ברוב לוחות הבקרה של VPS, וזו הסיבה ששרת שבו ה-ufw status נראה תקין עדיין מסרב לקבל חיבורים.
STUN (ראשי תיבות של Session Traversal Utilities for NAT) הוא האופן שבו עמית (peer) לומד את הכתובת הציבורית והפורט שה-NAT שלו הקצה לו, כדי ששני עמיתים יוכלו לנסות ליצור מנהרה ישירה. חסימת UDP 3478 לא תמנע מהעמיתים להתחבר, שכן הם יעברו דרך ה-relay ב-TCP 443, כך שהמערכת לא תיראה שבורה. עמיתים שלא יצליחו למצוא נתיב ישיר יציגו Connection type: Relayed, ותעבורתם תעבור דרך ה-VPS שלכם במקום ישירות בין העמיתים. עמיתים באותה רשת מקומית (LAN) יוכלו עדיין להתחבר ישירות באמצעות הכתובות המקומיות שלהם.
בצד התוכנה, עליכם להתקין Docker עם תוסף Compose v2, בנוסף ל-jq ו-curl. הסקריפט בודק קיום של Docker, Compose ו-jq ועוצר אם אחד מהם חסר. הוא משתמש ב-curl ללא בדיקה, לכן התקינו אותו מראש. אם Docker חדש בשרת זה, בצעו תחילה את הגדרת Docker Compose ב-VPS.
פורטים אם אתם מוותרים על ה-reverse proxy המובנה
ללא Traefik, השרת המשולב עדיין מרכז את הניהול, ה-signal וה-relay ב-backend אחד של HTTP, כך שרשימת הפורטים כמעט אינה גדלה. קובץ ה-Compose שנוצר מפרסם:
- TCP 8080, לוח הבקרה, מאזין ל-127.0.0.1 כברירת מחדל
- TCP 8081,
netbird-server, מאזין ל-127.0.0.1 כברירת מחדל - UDP 3478, STUN, מפורסם ישירות
ה-proxy שלכם יבצע TLS termination בפורט TCP 443 ויעביר את התעבורה לשני הפורטים המקומיים הללו. STUN לעולם לא עובר דרך ה-proxy, לכן UDP 3478 נשאר פתוח ב-firewall בכל מקרה. מדריכים המפרטים פורטים נפרדים עבור ניהול gRPC, signal gRPC וה-relay מתארים את מבנה ה-multi-container הישן.
בחרו באפשרות זו רק אם השרת כבר מבצע TLS termination עבור שירותים אחרים. אחרת, השימוש ב-Traefik המובנה דורש פחות חוקים ומוביל לפחות טעויות.
התקנת שרת NetBird באמצעות סקריפט ה-quickstart
הפקודה המקוצרת המתועדת מריצה את הגרסה העדכנית ביותר ישירות לתוך ה-shell:
curl -fsSL https://github.com/netbirdio/netbird/releases/latest/download/getting-started.sh | bashבמקום זאת, קבעו גרסה ספציפית. latest משתנה, לכן אותה פקודה שתורץ בהפרש של שבועיים תייצר שתי התקנות שונות, ושום דבר בדיסק לא יתעד איזו מהן יצרה את קובץ התצורה שלכם. הורידו גרסה מתויגת (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הסקריפט מבקש תחילה את שם המתחם:
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 כותבות מקטע תצורה ומשאירות את החיבורים לטיפולכם, ואפשרות 5 כותבת את קובץ ה-Compose, את dashboard.env ואת config.yaml, ומדפיסה את תיעוד ההתקנה למסוף. זה נכון בשרת שכבר מריץ proxy, אך שגוי בשרת חדש. אפשרות 0 מבקשת כתובת דוא"ל, שבה Traefik משתמש כדי להירשם מול חשבון ה-Let's Encrypt שלכם. ההנחיה עדיין מתייחסת לזה כאל כתובת להתראות על תוקף תעודות, אך Let's Encrypt הפסיקה לשלוח הודעות דוא"ל על פקיעת תוקף ב-4 ביוני 2025, לכן בעיות בחידוש יופיעו ב-log של Traefik ולא בתיבת הדואר הנכנס שלכם.
סרבו לשירות ה-NetBird Proxy בהתקנה ראשונה. הוא דורש רשומת DNS נוספת, wildcard מסוג *.netbird.example.com CNAME שמצביע על netbird.example.com, והוא אינו תורם דבר לרשת mesh פשוטה. ההנחיה של CrowdSec מופיעה רק לאחר הפעלת ה-proxy, לכן דחיית ה-proxy מדלגת גם עליה. ניתן להוסיף את שניהם בשלב מאוחר יותר.
הסקריפט כותב לתיקייה הנוכחית: docker-compose.yml, config.yaml עם הרשאות 600, ו-dashboard.env. עם ה-Traefik המצורף הוא מוסיף את traefik-dynamic.yaml ואת proxy.env רק כאשר מפעילים את ה-NetBird Proxy. התייחסו לתיקייה זו כאל מצב (state) שיש לשמור, כיוון ש-config.yaml מכיל את המפתח שמצפין את הנתונים במאגר. אובדן שלו אינו דבר שניתן לתקן באמצעות התקנה מחדש.
docker compose ps
docker compose logs -f netbird-serverכל שירות אמור לקרוא את running, וה-log של השרת אמור להתייצב במקום לבצע אתחול בלולאה. עקבו אחר התעודה בנפרד:
docker compose logs traefik | grep -i acmeACME (automatic certificate management environment) הוא הפרוטוקול ש-Traefik משתמש בו כדי לקבל את התעודה. שגיאות כאן נובעות כמעט תמיד מבעיית DNS או מפורט 443 סגור.
יצירת חשבון מנהל המערכת הראשון
פתחו את https://netbird.example.com. בהתקנה חדשה, דף זה מוביל לדף הגדרה במקום לטופס התחברות. הזינו כתובת דוא"ל, שם וסיסמה, ולאחר מכן לחצו על Create Account. חשבון זה הופך לחשבון מנהל המערכת הראשון, והדף יפנה אתכם לטופס ההתחברות.
חשבון זה מאוחסן במאגר המשתמשים הפנימי של NetBird, המופעל על ידי ספק זהות המוטמע בתוך המכולה netbird-server. אין מעורבות של גורמים חיצוניים. זהו השינוי המשמעותי ביותר בגרסאות ה-self-hosted של NetBird בהשוואה לשנה שעברה, אז התקנה תקינה דרשה הקמה מוקדמת של Zitadel או Keycloak והעתקה של ארבעה ערכי OIDC (OpenID Connect) לתוך setup.env לפני שניתן היה להתחיל בתהליך כלשהו.
אם מופיעה אזהרת תעודת אבטחה בדפדפן במקום דף ההגדרה, סימן שהתעודה לא הונפקה. תקנו זאת לפני שתמשיכו, כיוון שלוח הבקרה מתקשר עם ה-API דרך אותו שם מארח (hostname), ותקלה בתעודה תוביל לשגיאות לא ברורות.
חיבור ה-peer הראשון שלכם
התקינו את ה-client על כל מכונת Linux, כולל ה-VPS עצמו אם ברצונכם לצרף אותו ל-mesh:
curl -fsSL https://pkgs.netbird.io/install.sh | shב-Debian וב-Ubuntu, הסקריפט מגדיר את מאגר החבילות של NetBird ומתקין את ה-client באמצעות apt, כך שמנהל החבילות מנהל את התוכנה בכל מקרה. אם הרצת סקריפט ישירות ל-shell אינה נוחה לכם, שמרו אותו תחילה באמצעות curl -fsSL -o install.sh https://pkgs.netbird.io/install.sh וקראו את תוכנו לפני הרצה עם sh install.sh. כך או כך, ודאו שההתקנה הושלמה:
apt-cache policy netbirdnetbird הוא ה-client של שורת הפקודה וה-daemon. netbird-ui הוא אפליקציית ה-tray לשולחן העבודה, ואין בה צורך בשרת ללא ממשק גרפי (headless).
כעת, כוונו את ה-client לשרת שלכם:
sudo netbird up --management-url https://netbird.example.comהשמטה של --management-url תגרום ל-client להירשם לשירות המנוהל של NetBird, כיוון שזו ברירת המחדל המקודדת בתוכנה. הפקודה תצליח, המכונה תקבל כתובת, אך ה-dashboard שלכם בשרת העצמי יישאר ריק. זו טעות נפוצה מאוד.
הפקודה תציג URL לפתיחה בדפדפן לצורך השלמת ההתחברות. לאחר מכן:
netbird status
ip addr show wt0קראו ארבע שורות מתוך netbird status: Management: Connected, Signal: Connected, שורת Relays: המדווחת על כל ה-relay הזמינים, ו-NetBird IP: בטווח ה-overlay. wt0 הוא ממשק ה-WireGuard ש-NetBird יוצר, והוא אמור לשאת את אותה הכתובת.
צירוף מכונה שנייה ללא השגחה באמצעות מפתח הגדרה (setup key)
התחברות דרך דפדפן אינה אפשרית במכונה ללא ממשק גרפי וללא משתמש נוכח. מפתח הגדרה הוא אסימון אימות מוקדם המרשם מכונה ללא צורך בשלב אינטראקטיבי. ניתן ליצור מפתח כזה בלוח הבקרה תחת Settings → Setup Keys.
קיימים שני סוגי מפתחות. מפתח חד-פעמי מאמת מכונה אחת בדיוק ולאחר מכן מתבטל. מפתח רב-פעמי רושם מכונות רבות, עם אפשרות להגבלת כמות. לשני הסוגים ניתן להגדיר תאריך תפוגה אופציונלי, ושניהם מאפשרים שיוך אוטומטי של המכונה החדשה לקבוצה, כך שחוקי הגישה של אותה קבוצה יחולו ברגע שהמכונה תופיע ברשת.
sudo netbird up --setup-key <SETUP-KEY> \
--management-url https://netbird.example.com \
--hostname build-runner-01הדגל --hostname קובע את השם שיוצג בלוח הבקרה. ללא הגדרה זו, המכונה תשתמש בשם המארח (hostname) שלה, ורשימה של עשרות מכונות שכולן נקראות ubuntu אינה מועילה לאיש.
עבור מכולות (containers) וסוכני בנייה בעלי אורך חיים קצר, יש לסמן את המפתח כ-ephemeral בעת היצירה. מכונות שנרשמו באמצעות מפתח ephemeral יוסרו אוטומטית ברגע שיהיו במצב לא מקוון למשך יותר מ-10 דקות, מה שמונע הצטברות של רשומות מתות ברשימת המכונות.
מגבלה אחת שחשוב להבין לפני תכנון השימוש במפתחות הגדרה: פקיעת תוקף או ביטול של מפתח עוצרים רישומים חדשים, אך אינם מנתקים מכונות שכבר נרשמו באמצעותו. הסרת גישה ממכונה מחייבת הסרה ישירה של אותה מכונה מהרשת.
האם עדיין נדרש ספק זהות נפרד?
עבור התקנה קטנה, לא. מאגר המשתמשים המובנה מטפל בחשבונות שנוצרו מלוח הבקרה, וזה מספיק עבור קבוצה קטנה של אנשים.
יש צורך בספק זהות חיצוני כאשר כבר קיים אחד כזה ולא מעוניינים ברשימת משתמשים שנייה. NetBird מקבלת כל ספק התומך ב־OIDC. יש לרשום לקוח OIDC סודי (confidential) אצל הספק שלכם, ולאחר מכן להוסיף אותו בלוח הבקרה של NetBird עם שם, client ID, client secret, ובמידת הצורך, issuer. NetBird תספק לכם כתובת URL להפניה (redirect URL) שעליכם להדביק בחזרה אצל הספק. קיימות אינטגרציות מוגדרות מראש עבור Google, Microsoft Entra ID, Okta, Zitadel, Keycloak, Authentik ו־Pocket ID, וכל שירות אחר יוגדר כ־OIDC גנרי. אם אתם כבר מריצים את Authentik כפתרון ה-Single Sign-On שלכם, זהו הנתיב שיאפשר לכם לשמור על רשימת חשבונות אחת במקום שתיים.
התחברות מקומית נשארת זמינה לאחר הוספת ספק, וכל ספק שהוגדר יופיע בדף ההתחברות. שמרו חשבון מנהל מקומי אחד עם סיסמה חזקה. כך, במקרה של הגדרת OIDC שגויה, עדיין תהיה לכם דרך גישה למערכת.
NetBird או Headscale: איזה control plane כדאי להריץ?
שניהם מסירים את אותה תלות: שרת הניהול המרוחק שאליו הלקוחות היו מתקשרים כברירת מחדל. עם זאת, מדובר בפרויקטים בעלי אופי שונה.
Headscale הוא מימוש מחדש של שרת הניהול של Tailscale, ואתם ממשיכים להשתמש בלקוחות הרשמיים של Tailscale. אין בו ממשק ניהול גרפי רשמי. ניהול משתמשים ומפתחות אימות מוקדם מתבצע באמצעות הפקודה headscale מול קובץ הגדרות. קיימים ממשקי ניהול קהילתיים, אך הם אינם חלק מהפרויקט. גישה זו מתאימה למי שמעדיף לשמור את מצב המערכת בקבצים ולנהל שינויים באמצעות מערכת בקרת גרסאות.
NetBird משחררת את המוצר המלא: לקוח משלה, לוח בקרה משלה, ספק זהויות משולב ומדיניות גישה שניתן לערוך בדפדפן. המשמעות היא יותר רכיבים ב־VPS שלך, אך גם פחות עבודה כשמעבירים את הניהול לעמית שלא יפתח מסוף לעולם. אם אתם באמת משווים את NetBird ל־Tailscale המתארחת ולא ל־Headscale, שתיהן משתמשות ב־WireGuard מתחת למכסה המנוע, ולכן ההשוואה בין NetBird ל־Tailscale מסבירה היכן הן שונות בפועל: מי מפעיל את מישור הבקרה, כיצד כותבים כללי גישה וכיצד ממסרים מעבירים תעבורת רשת.
הריצו את Headscale אם אתם כבר משתמשים בלקוחות Tailscale או אם אתם מחפשים את ה-control plane המינימלי ביותר. הריצו את NetBird אם מספר אנשים צריכים לנהל את ה-peers ואתם זקוקים ללוח בקרה ול-SSO ללא צורך בהרכבת פתרון עצמאי. לפני שתחליטו, בדקו מה כוללת התוכנית החינמית של Tailscale, שכן קבוצה לא-מסחרית המונה עד שישה משתמשים אינה משלמת דבר על שרת ניהול מרוחק, ומקבלת מכשירי משתמש ללא הגבלה ו-50 משאבים מתויגים כנקודת התחלה; ייתכן שאין לכם כל סיבה להריץ שרת כזה בעצמכם. מעבר למגבלה זו, העלות גדלה לפי מספר האנשים ולא לפי מספר המכונות, לכן חישוב העלות של Tailscale עבור הקבוצה שלכם יספק לכם נתון שתוכלו לשקול מול עלות ה-VPS והזמן שתשקיעו בתחזוקת המערכת.
מהו הגודל המינימלי של VPS להרצת המערכת?
המינימום המתועד הוא 1 CPU ו-2 GB זיכרון. מומלץ לרכוש 2 GB.
ניתן לוותר בבטחה על שלושה רכיבים בשרת קטן. ניתן לדלג על שירות ה-NetBird Proxy, שנועד לפרסם שירותים פנימיים תחת שמות מתחם ציבוריים ואינו קשור לחיבור ישיר בין עמיתים (peers). ניתן לוותר על CrowdSec, שהסקריפט מציע רק לצד ה-proxy, ושכדאי להוסיף לשרת חשוף בשלב מאוחר יותר ולא ביום הראשון. השאירו את מאגר ה-SQLite המוגדר כברירת מחדל בנפח ה-netbird_data, ועברו ל-PostgreSQL רק כאשר תפצלו את הפריסה בין מכונות שונות או כאשר תגיעו לעומס עבודה משמעותי; תהליך זה מתועד כמיגרציה שניתן לבצע בהמשך.
ה-relay הוא הרכיב היחיד שאין להסיר. שני עמיתים שמאחורי NAT המקצה פורט שונה לכל יעד לא יצליחו ליצור מנהרה ישירה, ולכן ה-relay הוא הנתיב היחיד המאפשר להם לעבוד. השבתתו חוסכת מעט מאוד זיכרון וגורמת לניתוקים שקשה לאתר את מקורם.
כאשר שרת אחד אינו מספיק עוד, ה-relays הם הרכיב הראשון שכדאי להעביר למכונה נפרדת. relay עצמאי רץ עם NB_LISTEN_ADDRESS, NB_EXPOSED_ADDRESS, NB_AUTH_SECRET ו-NB_ENABLE_STUN. ה-shared secret חייב להיות זהה ב-relay ובשרת הראשי, אחרת לקוחות לא יצליחו לבצע אימות מולו.
מצבי כשל ומה שניתן לראות
לוח הבקרה מציג אזהרת תעודה. Traefik לא הצליח להנפיק תעודה. הריצו את docker compose logs traefik | grep -i acme. יש לכך שתי סיבות אפשריות. או ש־dig +short netbird.example.com עדיין לא מצביע על ה-VPS הזה, או שפורט TCP 443 חסום איפשהו בדרך בין Let's Encrypt לבין המכולה, בדרך כלל ב-firewall של ספק התשתית ולא ב-ufw. האתגר (challenge) נענה על פורט 443, לכן פורט 80 פתוח לא יסייע כאן. תקנו את מקור הבעיה לפני שתנסו שוב בלולאה, כיוון ש-Let's Encrypt מאפשרת רק חמש הרשאות כושלות לשם מתחם לכל חשבון בשעה, וניסיונות חוזרים בלולאה יחסמו אתכם מביצוע ניסיונות נוספים עד להתאפסות המכסה.
הלקוח מדווח על חיבור, אך לוח הבקרה ריק. הלקוח נרשם לשירות המנוהל של NetBird, כיוון ש---management-url היה חסר. הריצו את netbird status --detail וקראו את השורה Management:, המציינת את השרת שאליו הוא מתחבר בפועל. אם מופיע Management: Connected to https://api.netbird.io:443, המשמעות היא שהלקוח פנה לענן. הריצו את sudo netbird down, ולאחר מכן שוב את sudo netbird up --management-url https://netbird.example.com.
כל עמית (peer) מציג Connection type: Relayed. לא נוצרים מנהרות ישירות, ולכן כל התעבורה עוברת דרך ה-VPS שלכם ומוסיפה השהיה (latency). בדקו את פורט UDP 3478 ב-firewall של ה-VPS וב-firewall של ספק התשתית, שכן STUN הוא המנגנון המאפשר לעמית ללמוד את כתובת ה-IP הציבורית והפורט שלו. הפקודה netbird status --detail מדפיסה גם את Direct: false ואת סוגי ה-ICE (interactive connectivity establishment) candidate עבור כל עמית, מה שמראה עד איזה שלב הגיע הניסיון. ברשתות מסוימות, relayed הוא התוצאה היחידה האפשרית ואין בכך תקלה.
עמית מצטרף אך לא מצליח להגיע לשום יעד. הימצאות ב-mesh לא מבטיחה ששני עמיתים יכולים לתקשר. מדיניות גישה (access policies) קובעת זאת, וקבוצה ללא מדיניות משויכת לא תגיע לשום מקום. בדקו את המדיניות בלוח הבקרה לפני שאתם מתחילים לנפות שגיאות בניתובים וב-firewall.
netbird status מדווח על בעיית daemon. השירות אינו רץ. השתמשו ב-sudo netbird service status וב-sudo netbird service start. לוגים של הלקוח נמצאים ב-/var/log/netbird/client.log. עבור כל דבר שאינכם מצליחים לאתר, netbird debug bundle --anonymize --system-info אוסף לוגים, סטטוס, ניתובים, הגדרות DNS ומצב ה-firewall לארכיון אחד.
גיבויים ושדרוגים
שני דברים מחזיקים את כל ההתקנה: הספרייה המכילה את docker-compose.yml ואת config.yaml, וה־volume של Docker שמחזיק את מסד הנתונים ואת מפתחות ההצפנה. בצעו להם גיבוי יחד. config.yaml מחזיק את המפתח שמצפין נתונים רגישים במאגר, לכן עותק של מסד הנתונים בלעדיו לא יוכל לשחזר מפתחות הגדרה מוצפנים ו־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 מוסיפה קידומת של שם ספריית הפרויקט לשמות ה־volumes, לכן ה־volume המתועד כ־netbird_data מופיע בדרך כלל כ־netbird_netbird_data. הריצו תחילה את docker volume ls והשתמשו בשם שהוא מדפיס, אחרת ה־docker run שלעיל ייכשל על ידי יצירה שקטה של volume ריק וגיבוי של שום דבר. שמרו את הארכיונים מחוץ ל־VPS. אם כבר יש לכם כלי גיבוי, restic או BorgBackup יטפלו בחלק של האחסון מחוץ לאתר.
שדרוג השרת הוא פעולת pull ו־recreate:
docker compose pull
docker compose up -d
docker compose psלפני שתסתמכו על כך, הריצו את docker compose config | grep image:. כל תגית שכתוב בה latest צריכה להיות מקובעת (pinned) לגרסה מסוימת, מאותה סיבה שקיבעתם את סקריפט ההתקנה: אתם רוצים לדעת מה רץ, ואתם רוצים גרסה לחזור אליה כאשר שדרוג מתנהג בצורה לא תקינה. לקוחות משתדרגים דרך מנהל החבילות שדרכו הם הותקנו.
FAQ
האם אני זקוק לספק זהות משלי כדי לארח את NetBird באופן עצמאי?
לא. הגרסאות הנוכחיות כוללות מאגר משתמשים מובנה, כך שניתן ליצור את חשבון הניהול הראשון בדפדפן בכתובת https://netbird.example.com ולהוסיף משתמשים מלוח הבקרה לאחר מכן. ספק OIDC חיצוני הוא אופציונלי וניתן להוסיף אותו בשלב מאוחר יותר באמצעות שם, client ID, client secret ובמידת הצורך, issuer. מדריכים המנחים לפרוס את Zitadel או Keycloak לפני NetBird מתארים הגדרה שכבר אינה נדרשת, וביצועם גורר הפעלה של שירות נוסף ומיותר.
מדוע כל ה־peers שלי מציגים Connection type: Relayed?
חיבורים ישירים אינם נוצרים, ולכן התעבורה עוברת דרך ה־relay בשרת ה-VPS שלכם. הסיבה הנפוצה לכך היא חסימה של פורט UDP 3478, שהוא פורט ה-STUN שבו ה-peers משתמשים כדי לגלות את הכתובת הציבורית והפורט שלהם. פתחו אותו ב-firewall של ה-VPS וב-firewall הרשתי החיצוני של ספק הענן, לאחר מכן הריצו שוב את netbird status --detail וקראו את השורה Direct:. כאשר שני ה-peers נמצאים מאחורי NAT שמקצה פורט שונה לכל יעד, מצב relayed הוא התוצאה הצפויה ואין כאן שגיאת תצורה.
הלקוח שלי התחבר אך לוח הבקרה לא מציג peers. מה קרה?
הלקוח נרשם לשירות המנוהל של NetBird במקום לשרת שלכם, מה שקורה כאשר משמיטים את --management-url. הפקודה netbird status --detail מציגה את השרת שאליו הלקוח מתקשר בשורה Management:, כך שערך כמו https://api.netbird.io:443 מאשר זאת. הריצו את sudo netbird down, לאחר מכן את sudo netbird up --management-url https://netbird.example.com, וה-peer יופיע בלוח הבקרה שלכם.
במה שונה NetBird בניהול עצמי מ-Headscale?
שניהם מחליפים שרת בקרה מנוהל בשרת שאתם מריצים בעצמכם. Headscale הוא מישור בקרה בלבד: אתם מנהלים אותו באמצעות הפקודה headscale וקובץ תצורה, אין לו ממשק ניהול רשמי, והוא מניע את לקוחות Tailscale הרשמיים. NetBird מספקת לקוח משלה, לוח בקרה למנהלים ואינטגרציה עם ספקי זהות באותה חבילה. Headscale קל יותר להרצה ושומר את המצב שלו בקבצים. NetBird נגיש יותר למשתמשים שאינם מעוניינים להשתמש בטרמינל.
איזה גודל VPS נדרש עבור שרת NetBird בניהול עצמי?
המינימום המתועד הוא 1 CPU ו-2 GB זיכרון, ו-2 GB הוא הערך המומלץ לרכישה. וותרו על שירות ה-proxy האופציונלי במהלך ההתקנה, מה שגם ידלג על ההנחיה של CrowdSec, והישארו עם מאגר ה-SQLite המוגדר כברירת מחדל עד שתזדקקו בפועל ל-PostgreSQL.