FreeGuard CLI hibaelhárítás

Problémái vannak a FreeGuard CLI-vel? Ez az útmutató a leggyakoribb problémákat és megoldásaikat mutatja be. Minden probléma esetén először próbálja meg futtatni a freeguard doctor parancsot — automatikusan észleli a legtöbb konfigurációs és környezeti problémát.

Telepítési problémák

Hozzáférés megtagadva a telepítés során

Tünet: A telepítő szkript Permission denied vagy EACCES hibával sikertelen.

Megoldás: macOS/Linux rendszeren a telepítőnek írási jogosultságra van szüksége a /usr/local/bin könyvtárhoz. Futtassa emelt jogosultságokkal:

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

Windows rendszeren győződjön meg róla, hogy a PowerShellt rendszergazdaként nyitja meg a telepítési parancs futtatása előtt.

Parancs nem található a telepítés után

Tünet: A freeguard futtatása command not found vagy not recognized hibaüzenetet ad.

Doctor kimenet:

✗ CLI binary:     Not in PATH

Megoldás: A bináris fájl lehet, hogy nincs a shell PATH-jában. Adja hozzá kézzel:

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

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

Windows rendszeren adja hozzá a %USERPROFILE%\.freeguard\bin elérési utat a rendszer PATH környezeti változójához, és indítsa újra a terminált.

curl sikertelen vagy a letöltés időtúllépés

Tünet: A telepítő szkript nem tudja letölteni a bináris fájlt.

Megoldás: Ha vállalati tűzfal mögött van vagy korlátozott hálózatban, töltse le a bináris fájlt kézzel a GitHub Releases oldalról, és helyezze a ~/.freeguard/bin/ mappába. Ezután tegye futtathatóvá:

chmod +x ~/.freeguard/bin/freeguard

Bejelentkezési problémák

Ellenőrző kód nem érkezett meg

Tünet: A freeguard login --email [email protected] --send-code futtatása után nem érkezik e-mail.

Megoldás:

Ellenőrizze a spam/levélszemét mappát — az ellenőrző e-maileket néha kiszűrik.
Várjon 2 percet az újbóli kérés előtt. A kódküldésre sebességkorlát vonatkozik.
Ellenőrizze, hogy az e-mail cím helyes-e:

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

Próbáljon meg egy másik e-mail szolgáltatót, ha a probléma fennáll.

Token lejárt

Tünet: A parancsok Authentication expired vagy Token invalid hibával sikertelenek.

Doctor kimenet:

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

Megoldás: Jelentkezzen be újra a hitelesítő adatok frissítéséhez:

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

Rossz e-mail — nem található előfizetés

Tünet: A bejelentkezés sikeres, de a freeguard connect azt mondja: No active subscription.

Doctor kimenet:

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

Megoldás: Győződjön meg róla, hogy ugyanazzal az e-mail címmel jelentkezik be, amellyel az előfizetést vásárolta. Ha másik e-mailt használt:

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

Kapcsolódási problémák

Kapcsolat időtúllépés

Tünet: A freeguard connect lefagy vagy Connection timed out hibaüzenetet ad.

Doctor kimenet:

✗ Network:         Internet not reachable

Megoldás:

Ellenőrizze az alapvető internetkapcsolatot (először válassza le a VPN-t):

freeguard disconnect
ping 8.8.8.8

Próbáljon egy másik csomópontot vagy országot:

freeguard connect --country SG

Próbáljon egy másik protokollt, amely jobban működhet a hálózatán:

freeguard connect --protocol hysteria2

A 7890-es port már használatban van

Tünet: A freeguard connect Port 7890 is already in use hibával sikertelen.

Doctor kimenet:

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

Megoldás: Egy másik proxy alkalmazás használja az alapértelmezett portot. Állítsa le a másik alkalmazást, vagy változtassa meg a FreeGuard proxy portját:

freeguard config set proxy.port 8080
freeguard connect

DNS-szivárgás észlelve

Tünet: A DNS-lekérdezések megkerülik a VPN-alagutat.

Megoldás: Váltson biztonságos DNS-konfigurációra:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Ellenőrizheti, hogy a DNS a VPN-en keresztül van-e irányítva:

freeguard doctor

Keresse a DNS ellenőrzést a kimenetben, hogy megerősítse a helyes működést.

Jogosultsági problémák

A TUN mód sudo-t igényel

Tünet: A freeguard connect --tun Permission denied: TUN device hibával sikertelen.

Doctor kimenet:

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

Megoldás: A TUN mód virtuális hálózati interfészt hoz létre, amihez emelt jogosultságok szükségesek:

# macOS/Linux
sudo freeguard connect --tun

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

Ha nincs szüksége rendszerszintű VPN-lefedettségre, használja az alapértelmezett rendszer proxy módot (sudo nem szükséges):

freeguard connect

1024 alatti port emelt jogosultságot igényel

Tünet: Az 1024 alatti proxy port beállítása Permission denied hibával sikertelen.

Megoldás: Az 1024 alatti portok a legtöbb operációs rendszeren korlátozottak. Használjon 1024 feletti portot:

freeguard config set proxy.port 7890

Vagy futtassa emelt jogosultságokkal, ha kifejezetten alacsony portra van szüksége:

sudo freeguard connect

Még mindig elakadt?

Ha a freeguard doctor és a fenti megoldások nem oldják meg a problémát, hagyja, hogy az AI automatikusan diagnosztizálja.

Látogasson el a FreeGuard CLI Agent oldalra, és írja le a problémáját. Az ügynök el tudja olvasni a freeguard doctor --json kimenetét, és lépésről lépésre végigvezeti a megoldáson.

Az interaktív hibaelhárítási varázslót is futtathatja:

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

Gyakran ismételt kérdések

Miért mondja a FreeGuard CLI, hogy “connection refused”?

Ez általában azt jelenti, hogy a VPN-szerver átmenetileg nem elérhető. Próbálja a freeguard connect --server auto parancsot a legjobb elérhető szerver automatikus kiválasztásához, vagy ellenőrizze a tűzfal beállításait.

Hogyan ellenőrizhetem, hogy a VPN-kapcsolatom működik-e?

Futtassa a freeguard status parancsot a kapcsolat állapotának, az aktuális szerver és protokoll megtekintéséhez. A curl ifconfig.me parancssal is ellenőrizheti, hogy az IP-címe megváltozott-e.

A FreeGuard CLI nem indul el rendszerfrissítés után. Mit tegyek?

Futtassa a freeguard update parancsot a legújabb verzió beszerzéséhez. Ha ez sikertelen, telepítse újra a telepítő szkripttel: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Hogyan jelenthetek hibát vagy kérhetek segítséget?

Futtassa a freeguard debug parancsot a diagnosztikai információk összegyűjtéséhez, majd lépjen kapcsolatba a támogatással a weboldalon vagy e-mailben. Mellékelje a debug kimenetet a gyorsabb megoldás érdekében.

Utolsó frissítés: 2026. március