Časté otázky k PandaVPN CLI

Panda CLI je klient príkazového riadka pre Panda a podporuje vykonávanie nasledujúcich akcií cez terminál:

• Prihlásenie a správa účtu
• Obnovenie uzlov a pripojenie k uzlom
• Prepínanie režimov PandaVPN / Proxy / WireGuard / Auto
• Konfigurácia systémového proxy
• Pravidlá Split rules na rozdelenie prevádzky
• Konfigurácia Split DNS
• Ochrana Kill-switch
• Auto-connect
• Protokoly a diagnostika

Je vhodný pre interných testovacích používateľov, vývojárov, pokročilých používateľov a testovacie scenáre vyžadujúce skriptované operácie.

Panda CLI funguje cez príkazový riadok a je vhodnejší na:

• Automatizované testovanie
• Vzdialené riešenie problémov
• Skriptované pripojenia
• Zobrazenie podrobných diagnostických informácií
• Overovanie nízkoúrovňového správania, ako je Kill-switch, DNS, smerovanie a systémový proxy

Desktopový klient je vhodnejší na každodenné grafické operácie bežných používateľov.

Poznámka: Neodporúča sa, aby starý desktopový klient Qt a CLI súčasne spravovali VPN / systémový proxy, aby sa predišlo vzájomnému prepisovaniu konfigurácií.

Niektoré funkcie vyžadujú oprávnenia na úrovni systému, napríklad:

• Vytváranie sieťových rozhraní TUN / WireGuard
• Úprava DNS
• Nastavenie systémového proxy
• Použitie Kill-switch
• Oprava trás
• Správa packet VPN runtime

CLI preto vykonáva tieto operácie prostredníctvom daemon / service zodpovedajúcej danej platforme.

Formy daemon na rôznych platformách:

Hlavný rozdiel je: V systémoch Windows a macOS sa služba zvyčajne nainštaluje automaticky cez inštalačný balík, zatiaľ čo v Linuxe musí používateľ zvyčajne ručne spustiť sudo panda service install.

V systéme Windows je potrebné spustiť nasledujúci príkaz v PowerShelli ako správca iba vtedy, ak nepoužívate inštalačný balík a binárne súbory umiestňujete ručne:

panda service install windows

V systéme macOS je to potrebné iba pri vývoji a ladení, keď sa nepoužíva inštalačný balík .pkg, alebo keď sa daemon nespustí automaticky:

sudo panda start

V Linuxe odporúčame:

sudo panda service install
panda service status

Áno, sú rovnaké. Rozdiel je hlavne v architektúre stiahnutého inštalačného balíka.

Kroky inštalácie, príkazy aj spôsob správy služby sú rovnaké. Inštalátor automaticky zvýši oprávnenia a zaregistruje Windows Service.

Podporuje hlavne:

Časté nastavenia:

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

openvpn sa aktuálne neodporúča zobrazovať ako hlavný režim v používateľskej dokumentácii.

Odporúčanie:

Poznámka: mode proxy a Kill-switch sa navzájom vylučujú.

mode auto je predvolený režim v novej verzii.

Jeho správanie je:

• API node / smart connect prioritne vyberá runtime podľa meta.protocol;
• Ak je odporúčaný WireGuard, najskôr sa skúsi WireGuard;
• Ak zlyhajú metadáta WireGuard, pridelenie adresy, spustenie runtime, handshake alebo test konektivity, vráti sa na PandaVPN global skompilovaný zo SS payload;
• SS, OPENVPN a neznáme alebo chýbajúce protokoly použijú PandaVPN global ako fallback;
• mode auto neprijíma parameter policy a vyriešený runtime je vždy global.

Odporúčané pre nových používateľov:

panda mode auto
panda connect

direct-region je odporúčaný zápis; bypass-region / bypass sú kompatibilné aliasy.

Napríklad:

panda mode pandavpn direct-region in

Je ekvivalentom kompatibilného aliasu:

panda mode pandavpn bypass-region in

Nová verzia podporuje úplnejšiu syntax split profile:

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

Časté tokeny:

Príklady:

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

V dokumentácii pre začiatočníkov sa neodporúča zobrazovať dlhé príkazy; sú vhodnejšie pre pokročilú split dokumentáciu.

doctor je diagnostický príkaz iba na čítanie, ktorý slúži na zobrazenie aktuálnych kľúčových stavov Panda CLI.

panda doctor
panda doctor --json

Skrátený zápis:

panda do

