PandaVPN CLI GYIK

A Panda CLI a Panda parancssori kliense, amely a terminálon keresztül az alábbiakat támogatja:

• Bejelentkezés és fiókkezelés
• Csomópontok frissítése és csatlakozás csomópontokhoz
• Váltás a PandaVPN / Proxy / WireGuard / Auto módok között
• Rendszerproxy konfigurálása
• Split rules forgalommegosztási szabályok
• Split DNS konfigurálása
• Kill-switch védelem
• Auto-connect
• Naplók és diagnosztika

Belső tesztfelhasználók, fejlesztők, haladó felhasználók és szkriptelt műveleteket igénylő tesztelési forgatókönyvek számára alkalmas.

A PandaVPN CLI alkalmasabb automatizált tesztelésre, távoli hibaelhárításra és szkriptekkel vezérelt kapcsolatokra.

A Panda Desktop és a PandaVPN CLI ugyanannak a PandaVPN daemon szolgáltatásnak két vezérlőfelülete, és ugyanazt a kapcsolati állapotot használják, ezért együtt is használhatók.

Ne futtasson régi asztali alkalmazásokat, például a Panda-Qt-t vagy a régi Linux AppImage-ot a PandaVPN CLI-vel egyidejűleg, mert ez hálózati konfigurációs ütközéseket okozhat.

Bizonyos képességek rendszerszintű jogosultságokat igényelnek, például:

• TUN / WireGuard hálózati interfészek létrehozása
• DNS módosítása
• Rendszerproxy beállítása
• Kill-switch alkalmazása
• Útvonalak javítása
• A packet VPN runtime kezelése

Ezért a CLI ezeket a műveleteket a platformnak megfelelő daemon / service segítségével hajtja végre.

daemon formák különböző platformokon:

A fő különbség: Windows és macOS alatt a szolgáltatás általában automatikusan települ a telepítőcsomagon keresztül, míg Linux alatt a felhasználónak általában kézzel kell futtatnia a sudo panda service install parancsot.

Windows alatt csak akkor kell a következőt rendszergazdai PowerShellben futtatni, ha nem használ telepítőcsomagot, és kézzel helyezi el a bináris fájlokat:

panda service install windows

macOS alatt erre csak fejlesztés és hibakeresés során, .pkg telepítőcsomag használata nélkül, vagy ha a daemon nem indul el automatikusan, van szükség:

sudo panda start

Linux alatt ajánlott:

sudo panda service install
panda service status

Igen, megegyeznek. A fő különbség a letöltött telepítőcsomag architektúrája.

A telepítési lépések, parancsok és a szolgáltatáskezelés módja megegyezik. A telepítő automatikusan emeli a jogosultságokat, és regisztrálja a Windows Service-t.

Igen, ugyanazok. A fő különbség a letöltött .pkg csomag architektúrája.

A telepítési lépések megegyeznek. .pkg használatával végzett telepítés után a LaunchDaemon / helper általában automatikusan települ és elindul.

Globális felhasználók számára alapértelmezésként a mode auto használatát javasoljuk:

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

Ha egy új telepítésben alapértelmezés szerint már a mode auto van beállítva, használható az egyszerűbb verzió is:

panda login
panda node refresh
panda connect
panda doctor

A megfelelő rövidített verzió:

panda login
panda no re
panda conn
panda do

A hivatalos letöltési oldalon és a kezdő útmutatóban érdemes először a teljes parancsokat megjeleníteni; a rövidítések később, a haladó dokumentációban vagy az interaktív mód magyarázataiban jelenhetnek meg.

A gfwlist egy speciális split-szabályforrás, és nem alkalmas alapértelmezett módnak globális felhasználók számára.

Globális felhasználók számára az ajánlott alapértelmezés:

panda mode auto

Vagy használja rögzítetten a PandaVPN globális módját:

panda mode pandavpn global

A gfwlist megtartható a haladó split routing dokumentációban, de nem ajánlott megjeleníteni a hivatalos webhely első képernyőjén, a letöltési oldal Hero részében vagy a kezdőknek szóló gyorsindítóban.

Javasolt először lecsatlakozni és kikapcsolni a Kill-switch funkciót:

panda disconnect
panda kill-switch off

Ha kézi frissítésről vagy Linux service frissítésről van szó, javasolt a daemon leállítása is:

sudo panda stop

