Întrebări frecvente PandaVPN CLI

Panda CLI este clientul de linie de comandă al Panda și permite efectuarea următoarelor acțiuni prin terminal:

• Autentificare și administrarea contului
• Reîmprospătarea nodurilor și conectarea la noduri
• Comutarea între modurile PandaVPN / Proxy / WireGuard / Auto
• Configurarea proxy-ului de sistem
• Reguli Split rules pentru împărțirea traficului
• Configurarea Split DNS
• Protecție Kill-switch
• Auto-connect
• Jurnale și diagnosticare

Este potrivit pentru utilizatori de testare internă, dezvoltatori, utilizatori avansați și scenarii de testare care necesită operațiuni scriptate.

PandaVPN CLI este mai potrivit pentru testare automată, depanare de la distanță și conexiuni controlate prin scripturi.

Panda Desktop și PandaVPN CLI sunt două interfețe de control pentru același PandaVPN daemon și partajează aceeași stare a conexiunii, astfel încât pot fi utilizate împreună.

Nu rulați aplicații desktop vechi, precum Panda-Qt sau vechiul Linux AppImage, în același timp cu PandaVPN CLI, deoarece acest lucru poate provoca conflicte în configurația rețelei.

Unele capabilități necesită permisiuni la nivel de sistem, de exemplu:

• Crearea interfețelor de rețea TUN / WireGuard
• Modificarea DNS
• Setarea proxy-ului de sistem
• Aplicarea Kill-switch
• Repararea rutelor
• Gestionarea packet VPN runtime

Prin urmare, CLI execută aceste operațiuni prin daemon / service corespunzător platformei.

Forme de daemon pe diferite platforme:

Diferența principală este: pe Windows și macOS, serviciul este de obicei instalat automat prin pachetul de instalare, în timp ce pe Linux utilizatorul trebuie de obicei să ruleze manual sudo panda service install.

Pe Windows, doar dacă nu folosiți pachetul de instalare și plasați manual fișierul binar, trebuie să rulați următoarea comandă în PowerShell ca administrator:

panda service install windows

Pe macOS, acest lucru este necesar doar în timpul dezvoltării și depanării, când nu se folosește pachetul de instalare .pkg, sau când daemon nu pornește automat:

sudo panda start

Pe Linux, recomandăm:

sudo panda service install
panda service status

Da, sunt aceiași. Diferența principală este arhitectura pachetului de instalare descărcat.

Pașii de instalare, comenzile și modul de gestionare a serviciului sunt aceleași. Instalatorul va ridica automat privilegiile și va înregistra Windows Service.

Da, sunt aceiași. Diferența principală este arhitectura pachetului .pkg descărcat.

Pașii de instalare sunt aceiași. După instalarea cu .pkg, LaunchDaemon / helper este de obicei instalat și pornit automat.

Pentru utilizatorii globali, recomandăm utilizarea implicită a mode auto:

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

Dacă o instalare nouă folosește deja implicit mode auto, puteți utiliza și o versiune mai simplă:

panda login
panda node refresh
panda connect
panda doctor

Versiunea prescurtată corespunzătoare:

panda login
panda no re
panda conn
panda do

Pagina oficială de descărcare și ghidul pentru începători ar trebui să afișeze cu prioritate comenzile complete; prescurtările pot fi afișate ulterior în documentația avansată sau în explicațiile modului interactiv.

gfwlist este o sursă specifică de reguli split și nu este potrivită ca mod implicit pentru utilizatorii globali.

Pentru utilizatorii globali, implicit se recomandă:

panda mode auto

Sau utilizați în mod fix modul global PandaVPN:

panda mode pandavpn global

gfwlist poate rămâne în documentația avansată de split routing, dar nu este recomandat să apară pe primul ecran al site-ului oficial, în Hero-ul paginii de descărcare sau în ghidul quick start pentru începători.

Se recomandă să vă deconectați mai întâi și să opriți Kill-switch:

panda disconnect
panda kill-switch off

