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.

PandaVPN CLI otomatik testler, uzaktan sorun giderme ve betiklerle yönetilen bağlantılar için daha uygundur.

Panda Desktop ve PandaVPN CLI, aynı PandaVPN daemon için iki kontrol arayüzüdür ve aynı bağlantı durumunu paylaşır, bu nedenle birlikte kullanılabilirler.

Panda-Qt veya eski Linux AppImage gibi eski masaüstü uygulamalarını PandaVPN CLI ile aynı anda çalıştırmayın; bu durum ağ yapılandırması çakışmalarına neden olabilir.

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.

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

Kurulum adımları aynıdır. .pkg ile kurulumdan sonra LaunchDaemon / helper genellikle otomatik olarak kurulur ve başlatılır.

Küresel kullanıcılar için varsayılan olarak mode auto kullanılmasını öneriyoruz:

panda login
panda node refresh
panda mode auto
panda connect
panda doctor

Yeni kurulum zaten varsayılan olarak mode auto kullanıyorsa, daha basit bir sürüm de kullanılabilir:

panda login
panda node refresh
panda connect
panda doctor

Karşılık gelen kısa yazım sürümü:

panda login
panda no re
panda conn
panda do

Resmi indirme sayfasında ve başlangıç rehberinde önce tam komutların gösterilmesi önerilir; kısa yazımlar daha sonra gelişmiş dokümantasyonda veya etkileşimli mod açıklamalarında gösterilebilir.

gfwlist, belirli bir split rules kaynağıdır ve küresel kullanıcılar için varsayılan mod olarak uygun değildir.

Küresel kullanıcılar için önerilen varsayılan ayar:

panda mode auto

Veya PandaVPN global modunu sabit olarak kullanın:

panda mode pandavpn global

gfwlist, gelişmiş split routing belgelerinde tutulabilir; ancak resmi web sitesinin ilk ekranında, indirme sayfasının Hero bölümünde veya yeni başlayanlar için quick start içinde görünmesi önerilmez.

Önce bağlantıyı kesmeniz ve Kill-switch’i kapatmanız önerilir:

panda disconnect
panda kill-switch off

Manuel yükseltme veya Linux service yükseltmesi ise daemon’u da durdurmanız önerilir:

sudo panda stop

macOS ve Windows installer ile yükseltilirken installer genellikle service kurulumunu ve yeniden başlatmayı otomatik olarak yönetir. Yükseltme tamamlandıktan sonra şunları çalıştırmanız önerilir:

panda version
panda doctor
panda connect

Linux’ta manuel yükseltmeden sonra önerilen:

sudo panda service install
sudo panda service restart
panda version
panda doctor

panda connect us

Bu, bare group selector anlamına gelir; VIP / SVIP / FREE tab sabitlenmez, uygun tab API tarafından seçilir.

panda connect svip us

SVIP tab altındaki us değerinin sabit kullanılacağı anlamına gelir.

İki noktalı biçim eşdeğerdir ve scripts için uygundur:

panda connect svip:us

favorite tab şu anda flat favorite channel list’tir ve connect fav us gibi favorite group smart connect desteklemez; favorite için şunu kullanın:

panda connect fav

veya:

panda connect --node <NODE_ID>

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.

Tüm node’ları görüntüleme:

panda node list

Yenileyip tekrar görüntüleme:

panda node refresh
panda node list

Kısa yazım:

panda no re
panda no list

Belirli bir bölgeyi veya grubu görüntüleme:

panda node list us
panda node list jp
panda node list de

Node gruplarını görüntüleme:

panda node group

Belirli bir grubun ayrıntılarını görüntüleme:

panda node group show us

Önce node arayın:

panda node list us

Ardından bağlanın:

panda connect --node 1822

Adla da bağlanabilirsiniz:

panda connect --node "US Node"

Kısa yazım:

panda no list us
panda conn --node 1822

panda connect son hedefi kullanır.
Önceki bir hedef yoksa global smart connect dener.

Smart connect şunları gerektirir:

• giriş yapmış olmanız;
• node dizininin önbelleğe alınmış olması;
• gerektiğinde önce panda node refresh çalıştırmanız.

Kısa yazım:

panda conn

Yaygın nedenler:

