Pogosta vprašanja PandaVPN CLI

Panda CLI je Pandin odjemalec ukazne vrstice in prek terminala podpira naslednje:

• Prijavo in upravljanje računa
• Osveževanje vozlišč in povezovanje z vozlišči
• Preklapljanje med načini PandaVPN / Proxy / WireGuard / Auto
• Konfiguracijo sistemskega posredniškega strežnika
• Pravila Split rules za delitev prometa
• Konfiguracijo Split DNS
• Zaščito Kill-switch
• Auto-connect
• Dnevnike in diagnostiko

Primeren je za interne testne uporabnike, razvijalce, napredne uporabnike in testne scenarije, ki zahtevajo skriptirane operacije.

PandaVPN CLI je primernejši za avtomatizirano testiranje, oddaljeno odpravljanje težav in povezave, upravljane s skripti.

Panda Desktop in PandaVPN CLI sta dva nadzorna vmesnika za isti PandaVPN daemon in si delita isto stanje povezave, zato ju je mogoče uporabljati skupaj.

Ne zaganjajte starejših namiznih aplikacij, kot sta Panda-Qt ali stari Linux AppImage, hkrati s PandaVPN CLI, saj lahko to povzroči spore v omrežni konfiguraciji.

Nekatere zmožnosti zahtevajo dovoljenja na ravni sistema, na primer:

• Ustvarjanje omrežnih vmesnikov TUN / WireGuard
• Spreminjanje DNS
• Nastavitev sistemskega posrednika
• Uporaba Kill-switch
• Popravilo poti
• Upravljanje packet VPN runtime

Zato CLI te operacije izvaja prek daemon / service, ki ustreza platformi.

Oblike daemon na različnih platformah:

Glavna razlika je: V sistemih Windows in macOS se storitev običajno samodejno namesti prek namestitvenega paketa, medtem ko mora uporabnik v Linuxu običajno ročno zagnati sudo panda service install.

V sistemu Windows morate naslednje zagnati v PowerShellu kot skrbnik samo, če ne uporabljate namestitvenega paketa in binarne datoteke nameščate ročno:

panda service install windows

V sistemu macOS je to potrebno samo med razvojem in odpravljanjem napak, kadar ne uporabljate namestitvenega paketa .pkg, ali kadar se daemon ne zažene samodejno:

sudo panda start

V Linuxu priporočamo:

sudo panda service install
panda service status

Da, enaki so. Razlika je predvsem v arhitekturi prenesenega namestitvenega paketa.

Koraki namestitve, ukazi in način upravljanja storitve so enaki. Namestitveni program bo samodejno povišal privilegije in registriral Windows Service.

Da, enaki so. Glavna razlika je v arhitekturi prenesenega paketa .pkg.

Koraki namestitve so enaki. Po namestitvi s .pkg se LaunchDaemon / helper običajno samodejno namesti in zažene.

Za globalne uporabnike priporočamo privzeto uporabo mode auto:

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

Če nova namestitev že privzeto uporablja mode auto, lahko uporabite tudi preprostejšo različico:

panda login
panda node refresh
panda connect
panda doctor

Ustrezna skrajšana različica:

panda login
panda no re
panda conn
panda do

Uradna stran za prenos in uvod za začetnike naj najprej prikazujeta polne ukaze; okrajšave se lahko prikažejo pozneje v napredni dokumentaciji ali razlagi interaktivnega načina.

gfwlist je specifičen vir pravil za split routing in ni primeren kot privzeti način za globalne uporabnike.

Za globalne uporabnike je privzeto priporočeno:

panda mode auto

Ali pa stalno uporabljajte globalni način PandaVPN:

panda mode pandavpn global

gfwlist lahko ostane v dokumentaciji za napredni split routing, vendar ni priporočljivo, da se pojavi na prvem zaslonu uradne spletne strani, v Hero delu strani za prenos ali v hitrem začetku za začetnike.

Priporočljivo je, da se najprej odklopite in izklopite Kill-switch:

panda disconnect
panda kill-switch off