macOS és Windows esetén telepítővel végzett frissítéskor a telepítő általában automatikusan kezeli a service telepítését és újraindítását. A frissítés befejezése után javasolt futtatni:

panda version
panda doctor
panda connect

Linux kézi frissítése után javasolt:

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

panda connect us

Ez bare group selector-t jelent; nem rögzíti a VIP / SVIP / FREE tab értékét, az API választja ki a megfelelő tabot.

panda connect svip us

Ez azt jelenti, hogy az SVIP tab alatti us fixen lesz használva.

A kettőspontos forma ekvivalens, és szkriptekhez alkalmas:

panda connect svip:us

A favorite tab jelenleg flat favorite channel list, és nem támogatja az olyan favorite group smart connect működést, mint a connect fav us; favorite esetén használja:

panda connect fav

vagy:

panda connect --node <NODE_ID>

Főként ezeket támogatja:

Gyakori beállítások:

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

Az openvpn jelenleg nem ajánlott fő módként megjeleníteni a felhasználói dokumentációban.

Ajánlás:

Megjegyzés: a mode proxy és a Kill-switch kölcsönösen kizárják egymást.

A mode auto az új verzió alapértelmezett módja.

A működése:

• Az API node / smart connect a meta.protocol alapján elsődlegesen választ runtime-ot;
• Ha a WireGuard ajánlott, először a WireGuardot próbálja meg;
• Ha a WireGuard metaadatok, címkiosztás, runtime indítás, handshake vagy kapcsolódási próba sikertelen, visszaáll az SS payloadból összeállított PandaVPN globalra;
• Az SS, OPENVPN, ismeretlen vagy hiányzó protokollok a PandaVPN globalt használják tartalékként;
• A mode auto nem fogad el policy paramétert, és a feloldott runtime mindig global.

Új felhasználóknak ajánlott:

panda mode auto
panda connect

A direct-region az ajánlott írásmód; a bypass-region / bypass kompatibilitási aliasok.

Például:

panda mode pandavpn direct-region in

Ez egyenértékű a kompatibilitási aliasszal:

panda mode pandavpn bypass-region in

Az új verzió teljesebb split profile szintaxist támogat:

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

Gyakori tokenek:

Példák:

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

Kezdő dokumentációban nem ajánlott hosszú parancsokat megjeleníteni; ezek inkább haladó split dokumentációba valók.

Az összes node megtekintése:

panda node list

Frissítés után újra megtekintés:

panda node refresh
panda node list

Rövid forma:

panda no re
panda no list

Egy adott régió vagy csoport megtekintése:

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

Node-csoportok megtekintése:

panda node group

Egy adott csoport részleteinek megtekintése:

panda node group show us

Először keresse meg a node-ot:

panda node list us

Ezután csatlakozzon:

panda connect --node 1822

Név alapján is csatlakozhat:

panda connect --node "US Node"

Rövid forma:

panda no list us
panda conn --node 1822

A panda connect az utolsó célt használja.
Ha nincs korábbi cél, megpróbálja a global smart connectet.

A Smart connect feltételei:

• be van jelentkezve;
• a node-könyvtár gyorsítótárazva van;
• szükség esetén először futtassa: panda node refresh.

Rövid forma:

panda conn

Gyakori okok:

• még nincs bejelentkezve;
• a node-könyvtár nem lett frissítve;
• az aktuális fiókhoz nincs elérhető node;
• a hálózat nem érhető el;
• a daemon nem fut;
• az aktuális mode nem kompatibilis a cél-node-dal;
• mode auto alatt az ajánlott protokoll indítása sikertelen volt, és a fallback is sikertelen lett.

Ajánlott ellenőrzés:

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

panda status

Strukturált kimenet:

panda status --json

Rövid forma:

panda stat

A doctor egy csak olvasható diagnosztikai parancs, amely a Panda CLI aktuális kulcsfontosságú állapotainak megtekintésére szolgál.

panda doctor
panda doctor --json

Rövid forma:

panda do

Főként ezekre figyeljen:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

A trace annak megtekintésére szolgál, hogy egy adott cél melyik szabályt, DNS actiont és route-ot fogja használni.

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

Megjegyzés: a teljes trace képességhez active PandaVPN packet runtime szükséges. Kompatibilis runtime nélkül csak korlátozott ellenőrzés végezhető, vagy visszaesés történik legacy trace-re.

Ez általában azért történik, mert telepítve van a hivatalos service / LaunchDaemon, és emellett kézzel is futtatva lett:

sudo panda start

A sudo panda start egy unmanaged / nem kezelt daemont indít, amely a hivatalos daemon mellett egyszerre kezelheti az alábbiakat:

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

A kezelési elv: csak egy daemont tarts meg.

Gyakori eljárás macOS / Linux alatt:

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

Linuxon, ha systemd service-t használsz, ezután indítsd újra a hivatalos szolgáltatást:

sudo panda service restart
panda doctor

macOS-en, ha .pkg telepítést használsz, általában hagyd, hogy a LaunchDaemon / helper kezelje a daemont, és ne használd hosszú távon a sudo panda start parancsot napi indítási módként.

Ha csak a VPN-t szeretné bontani, nem kell kilépnie a daemon-ból:

panda disconnect
panda kill-switch off

Ha valóban le szeretné állítani a daemon-t:

sudo panda stop

Ellenőrzés:

panda status

Ha a panda daemon unavailable jelenik meg, az azt jelenti, hogy a fő daemon leállt.

Megjegyzés: A macOS .pkg által telepített LaunchDaemon / helper rendszer által kezelt lehet; átlagos felhasználóknak nem ajánlott gyakran kézzel leállítani a szolgáltatást.

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

Logs törlése:

panda log clear

Debug ideiglenes bekapcsolása:

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

Alapértelmezés visszaállítása:

panda log level reset

no-tunnel IPv6 esetén a awdl0 / llw0 block alá kerülhet, ami miatt az AirDrop / Continuity átmenetileg nem érhető el.
Általában disconnect után helyreáll.

Ha továbbra is rendellenes, ajánlott:

panda disconnect
panda kill-switch off
panda repair
panda doctor

A támogatott verziókban ez konfigurálható:

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

Magyarázat:

• Alapértelmezésként a auto ajánlott;
• A módosítás után nem történik hot reconnect;
• Reconnect szükséges ahhoz, hogy az új TCP socket esetén érvénybe lépjen;
• Azoknál a node-oknál, amelyek nem támogatják a TFO-t, nem kellene jelentős kapcsolódási késleltetés-romlásnak jelentkeznie.

Ha az aktuális verzióban nincs ilyen konfigurációs elem, a panda config --help vagy a tényleges CLI help az irányadó.

A Privacy mode szigorúbb biztonsági módként értelmezhető, és ajánlott az alábbival egyenértékűnek tekinteni:

panda mode pandavpn global
panda kill-switch on

Vagy az alapértelmezett automatikus protokollválasztás mellett:

panda mode auto
panda kill-switch on

Privacy mode esetén a következő korlátozások ajánlottak:

• Nem támogatja a proxy mode módot;
• Nem támogatja a split mode módot;
• Csak VPN global szemantika engedélyezett;
• A Kill-switch bekapcsolása kötelező;
• A normál egress blokkolva van.

A panda repair átfogóbb, és javíthatja a következőket:

• VPN route
• DNS snapshot
• Kill-switch guard
• system proxy-val kapcsolatos állapot

A panda proxy repair főként az aktuális felhasználó system proxy drift problémáját javítja.

panda repair
panda proxy repair

Fresh install esetén az alapértelmezés proxy system-proxy on.
Ha a felhasználó kifejezetten elmentette az off értéket, ez a konfiguráció megmarad.

Megtekintés vagy beállítás:

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

Megjegyzés: mode auto, pandavpn és wireguard alatt a VPN runtime figyelmen kívül hagyja a tartósan mentett system proxy preferenciát; a VPN companion proxy továbbra is elérhető, és scoped egress útvonalat használ.

A Windows system proxy az aktuális felhasználó HKCU WinINET beállítása, és per-user user-agent szükséges hozzá.
Ha SSH-ban vagy nem interaktív munkamenetben van, a proxy repair nem mindig tudja automatikusan elindítani a user-agentet.

Ajánlott:

panda proxy status
panda proxy repair
panda doctor

Ha továbbra sem lép érvénybe, próbálja újra asztali bejelentkezési munkamenetben.

A Linux Phase 1 főként a GNOME gsettings támogatását biztosítja.
Az olyan környezetek, mint a KDE / XFCE, unsupported állapotként jelenhetnek meg.

Ez nem feltétlenül érinti a PandaVPN packet runtime működését, de befolyásolhatja a system proxy mode élményét.

A Kill-switch jelentése az, hogy csak a TUN-on áthaladó forgalmat engedi, minden más normál forgalmat blokkol.

