Časté dotazy k PandaVPN CLI

Panda CLI je klient příkazového řádku pro Panda a podporuje provádění následujících akcí přes terminál:

• Přihlášení a správa účtu
• Obnovení uzlů a připojení k uzlům
• Přepínání režimů PandaVPN / Proxy / WireGuard / Auto
• Konfigurace systémového proxy
• Pravidla Split rules pro rozdělení provozu
• Konfigurace Split DNS
• Ochrana Kill-switch
• Auto-connect
• Protokoly a diagnostika

Je vhodný pro interní testovací uživatele, vývojáře, pokročilé uživatele a testovací scénáře vyžadující skriptované operace.

Panda CLI funguje přes příkazový řádek a je vhodnější pro:

• Automatizované testování
• Vzdálené řešení problémů
• Skriptované připojení
• Zobrazení podrobných diagnostických informací
• Ověřování nízkoúrovňového chování, jako je Kill-switch, DNS, směrování a systémový proxy

Desktopový klient je vhodnější pro běžné uživatele a každodenní grafické ovládání.

Poznámka: Nedoporučuje se, aby starý desktopový klient Qt a CLI současně spravovaly VPN / systémový proxy, aby nedocházelo k vzájemnému přepisování konfigurace.

Některé funkce vyžadují oprávnění na úrovni systému, například:

• Vytváření síťových rozhraní TUN / WireGuard
• Úprava DNS
• Nastavení systémového proxy
• Použití Kill-switch
• Oprava tras
• Správa packet VPN runtime

CLI proto tyto operace provádí prostřednictvím daemon / service odpovídající dané platformě.

Formy daemon na různých platformách:

Hlavní rozdíl je: Ve Windows a macOS se služba obvykle instaluje automaticky pomocí instalačního balíčku, zatímco v Linuxu musí uživatel obvykle ručně spustit sudo panda service install.

Ve Windows je nutné spustit následující příkaz v PowerShellu jako správce pouze tehdy, když nepoužíváte instalační balíček a binární soubory umisťujete ručně:

panda service install windows

V macOS je to potřeba pouze při vývoji a ladění, pokud nepoužíváte instalační balíček .pkg, nebo když se daemon nespustí automaticky:

sudo panda start

Pro Linux se doporučuje:

sudo panda service install
panda service status

Ano, jsou stejné. Rozdíl je hlavně v architektuře staženého instalačního balíčku.

Kroky instalace, příkazy i způsob správy služby jsou stejné. Instalační balíček automaticky zvýší oprávnění a zaregistruje Windows Service.

Hlavně podporuje:

Běžná nastavení:

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

openvpn se aktuálně nedoporučuje zobrazovat jako hlavní režim v uživatelské dokumentaci.

Doporučení:

Poznámka: mode proxy se vzájemně vylučuje s Kill-switch.

mode auto je výchozí režim nové verze.

Chová se takto:

• API node / smart connect přednostně vybírá runtime podle meta.protocol;
• Pokud je doporučen WireGuard, nejdříve se zkusí WireGuard;
• Pokud selžou metadata WireGuard, přidělení adresy, spuštění runtime, handshake nebo test konektivity, vrátí se na PandaVPN global sestavený z SS payload;
• SS, OPENVPN a neznámé nebo chybějící protokoly použijí jako zálohu PandaVPN global;
• mode auto nepřijímá parametr policy a vyřešený runtime je vždy global.

Novým uživatelům doporučujeme používat:

panda mode auto
panda connect

direct-region je doporučený zápis; bypass-region / bypass jsou kompatibilní aliasy.

Například:

panda mode pandavpn direct-region in

Je ekvivalentní kompatibilnímu aliasu:

panda mode pandavpn bypass-region in

Nová verze podporuje úplnější zápis split profile:

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

Běžné tokeny:

Pří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 dokumentaci pro začátečníky se nedoporučuje zobrazovat dlouhé příkazy; hodí se do pokročilé dokumentace pro split.

doctor je diagnostický příkaz jen pro čtení, který slouží k zobrazení aktuálních klíčových stavů Panda CLI.

panda doctor
panda doctor --json

Zkrácený zápis:

panda do