Če gre za ročno nadgradnjo ali nadgradnjo Linux service, je priporočljivo ustaviti tudi daemon:

sudo panda stop

Pri nadgradnji macOS in Windows z namestitvenim programom ta običajno samodejno uredi namestitev in ponovni zagon service. Po končani nadgradnji priporočamo zagon:

panda version
panda doctor
panda connect

Po ročni nadgradnji na Linuxu priporočamo:

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

panda connect us

Pomeni bare group selector; ne določi VIP / SVIP / FREE tab, API pa izbere ustrezen tab.

panda connect svip us

Pomeni stalno uporabo us pod SVIP tab.

Oblika z dvopičjem je enakovredna in primerna za skripte:

panda connect svip:us

favorite tab je trenutno flat favorite channel list in ne podpira favorite group smart connect, kot je connect fav us; za favorite uporabite:

panda connect fav

ali:

panda connect --node <NODE_ID>

Podpira predvsem:

Pogoste nastavitve:

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

Trenutno ni priporočljivo prikazovati openvpn kot glavnega načina v uporabniški dokumentaciji.

Priporočilo:

Opomba: mode proxy in Kill-switch se medsebojno izključujeta.

mode auto je privzeti način v novi različici.

Njegovo delovanje je:

• API node / smart connect prednostno izbere runtime glede na meta.protocol;
• Če je priporočen WireGuard, bo najprej poskusil WireGuard;
• Če metapodatki WireGuard, dodelitev naslova, zagon runtime, handshake ali preverjanje povezljivosti ne uspejo, se vrne na PandaVPN global, sestavljen iz SS payload;
• SS, OPENVPN ter neznani ali manjkajoči protokoli bodo uporabili PandaVPN global kot fallback;
• mode auto ne sprejme parametra policy, razrešeni runtime pa je vedno global.

Priporočeno za nove uporabnike:

panda mode auto
panda connect

direct-region je priporočeni zapis; bypass-region / bypass sta združljiva aliasa.

Na primer:

panda mode pandavpn direct-region in

Je enakovredno združljivemu aliasu:

panda mode pandavpn bypass-region in

Nova različica podpira popolnejšo sintakso split profile:

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

Pogosti tokeni:

Primeri:

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 dokumentaciji za začetnike ni priporočljivo prikazovati dolgih ukazov; primernejši so za napredno split dokumentacijo.

Prikaz vseh vozlišč:

panda node list

Osvežite in nato znova prikažite:

panda node refresh
panda node list

Kratka oblika:

panda no re
panda no list

Prikaz določene regije ali skupine:

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

Prikaz skupin vozlišč:

panda node group

Prikaz podrobnosti določene skupine:

panda node group show us

Najprej poiščite node:

panda node list us

Nato se povežite:

panda connect --node 1822

Povežete se lahko tudi po imenu:

panda connect --node "US Node"

Kratka oblika:

panda no list us
panda conn --node 1822

panda connect uporabi zadnji cilj.
Če prejšnjega cilja ni, poskusi global smart connect.

Smart connect zahteva:

• da ste prijavljeni;
• da je imenik vozlišč shranjen v predpomnilniku;
• po potrebi najprej zaženite panda node refresh.

Kratka oblika:

panda conn

Pogosti razlogi:

• še niste prijavljeni;
• imenik vozlišč ni bil osvežen;
• trenutni račun nima razpoložljivih vozlišč;
• omrežje ni na voljo;
• daemon ne teče;
• trenutni mode ni združljiv s ciljnim vozliščem;
• v mode auto se priporočeni protokol ni uspel zagnati, fallback pa je prav tako spodletel.

Priporočeno preverjanje:

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

panda status

Strukturiran izpis:

panda status --json

Kratka oblika:

panda stat

doctor je diagnostični ukaz samo za branje, ki se uporablja za ogled trenutnih ključnih stanj Panda CLI.

panda doctor
panda doctor --json

Kratka oblika:

panda do

Posebej se osredotočite na:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace se uporablja za ogled, katero pravilo, DNS action in route bo uporabila določena tarča.

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