Dacă este o actualizare manuală sau o actualizare Linux service, se recomandă să opriți și daemon:

sudo panda stop

La actualizarea macOS și Windows cu un installer, installerul gestionează de obicei automat instalarea și repornirea service. După finalizarea actualizării, se recomandă să rulați:

panda version
panda doctor
panda connect

După o actualizare manuală pe Linux, se recomandă:

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

panda connect us

Înseamnă un bare group selector; nu fixează VIP / SVIP / FREE tab, iar API alege tab-ul potrivit.

panda connect svip us

Înseamnă folosirea fixă a us sub SVIP tab.

Forma cu două puncte este echivalentă și potrivită pentru scripturi:

panda connect svip:us

favorite tab este în prezent o flat favorite channel list și nu acceptă favorite group smart connect precum connect fav us; pentru favorite, folosește:

panda connect fav

sau:

panda connect --node <NODE_ID>

Acceptă în principal:

Setări comune:

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

În prezent, nu se recomandă afișarea openvpn ca mod principal în documentația pentru utilizatori.

Recomandare:

Notă: mode proxy și Kill-switch se exclud reciproc.

mode auto este modul implicit al noii versiuni.

Comportamentul său este:

• API node / smart connect alege runtime-ul cu prioritate pe baza meta.protocol;
• Dacă WireGuard este recomandat, va încerca mai întâi WireGuard;
• Dacă metadatele WireGuard, alocarea adresei, pornirea runtime-ului, handshake-ul sau verificarea conectivității eșuează, revine la PandaVPN global compilat din SS payload;
• SS, OPENVPN și protocoalele necunoscute sau lipsă vor folosi PandaVPN global ca fallback;
• mode auto nu acceptă parametrul policy, iar runtime-ul rezolvat este întotdeauna global.

Recomandat pentru utilizatorii noi:

panda mode auto
panda connect

direct-region este sintaxa recomandată; bypass-region / bypass sunt aliasuri de compatibilitate.

De exemplu:

panda mode pandavpn direct-region in

Este echivalent cu aliasul de compatibilitate:

panda mode pandavpn bypass-region in

Noua versiune acceptă o sintaxă split profile mai completă:

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

Token-uri comune:

Exemple:

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

Nu se recomandă afișarea comenzilor lungi în documentația pentru începători; sunt mai potrivite pentru documentația split avansată.

Afișarea tuturor nodurilor:

panda node list

Reîmprospătați și apoi afișați din nou:

panda node refresh
panda node list

Formă scurtă:

panda no re
panda no list

Afișarea unei regiuni sau a unui grup anume:

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

Afișarea grupurilor de noduri:

panda node group

Afișarea detaliilor unui grup anume:

panda node group show us

Mai întâi caută node-ul:

panda node list us

Apoi conectează-te:

panda connect --node 1822

Te poți conecta și după nume:

panda connect --node "US Node"

Formă scurtă:

panda no list us
panda conn --node 1822

panda connect folosește ultima țintă.
Dacă nu există o țintă anterioară, va încerca global smart connect.

Smart connect necesită:

• să fiți autentificat;
• directorul de noduri să fie în cache;
• dacă este necesar, rulați mai întâi panda node refresh.

Formă scurtă:

panda conn

Cauze frecvente:

• nu sunteți încă autentificat;
• directorul de noduri nu a fost reîmprospătat;
• contul curent nu are noduri disponibile;
• rețeaua nu este disponibilă;
• daemon nu rulează;
• mode-ul curent este incompatibil cu nodul țintă;
• în mode auto, protocolul recomandat nu a pornit, iar fallback a eșuat și el.

Verificări recomandate:

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

panda status

Ieșire structurată:

panda status --json

Formă scurtă:

panda stat

doctor este o comandă de diagnosticare doar pentru citire, folosită pentru a vedea stările cheie curente ale Panda CLI.

panda doctor
panda doctor --json

Formă scurtă:

panda do

Acordați atenție în special la:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace este folosit pentru a vedea ce regulă, DNS action și route va folosi o anumită țintă.

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

