FreeGuard VPN
SākumlapaVPN mezgliCenu noteikšana
FreeGuard CLI problēmu novēršana
Vai jums ir problēmas ar FreeGuard CLI? Šī rokasgrāmata aptver visbiežākās problēmas un to risinājumus. Katrai problēmai vispirms mēģiniet palaist `freeguard doctor` — tas automātiski nosaka lielāko daļu konfigurācijas un vides problēmu.
Saturs

FreeGuard CLI problēmu novēršana

Vai jums ir problēmas ar FreeGuard CLI? Šī rokasgrāmata aptver visbiežākās problēmas un to risinājumus. Katrai problēmai vispirms mēģiniet palaist freeguard doctor — tas automātiski nosaka lielāko daļu konfigurācijas un vides problēmu.

Instalēšanas problēmas

Atļauja liegta instalēšanas laikā

Simptoms: Instalēšanas skripts neizdodas ar Permission denied vai EACCES.

Risinājums: macOS/Linux sistēmā instalēšanas programmai nepieciešama rakstīšanas piekļuve /usr/local/bin. Palaidiet ar paaugstinātām tiesībām:

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

Windows sistēmā pārliecinieties, ka atverat PowerShell kā administrators pirms instalēšanas komandas izpildes.

Komanda nav atrasta pēc instalēšanas

Simptoms: freeguard palaišana atgriež command not found vai not recognized.

Doctor izvade:

✗ CLI binary:     Not in PATH

Risinājums: Binārais fails var nebūt jūsu čaulas PATH. Pievienojiet to manuāli:

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

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

Windows sistēmā pievienojiet %USERPROFILE%\.freeguard\bin sistēmas PATH vides mainīgajam un restartējiet termināli.

curl neizdodas vai lejupielāde beidzas ar taimautu

Simptoms: Instalēšanas skripts nevar lejupielādēt bināro failu.

Risinājums: Ja atrodaties aiz korporatīvā ugunsmūra vai ierobežotā tīklā, lejupielādējiet bināro failu manuāli no GitHub izlaišanas lapas un novietojiet to mapē ~/.freeguard/bin/. Pēc tam padariet to izpildāmu:

chmod +x ~/.freeguard/bin/freeguard

Pieteikšanās problēmas

Verifikācijas kods nav saņemts

Simptoms: Pēc freeguard login --email [email protected] --send-code palaišanas e-pasts nepienāk.

Risinājums:

  1. Pārbaudiet savu surogātpasta/nevēlamā pasta mapi — verifikācijas e-pasti dažkārt tiek filtrēti.
  2. Pagaidiet 2 minūtes pirms atkārtota pieprasījuma. Kodu sūtīšanai ir ātruma ierobežojums.
  3. Pārliecinieties, ka e-pasta adrese ir pareiza:
freeguard login --email [email protected] --send-code
  1. Mēģiniet citu e-pasta pakalpojumu sniedzēju, ja problēma turpinās.

Tokens beidzies

Simptoms: Komandas neizdodas ar Authentication expired vai Token invalid.

Doctor izvade:

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

Risinājums: Piesakieties vēlreiz, lai atsvaidzinātu savus akreditācijas datus:

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

Nepareizs e-pasts — abonements nav atrasts

Simptoms: Pieteikšanās izdodas, bet freeguard connect saka No active subscription.

Doctor izvade:

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

Risinājums: Pārliecinieties, ka piesakāties ar to pašu e-pastu, ko izmantojāt abonementa iegādei. Ja izmantojāt citu e-pastu:

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

Savienojuma problēmas

Savienojuma taimauts

Simptoms: freeguard connect uzkaras vai atgriež Connection timed out.

Doctor izvade:

✗ Network:         Internet not reachable

Risinājums:

  1. Pārbaudiet savu pamata interneta savienojumu (vispirms atvienojiet VPN):
freeguard disconnect
ping 8.8.8.8
  1. Mēģiniet citu mezglu vai valsti:
freeguard connect --country SG
  1. Mēģiniet citu protokolu, kas var labāk darboties jūsu tīklā:
freeguard connect --protocol hysteria2

Ports 7890 jau tiek izmantots

Simptoms: freeguard connect neizdodas ar Port 7890 is already in use.

Doctor izvade:

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

Risinājums: Cita proxy lietojumprogramma izmanto noklusējuma portu. Vai nu apturiet otru lietojumprogrammu, vai mainiet FreeGuard proxy portu:

freeguard config set proxy.port 8080
freeguard connect

Atklāta DNS noplūde

Simptoms: DNS vaicājumi apiet VPN tuneli.

Risinājums: Pārslēdzieties uz drošu DNS konfigurāciju:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Varat pārbaudīt, vai DNS tiek maršrutēts caur VPN:

freeguard doctor

Meklējiet DNS pārbaudi izvadē, lai apstiprinātu pareizu darbību.

Atļauju problēmas

TUN režīmam nepieciešams sudo

Simptoms: freeguard connect --tun neizdodas ar Permission denied: TUN device.

Doctor izvade:

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

Risinājums: TUN režīms izveido virtuālu tīkla saskarni, kam nepieciešamas paaugstinātas tiesības:

# macOS/Linux
sudo freeguard connect --tun

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

Ja jums nav nepieciešama sistēmas līmeņa VPN pārklājums, izmantojiet noklusējuma sistēmas proxy režīmu (sudo nav nepieciešams):

freeguard connect

Portam zem 1024 nepieciešamas paaugstinātas tiesības

Simptoms: Proxy porta iestatīšana zem 1024 neizdodas ar Permission denied.

Risinājums: Porti zem 1024 ir ierobežoti lielākajā daļā operētājsistēmu. Izmantojiet portu virs 1024:

freeguard config set proxy.port 7890

Vai palaidiet ar paaugstinātām tiesībām, ja jums īpaši nepieciešams zems ports:

sudo freeguard connect

Joprojām iestrēdzis?

Ja freeguard doctor un iepriekš minētie risinājumi neatrisina jūsu problēmu, ļaujiet AI to diagnosticēt automātiski.

Apmeklējiet FreeGuard CLI Agent lapu un aprakstiet savu problēmu. Aģents var izlasīt jūsu freeguard doctor --json izvadi un soli pa solim vadīt jūs uz risinājumu.

Varat arī palaist interaktīvo problēmu novēršanas vedni:

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

Bieži uzdotie jautājumi

Kāpēc FreeGuard CLI saka “connection refused”?

Tas parasti nozīmē, ka VPN serveris īslaicīgi nav pieejams. Mēģiniet freeguard connect --server auto, lai automātiski izvēlētos labāko pieejamo serveri, vai pārbaudiet ugunsmūra iestatījumus.

Kā pārbaudīt, vai mans VPN savienojums darbojas?

Palaidiet freeguard status, lai redzētu savienojuma statusu, pašreizējo serveri un protokolu. Varat arī palaist curl ifconfig.me, lai pārbaudītu, vai jūsu IP adrese ir mainījusies.

FreeGuard CLI nesākas pēc sistēmas atjaunināšanas. Ko darīt?

Palaidiet freeguard update, lai iegūtu jaunāko versiju. Ja tas neizdodas, pārinstalējiet ar instalēšanas skriptu: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Kā ziņot par kļūdu vai saņemt palīdzību?

Palaidiet freeguard debug, lai apkopotu diagnostikas informāciju, pēc tam sazinieties ar atbalstu caur tīmekļa vietni vai e-pastu. Iekļaujiet debug izvadi ātrākam risinājumam.

Pēdējo reizi atjaunināts: 2026. gada marts