Opomba: polna zmožnost trace zahteva active PandaVPN packet runtime. Brez združljivega runtime je mogoča le omejena validacija ali fallback na legacy trace.

To se običajno zgodi, ker je nameščen uradni service / LaunchDaemon, poleg tega pa je bil ročno zagnan:

sudo panda start

sudo panda start zažene unmanaged / neupravljan daemon, ki lahko hkrati z uradnim daemon upravlja:

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

Načelo reševanja je: obdržite samo en daemon.

Pogosta obravnava na macOS / Linux:

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

Na Linuxu, če uporabljate systemd service, nato znova zaženite uradni service:

sudo panda service restart
panda doctor

Na macOS, če uporabljate namestitev .pkg, običajno pustite, da LaunchDaemon / helper upravlja daemon, in ne uporabljajte sudo panda start dolgoročno kot vsakodnevni način zagona.

Če želite samo prekiniti VPN, vam ni treba zapustiti daemon:

panda disconnect
panda kill-switch off

Če res želite ustaviti daemon:

sudo panda stop

Potrditev:

panda status

Če se prikaže panda daemon unavailable, pomeni, da je glavni daemon ustavljen.

Opomba: LaunchDaemon / helper, nameščen prek macOS .pkg, lahko upravlja sistem; običajnim uporabnikom ni priporočeno pogosto ročno ustavljati storitve.

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

Počisti logs:

panda log clear

Začasno vklopi debug:

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

Obnovi privzeto:

panda log level reset

V scenariju no-tunnel IPv6 sta lahko awdl0 / llw0 block, zaradi česar sta AirDrop / Continuity začasno nedostopna.
Običajno se obnovi po disconnect.

Če je še vedno nenavadno, priporočeno:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Podprte različice lahko to konfigurirajo:

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

Pojasnilo:

• Privzeto je priporočeno auto;
• Po spremembi ne bo hot reconnect;
• Za uveljavitev na novih TCP socket je potreben reconnect;
• Nodes, ki ne podpirajo TFO, ne bi smeli pokazati očitne regresije zakasnitve povezave.

Če trenutna različica nima te konfiguracijske možnosti, upoštevajte panda config --help ali dejansko CLI help.

Privacy mode lahko razumemo kot strožji varnostni način in priporočeno je, da je enakovreden:

panda mode pandavpn global
panda kill-switch on

Ali pri privzeti samodejni izbiri protokola:

panda mode auto
panda kill-switch on

V Privacy mode so priporočene naslednje omejitve:

• Ne podpira proxy mode;
• Ne podpira split mode;
• Dovoljuje samo semantiko VPN global;
• Kill-switch mora biti omogočen;
• Običajni egress je blokiran.

panda repair je bolj celovit in lahko popravi:

• VPN route
• DNS snapshot
• Kill-switch guard
• stanje, povezano s system proxy

panda proxy repair predvsem popravi system proxy drift trenutnega uporabnika.

panda repair
panda proxy repair

Pri Fresh install je privzeto proxy system-proxy on.
Če je uporabnik izrecno shranil off, se ta konfiguracija ohrani.

Ogled ali nastavitev:

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

Opomba: v mode auto, pandavpn in wireguard VPN runtime ignorira shranjeno nastavitev system proxy; VPN companion proxy ostane na voljo in uporablja scoped egress.

Windows system proxy je nastavitev HKCU WinINET trenutnega uporabnika in zahteva per-user user-agent.
Če ste v SSH ali neinteraktivni seji, proxy repair morda ne bo vedno mogel samodejno zagnati user-agent.

Priporočeno:

panda proxy status
panda proxy repair
panda doctor

Če še vedno ne začne veljati, poskusite znova v desktop login session.

Linux Phase 1 podpira predvsem GNOME gsettings.
Okolja, kot sta KDE / XFCE, se lahko prikažejo kot unsupported.

To ne vpliva nujno na PandaVPN packet runtime, lahko pa vpliva na izkušnjo s system proxy mode.

