PandaVPN CLI SSS

Panda CLI, Panda’nın komut satırı istemcisidir ve terminal üzerinden aşağıdakileri destekler:

• Oturum açma ve hesap yönetimi
• Düğüm yenileme ve düğümlere bağlanma
• PandaVPN / Proxy / WireGuard / Auto modları arasında geçiş
• Sistem proxy yapılandırması
• Trafik bölme için Split rules
• Split DNS yapılandırması
• Kill-switch koruması
• Auto-connect
• Günlükler ve tanılama

Dahili beta kullanıcıları, geliştiriciler, ileri düzey kullanıcılar ve betikli işlemler gerektiren test senaryoları için uygundur.

Panda CLI komut satırı üzerinden çalışır ve şunlar için daha uygundur:

• Otomatik test
• Uzaktan sorun giderme
• Betik tabanlı bağlantılar
• Ayrıntılı tanılama bilgilerini görüntüleme
• Kill-switch, DNS, yönlendirme ve sistem proxy’si gibi düşük seviyeli davranışları doğrulama

Masaüstü istemcisi, normal kullanıcıların günlük grafiksel işlemleri için daha uygundur.

Not: Eski Qt masaüstü istemcisinin ve CLI’nin VPN / sistem proxy’sini aynı anda yönetmesi önerilmez; bu, yapılandırmaların birbirinin üzerine yazılmasını önlemek içindir.

Bazı yetenekler sistem düzeyinde izinler gerektirir, örneğin:

• TUN / WireGuard ağ arayüzleri oluşturma
• DNS değiştirme
• Sistem proxy'sini ayarlama
• Kill-switch uygulama
• Rotaları onarma
• packet VPN runtime yönetme

Bu nedenle CLI, bu işlemleri platforma karşılık gelen daemon / service üzerinden gerçekleştirir.

Farklı platformlardaki daemon biçimleri:

Temel fark şudur: Windows ve macOS’te hizmet genellikle kurulum paketi aracılığıyla otomatik olarak kurulur; Linux’ta ise kullanıcıların genellikle sudo panda service install komutunu manuel olarak çalıştırması gerekir.

Windows’ta yalnızca kurulum paketini kullanmıyor ve binary dosyasını manuel olarak yerleştiriyorsanız, yönetici PowerShell içinde şunu çalıştırmanız gerekir:

panda service install windows

macOS’te bu yalnızca geliştirme ve hata ayıklama sırasında, .pkg kurulum paketi kullanılmadığında veya daemon otomatik başlamadığında gerekir:

sudo panda start

Linux’ta önerilen:

sudo panda service install
panda service status

Evet, aynıdır. Temel fark, indirilen kurulum paketinin mimarisidir.

Kurulum adımları, komutlar ve hizmet yönetimi yöntemi aynıdır. Kurulum paketi ayrıcalıkları otomatik olarak yükseltir ve Windows Service’i kaydeder.

Başlıca şunları destekler:

Yaygın ayarlar:

panda mode auto
panda mode pandavpn global
panda mode proxy global
panda mode wireguard

openvpn şu anda kullanıcı belgelerinde ana mod olarak gösterilmesi önerilmez.

Öneri:

Not: mode proxy ve Kill-switch birbirini dışlar.

mode auto yeni sürümün varsayılan modudur.

Davranışı şöyledir:

• API node / smart connect, meta.protocol değerine göre runtime’ı öncelikli olarak seçer;
• WireGuard önerilirse önce WireGuard denenir;
• WireGuard metadata, adres atama, runtime başlatma, handshake veya bağlantı testi başarısız olursa SS payload’dan derlenen PandaVPN global’a geri döner;
• SS, OPENVPN, bilinmeyen veya eksik protokoller fallback olarak PandaVPN global kullanır;
• mode auto policy parametresini kabul etmez ve çözümlenen runtime her zaman global olur.

Yeni kullanıcılar için önerilir:

panda mode auto
panda connect

direct-region önerilen yazımdır; bypass-region / bypass uyumluluk aliaslarıdır.

Örneğin:

panda mode pandavpn direct-region in

Uyumluluk aliası ile eşdeğerdir:

panda mode pandavpn bypass-region in

Yeni sürüm daha kapsamlı bir split profile söz dizimini destekler:

panda mode pandavpn split default direct proxy-region <cc>
panda mode pandavpn split default proxy direct-region <cc>

Yaygın token’lar:

Örnekler:

panda mode pandavpn split default direct proxy-region us custom-rules
panda mode pandavpn split default proxy direct-region in direct-lan custom-rules

Başlangıç belgelerinde uzun komutların gösterilmesi önerilmez; gelişmiş split belgelerine daha uygundur.

doctor, Panda CLI’nin mevcut temel durumlarını görüntülemek için kullanılan salt okunur bir tanılama komutudur.

panda doctor
panda doctor --json

Kısa yazım:

panda do

Özellikle şunlara odaklanın:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace, belirli bir hedefin hangi rule, DNS action ve route üzerinden gideceğini görmek için kullanılır.

panda trace example.com:443
panda trace 8.8.8.8:53 --json

Not: tam trace yeteneği active PandaVPN packet runtime gerektirir. Uyumlu runtime yoksa yalnızca sınırlı doğrulama yapılabilir veya legacy trace’e fallback edilir.

