Česta pitanja za PandaVPN CLI

Panda CLI je Pandin klijent naredbenog retka i podržava sljedeće radnje putem terminala:

• Prijavu i upravljanje računom
• Osvježavanje čvorova i povezivanje s čvorovima
• Prebacivanje između načina PandaVPN / Proxy / WireGuard / Auto
• Konfiguraciju sistemskog proxyja
• Split rules pravila za podjelu prometa
• Konfiguraciju Split DNS-a
• Kill-switch zaštitu
• Auto-connect
• Zapisnike i dijagnostiku

Prikladan je za interne testne korisnike, programere, napredne korisnike i testne scenarije koji zahtijevaju skriptirane operacije.

PandaVPN CLI prikladniji je za automatizirano testiranje, udaljeno otklanjanje poteškoća i povezivanje putem skripti.

Panda Desktop i PandaVPN CLI dva su upravljačka sučelja za isti PandaVPN daemon i dijele isto stanje veze, pa se mogu koristiti zajedno.

Nemojte istodobno s PandaVPN CLI-jem pokretati stare desktop aplikacije, poput Panda-Qt-a ili starog Linux AppImagea, jer to može uzrokovati sukobe u mrežnoj konfiguraciji.

Neke mogućnosti zahtijevaju dozvole na razini sustava, primjerice:

• Stvaranje TUN / WireGuard mrežnih sučelja
• Izmjena DNS-a
• Postavljanje sistemskog proxyja
• Primjena Kill-switcha
• Popravak ruta
• Upravljanje packet VPN runtimeom

Zato CLI izvodi te operacije putem daemon / service odgovarajućeg za platformu.

Oblici daemon na različitim platformama:

Ključna razlika je: Na Windowsu i macOS-u usluga se obično automatski instalira putem instalacijskog paketa, dok na Linuxu korisnik obično mora ručno pokrenuti sudo panda service install.

Na Windowsu je sljedeće potrebno pokrenuti u administratorskom PowerShellu samo ako ne koristite instalacijski paket i ručno postavljate binarne datoteke:

panda service install windows

Na macOS-u je ovo potrebno samo tijekom razvoja i otklanjanja pogrešaka, ako se ne koristi .pkg instalacijski paket ili ako se daemon ne pokreće automatski:

sudo panda start

Na Linuxu preporučujemo:

sudo panda service install
panda service status

Da, isti su. Razlika je uglavnom u arhitekturi instalacijskog paketa koji se preuzima.

Koraci instalacije, naredbe i način upravljanja uslugom isti su. Instalacijski paket automatski će povisiti privilegije i registrirati Windows Service.

Da, isti su. Glavna razlika je u arhitekturi preuzetog .pkg paketa.

Koraci instalacije su isti. Nakon instalacije pomoću .pkg, LaunchDaemon / helper obično se automatski instalira i pokreće.

Za globalne korisnike preporučujemo zadano korištenje mode auto:

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

Ako nova instalacija već zadano koristi mode auto, može se koristiti i jednostavnija verzija:

panda login
panda node refresh
panda connect
panda doctor

Odgovarajuća skraćena verzija:

panda login
panda no re
panda conn
panda do

Na službenoj stranici za preuzimanje i u vodiču za početnike preporučuje se prvo prikazati pune naredbe; skraćenice se mogu prikazati kasnije u naprednoj dokumentaciji ili objašnjenjima interaktivnog načina rada.

gfwlist je specifičan izvor pravila za split routing i nije prikladan kao zadani način rada za globalne korisnike.

Za globalne korisnike zadano se preporučuje:

panda mode auto

Ili stalno koristiti globalni način rada PandaVPN-a:

panda mode pandavpn global

gfwlist može ostati u dokumentaciji za napredni split routing, ali se ne preporučuje prikazivati ga na prvom zaslonu službene stranice, u Hero dijelu stranice za preuzimanje ili u brzom vodiču za početnike.

Preporučuje se najprije odspojiti vezu i isključiti Kill-switch:

panda disconnect
panda kill-switch off