Notă: capacitatea completă de trace necesită active PandaVPN packet runtime. Fără un runtime compatibil, este disponibilă doar validarea limitată sau fallback la legacy trace.

De obicei, acest lucru se întâmplă deoarece service / LaunchDaemon oficial este instalat și, în plus, ați rulat manual:

sudo panda start

sudo panda start pornește un daemon unmanaged / negestionat, care poate gestiona în același timp cu daemon oficial:

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

Principiul de remediere este: păstrați un singur daemon.

Remediere uzuală pe macOS / Linux:

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

Pe Linux, dacă folosiți systemd service, reporniți apoi serviciul oficial:

sudo panda service restart
panda doctor

Pe macOS, dacă instalarea s-a făcut cu .pkg, de obicei lăsați LaunchDaemon / helper să gestioneze daemon și nu folosiți sudo panda start pe termen lung ca metodă zilnică de pornire.

Dacă doriți doar să deconectați VPN-ul, nu este nevoie să ieșiți din daemon:

panda disconnect
panda kill-switch off

Dacă doriți într-adevăr să opriți daemon:

sudo panda stop

Confirmați:

panda status

Dacă apare panda daemon unavailable, înseamnă că daemon-ul principal s-a oprit.

Notă: LaunchDaemon / helper instalat prin macOS .pkg poate fi gestionat de sistem; utilizatorilor obișnuiți nu li se recomandă să oprească manual serviciul frecvent.

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

Curățați logs:

panda log clear

Activați temporar debug:

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

Restabiliți implicit:

panda log level reset

Într-un scenariu no-tunnel IPv6, awdl0 / llw0 pot fi block, ceea ce face ca AirDrop / Continuity să fie temporar indisponibile.
De obicei se recuperează după disconnect.

Dacă încă este anormal, recomandat:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Versiunile acceptate pot configura acest lucru:

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

Explicație:

• Valoarea implicită recomandată este auto;
• Modificarea nu va declanșa hot reconnect;
• Este necesar reconnect pentru ca setarea să se aplice pe TCP socket noi;
• Nodes care nu acceptă TFO nu ar trebui să prezinte o regresie evidentă a latenței de conectare.

Dacă versiunea curentă nu are această opțiune de configurare, urmați panda config --help sau ajutorul CLI real.

Privacy mode poate fi înțeles ca un mod de securitate mai strict și se recomandă să fie considerat echivalent cu:

panda mode pandavpn global
panda kill-switch on

Sau, cu selecția automată implicită a protocolului:

panda mode auto
panda kill-switch on

În Privacy mode se recomandă următoarele restricții:

• Nu acceptă proxy mode;
• Nu acceptă split mode;
• Permite doar semantica VPN global;
• Kill-switch trebuie activat;
• egress normal este blocat.

panda repair este mai cuprinzător și poate repara:

• VPN route
• DNS snapshot
• Kill-switch guard
• stări legate de system proxy

panda proxy repair repară în principal system proxy drift pentru utilizatorul curent.

panda repair
panda proxy repair

La Fresh install, valoarea implicită este proxy system-proxy on.
Dacă utilizatorul a salvat explicit off, acea configurație va fi păstrată.

Vizualizare sau setare:

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

Notă: în mode auto, pandavpn și wireguard, VPN runtime ignoră preferința system proxy persistentă; VPN companion proxy rămâne disponibil și folosește scoped egress.

Windows system proxy este o setare HKCU WinINET a utilizatorului curent și necesită un per-user user-agent.
Dacă sunteți într-o sesiune SSH sau neinteractivă, proxy repair este posibil să nu poată porni automat user-agent.

Recomandat:

panda proxy status
panda proxy repair
panda doctor

Dacă tot nu se aplică, încercați din nou într-o sesiune de autentificare desktop.

Linux Phase 1 acceptă în principal GNOME gsettings.
Mediile precum KDE / XFCE pot apărea ca unsupported.

Acest lucru nu afectează neapărat PandaVPN packet runtime, dar poate afecta experiența system proxy mode.

