Řešení problémů s FreeGuard CLI

Máte problémy s FreeGuard CLI? Tento průvodce pokrývá nejčastější problémy a jejich řešení. U každého problému nejprve zkuste spustit freeguard doctor — automaticky detekuje většinu problémů s konfigurací a prostředím.

Problémy s instalací

Odepřen přístup při instalaci

Příznak: Instalační skript selže s Permission denied nebo EACCES.

Řešení: Na macOS/Linux potřebuje instalátor oprávnění k zápisu do /usr/local/bin. Spusťte se zvýšenými oprávněními:

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

Na Windows se ujistěte, že otevřete PowerShell jako správce před spuštěním instalačního příkazu.

Příkaz nenalezen po instalaci

Příznak: Spuštění freeguard vrátí command not found nebo not recognized.

Výstup Doctor:

✗ CLI binary:     Not in PATH

Řešení: Binární soubor nemusí být v PATH vašeho shellu. Přidejte ho ručně:

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

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

Na Windows přidejte %USERPROFILE%\.freeguard\bin do systémové proměnné prostředí PATH a restartujte terminál.

curl selže nebo vyprší časový limit stahování

Příznak: Instalační skript nemůže stáhnout binární soubor.

Řešení: Pokud jste za firemním firewallem nebo v omezené síti, stáhněte binární soubor ručně ze stránky vydání na GitHubu a umístěte ho do ~/.freeguard/bin/. Poté ho nastavte jako spustitelný:

chmod +x ~/.freeguard/bin/freeguard

Problémy s přihlášením

Ověřovací kód nebyl doručen

Příznak: Po spuštění freeguard login --email [email protected] --send-code nepřijde žádný e-mail.

Řešení:

Zkontrolujte složku spam/nevyžádaná pošta — ověřovací e-maily se někdy filtrují.
Počkejte 2 minuty před dalším požadavkem. Existuje limit frekvence odesílání kódů.
Ověřte správnost e-mailové adresy:

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

Zkuste jiného poskytovatele e-mailu, pokud problém přetrvává.

Vypršený token

Příznak: Příkazy selžou s Authentication expired nebo Token invalid.

Výstup Doctor:

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

Řešení: Přihlaste se znovu pro obnovení přihlašovacích údajů:

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

Špatný e-mail — předplatné nenalezeno

Příznak: Přihlášení je úspěšné, ale freeguard connect hlásí No active subscription.

Výstup Doctor:

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

Řešení: Ujistěte se, že se přihlašujete stejným e-mailem, který jste použili k nákupu předplatného. Pokud jste použili jiný e-mail:

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

Problémy s připojením

Vypršení časového limitu připojení

Příznak: freeguard connect visí nebo vrátí Connection timed out.

Výstup Doctor:

✗ Network:         Internet not reachable

Řešení:

Zkontrolujte základní internetové připojení (nejprve odpojte VPN):

freeguard disconnect
ping 8.8.8.8

Zkuste jiný uzel nebo zemi:

freeguard connect --country SG

Zkuste jiný protokol, který může na vaší síti fungovat lépe:

freeguard connect --protocol hysteria2

Port 7890 je již používán

Příznak: freeguard connect selže s Port 7890 is already in use.

Výstup Doctor:

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

Řešení: Jiná proxy aplikace používá výchozí port. Buď zastavte druhou aplikaci, nebo změňte proxy port FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

Detekován únik DNS

Příznak: DNS dotazy obcházejí VPN tunel.

Řešení: Přepněte na zabezpečenou konfiguraci DNS:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Můžete ověřit, že DNS je směrován přes VPN:

freeguard doctor

Vyhledejte kontrolu DNS ve výstupu a potvrďte, že funguje správně.

Problémy s oprávněními

Režim TUN vyžaduje sudo

Příznak: freeguard connect --tun selže s Permission denied: TUN device.

Výstup Doctor:

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

Řešení: Režim TUN vytváří virtuální síťové rozhraní, což vyžaduje zvýšená oprávnění:

# macOS/Linux
sudo freeguard connect --tun

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

Pokud nepotřebujete celosystémové VPN pokrytí, použijte výchozí režim systémového proxy (bez sudo):

freeguard connect

Port pod 1024 vyžaduje zvýšená oprávnění

Příznak: Nastavení proxy portu pod 1024 selže s Permission denied.

Řešení: Porty pod 1024 jsou na většině operačních systémů omezeny. Použijte port nad 1024:

freeguard config set proxy.port 7890

Nebo spusťte se zvýšenými oprávněními, pokud specificky potřebujete nízký port:

sudo freeguard connect

Stále máte problém?

Pokud freeguard doctor a výše uvedená řešení váš problém nevyřeší, nechte AI diagnostikovat ho automaticky.

Navštivte stránku FreeGuard CLI Agent a popište svůj problém. Agent může přečíst výstup freeguard doctor --json a provést vás opravou krok za krokem.

Můžete také spustit interaktivního průvodce řešením problémů:

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

Často kladené otázky

Proč FreeGuard CLI hlásí “connection refused”?

To obvykle znamená, že VPN server je dočasně nedostupný. Zkuste freeguard connect --server auto pro automatický výběr nejlepšího dostupného serveru, nebo zkontrolujte nastavení firewallu.

Jak zjistím, zda mé VPN připojení funguje?

Spusťte freeguard status pro zobrazení stavu připojení, aktuálního serveru a protokolu. Můžete také spustit curl ifconfig.me pro ověření, že se vaše IP adresa změnila.

FreeGuard CLI se nespustí po aktualizaci systému. Co mám dělat?

Spusťte freeguard update pro získání nejnovější verze. Pokud to selže, přeinstalujte pomocí instalačního skriptu: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Jak nahlásit chybu nebo získat pomoc?

Spusťte freeguard debug pro sběr diagnostických informací a poté kontaktujte podporu prostřednictvím webu nebo e-mailu. Pro rychlejší vyřešení přiložte diagnostický výstup.

Poslední aktualizace: březen 2026