Rozwiązywanie problemów z FreeGuard CLI

Masz problemy z FreeGuard CLI? Ten przewodnik obejmuje najczęstsze problemy i ich rozwiązania. Przy każdym problemie najpierw spróbuj uruchomić freeguard doctor — automatycznie wykrywa większość problemów z konfiguracją i środowiskiem.

Problemy z instalacją

Odmowa uprawnień podczas instalacji

Objaw: Skrypt instalacyjny kończy się błędem Permission denied lub EACCES.

Rozwiązanie: Na macOS/Linux instalator potrzebuje uprawnień zapisu do /usr/local/bin. Uruchom z podwyższonymi uprawnieniami:

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

Na Windows upewnij się, że otwierasz PowerShell jako Administrator przed uruchomieniem polecenia instalacji.

Polecenie nie znalezione po instalacji

Objaw: Uruchomienie freeguard zwraca command not found lub not recognized.

Wynik Doctor:

✗ CLI binary:     Not in PATH

Rozwiązanie: Plik binarny może nie być w PATH twojej powłoki. Dodaj go ręcznie:

# 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 dodaj %USERPROFILE%\.freeguard\bin do systemowej zmiennej środowiskowej PATH i uruchom ponownie terminal.

curl kończy się błędem lub pobieranie przekracza limit czasu

Objaw: Skrypt instalacyjny nie może pobrać pliku binarnego.

Rozwiązanie: Jeśli jesteś za firmowym firewallem lub w ograniczonej sieci, pobierz plik binarny ręcznie ze strony wydań na GitHubie i umieść go w ~/.freeguard/bin/. Następnie nadaj mu uprawnienia wykonywania:

chmod +x ~/.freeguard/bin/freeguard

Problemy z logowaniem

Kod weryfikacyjny nie został otrzymany

Objaw: Po uruchomieniu freeguard login --email [email protected] --send-code nie przychodzi żaden e-mail.

Rozwiązanie:

Sprawdź folder spam/śmieci — e-maile weryfikacyjne czasami są filtrowane.
Poczekaj 2 minuty przed ponownym żądaniem. Wysyłanie kodów ma ograniczenie częstotliwości.
Sprawdź, czy adres e-mail jest poprawny:

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

Wypróbuj innego dostawcę poczty e-mail, jeśli problem się utrzymuje.

Token wygasł

Objaw: Polecenia kończą się błędem Authentication expired lub Token invalid.

Wynik Doctor:

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

Rozwiązanie: Zaloguj się ponownie, aby odświeżyć dane logowania:

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

Błędny e-mail — subskrypcja nie znaleziona

Objaw: Logowanie się udaje, ale freeguard connect mówi No active subscription.

Wynik Doctor:

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

Rozwiązanie: Upewnij się, że logujesz się tym samym adresem e-mail, którego użyłeś do zakupu subskrypcji. Jeśli użyłeś innego e-maila:

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

Problemy z połączeniem

Przekroczenie limitu czasu połączenia

Objaw: freeguard connect zawiesza się lub zwraca Connection timed out.

Wynik Doctor:

✗ Network:         Internet not reachable

Rozwiązanie:

Sprawdź podstawowe połączenie internetowe (najpierw rozłącz VPN):

freeguard disconnect
ping 8.8.8.8

Wypróbuj inny węzeł lub kraj:

freeguard connect --country SG

Wypróbuj inny protokół, który może lepiej działać w twojej sieci:

freeguard connect --protocol hysteria2

Port 7890 jest już w użyciu

Objaw: freeguard connect kończy się błędem Port 7890 is already in use.

Wynik Doctor:

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

Rozwiązanie: Inna aplikacja proxy korzysta z domyślnego portu. Zatrzymaj drugą aplikację lub zmień port proxy FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

Wykryto wyciek DNS

Objaw: Zapytania DNS omijają tunel VPN.

Rozwiązanie: Przełącz się na bezpieczną konfigurację DNS:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Możesz zweryfikować, czy DNS jest kierowany przez VPN:

freeguard doctor

Szukaj sprawdzenia DNS w wynikach, aby potwierdzić poprawne działanie.

Problemy z uprawnieniami

Tryb TUN wymaga sudo

Objaw: freeguard connect --tun kończy się błędem Permission denied: TUN device.

Wynik Doctor:

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

Rozwiązanie: Tryb TUN tworzy wirtualny interfejs sieciowy, co wymaga podwyższonych uprawnień:

# macOS/Linux
sudo freeguard connect --tun

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

Jeśli nie potrzebujesz pokrycia VPN na poziomie systemowym, użyj domyślnego trybu proxy systemowego (sudo nie jest wymagane):

freeguard connect

Port poniżej 1024 wymaga podwyższonych uprawnień

Objaw: Ustawienie portu proxy poniżej 1024 kończy się błędem Permission denied.

Rozwiązanie: Porty poniżej 1024 są ograniczone w większości systemów operacyjnych. Użyj portu powyżej 1024:

freeguard config set proxy.port 7890

Lub uruchom z podwyższonymi uprawnieniami, jeśli konkretnie potrzebujesz niskiego portu:

sudo freeguard connect

Nadal utknąłeś?

Jeśli freeguard doctor i powyższe rozwiązania nie rozwiązują twojego problemu, pozwól AI zdiagnozować go automatycznie.

Odwiedź stronę FreeGuard CLI Agent i opisz swój problem. Agent może odczytać wynik freeguard doctor --json i przeprowadzić cię krok po kroku przez rozwiązanie.

Możesz też uruchomić interaktywnego kreatora rozwiązywania problemów:

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

Często zadawane pytania

Dlaczego FreeGuard CLI mówi “connection refused”?

To zazwyczaj oznacza, że serwer VPN jest tymczasowo niedostępny. Wypróbuj freeguard connect --server auto, aby automatycznie wybrać najlepszy dostępny serwer, lub sprawdź ustawienia firewalla.

Jak sprawdzić, czy moje połączenie VPN działa?

Uruchom freeguard status, aby zobaczyć stan połączenia, bieżący serwer i protokół. Możesz też uruchomić curl ifconfig.me, aby zweryfikować, że twój adres IP się zmienił.

FreeGuard CLI nie uruchamia się po aktualizacji systemu. Co robić?

Uruchom freeguard update, aby pobrać najnowszą wersję. Jeśli to się nie uda, zainstaluj ponownie skryptem instalacyjnym: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Jak zgłosić błąd lub uzyskać pomoc?

Uruchom freeguard debug, aby zebrać informacje diagnostyczne, a następnie skontaktuj się ze wsparciem przez stronę internetową lub e-mail. Dołącz wynik debug, aby przyspieszyć rozwiązanie problemu.

Ostatnia aktualizacja: marzec 2026