Ako je riječ o ručnoj nadogradnji ili nadogradnji Linux service, preporučuje se zaustaviti i daemon:

sudo panda stop

Pri nadogradnji macOS-a i Windowsa pomoću instalacijskog paketa, instalacijski paket obično automatski obrađuje instalaciju i ponovno pokretanje service. Nakon završetka nadogradnje preporučuje se pokrenuti:

panda version
panda doctor
panda connect

Nakon ručne nadogradnje na Linuxu preporučuje se:

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

panda connect us

Označava bare group selector; ne fiksira VIP / SVIP / FREE tab, nego API odabire odgovarajući tab.

panda connect svip us

Označava fiksno korištenje us pod SVIP tab.

Oblik s dvotočkom je ekvivalentan i prikladan za skripte:

panda connect svip:us

favorite tab trenutno je flat favorite channel list i ne podržava favorite group smart connect poput connect fav us; za favorite koristite:

panda connect fav

ili:

panda connect --node <NODE_ID>

Uglavnom podržava:

Česte postavke:

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

Trenutačno se ne preporučuje prikazivati openvpn kao glavni način u korisničkoj dokumentaciji.

Preporuka:

Napomena: mode proxy i Kill-switch međusobno se isključuju.

mode auto je zadani način u novoj verziji.

Njegovo ponašanje je:

• API node / smart connect prioritetno bira runtime prema meta.protocol;
• Ako je preporučen WireGuard, najprije će pokušati WireGuard;
• Ako WireGuard metapodaci, dodjela adrese, pokretanje runtimea, handshake ili provjera povezivosti ne uspiju, vraća se na PandaVPN global kompiliran iz SS payload;
• SS, OPENVPN te nepoznati ili nedostajući protokoli koriste PandaVPN global kao fallback;
• mode auto ne prihvaća parametar policy, a razriješeni runtime uvijek je global.

Preporučeno za nove korisnike:

panda mode auto
panda connect

direct-region je preporučeni zapis; bypass-region / bypass su kompatibilni aliasi.

Na primjer:

panda mode pandavpn direct-region in

Ekvivalentno je kompatibilnom aliasu:

panda mode pandavpn bypass-region in

Nova verzija podržava potpuniju sintaksu split profile:

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

Česti tokeni:

Primjeri:

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

Ne preporučuje se prikazivanje dugih naredbi u dokumentaciji za početnike; prikladnije su za naprednu split dokumentaciju.

Prikaz svih čvorova:

panda node list

Osvježite pa ponovno prikažite:

panda node refresh
panda node list

Kratki zapis:

panda no re
panda no list

Prikaz određene regije ili grupe:

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

Prikaz grupa čvorova:

panda node group

Prikaz detalja određene grupe:

panda node group show us

Prvo pretražite node:

panda node list us

Zatim se povežite:

panda connect --node 1822

Možete se povezati i po nazivu:

panda connect --node "US Node"

Kratki zapis:

panda no list us
panda conn --node 1822

panda connect koristi zadnji cilj.
Ako nema prethodnog cilja, pokušat će global smart connect.

Smart connect zahtijeva:

• da ste prijavljeni;
• da je direktorij čvorova spremljen u predmemoriju;
• po potrebi najprije pokrenite panda node refresh.

Kratki zapis:

panda conn

Česti razlozi:

• još niste prijavljeni;
• direktorij čvorova nije osvježen;
• trenutni račun nema dostupnih čvorova;
• mreža nije dostupna;
• daemon nije pokrenut;
• trenutni mode nije kompatibilan s ciljnim čvorom;
• u mode auto preporučeni protokol nije se uspio pokrenuti, a fallback je također zakazao.

Preporučena provjera:

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

panda status

Strukturirani izlaz:

panda status --json

Kratki zapis:

panda stat

doctor je dijagnostička naredba samo za čitanje, koja se koristi za prikaz trenutačnih ključnih stanja Panda CLI-ja.

panda doctor
panda doctor --json

Kratki zapis:

panda do

Posebno obratite pozornost na:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace se koristi za pregled pravila, DNS action i route koje će određeni cilj koristiti.

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