Pomen Kill-switch je, da dovoli samo promet prek TUN, medtem ko je drug običajen promet blokiran.

proxy mode je standalone lokalni proxy način, brez packet VPN / TUN in brez enakovredne zaščite DNS ter routinga. Zato Kill-switch ne podpira standalone proxy mode.

Ko potrebujete Kill-switch, uporabite:

panda mode auto
panda kill-switch on

Ali:

panda mode pandavpn global
panda kill-switch on

Ali:

panda mode wireguard
panda kill-switch on

Ne.

Auto-connect večinoma pokriva best-effort connect ob zagonu daemon / service ter pending retry, kadar omrežje ob zagonu začasno ni na voljo.

Vklop:

panda config auto-connect on

Izklop:

panda config auto-connect off

To ni splošen mehanizem samodejne ponovne povezave med runtime.

Split rules se uporabljajo za določanje, ali določene domene, ključne besede, regex ali IP gredo prek proxy, direct ali block.

Datoteke pravil:

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

Pogosti ukazi:

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

Trenutno znana omejitev: po login se pending auto-connect, ki čaka na retry, ne bo samodejno wake.

Po login je priporočljivo ročno zagnati:

panda connect

Običajno ne. Spremembe konfiguracije Split DNS se naložijo z hot-load.

Pogosti ukazi:

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

Če platforma ne podpira nekaterih virov local DNS, bo doctor prikazal warning.

V novih različicah je Windows Kill-switch nadgrajen iz daemon-held dynamic session na persistent WFP filters.
To pomeni, da lahko guard ostane tudi po nenormalnem izhodu daemon.

Vendar persistent WFP ni enak boot-time filter; zelo zgodnje zagonsko okno še vedno spada v prihodnji obseg hardening.

Pomen Kill-switch je, da dovoli samo promet prek TUN, medtem ko je drug običajen promet blokiran.

proxy mode je standalone lokalni proxy način, brez packet VPN / TUN in brez enakovredne zaščite DNS ter routinga. Zato Kill-switch ne podpira standalone proxy mode.

Ko potrebujete Kill-switch, uporabite:

panda mode auto
panda kill-switch on

Ali:

panda mode pandavpn global
panda kill-switch on

Ali:

panda mode wireguard
panda kill-switch on

Da.

mode auto + kill-switch on je dovoljeno, vendar se mora končna pot resolve v PandaVPN / WireGuard in ne sme pasti na standalone proxy. Med povezovanjem, če pride do fallbacka iz WireGuard na PandaVPN, mora guard active ostati ohranjen in ne sme se pojaviti fail-open window.

Priporočeno:

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

Ni priporočljivo.

Kill-switch je možnost za okrepljeno zaščito zasebnosti in ni primeren za najkrajšo uporabno pot. Razlogi:

• disconnect ne izklopi Kill-switch;
• Po vklopu je lahko običajno omrežje blokirano;
• Vključuje tudi dostop LAN, DNS lockdown, firewall in razlike v dovoljenjih platform;
• Novi uporabniki lahko napačno mislijo, da je omrežje pokvarjeno.

Novim uporabnikom priporočamo, da najprej dokončajo:

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

Ko potrdite, da povezava deluje normalno, ga po potrebi vklopite:

panda kill-switch on
panda doctor

Ne.

To je pričakovano vedenje. Kill-switch je trajno varnostno stikalo, disconnect pa samo prekine trenutni runtime; Kill-switch se ne izklopi samodejno.

Če želite obnoviti običajen dostop do omrežja, zaženite:

panda kill-switch off

V strogem načinu Kill-switch blokira običajen promet LAN / WAN.
Različice, ki podpirajo allow-lan, lahko omogočijo omejen dostop do LAN:

panda kill-switch allow-lan on

Izklop dovoljenja LAN:

panda kill-switch allow-lan off

Opomba: allow-lan dovoljuje private network / link-local / ULA unicast in v1 discovery, vendar mora LAN DNS ostati blokiran, da se prepreči obhod Panda DNS lockdown.