FreeGuard CLI Sorun Giderme

FreeGuard CLI ile sorun mu yaşıyorsunuz? Bu kılavuz en yaygın sorunları ve çözümlerini kapsar. Her sorun için önce freeguard doctor komutunu çalıştırmayı deneyin — yapılandırma ve ortam sorunlarının çoğunu otomatik olarak tespit eder.

Kurulum Sorunları

Kurulum sırasında izin reddedildi

Belirti: Kurulum betiği Permission denied veya EACCES hatası ile başarısız olur.

Çözüm: macOS/Linux’ta yükleyicinin /usr/local/bin dizinine yazma erişimine ihtiyacı vardır. Yükseltilmiş yetkilerle çalıştırın:

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

Windows’ta kurulum komutunu çalıştırmadan önce PowerShell’i Yönetici olarak açtığınızdan emin olun.

Kurulumdan sonra komut bulunamadı

Belirti: freeguard çalıştırıldığında command not found veya not recognized döner.

Doctor çıktısı:

✗ CLI binary:     Not in PATH

Çözüm: İkili dosya kabuğunuzun PATH’inde olmayabilir. Manuel olarak ekleyin:

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

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

Windows’ta %USERPROFILE%\.freeguard\bin yolunu sistem PATH ortam değişkenine ekleyin ve terminali yeniden başlatın.

curl başarısız oluyor veya indirme zaman aşımına uğruyor

Belirti: Kurulum betiği ikili dosyayı indiremez.

Çözüm: Kurumsal güvenlik duvarının arkasındaysanız veya kısıtlı bir ağdaysanız, ikili dosyayı GitHub Releases sayfasından manuel olarak indirip ~/.freeguard/bin/ dizinine yerleştirin. Ardından çalıştırılabilir yapın:

chmod +x ~/.freeguard/bin/freeguard

Giriş Sorunları

Doğrulama kodu alınamadı

Belirti: freeguard login --email [email protected] --send-code çalıştırıldıktan sonra e-posta gelmiyor.

Çözüm:

Spam/gereksiz posta klasörünüzü kontrol edin — doğrulama e-postaları bazen filtrelenir.
Tekrar istemeden önce 2 dakika bekleyin. Kod gönderiminde hız sınırı vardır.
E-posta adresinin doğru olduğunu kontrol edin:

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

Sorun devam ederse farklı bir e-posta sağlayıcısı deneyin.

Token süresi dolmuş

Belirti: Komutlar Authentication expired veya Token invalid hatası ile başarısız olur.

Doctor çıktısı:

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

Çözüm: Kimlik bilgilerinizi yenilemek için tekrar giriş yapın:

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

Yanlış e-posta — abonelik bulunamadı

Belirti: Giriş başarılı oluyor ancak freeguard connect No active subscription diyor.

Doctor çıktısı:

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

Çözüm: Aboneliğinizi satın aldığınız e-posta ile giriş yaptığınızdan emin olun. Farklı bir e-posta kullandıysanız:

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

Bağlantı Sorunları

Bağlantı zaman aşımı

Belirti: freeguard connect takılıyor veya Connection timed out döndürüyor.

Doctor çıktısı:

✗ Network:         Internet not reachable

Çözüm:

Temel internet bağlantınızı kontrol edin (önce VPN bağlantısını kesin):

freeguard disconnect
ping 8.8.8.8

Farklı bir düğüm veya ülke deneyin:

freeguard connect --country SG

Ağınızda daha iyi çalışabilecek farklı bir protokol deneyin:

freeguard connect --protocol hysteria2

Port 7890 zaten kullanımda

Belirti: freeguard connect Port 7890 is already in use hatası ile başarısız olur.

Doctor çıktısı:

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

Çözüm: Başka bir proxy uygulaması varsayılan portu kullanıyor. Diğer uygulamayı durdurun veya FreeGuard proxy portunu değiştirin:

freeguard config set proxy.port 8080
freeguard connect

DNS sızıntısı tespit edildi

Belirti: DNS sorguları VPN tünelini atlıyor.

Çözüm: Güvenli DNS yapılandırmasına geçin:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

DNS’in VPN üzerinden yönlendirildiğini doğrulayabilirsiniz:

freeguard doctor

Doğru çalıştığını onaylamak için çıktıda DNS kontrolünü arayın.

İzin Sorunları

TUN modu sudo gerektirir

Belirti: freeguard connect --tun Permission denied: TUN device hatası ile başarısız olur.

Doctor çıktısı:

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

Çözüm: TUN modu sanal bir ağ arayüzü oluşturur, bu da yükseltilmiş yetkiler gerektirir:

# macOS/Linux
sudo freeguard connect --tun

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

Sistem genelinde VPN kapsamına ihtiyacınız yoksa varsayılan sistem proxy modunu kullanın (sudo gerekmez):

freeguard connect

1024 altında port yükseltilmiş yetki gerektirir

Belirti: 1024 altında proxy portu ayarlamak Permission denied ile başarısız olur.

Çözüm: 1024 altındaki portlar çoğu işletim sisteminde kısıtlanmıştır. 1024 üzerinde bir port kullanın:

freeguard config set proxy.port 7890

Veya özellikle düşük bir porta ihtiyacınız varsa yükseltilmiş yetkilerle çalıştırın:

sudo freeguard connect

Hâlâ takılı mı kaldınız?

freeguard doctor ve yukarıdaki çözümler sorununuzu çözmezse, yapay zekanın otomatik olarak teşhis etmesine izin verin.

FreeGuard CLI Agent sayfasını ziyaret edin ve sorununuzu açıklayın. Agent, freeguard doctor --json çıktınızı okuyabilir ve adım adım çözüme yönlendirebilir.

Etkileşimli sorun giderme sihirbazını da çalıştırabilirsiniz:

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

Sıkça Sorulan Sorular

FreeGuard CLI neden “connection refused” diyor?

Bu genellikle VPN sunucusunun geçici olarak kullanılamaz olduğu anlamına gelir. En iyi kullanılabilir sunucuyu otomatik seçmek için freeguard connect --server auto deneyin veya güvenlik duvarı ayarlarınızı kontrol edin.

VPN bağlantımın çalışıp çalışmadığını nasıl kontrol ederim?

Bağlantı durumunuzu, mevcut sunucunuzu ve protokolünüzü görmek için freeguard status çalıştırın. IP adresinizin değişip değişmediğini doğrulamak için curl ifconfig.me de çalıştırabilirsiniz.

Sistem güncellemesinden sonra FreeGuard CLI başlamıyor. Ne yapmalıyım?

En son sürümü almak için freeguard update çalıştırın. Bu başarısız olursa, kurulum betiği ile yeniden kurun: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Nasıl hata bildiririm veya yardım alırım?

Tanılama bilgilerini toplamak için freeguard debug çalıştırın, ardından web sitesi veya e-posta yoluyla destekle iletişime geçin. Daha hızlı çözüm için debug çıktısını ekleyin.

Son güncelleme: Mart 2026