FreeGuard VPN
KotiVPN-solmutHinnoittelu
FreeGuard CLI -vianmääritys
Onko sinulla ongelmia FreeGuard CLI:n kanssa? Tämä opas käsittelee yleisimmät ongelmat ja niiden ratkaisut. Kokeile jokaisen ongelman kohdalla ensin `freeguard doctor` -komentoa — se tunnistaa automaattisesti useimmat konfiguraatio- ja ympäristöongelmat.
Sisällysluettelo

FreeGuard CLI -vianmääritys

Onko sinulla ongelmia FreeGuard CLI:n kanssa? Tämä opas käsittelee yleisimmät ongelmat ja niiden ratkaisut. Kokeile jokaisen ongelman kohdalla ensin freeguard doctor -komentoa — se tunnistaa automaattisesti useimmat konfiguraatio- ja ympäristöongelmat.

Asennusongelmat

Käyttöoikeus evätty asennuksen aikana

Oire: Asennusskripti epäonnistuu virheilmoituksella Permission denied tai EACCES.

Ratkaisu: macOS/Linux-järjestelmässä asennusohjelma tarvitsee kirjoitusoikeudet hakemistoon /usr/local/bin. Suorita korotetuin oikeuksin:

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

Windowsissa varmista, että avaat PowerShellin järjestelmänvalvojana ennen asennuskomennon suorittamista.

Komentoa ei löydy asennuksen jälkeen

Oire: freeguard-komennon suorittaminen palauttaa command not found tai not recognized.

Doctor-tuloste:

✗ CLI binary:     Not in PATH

Ratkaisu: Binääritiedosto ei ehkä ole komentotulkin PATH-muuttujassa. Lisää se manuaalisesti:

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

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

Windowsissa lisää %USERPROFILE%\.freeguard\bin järjestelmän PATH-ympäristömuuttujaan ja käynnistä terminaali uudelleen.

curl epäonnistuu tai lataus aikakatkaistaan

Oire: Asennusskripti ei pysty lataamaan binääritiedostoa.

Ratkaisu: Jos olet yrityksen palomuurin takana tai rajoitetussa verkossa, lataa binääritiedosto manuaalisesti GitHub Releases -sivulta ja sijoita se hakemistoon ~/.freeguard/bin/. Tee siitä sitten suoritettava:

chmod +x ~/.freeguard/bin/freeguard

Kirjautumisongelmat

Vahvistuskoodia ei vastaanotettu

Oire: freeguard login --email [email protected] --send-code -komennon jälkeen sähköpostia ei saavu.

Ratkaisu:

  1. Tarkista roskaposti-/spämmikansio — vahvistussähköpostit suodatetaan joskus.
  2. Odota 2 minuuttia ennen uutta pyyntöä. Koodien lähettämisessä on nopeusrajoitus.
  3. Varmista, että sähköpostiosoite on oikein:
freeguard login --email [email protected] --send-code
  1. Kokeile eri sähköpostipalveluntarjoajaa, jos ongelma jatkuu.

Token vanhentunut

Oire: Komennot epäonnistuvat virheilmoituksella Authentication expired tai Token invalid.

Doctor-tuloste:

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

Ratkaisu: Kirjaudu uudelleen sisään päivittääksesi tunnistetietosi:

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

Väärä sähköposti — tilausta ei löydy

Oire: Kirjautuminen onnistuu, mutta freeguard connect sanoo No active subscription.

Doctor-tuloste:

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

Ratkaisu: Varmista, että kirjaudut samalla sähköpostilla, jolla ostit tilauksesi. Jos käytit eri sähköpostia:

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

Yhteysongelmat

Yhteyden aikakatkaisu

Oire: freeguard connect jumittuu tai palauttaa Connection timed out.

Doctor-tuloste:

✗ Network:         Internet not reachable

Ratkaisu:

  1. Tarkista perusinternetyhteytesi (katkaise ensin VPN-yhteys):
freeguard disconnect
ping 8.8.8.8
  1. Kokeile eri solmua tai maata:
freeguard connect --country SG
  1. Kokeile eri protokollaa, joka saattaa toimia paremmin verkossasi:
freeguard connect --protocol hysteria2

Portti 7890 on jo käytössä

Oire: freeguard connect epäonnistuu virheilmoituksella Port 7890 is already in use.

Doctor-tuloste:

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

Ratkaisu: Toinen proxy-sovellus käyttää oletusporttia. Joko pysäytä toinen sovellus tai vaihda FreeGuardin proxy-porttia:

freeguard config set proxy.port 8080
freeguard connect

DNS-vuoto havaittu

Oire: DNS-kyselyt ohittavat VPN-tunnelin.

Ratkaisu: Vaihda turvalliseen DNS-konfiguraatioon:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Voit varmistaa, että DNS reititetään VPN:n kautta:

freeguard doctor

Etsi tulosteesta DNS-tarkistus varmistaaksesi, että se toimii oikein.

Käyttöoikeusongelmat

TUN-tila vaatii sudon

Oire: freeguard connect --tun epäonnistuu virheilmoituksella Permission denied: TUN device.

Doctor-tuloste:

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

Ratkaisu: TUN-tila luo virtuaalisen verkkoliitännän, joka vaatii korotetut oikeudet:

# macOS/Linux
sudo freeguard connect --tun

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

Jos et tarvitse järjestelmänlaajuista VPN-suojausta, käytä oletusarvoista järjestelmän proxy-tilaa (sudo ei tarvita):

freeguard connect

Portti alle 1024 vaatii korotetut oikeudet

Oire: Proxy-portin asettaminen alle 1024:n epäonnistuu virheilmoituksella Permission denied.

Ratkaisu: Portit alle 1024 ovat rajoitettuja useimmissa käyttöjärjestelmissä. Käytä porttia yli 1024:

freeguard config set proxy.port 7890

Tai suorita korotetuin oikeuksin, jos tarvitset nimenomaan matalan portin:

sudo freeguard connect

Edelleen jumissa?

Jos freeguard doctor ja yllä olevat ratkaisut eivät ratkaise ongelmaasi, anna tekoälyn diagnosoida se automaattisesti.

Käy FreeGuard CLI Agent -sivulla ja kuvaile ongelmasi. Agentti voi lukea freeguard doctor --json -tulosteesi ja opastaa sinua vaihe vaiheelta ratkaisuun.

Voit myös suorittaa interaktiivisen vianmääritysapurin:

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

Usein kysytyt kysymykset

Miksi FreeGuard CLI sanoo “connection refused”?

Tämä tarkoittaa yleensä, että VPN-palvelin on tilapäisesti poissa käytöstä. Kokeile freeguard connect --server auto valitaksesi automaattisesti parhaan saatavilla olevan palvelimen, tai tarkista palomuuriasetuksesi.

Miten tarkistan, toimiiko VPN-yhteyteni?

Suorita freeguard status nähdäksesi yhteytesi tilan, nykyisen palvelimen ja protokollan. Voit myös suorittaa curl ifconfig.me varmistaaksesi, että IP-osoitteesi on muuttunut.

FreeGuard CLI ei käynnisty järjestelmäpäivityksen jälkeen. Mitä teen?

Suorita freeguard update saadaksesi uusimman version. Jos se epäonnistuu, asenna uudelleen asennusskriptillä: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Miten raportoin virheen tai saan apua?

Suorita freeguard debug kerätäksesi diagnostiikkatietoja ja ota sitten yhteyttä tukeen verkkosivuston tai sähköpostin kautta. Liitä mukaan debug-tuloste nopeampaa ratkaisua varten.

Viimeksi päivitetty: maaliskuu 2026