FreeGuard VPN
ביתצמתות VPNמחירון
פתרון בעיות FreeGuard CLI
נתקלת בבעיות עם FreeGuard CLI? מדריך זה מכסה את הבעיות הנפוצות ביותר ואת הפתרונות שלהן. לכל בעיה, נסה קודם להריץ `freeguard doctor` — הוא מזהה אוטומטית את רוב בעיות התצורה והסביבה.
תוכן העניינים

פתרון בעיות FreeGuard CLI

נתקלת בבעיות עם FreeGuard CLI? מדריך זה מכסה את הבעיות הנפוצות ביותר ואת הפתרונות שלהן. לכל בעיה, נסה קודם להריץ freeguard doctor — הוא מזהה אוטומטית את רוב בעיות התצורה והסביבה.

בעיות התקנה

הרשאה נדחתה בזמן ההתקנה

סימפטום: סקריפט ההתקנה נכשל עם Permission denied או EACCES.

פתרון: ב-macOS/Linux, המתקין צריך הרשאות כתיבה ל-/usr/local/bin. הפעל עם הרשאות מוגברות:

curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sudo sh

ב-Windows, וודא שאתה פותח את PowerShell כמנהל מערכת לפני הפעלת פקודת ההתקנה.

הפקודה לא נמצאה לאחר ההתקנה

סימפטום: הפעלת freeguard מחזירה command not found או not recognized.

פלט Doctor:

✗ CLI binary:     Not in PATH

פתרון: הקובץ הבינארי עשוי לא להיות ב-PATH של המעטפת שלך. הוסף אותו ידנית:

# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"

# Then reload your shell
source ~/.zshrc  # or ~/.bashrc

ב-Windows, הוסף את %USERPROFILE%\.freeguard\bin למשתנה הסביבה PATH של המערכת והפעל מחדש את הטרמינל.

curl נכשל או הורדה פגת זמן

סימפטום: סקריפט ההתקנה לא מצליח להוריד את הקובץ הבינארי.

פתרון: אם אתה מאחורי חומת אש ארגונית או ברשת מוגבלת, הורד את הקובץ הבינארי ידנית מ-דף הגרסאות ב-GitHub ושים אותו ב-~/.freeguard/bin/. לאחר מכן הפוך אותו לניתן להפעלה:

chmod +x ~/.freeguard/bin/freeguard

בעיות התחברות

קוד אימות לא התקבל

סימפטום: לאחר הפעלת freeguard login --email [email protected] --send-code, לא מגיע דוא"ל.

פתרון:

  1. בדוק את תיקיית הספאם/דואר הזבל — דוא"ל אימות מסונן לפעמים.
  2. המתן 2 דקות לפני בקשה חוזרת. יש מגבלת קצב על שליחת קודים.
  3. וודא שכתובת הדוא"ל נכונה:
freeguard login --email [email protected] --send-code
  1. נסה ספק דוא"ל אחר אם הבעיה נמשכת.

טוקן פג תוקף

סימפטום: פקודות נכשלות עם Authentication expired או Token invalid.

פלט Doctor:

✗ Credentials:     Token expired (last refresh: 2026-03-01)

פתרון: התחבר מחדש כדי לרענן את האישורים שלך:

freeguard logout
freeguard login --email [email protected] --send-code

דוא"ל שגוי — לא נמצא מנוי

סימפטום: ההתחברות מצליחה אבל freeguard connect אומר No active subscription.

פלט Doctor:

✓ Credentials:     Logged in (email: u***@example.com)
✗ Subscription:    No active subscription found

פתרון: וודא שאתה מתחבר עם אותו דוא"ל שבו השתמשת לרכישת המנוי. אם השתמשת בדוא"ל אחר:

freeguard logout
freeguard login --email [email protected] --send-code

בעיות חיבור

פסק זמן חיבור

סימפטום: freeguard connect נתקע או מחזיר Connection timed out.

פלט Doctor:

✗ Network:         Internet not reachable

פתרון:

  1. בדוק את חיבור האינטרנט הבסיסי שלך (נתק את ה-VPN קודם):
freeguard disconnect
ping 8.8.8.8
  1. נסה צומת או מדינה אחרת:
freeguard connect --country SG
  1. נסה פרוטוקול אחר שעשוי לעבוד טוב יותר ברשת שלך:
freeguard connect --protocol hysteria2

פורט 7890 כבר בשימוש

סימפטום: freeguard connect נכשל עם Port 7890 is already in use.

פלט Doctor:

✗ Port 7890:       In use by another process (PID: 12345)

פתרון: יישום proxy אחר משתמש בפורט ברירת המחדל. או עצור את היישום האחר, או שנה את פורט ה-proxy של FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

זוהתה דליפת DNS

סימפטום: שאילתות DNS עוקפות את מנהרת ה-VPN.

פתרון: עבור לתצורת DNS מאובטחת:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

תוכל לוודא ש-DNS מנותב דרך ה-VPN:

freeguard doctor

חפש את בדיקת ה-DNS בפלט כדי לאשר שהיא עובדת כראוי.

בעיות הרשאות

מצב TUN דורש sudo

סימפטום: freeguard connect --tun נכשל עם Permission denied: TUN device.

פלט Doctor:

✗ TUN permission:  Not available (run with sudo for TUN mode)

פתרון: מצב TUN יוצר ממשק רשת וירטואלי, מה שדורש הרשאות מוגברות:

# macOS/Linux
sudo freeguard connect --tun

# Windows — run PowerShell as Administrator
freeguard connect --tun

אם אינך צריך כיסוי VPN ברמת המערכת, השתמש במצב proxy המערכת בברירת מחדל (ללא צורך ב-sudo):

freeguard connect

פורט מתחת ל-1024 דורש הרשאות מוגברות

סימפטום: הגדרת פורט proxy מתחת ל-1024 נכשלת עם Permission denied.

פתרון: פורטים מתחת ל-1024 מוגבלים ברוב מערכות ההפעלה. השתמש בפורט מעל 1024:

freeguard config set proxy.port 7890

או הפעל עם הרשאות מוגברות אם אתה צריך ספציפית פורט נמוך:

sudo freeguard connect

עדיין תקוע?

אם freeguard doctor והפתרונות לעיל לא פותרים את הבעיה שלך, תן ל-AI לאבחן אותה אוטומטית.

בקר בדף FreeGuard CLI Agent ותאר את הבעיה שלך. הסוכן יכול לקרוא את פלט freeguard doctor --json ולהדריך אותך צעד אחר צעד לפתרון.

תוכל גם להפעיל את אשף פתרון הבעיות האינטראקטיבי:

freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat

שאלות נפוצות

למה FreeGuard CLI אומר “connection refused”?

זה בדרך כלל אומר ששרת ה-VPN אינו זמין זמנית. נסה freeguard connect --server auto לבחירה אוטומטית של השרת הטוב ביותר הזמין, או בדוק את הגדרות חומת האש שלך.

איך אני בודק אם חיבור ה-VPN שלי עובד?

הפעל freeguard status כדי לראות את מצב החיבור, השרת הנוכחי והפרוטוקול. תוכל גם להפעיל curl ifconfig.me כדי לוודא שכתובת ה-IP שלך השתנתה.

FreeGuard CLI לא מתחיל לאחר עדכון מערכת. מה עלי לעשות?

הפעל freeguard update כדי לקבל את הגרסה האחרונה. אם זה נכשל, התקן מחדש עם סקריפט ההתקנה: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

איך אני מדווח על באג או מקבל עזרה?

הפעל freeguard debug כדי לאסוף מידע אבחוני, ואז צור קשר עם התמיכה דרך האתר או הדוא"ל. צרף את פלט ה-debug לפתרון מהיר יותר.

עודכן לאחרונה: מרץ 2026