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 پر، اپنے سسٹم PATH ماحولیاتی متغیر میں %USERPROFILE%\.freeguard\bin شامل کریں اور ٹرمینل دوبارہ شروع کریں۔

curl ناکام ہو جاتا ہے یا ڈاؤن لوڈ ٹائم آؤٹ ہو جاتا ہے

علامت: انسٹال اسکرپٹ بائنری ڈاؤن لوڈ نہیں کر سکتا۔

حل: اگر آپ کارپوریٹ فائر وال کے پیچھے ہیں یا محدود نیٹ ورک میں ہیں، تو GitHub Releases صفحے سے دستی طور پر بائنری ڈاؤن لوڈ کریں اور اسے ~/.freeguard/bin/ میں رکھیں۔ پھر اسے قابل عمل بنائیں:

chmod +x ~/.freeguard/bin/freeguard

لاگ ان مسائل

تصدیقی کوڈ موصول نہیں ہوا

علامت: freeguard login --email [email protected] --send-code چلانے کے بعد کوئی ای میل نہیں آتی۔

حل:

اپنا سپیم/جنک فولڈر چیک کریں — تصدیقی ای میلز کبھی کبھی فلٹر ہو جاتی ہیں۔
دوبارہ درخواست کرنے سے پہلے 2 منٹ انتظار کریں۔ کوڈ بھیجنے پر شرح کی حد ہے۔
یقینی بنائیں کہ ای میل ایڈریس درست ہے:

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

اگر مسئلہ برقرار رہے تو مختلف ای میل فراہم کنندہ آزمائیں۔

ٹوکن ختم ہو گیا

علامت: کمانڈز 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

حل:

اپنا بنیادی انٹرنیٹ کنکشن چیک کریں (پہلے VPN منقطع کریں):

freeguard disconnect
ping 8.8.8.8

مختلف نوڈ یا ملک آزمائیں:

freeguard connect --country SG

مختلف پروٹوکول آزمائیں جو آپ کے نیٹ ورک پر بہتر کام کر سکتا ہے:

freeguard connect --protocol hysteria2

پورٹ 7890 پہلے سے استعمال میں ہے

علامت: freeguard connect Port 7890 is already in use کے ساتھ ناکام ہو جاتا ہے۔

Doctor آؤٹ پٹ:

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

حل: کوئی اور proxy ایپلیکیشن ڈیفالٹ پورٹ استعمال کر رہی ہے۔ یا تو دوسری ایپلیکیشن بند کریں، یا FreeGuard proxy پورٹ تبدیل کریں:

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 سے کم پورٹ کے لیے بلند مراعات درکار

علامت: 1024 سے کم proxy پورٹ سیٹ کرنا 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 چلائیں، پھر ویب سائٹ یا ای میل کے ذریعے سپورٹ سے رابطہ کریں۔ تیز حل کے لیے ڈیبگ آؤٹ پٹ شامل کریں۔

آخری اپ ڈیٹ: مارچ 2026