• henüz giriş yapılmamış;
• node dizini yenilenmemiş;
• mevcut hesapta kullanılabilir node yok;
• ağ kullanılamıyor;
• daemon çalışmıyor;
• mevcut mode hedef node ile uyumlu değil;
• mode auto altında önerilen protokol başlatılamadı ve fallback de başarısız oldu.

Önerilen kontroller:

panda account
panda node refresh
panda node list
panda mode
panda doctor
panda log --lines 200

panda status

Yapılandırılmış çıktı:

panda status --json

Kısa yazım:

panda stat

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

no-tunnel IPv6 senaryosunda awdl0 / llw0 block olabilir ve AirDrop / Continuity geçici olarak kullanılamayabilir.
Genellikle disconnect sonrasında düzelir.

Hâlâ anormalse önerilen:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Desteklenen sürümlerde bu yapılandırılabilir:

panda config tcp-fast-open auto
panda config tcp-fast-open on
panda config tcp-fast-open off

Açıklama:

• Varsayılan olarak auto önerilir;
• Değişiklikten sonra hot reconnect yapılmaz;
• Yeni TCP socket üzerinde etkili olması için reconnect gerekir;
• TFO desteklemeyen nodes belirgin bir bağlantı gecikmesi regresyonu göstermemelidir.

Geçerli sürümde bu yapılandırma seçeneği yoksa panda config --help veya gerçek CLI help esas alınmalıdır.

Privacy mode daha katı bir güvenlik modu olarak anlaşılabilir ve şu yapıya eşdeğer olması önerilir:

panda mode pandavpn global
panda kill-switch on

Veya varsayılan otomatik protocol seçimi altında:

panda mode auto
panda kill-switch on

Privacy mode altında şu kısıtlamalar önerilir:

• proxy mode desteklenmez;
• split mode desteklenmez;
• Yalnızca VPN global semantiğine izin verilir;
• Kill-switch etkinleştirilmiş olmalıdır;
• Normal egress engellenir.

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.

Yeni sürümlerde Windows Kill-switch, daemon-held dynamic session’dan persistent WFP filters’a yükseltildi.
Bu, daemon anormal şekilde çıktıktan sonra guard’ın korunabileceği anlamına gelir.

Ancak persistent WFP, boot-time filter ile aynı değildir; çok erken başlangıç penceresi hâlâ sonraki hardening kapsamındadır.

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

Evet.

mode auto + kill-switch on kullanılabilir, ancak nihai path PandaVPN / WireGuard olarak resolve edilmelidir ve standalone proxy’ye düşmemelidir. Bağlantı sırasında WireGuard’dan PandaVPN’e fallback olursa, guard active de korunmalı ve fail-open window oluşmamalıdır.

Önerilen:

panda mode auto
panda kill-switch on
panda connect
panda doctor

Önerilmez.

Kill-switch, gizlilik korumasını artıran bir seçenektir ve en kısa kullanılabilir yola eklemek için uygun değildir. Nedenler:

• disconnect Kill-switch’i kapatmaz;
• Etkinleştirildikten sonra normal ağ engellenebilir;
• LAN erişimi, DNS lockdown, firewall ve platform izin farklılıklarını da içerir;
• Yeni kullanıcılar yanlışlıkla ağın bozulduğunu düşünebilir.

Yeni kullanıcıların önce şunları tamamlaması önerilir:

panda login
panda node refresh
panda mode auto
panda connect
panda doctor

Bağlantının normal çalıştığını doğruladıktan sonra, gerektiğinde etkinleştirin:

panda kill-switch on
panda doctor

Hayır.

Bu beklenen davranıştır. Kill-switch kalıcı bir güvenlik anahtarıdır ve disconnect yalnızca mevcut runtime bağlantısını keser; Kill-switch’i otomatik olarak kapatmaz.

Normal ağ erişimini geri yüklemek için şunu çalıştırın:

panda kill-switch off

Strict mode’da Kill-switch normal LAN / WAN trafiğini engeller.
allow-lan destekleyen sürümler sınırlı LAN erişimini etkinleştirebilir:

panda kill-switch allow-lan on

LAN iznini kapatmak için:

panda kill-switch allow-lan off

Not: allow-lan private network / link-local / ULA unicast ve v1 discovery’ye izin verir, ancak Panda DNS lockdown’ın atlatılmasını önlemek için LAN DNS yine de engellenmelidir.