Zamerajte sa najmä na:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace slúži na zistenie, aké pravidlo, DNS action a route použije konkrétny cieľ.

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

Poznámka: úplná funkcia trace vyžaduje active PandaVPN packet runtime. Bez kompatibilného runtime je možná iba obmedzená kontrola alebo fallback na legacy trace.

Zvyčajne sa to stane preto, že je nainštalovaný oficiálny service / LaunchDaemon a zároveň bolo ručne spustené:

sudo panda start

sudo panda start spustí unmanaged / nespravovaný daemon, ktorý môže súčasne s oficiálnym daemon spravovať:

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

Princíp riešenia je: ponechajte iba jeden daemon.

Bežný postup na macOS / Linux:

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

V Linuxe, ak používate systemd service, potom reštartujte oficiálnu službu:

sudo panda service restart
panda doctor

V macOS, ak používate inštaláciu cez .pkg, zvyčajne nechajte LaunchDaemon / helper spravovať daemon a nepoužívajte sudo panda start dlhodobo ako každodenný spôsob spúšťania.

Ak chcete iba odpojiť VPN, nemusíte ukončovať daemon:

panda disconnect
panda kill-switch off

Ak naozaj chcete zastaviť daemon:

sudo panda stop

Potvrdenie:

panda status

Ak sa zobrazí panda daemon unavailable, znamená to, že hlavný daemon bol zastavený.

Poznámka: LaunchDaemon / helper nainštalovaný cez macOS .pkg môže byť spravovaný systémom; bežným používateľom sa neodporúča často manuálne zastavovať službu.

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

Vyčistiť logs:

panda log clear

Dočasne zapnúť debug:

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

Obnoviť predvolené:

panda log level reset

panda repair je komplexnejší a môže opraviť:

• VPN route
• DNS snapshot
• Kill-switch guard
• stavy súvisiace so system proxy

panda proxy repair opravuje hlavne system proxy drift aktuálneho používateľa.

panda repair
panda proxy repair

Pri Fresh install je predvolene nastavené proxy system-proxy on.
Ak používateľ výslovne uložil off, táto konfigurácia sa zachová.

Zobraziť alebo nastaviť:

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

Poznámka: v mode auto, pandavpn a wireguard VPN runtime ignoruje uloženú preferenciu system proxy; VPN companion proxy zostáva dostupný a používa scoped egress.

Windows system proxy je nastavenie HKCU WinINET aktuálneho používateľa a vyžaduje per-user user-agent.
Ak ste v SSH alebo neinteraktívnej relácii, proxy repair nemusí vždy automaticky spustiť user-agent.

Odporúčané:

panda proxy status
panda proxy repair
panda doctor

Ak sa stále neprejaví, skúste to znova v desktop login session.

Linux Phase 1 podporuje hlavne GNOME gsettings.
Prostredia ako KDE / XFCE sa môžu zobrazovať ako unsupported.

Nemusí to nevyhnutne ovplyvniť PandaVPN packet runtime, ale môže to ovplyvniť skúsenosť so system proxy mode.

Význam Kill-switch je povoliť iba prevádzku cez TUN, zatiaľ čo iná bežná prevádzka sa blokuje.

proxy mode je standalone lokálny proxy režim, bez packet VPN / TUN a bez ekvivalentnej ochrany DNS a routingu. Preto Kill-switch nepodporuje standalone proxy mode.

Keď potrebujete Kill-switch, použite:

panda mode auto
panda kill-switch on

Alebo:

panda mode pandavpn global
panda kill-switch on

Alebo:

panda mode wireguard
panda kill-switch on

Nie.

Auto-connect pokrýva najmä best-effort connect pri spustení daemon / service a tiež pending retry, keď pri štarte dočasne nie je dostupná sieť.

Zapnúť:

panda config auto-connect on

Vypnúť:

panda config auto-connect off

Nie je to všeobecný mechanizmus automatického opätovného pripojenia počas runtime.

Split rules slúžia na určenie, či určité domény, kľúčové slová, regex alebo IP pôjdu cez proxy, direct alebo block.

Súbory pravidiel:

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

Bežné príkazy:

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

Aktuálne známe obmedzenie: po login sa pending auto-connect čakajúci na retry automaticky neprebudí.

Po login odporúčame manuálne spustiť:

panda connect

Zvyčajne nie. Zmeny konfigurácie Split DNS sa načítajú cez hot-load.

Bežné príkazy:

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

Ak platforma nepodporuje niektoré zdroje local DNS, doctor zobrazí warning.