Napomena: puna trace funkcionalnost zahtijeva active PandaVPN packet runtime. Bez kompatibilnog runtimea moguća je samo ograničena provjera ili povratak na legacy trace.

To se obično događa zato što je instaliran službeni service / LaunchDaemon, a ručno je pokrenuto i:

sudo panda start

sudo panda start pokreće unmanaged / neupravljani daemon, koji istovremeno sa službenim daemonom može upravljati:

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

Načelo rješavanja je: zadržati samo jedan daemon.

Uobičajeno rješavanje na macOS / Linux:

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

Na Linuxu, ako koristite systemd service, zatim ponovno pokrenite službeni servis:

sudo panda service restart
panda doctor

Na macOS-u, ako je instalirano putem .pkg, obično prepustite LaunchDaemon / helperu upravljanje daemonom i nemojte dugoročno koristiti sudo panda start kao svakodnevni način pokretanja.

Ako samo želite prekinuti VPN, ne morate izlaziti iz daemon:

panda disconnect
panda kill-switch off

Ako zaista želite zaustaviti daemon:

sudo panda stop

Potvrdite:

panda status

Ako se prikaže panda daemon unavailable, to znači da je glavni daemon zaustavljen.

Napomena: LaunchDaemon / helper instaliran putem macOS .pkg može biti pod upravljanjem sustava; običnim korisnicima se ne preporučuje često ručno zaustavljanje usluge.

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

Očisti logs:

panda log clear

Privremeno uključi debug:

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

Vrati zadano:

panda log level reset

U no-tunnel IPv6 scenariju awdl0 / llw0 mogu biti block, zbog čega AirDrop / Continuity mogu privremeno biti nedostupni.
Obično se oporavi nakon disconnect.

Ako je i dalje neuobičajeno, preporučuje se:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Podržane verzije mogu konfigurirati ovo:

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

Objašnjenje:

• Zadano se preporučuje auto;
• Nakon promjene neće doći do hot reconnect;
• Potreban je reconnect kako bi vrijedilo za novi TCP socket;
• Nodes koji ne podržavaju TFO ne bi trebali pokazati očito pogoršanje latencije povezivanja.

Ako trenutna verzija nema ovu konfiguracijsku opciju, mjerodavan je panda config --help ili stvarni CLI help.

Privacy mode može se shvatiti kao stroži sigurnosni način rada i preporučuje se smatrati ga ekvivalentnim ovome:

panda mode pandavpn global
panda kill-switch on

Ili, uz zadani automatski odabir protokola:

panda mode auto
panda kill-switch on

U Privacy mode preporučuju se sljedeća ograničenja:

• Ne podržava proxy mode;
• Ne podržava split mode;
• Dopušta samo semantiku VPN global;
• Kill-switch mora biti omogućen;
• Uobičajeni egress je blokiran.

panda repair je sveobuhvatniji i može popraviti:

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

panda proxy repair uglavnom popravlja system proxy drift trenutačnog korisnika.

panda repair
panda proxy repair

Kod Fresh install zadano je proxy system-proxy on.
Ako je korisnik izričito spremio off, ta će se konfiguracija zadržati.

Prikaz ili postavljanje:

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

Napomena: u mode auto, pandavpn i wireguard, VPN runtime ignorira spremljenu system proxy preferencu; VPN companion proxy ostaje dostupan i koristi scoped egress.

Windows system proxy je HKCU WinINET postavka trenutnog korisnika i zahtijeva per-user user-agent.
Ako ste u SSH ili neinteraktivnoj sesiji, proxy repair možda neće uvijek moći automatski pokrenuti user-agent.

Preporučeno:

panda proxy status
panda proxy repair
panda doctor

Ako i dalje ne stupi na snagu, pokušajte ponovno u desktop login session.

Linux Phase 1 uglavnom podržava GNOME gsettings.
Okruženja poput KDE / XFCE mogu se prikazati kao unsupported.

To ne mora nužno utjecati na PandaVPN packet runtime, ali može utjecati na iskustvo system proxy mode.