Bu genellikle resmi service / LaunchDaemon kurulu olduğu ve ayrıca elle şu komut çalıştırıldığı için olur:

sudo panda start

sudo panda start, unmanaged / yönetilmeyen bir daemon başlatır; bu daemon resmi daemon ile aynı anda şunları yönetebilir:

• VPN route
• DNS
• TUN
• system proxy
• Kill-switch

Çözüm ilkesi: yalnızca bir daemon bırakın.

macOS / Linux için yaygın işlem:

panda disconnect
panda kill-switch off
sudo panda stop
panda repair
panda doctor

Linux’ta systemd service kullanıyorsanız ardından resmi service’i yeniden başlatın:

sudo panda service restart
panda doctor

macOS’ta .pkg ile kurulum yaptıysanız genellikle daemon yönetimini LaunchDaemon / helper’a bırakın ve sudo panda start komutunu uzun vadede günlük başlatma yöntemi olarak kullanmayın.

Yalnızca VPN bağlantısını kesmek istiyorsanız daemon’dan çıkmanız gerekmez:

panda disconnect
panda kill-switch off

Gerçekten daemon’u durdurmak istiyorsanız:

sudo panda stop

Onaylayın:

panda status

panda daemon unavailable gösteriliyorsa, ana daemon durmuş demektir.

Not: macOS .pkg ile kurulan LaunchDaemon / helper sistem tarafından yönetilebilir; normal kullanıcıların hizmeti sık sık manuel olarak durdurması önerilmez.

panda log
panda log --lines 200
panda log --all

Logs temizle:

panda log clear

Debug’i geçici olarak aç:

panda log level debug dns,tcp --ttl 10m

Varsayılana geri döndür:

panda log level reset

panda repair daha kapsamlıdır ve şunları onarabilir:

• VPN route
• DNS snapshot
• Kill-switch guard
• system proxy ile ilgili durumlar

panda proxy repair temel olarak mevcut kullanıcının system proxy drift sorununu onarır.

panda repair
panda proxy repair

Fresh install durumunda varsayılan proxy system-proxy on olur.
Kullanıcı açıkça off kaydetmişse, bu yapılandırma korunur.

Görüntüle veya ayarla:

panda proxy system-proxy on
panda proxy system-proxy off
panda proxy system-proxy lock-on

Not: mode auto, pandavpn ve wireguard altında VPN runtime kalıcı system proxy tercihini yok sayar; VPN companion proxy kullanılabilir kalır ve scoped egress kullanır.

Windows system proxy, geçerli kullanıcının HKCU WinINET ayarıdır ve per-user user-agent gerektirir.
SSH veya etkileşimli olmayan bir oturumdaysanız, proxy repair user-agent’i her zaman otomatik olarak başlatamayabilir.

Önerilen:

panda proxy status
panda proxy repair
panda doctor

Hâlâ etkili olmazsa, masaüstü oturum açma oturumunda tekrar deneyin.

Linux Phase 1 esas olarak GNOME gsettings desteği sunar.
KDE / XFCE gibi ortamlar unsupported olarak görünebilir.

Bu, PandaVPN packet runtime’ı mutlaka etkilemez, ancak system proxy mode deneyimini etkileyebilir.

Kill-switch’in anlamı, trafiğe yalnızca TUN üzerinden izin vermek ve diğer normal trafiği engellemektir.

proxy mode, standalone yerel proxy modudur; packet VPN / TUN içermez ve eşdeğer DNS ile routing koruması sağlamaz. Bu nedenle Kill-switch standalone proxy mode’u desteklemez.

Kill-switch gerektiğinde şunu kullanın:

panda mode auto
panda kill-switch on

Veya:

panda mode pandavpn global
panda kill-switch on

Veya:

panda mode wireguard
panda kill-switch on

Hayır.

Auto-connect temel olarak daemon / service başlarken best-effort connect’i ve başlangıçta ağ geçici olarak kullanılamadığında pending retry’yi kapsar.

Aç:

panda config auto-connect on

Kapat:

panda config auto-connect off

Bu, genel bir runtime otomatik yeniden bağlanma mekanizması değildir.

Split rules, belirli domain, keyword, regex veya IP’lerin proxy, direct ya da block üzerinden gitmesini belirtmek için kullanılır.

Rules dosyaları:

split/rules/proxy.txt
split/rules/direct.txt
split/rules/block.txt

Yaygın komutlar:

panda split rules list
panda split rules add proxy suffix:github.com
panda split rules add direct ip-cidr:10.0.0.0/8
panda split rules add block keyword:adservice

Mevcut bilinen sınırlama: login sonrasında retry bekleyen pending auto-connect otomatik olarak wake edilmez.

Login sonrasında manuel olarak çalıştırmanız önerilir:

panda connect

Genellikle gerekmez. Split DNS configuration değişiklikleri hot-load edilir.

Yaygın komutlar:

panda split dns status
panda split dns local set 223.5.5.5 114.114.114.114
panda split dns policy tunnel-only
panda split dns fake-ip on

Platform bazı local DNS kaynaklarını desteklemiyorsa, doctor warning gösterir.