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 को व्यवस्थापक (Administrator) के रूप में खोलना सुनिश्चित करें।

इंस्टॉलेशन के बाद कमांड नहीं मिली

लक्षण: 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 चलाने के बाद कोई ईमेल नहीं आता।

समाधान:

1. अपना स्पैम/जंक फ़ोल्डर जाँचें — सत्यापन ईमेल कभी-कभी फ़िल्टर हो जाते हैं।
2. फिर से अनुरोध करने से पहले 2 मिनट प्रतीक्षा करें। कोड भेजने पर दर सीमा है।
3. सत्यापित करें कि ईमेल पता सही है:

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

4. यदि समस्या बनी रहती है तो एक अलग ईमेल प्रदाता का प्रयास करें।

टोकन समाप्त हो गया

लक्षण: कमांड 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

2. एक अलग नोड या देश का प्रयास करें:

freeguard connect --country SG

3. एक अलग प्रोटोकॉल का प्रयास करें जो आपके नेटवर्क पर बेहतर काम कर सकता है:

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 चलाएँ। आप अपना IP पता बदला है या नहीं यह सत्यापित करने के लिए curl ifconfig.me भी चला सकते हैं।

सिस्टम अपडेट के बाद FreeGuard CLI शुरू नहीं होता। क्या करें?

नवीनतम संस्करण प्राप्त करने के लिए freeguard update चलाएँ। यदि वह विफल होता है, तो इंस्टॉल स्क्रिप्ट के साथ पुनः इंस्टॉल करें: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh।

मैं बग कैसे रिपोर्ट करूँ या सहायता कैसे प्राप्त करूँ?

डायग्नोस्टिक जानकारी एकत्र करने के लिए freeguard debug चलाएँ, फिर वेबसाइट या ईमेल के माध्यम से सहायता से संपर्क करें। तेज़ समाधान के लिए डीबग आउटपुट शामिल करें।

अंतिम अपडेट: मार्च 2026