A proxy mode egy standalone helyi proxy mód, nincs benne packet VPN / TUN, és nem nyújt azonos szintű DNS- és routingvédelmet. Ezért a Kill-switch nem támogatja a standalone proxy mode-ot.

Ha Kill-switch szükséges, használja:

panda mode auto
panda kill-switch on

Vagy:

panda mode pandavpn global
panda kill-switch on

Vagy:

panda mode wireguard
panda kill-switch on

Nem.

Az Auto-connect főként a best-effort connectet fedi le a daemon / service indulásakor, valamint a pending retryt, amikor induláskor átmenetileg nincs hálózat.

Bekapcsolás:

panda config auto-connect on

Kikapcsolás:

panda config auto-connect off

Ez nem általános runtime automatikus újracsatlakozási mechanizmus.

A Split rules arra szolgál, hogy megadja, bizonyos domainek, kulcsszavak, regex vagy IP-k proxy, direct vagy block útvonalon menjenek.

Szabályfájlok:

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

Gyakori parancsok:

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

Jelenlegi ismert korlátozás: login után a retryre váró pending auto-connect nem wake automatikusan.

Login után ajánlott kézzel futtatni:

panda connect

Általában nem. A Split DNS konfigurációs módosításai hot-load módon töltődnek be.

Gyakori parancsok:

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

Ha a platform nem támogat bizonyos local DNS forrásokat, a doctor warning üzenetet ad.

Az új verziókban a Windows Kill-switch daemon-held dynamic session modellről persistent WFP filters modellre frissült.
Ez azt jelenti, hogy a guard megmaradhat a daemon rendellenes kilépése után is.

A persistent WFP azonban nem azonos a boot-time filter-rel; a nagyon korai indítási ablak továbbra is a későbbi hardening körébe tartozik.

A Kill-switch jelentése az, hogy csak a TUN-on áthaladó forgalmat engedi, minden más normál forgalmat blokkol.

A proxy mode egy standalone helyi proxy mód, nincs benne packet VPN / TUN, és nem nyújt azonos szintű DNS- és routingvédelmet. Ezért a Kill-switch nem támogatja a standalone proxy mode-ot.

Ha Kill-switch szükséges, használja:

panda mode auto
panda kill-switch on

Vagy:

panda mode pandavpn global
panda kill-switch on

Vagy:

panda mode wireguard
panda kill-switch on

Igen.

A mode auto + kill-switch on engedélyezett, de a végső útvonalnak PandaVPN / WireGuard értékre kell resolve-olnia, és nem eshet vissza standalone proxyra. Csatlakozás közben, ha WireGuardról PandaVPN-re történik fallback, a guard active állapotot is fenn kell tartani, és nem jelenhet meg fail-open window.

Ajánlott:

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

Nem ajánlott.

A Kill-switch egy fokozott adatvédelmi opció, és nem alkalmas arra, hogy a legrövidebb használható útvonal része legyen. Okok:

• A disconnect nem kapcsolja ki a Kill-switch-et;
• Bekapcsolás után a normál hálózat blokkolódhat;
• LAN-hozzáférés, DNS lockdown, firewall és platformengedélyek közötti különbségek is érintettek;
• Az új felhasználók tévesen azt hihetik, hogy elromlott a hálózat.

Az új felhasználóknak ajánlott először ezt elvégezni:

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

Miután megerősítette, hogy a kapcsolat normálisan működik, szükség szerint kapcsolja be:

panda kill-switch on
panda doctor

Nem.

Ez a várt működés. A Kill-switch egy tartós biztonsági kapcsoló, a disconnect pedig csak az aktuális runtime-ot bontja; nem kapcsolja ki automatikusan a Kill-switch funkciót.

A normál hálózati hozzáférés visszaállításához futtasd:

panda kill-switch off

Szigorú módban a Kill-switch blokkolja a normál LAN / WAN forgalmat.
Az allow-lan-t támogató verziók korlátozott LAN-hozzáférést engedélyezhetnek:

panda kill-switch allow-lan on

LAN engedélyezés kikapcsolása:

panda kill-switch allow-lan off

Megjegyzés: az allow-lan engedélyezi a private network / link-local / ULA unicast és v1 discovery forgalmat, de a LAN DNS-nek továbbra is blokkolva kell maradnia, hogy ne lehessen megkerülni a Panda DNS lockdown-t.