FreeGuard VPN
PradžiaVPN mazgaiKainodara
FreeGuard CLI trikčių šalinimas
Kyla problemų su FreeGuard CLI? Šis vadovas apima dažniausiai pasitaikančias problemas ir jų sprendimus. Kiekvienai problemai pirmiausia pabandykite paleisti `freeguard doctor` — jis automatiškai aptinka daugumą konfigūracijos ir aplinkos problemų.
Turinys

FreeGuard CLI trikčių šalinimas

Kyla problemų su FreeGuard CLI? Šis vadovas apima dažniausiai pasitaikančias problemas ir jų sprendimus. Kiekvienai problemai pirmiausia pabandykite paleisti freeguard doctor — jis automatiškai aptinka daugumą konfigūracijos ir aplinkos problemų.

Diegimo problemos

Leidimas atmestas diegimo metu

Požymis: Diegimo skriptas nepavyksta su Permission denied arba EACCES.

Sprendimas: macOS/Linux sistemoje diegimo programai reikia rašymo prieigos prie /usr/local/bin. Paleiskite su padidintomis teisėmis:

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

Windows sistemoje įsitikinkite, kad atidarote PowerShell kaip administratorius prieš vykdydami diegimo komandą.

Komanda nerasta po diegimo

Požymis: Paleidus freeguard grąžina command not found arba not recognized.

Doctor išvestis:

✗ CLI binary:     Not in PATH

Sprendimas: Dvejetainis failas gali nebūti jūsų apvalkalo PATH. Pridėkite jį rankiniu būdu:

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

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

Windows sistemoje pridėkite %USERPROFILE%\.freeguard\bin prie sistemos PATH aplinkos kintamojo ir paleiskite terminalą iš naujo.

curl nepavyksta arba atsisiuntimas baigiasi laiko limitu

Požymis: Diegimo skriptas negali atsisiųsti dvejetainio failo.

Sprendimas: Jei esate už korporatyvinės ugniasienės arba ribotame tinkle, atsisiųskite dvejetainį failą rankiniu būdu iš GitHub leidimų puslapio ir padėkite jį į ~/.freeguard/bin/. Tada padarykite jį vykdomąjį:

chmod +x ~/.freeguard/bin/freeguard

Prisijungimo problemos

Patvirtinimo kodas negautas

Požymis: Paleidus freeguard login --email [email protected] --send-code, el. laiškas neateina.

Sprendimas:

  1. Patikrinkite savo šiukšlių/brukalų aplanką — patvirtinimo laiškai kartais filtruojami.
  2. Palaukite 2 minutes prieš prašydami pakartotinai. Kodų siuntimui taikomas dažnio apribojimas.
  3. Patikrinkite, ar el. pašto adresas teisingas:
freeguard login --email [email protected] --send-code
  1. Pabandykite kitą el. pašto teikėją, jei problema tęsiasi.

Žetonas pasibaigęs

Požymis: Komandos nepavyksta su Authentication expired arba Token invalid.

Doctor išvestis:

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

Sprendimas: Prisijunkite iš naujo, kad atnaujintumėte savo kredencialus:

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

Neteisingas el. paštas — prenumerata nerasta

Požymis: Prisijungimas pavyksta, bet freeguard connect rodo No active subscription.

Doctor išvestis:

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

Sprendimas: Įsitikinkite, kad prisijungiate tuo pačiu el. paštu, kurį naudojote prenumeratai įsigyti. Jei naudojote kitą el. paštą:

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

Ryšio problemos

Ryšio laiko limitas

Požymis: freeguard connect užstringa arba grąžina Connection timed out.

Doctor išvestis:

✗ Network:         Internet not reachable

Sprendimas:

  1. Patikrinkite pagrindinį interneto ryšį (pirmiausia atjunkite VPN):
freeguard disconnect
ping 8.8.8.8
  1. Pabandykite kitą mazgą arba šalį:
freeguard connect --country SG
  1. Pabandykite kitą protokolą, kuris gali geriau veikti jūsų tinkle:
freeguard connect --protocol hysteria2

Prievadas 7890 jau naudojamas

Požymis: freeguard connect nepavyksta su Port 7890 is already in use.

Doctor išvestis:

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

Sprendimas: Kita proxy programa naudoja numatytąjį prievadą. Sustabdykite kitą programą arba pakeiskite FreeGuard proxy prievadą:

freeguard config set proxy.port 8080
freeguard connect

Aptiktas DNS nutekėjimas

Požymis: DNS užklausos aplenkia VPN tunelį.

Sprendimas: Perjunkite į saugią DNS konfigūraciją:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Galite patikrinti, ar DNS nukreipiamas per VPN:

freeguard doctor

Ieškokite DNS patikrinimo išvestyje, kad patvirtintumėte teisingą veikimą.

Teisių problemos

TUN režimui reikia sudo

Požymis: freeguard connect --tun nepavyksta su Permission denied: TUN device.

Doctor išvestis:

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

Sprendimas: TUN režimas sukuria virtualią tinklo sąsają, kuriai reikia padidintų teisių:

# macOS/Linux
sudo freeguard connect --tun

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

Jei jums nereikia visos sistemos VPN aprėpties, naudokite numatytąjį sistemos proxy režimą (sudo nereikia):

freeguard connect

Prievadui žemiau 1024 reikia padidintų teisių

Požymis: Nustatant proxy prievadą žemiau 1024, nepavyksta su Permission denied.

Sprendimas: Prievadai žemiau 1024 yra riboti daugelyje operacinių sistemų. Naudokite prievadą virš 1024:

freeguard config set proxy.port 7890

Arba paleiskite su padidintomis teisėmis, jei jums konkrečiai reikia žemo prievado:

sudo freeguard connect

Vis dar įstrigote?

Jei freeguard doctor ir aukščiau pateikti sprendimai neišsprendžia jūsų problemos, leiskite AI ją diagnozuoti automatiškai.

Apsilankykite FreeGuard CLI Agent puslapyje ir aprašykite savo problemą. Agentas gali perskaityti jūsų freeguard doctor --json išvestį ir vesti jus žingsnis po žingsnio link sprendimo.

Taip pat galite paleisti interaktyvų trikčių šalinimo vedlį:

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

Dažnai užduodami klausimai

Kodėl FreeGuard CLI rodo “connection refused”?

Tai paprastai reiškia, kad VPN serveris laikinai nepasiekiamas. Pabandykite freeguard connect --server auto, kad automatiškai pasirinktumėte geriausią prieinamą serverį, arba patikrinkite ugniasienės nustatymus.

Kaip patikrinti, ar mano VPN ryšys veikia?

Paleiskite freeguard status, kad pamatytumėte ryšio būseną, dabartinį serverį ir protokolą. Taip pat galite paleisti curl ifconfig.me, kad patikrintumėte, ar jūsų IP adresas pasikeitė.

FreeGuard CLI nepasileidžia po sistemos atnaujinimo. Ką daryti?

Paleiskite freeguard update, kad gautumėte naujausią versiją. Jei tai nepavyksta, iš naujo įdiekite diegimo skriptu: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Kaip pranešti apie klaidą arba gauti pagalbą?

Paleiskite freeguard debug, kad surinktumėte diagnostikos informaciją, tada susisiekite su palaikymo komanda per svetainę arba el. paštą. Pridėkite debug išvestį greitesniam sprendimui.

Paskutinis atnaujinimas: 2026 m. kovas