Zaměřte se hlavně na:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace slouží ke zjištění, jaké pravidlo, DNS action a route použije konkrétní cíl.

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

Poznámka: plná funkce trace vyžaduje active PandaVPN packet runtime. Bez kompatibilního runtime lze provést pouze omezenou kontrolu nebo přejít zpět na legacy trace.

Obvykle je to proto, že byl nainstalován oficiální service / LaunchDaemon a zároveň byl ručně spuštěn:

sudo panda start

sudo panda start spustí unmanaged / nespravovaný daemon, který může současně s oficiálním daemon spravovat:

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

Princip řešení je: ponechte pouze jeden daemon.

Běžný postup pro macOS / Linux:

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

V Linuxu, pokud používáte systemd service, poté restartujte oficiální službu:

sudo panda service restart
panda doctor

V macOS, pokud používáte instalaci přes .pkg, obvykle nechte daemon spravovat LaunchDaemon / helper a nepoužívejte dlouhodobě sudo panda start jako každodenní způsob spuštění.

Pokud chcete pouze odpojit VPN, není potřeba daemon ukončovat:

panda disconnect
panda kill-switch off

Pokud opravdu chcete daemon zastavit:

sudo panda stop

Ověření:

panda status

Pokud se zobrazí panda daemon unavailable, znamená to, že hlavní daemon byl zastaven.

Poznámka: LaunchDaemon / helper nainstalovaný přes macOS .pkg může být spravován systémem; běžným uživatelům se nedoporučuje službu často ručně zastavovat.

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

Vymazání logs:

panda log clear

Dočasné zapnutí debug:

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

Obnovení výchozího nastavení:

panda log level reset

panda repair je komplexnější a může opravit:

• VPN route
• DNS snapshot
• Kill-switch guard
• stavy související se system proxy

panda proxy repair opravuje hlavně system proxy drift aktuálního uživatele.

panda repair
panda proxy repair

Při Fresh install je výchozí nastavení proxy system-proxy on.
Pokud uživatel výslovně uložil off, tato konfigurace se zachová.

Zobrazit nebo nastavit:

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

Poznámka: v mode auto, pandavpn a wireguard bude VPN runtime ignorovat uloženou preferenci system proxy; VPN companion proxy zůstává dostupný a používá scoped egress.

Windows system proxy je nastavení HKCU WinINET aktuálního uživatele a vyžaduje per-user user-agent.
Pokud jste v SSH nebo neinteraktivní relaci, proxy repair nemusí vždy automaticky spustit user-agent.

Doporučeno:

panda proxy status
panda proxy repair
panda doctor

Pokud to stále nefunguje, zkuste to znovu v desktop login session.

Linux Phase 1 podporuje hlavně GNOME gsettings.
Prostředí jako KDE / XFCE se mohou zobrazovat jako unsupported.

Nemusí to nutně ovlivnit PandaVPN packet runtime, ale může to ovlivnit zkušenost se system proxy mode.

Význam Kill-switch je povolit pouze provoz přes TUN a ostatní běžný provoz blokovat.

proxy mode je standalone režim místního proxy, bez packet VPN / TUN a bez ekvivalentní ochrany DNS a routingu. Proto Kill-switch nepodporuje standalone proxy mode.

Když potřebujete Kill-switch, použijte:

panda mode auto
panda kill-switch on

Nebo:

panda mode pandavpn global
panda kill-switch on

Nebo:

panda mode wireguard
panda kill-switch on

Ne.

Auto-connect pokrývá hlavně best-effort connect při spuštění daemon / service a také pending retry, když při spuštění dočasně není dostupná síť.

Zapnout:

panda config auto-connect on

Vypnout:

panda config auto-connect off

Není to obecný mechanismus automatického opětovného připojení za runtime.

Split rules slouží k určení, zda určité domény, klíčová slova, regex nebo IP půjdou přes proxy, direct nebo block.

Soubory pravidel:

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

Běžné pří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ální známé omezení: po login se pending auto-connect čekající na opakování automaticky neprobudí.

Po login doporučujeme ručně spustit:

panda connect

Obvykle není potřeba. Změny konfigurace Split DNS se hot-load.

Běžné pří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

Pokud platforma nepodporuje některé zdroje local DNS, doctor zobrazí warning.