Značenje Kill-switcha je dopustiti promet samo kroz TUN, dok se ostali uobičajeni promet blokira.

proxy mode je standalone lokalni proxy način rada, bez packet VPN / TUN i bez jednakovrijedne DNS i routing zaštite. Zato Kill-switch ne podržava standalone proxy mode.

Kada trebate Kill-switch, koristite:

panda mode auto
panda kill-switch on

Ili:

panda mode pandavpn global
panda kill-switch on

Ili:

panda mode wireguard
panda kill-switch on

Ne.

Auto-connect uglavnom pokriva best-effort connect pri pokretanju daemon / service, kao i pending retry kada mreža privremeno nije dostupna pri pokretanju.

Uključivanje:

panda config auto-connect on

Isključivanje:

panda config auto-connect off

To nije opći mehanizam automatskog ponovnog povezivanja tijekom runtime.

Split rules služe za određivanje da određene domene, ključne riječi, regex ili IP idu preko proxy, direct ili block.

Datoteke pravila:

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

Česte naredbe:

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 poznato ograničenje: nakon login, pending auto-connect koji čeka retry neće se automatski wake.

Preporučuje se nakon login ručno pokrenuti:

panda connect

Obično nije potrebno. Promjene konfiguracije Split DNS-a se hot-load.

Česte naredbe:

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

Ako platforma ne podržava neke local DNS izvore, doctor će prikazati warning.

U novim verzijama Windows Kill-switch nadograđen je s daemon-held dynamic session na persistent WFP filters.
To znači da guard može ostati nakon neuobičajenog izlaska daemon.

Međutim, persistent WFP nije isto što i boot-time filter; vrlo rani prozor pokretanja i dalje je dio budućeg hardening opsega.

Značenje Kill-switcha je dopustiti promet samo kroz TUN, dok se ostali uobičajeni promet blokira.

proxy mode je standalone lokalni proxy način rada, bez packet VPN / TUN i bez jednakovrijedne DNS i routing zaštite. Zato Kill-switch ne podržava standalone proxy mode.

Kada trebate Kill-switch, koristite:

panda mode auto
panda kill-switch on

Ili:

panda mode pandavpn global
panda kill-switch on

Ili:

panda mode wireguard
panda kill-switch on

Da.

mode auto + kill-switch on je dopušteno, ali konačna putanja mora se resolve u PandaVPN / WireGuard i ne smije završiti na standalone proxy. Tijekom povezivanja, ako dođe do fallbacka s WireGuard na PandaVPN, guard active također mora ostati aktivan i ne smije se pojaviti fail-open window.

Preporučeno:

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

Ne preporučuje se.

Kill-switch je opcija pojačane zaštite privatnosti i nije prikladan za najkraći upotrebljivi put. Razlozi:

• disconnect ne isključuje Kill-switch;
• Nakon uključivanja obična mreža može biti blokirana;
• Uključuje i LAN pristup, DNS lockdown, firewall i razlike u dozvolama platformi;
• Novi korisnici mogu pogrešno pomisliti da je mreža pokvarena.

Novim korisnicima preporučuje se da prvo dovrše:

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

Nakon što potvrdite da veza radi normalno, uključite po potrebi:

panda kill-switch on
panda doctor

Ne.

Ovo je očekivano ponašanje. Kill-switch je trajni sigurnosni prekidač, a disconnect samo prekida trenutni runtime; ne isključuje automatski Kill-switch.

Ako želite vratiti normalan pristup mreži, pokrenite:

panda kill-switch off

U strogom načinu rada Kill-switch blokira uobičajeni LAN / WAN promet.
Verzije koje podržavaju allow-lan mogu uključiti ograničen LAN pristup:

panda kill-switch allow-lan on

Isključivanje LAN dopuštenja:

panda kill-switch allow-lan off

Napomena: allow-lan dopušta private network / link-local / ULA unicast i v1 discovery, ali LAN DNS i dalje treba biti blokiran kako bi se izbjeglo zaobilaženje Panda DNS lockdown.