Semnificația Kill-switch este să permită traficul doar prin TUN, în timp ce alt trafic obișnuit este blocat.

proxy mode este un mod proxy local standalone, fără packet VPN / TUN și fără protecție DNS și routing echivalentă. Prin urmare, Kill-switch nu acceptă standalone proxy mode.

Când aveți nevoie de Kill-switch, folosiți:

panda mode auto
panda kill-switch on

Sau:

panda mode pandavpn global
panda kill-switch on

Sau:

panda mode wireguard
panda kill-switch on

Nu.

Auto-connect acoperă în principal best-effort connect la pornirea daemon / service, precum și pending retry când rețeaua este temporar indisponibilă la pornire.

Activare:

panda config auto-connect on

Dezactivare:

panda config auto-connect off

Nu este un mecanism general de reconectare automată în runtime.

Split rules sunt folosite pentru a specifica dacă anumite domenii, cuvinte-cheie, regex sau IP-uri trec prin proxy, direct sau block.

Fișiere de reguli:

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

Comenzi uzuale:

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

Limitare cunoscută în prezent: după login, pending auto-connect care așteaptă retry nu va fi wake automat.

Se recomandă să rulați manual după login:

panda connect

De obicei, nu. Modificările configurației Split DNS sunt încărcate prin hot-load.

Comenzi uzuale:

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

Dacă platforma nu acceptă anumite surse local DNS, doctor va afișa un warning.

În versiunile noi, Windows Kill-switch a fost actualizat de la daemon-held dynamic session la persistent WFP filters.
Aceasta înseamnă că guard poate rămâne activ după ieșirea anormală a daemon.

Dar persistent WFP nu este același lucru cu boot-time filter; fereastra foarte timpurie de pornire rămâne în domeniul viitorului hardening.

Semnificația Kill-switch este să permită traficul doar prin TUN, în timp ce alt trafic obișnuit este blocat.

proxy mode este un mod proxy local standalone, fără packet VPN / TUN și fără protecție DNS și routing echivalentă. Prin urmare, Kill-switch nu acceptă standalone proxy mode.

Când aveți nevoie de Kill-switch, folosiți:

panda mode auto
panda kill-switch on

Sau:

panda mode pandavpn global
panda kill-switch on

Sau:

panda mode wireguard
panda kill-switch on

Da.

mode auto + kill-switch on este permis, dar calea finală trebuie să resolve către PandaVPN / WireGuard și nu trebuie să ajungă la standalone proxy. În timpul conectării, dacă are loc fallback de la WireGuard la PandaVPN, guard active trebuie de asemenea menținut și nu trebuie să apară nicio fail-open window.

Recomandat:

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

Nu este recomandat.

Kill-switch este o opțiune de protecție sporită a confidențialității și nu este potrivită pentru cel mai scurt traseu utilizabil. Motive:

• disconnect nu dezactivează Kill-switch;
• După activare, rețeaua normală poate fi blocată;
• Implică și acces LAN, DNS lockdown, firewall și diferențe de permisiuni între platforme;
• Utilizatorii noi pot crede greșit că rețeaua este defectă.

Utilizatorilor noi li se recomandă să finalizeze mai întâi:

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

După ce confirmați că conexiunea funcționează normal, activați la nevoie:

panda kill-switch on
panda doctor

Nu.

Acesta este comportamentul așteptat. Kill-switch este un comutator de siguranță persistent, iar disconnect doar deconectează runtime-ul curent; nu dezactivează automat Kill-switch.

Pentru a restabili accesul normal la rețea, execută:

panda kill-switch off

În modul strict, Kill-switch blochează traficul LAN / WAN obișnuit.
Versiunile care acceptă allow-lan pot activa acces LAN limitat:

panda kill-switch allow-lan on

Dezactivarea permiterii LAN:

panda kill-switch allow-lan off

Notă: allow-lan permite private network / link-local / ULA unicast și v1 discovery, dar LAN DNS ar trebui să rămână blocat pentru a evita ocolirea Panda DNS lockdown.