PandaVPN CLI DUK

Panda CLI yra Panda komandinės eilutės klientas, palaikantis šiuos veiksmus per terminalą:

• Prisijungimą ir paskyros valdymą
• Mazgų atnaujinimą ir prisijungimą prie mazgų
• Perjungimą tarp PandaVPN / Proxy / WireGuard / Auto režimų
• Sistemos tarpinio serverio konfigūravimą
• Split rules srauto skaidymo taisykles
• Split DNS konfigūravimą
• Kill-switch apsaugą
• Auto-connect
• Žurnalus ir diagnostiką

Jis tinka vidiniams testuotojams, kūrėjams, pažengusiems naudotojams ir testavimo scenarijams, kuriems reikia scenarijais valdomų operacijų.

PandaVPN CLI geriau tinka automatizuotam testavimui, nuotoliniam trikčių šalinimui ir scenarijais valdomiems ryšiams.

Panda Desktop ir PandaVPN CLI yra dvi to paties PandaVPN daemon valdymo sąsajos ir naudoja tą pačią prisijungimo būseną, todėl jas galima naudoti kartu.

Nepaleiskite senų darbalaukio programų, tokių kaip Panda-Qt ar senasis Linux AppImage, kartu su PandaVPN CLI, nes tai gali sukelti tinklo konfigūracijos konfliktų.

Kai kurioms galimybėms reikia sistemos lygio leidimų, pavyzdžiui:

• Kurti TUN / WireGuard tinklo sąsajas
• Keisti DNS
• Nustatyti sistemos tarpinį serverį
• Taikyti Kill-switch
• Taisyti maršrutus
• Valdyti packet VPN runtime

Todėl CLI šias operacijas atlieka per platformai pritaikytą daemon / service.

daemon formos skirtingose platformose:

Pagrindinis skirtumas yra toks: Windows ir macOS sistemose paslauga paprastai automatiškai įdiegiama per diegimo paketą, o Linux sistemoje naudotojui paprastai reikia rankiniu būdu paleisti sudo panda service install.

Windows sistemoje tik tada, kai nenaudojate diegimo paketo ir rankiniu būdu dedate dvejetainius failus, reikia paleisti šią komandą administratoriaus PowerShell aplinkoje:

panda service install windows

macOS sistemoje to reikia tik kūrimo ir derinimo metu, kai nenaudojamas .pkg diegimo paketas, arba kai daemon nepasileidžia automatiškai:

sudo panda start

Linux sistemoje rekomenduojama:

sudo panda service install
panda service status

Taip, jie tokie patys. Pagrindinis skirtumas yra atsisiunčiamo diegimo paketo architektūra.

Diegimo veiksmai, komandos ir paslaugos valdymo būdas yra tokie patys. Diegimo paketas automatiškai padidins teises ir užregistruos Windows Service.

Taip, jie tokie patys. Pagrindinis skirtumas yra atsisiųsto .pkg paketo architektūra.

Diegimo veiksmai yra tokie patys. Įdiegus naudojant .pkg, LaunchDaemon / helper paprastai įdiegiamas ir paleidžiamas automatiškai.

Pasauliniams naudotojams rekomenduojame pagal numatytuosius nustatymus naudoti mode auto:

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

Jei naujoje diegimo versijoje mode auto jau yra numatytasis, galima naudoti ir paprastesnę versiją:

panda login
panda node refresh
panda connect
panda doctor

Atitinkama sutrumpinta versija:

panda login
panda no re
panda conn
panda do

Oficialiame atsisiuntimo puslapyje ir pradedančiųjų įvade rekomenduojama pirmiausia rodyti visas komandas; sutrumpinimus galima rodyti vėliau pažangioje dokumentacijoje arba interaktyvaus režimo paaiškinimuose.

gfwlist yra konkretus split rules šaltinis ir netinka kaip numatytasis režimas pasauliniams naudotojams.

Pasauliniams naudotojams pagal numatytuosius nustatymus rekomenduojama:

panda mode auto

Arba nuolat naudoti PandaVPN globalų režimą:

panda mode pandavpn global

gfwlist gali likti išplėstinėje split routing dokumentacijoje, bet nerekomenduojama jo rodyti oficialios svetainės pirmajame ekrane, atsisiuntimo puslapio Hero dalyje ar pradedančiųjų quick start vadove.

Rekomenduojama pirmiausia atsijungti ir išjungti Kill-switch:

panda disconnect
panda kill-switch off

Jei tai rankinis atnaujinimas arba Linux service atnaujinimas, taip pat rekomenduojama sustabdyti daemon:

sudo panda stop

Atnaujinant macOS ir Windows naudojant diegiklį, diegiklis paprastai automatiškai sutvarko service diegimą ir paleidimą iš naujo. Baigus atnaujinimą, rekomenduojama vykdyti:

panda version
panda doctor
panda connect

Po rankinio Linux atnaujinimo rekomenduojama:

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

panda connect us

Tai reiškia bare group selector; jis nefiksuoja VIP / SVIP / FREE tab, o API parenka tinkamą tab.

panda connect svip us

Tai reiškia fiksuotą us naudojimą po SVIP tab.

Forma su dvitaškiu yra lygiavertė ir tinkama skriptams:

panda connect svip:us

favorite tab šiuo metu yra flat favorite channel list ir nepalaiko favorite group smart connect, pvz., connect fav us; favorite naudokite:

panda connect fav

arba:

panda connect --node <NODE_ID>

Daugiausia palaiko:

Dažni nustatymai:

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

Šiuo metu nerekomenduojama naudotojų dokumentacijoje rodyti openvpn kaip pagrindinio režimo.

Rekomendacija:

Pastaba: mode proxy ir Kill-switch yra tarpusavyje nesuderinami.

mode auto yra naujos versijos numatytasis režimas.

Jo veikimas:

• API node / smart connect pirmenybę teikia runtime pasirinkimui pagal meta.protocol;
• Jei rekomenduojamas WireGuard, pirmiausia bus bandomas WireGuard;
• Jei WireGuard metaduomenys, adreso priskyrimas, runtime paleidimas, handshake arba ryšio patikra nepavyksta, grįžtama prie PandaVPN global, sukompiliuoto iš SS payload;
• SS, OPENVPN, nežinomi arba trūkstami protokolai naudos PandaVPN global kaip atsarginį variantą;
• mode auto nepriima policy parametro, o nustatytas runtime visada yra global.

Rekomenduojama naujiems naudotojams:

panda mode auto
panda connect

direct-region yra rekomenduojama rašyba; bypass-region / bypass yra suderinamumo aliasai.

Pavyzdžiui:

panda mode pandavpn direct-region in

Lygiavertis suderinamumo aliasui:

panda mode pandavpn bypass-region in

Naujoji versija palaiko išsamesnę split profile sintaksę:

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

Dažni token:

Pavyzdžiai:

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

Pradedančiųjų dokumentacijoje nerekomenduojama rodyti ilgų komandų; jos labiau tinka pažangiai split dokumentacijai.

Peržiūrėti visus node:

panda node list

Atnaujinti ir peržiūrėti dar kartą:

panda node refresh
panda node list

Trumpa forma:

panda no re
panda no list

Peržiūrėti konkretų regioną arba grupę:

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

Peržiūrėti node grupes:

panda node group

Peržiūrėti konkrečios grupės informaciją:

panda node group show us

Pirmiausia suraskite node:

panda node list us

Tada prisijunkite:

panda connect --node 1822

Taip pat galite prisijungti pagal pavadinimą:

panda connect --node "US Node"

Trumpasis variantas:

panda no list us
panda conn --node 1822

panda connect naudos paskutinį tikslą.
Jei ankstesnio tikslo nėra, bandys global smart connect.

Smart connect reikia:

• būti prisijungus;
• kad node katalogas būtų talpykloje;
• jei reikia, pirmiausia paleiskite panda node refresh.

Trumpa forma:

panda conn

Dažnos priežastys:

• dar neprisijungėte;
• node katalogas neatnaujintas;
• dabartinėje paskyroje nėra pasiekiamų node;
• tinklas nepasiekiamas;
• daemon neveikia;
• dabartinis mode nesuderinamas su tiksliniu node;
• naudojant mode auto, rekomenduojamo protokolo paleisti nepavyko ir fallback taip pat nepavyko.

Rekomenduojama patikrinti:

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

panda status

Struktūrizuota išvestis:

panda status --json

Trumpasis variantas:

panda stat

doctor yra tik skaitymo diagnostikos komanda, naudojama dabartinei pagrindinei Panda CLI būsenai peržiūrėti.

panda doctor
panda doctor --json

Trumpa forma:

panda do

Ypač atkreipkite dėmesį į:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace naudojamas norint pamatyti, kokią taisyklę, DNS action ir route naudos konkretus tikslas.

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

Pastaba: visa trace galimybė reikalauja active PandaVPN packet runtime. Be suderinamo runtime galima atlikti tik ribotą tikrinimą arba grįžti prie legacy trace.

Paprastai taip nutinka, nes įdiegtas oficialus service / LaunchDaemon ir papildomai rankiniu būdu buvo paleista:

sudo panda start

sudo panda start paleidžia unmanaged / nevaldomą daemon, kuris kartu su oficialiu daemon gali vienu metu valdyti:

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

Sprendimo principas: palikite tik vieną daemon.

Dažnas sprendimas macOS / Linux:

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

Linux sistemoje, jei naudojate systemd service, po to iš naujo paleiskite oficialų service:

sudo panda service restart
panda doctor

macOS sistemoje, jei įdiegta naudojant .pkg, paprastai leiskite LaunchDaemon / helper valdyti daemon ir ilgą laiką nenaudokite sudo panda start kaip kasdienio paleidimo būdo.

Jei norite tik atjungti VPN, daemon išjungti nereikia:

panda disconnect
panda kill-switch off

Jei tikrai norite sustabdyti daemon:

sudo panda stop

Patvirtinimas:

panda status

Jei rodoma panda daemon unavailable, tai reiškia, kad pagrindinis daemon sustabdytas.

Pastaba: macOS .pkg įdiegtą LaunchDaemon / helper gali valdyti sistema; paprastiems naudotojams nerekomenduojama dažnai rankiniu būdu stabdyti paslaugos.

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

Išvalyti logs:

panda log clear

Laikinai įjungti debug:

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

Atkurti numatytąjį:

panda log level reset

no-tunnel IPv6 scenarijuje awdl0 / llw0 gali būti block, todėl AirDrop / Continuity laikinai tampa nepasiekiami.
Paprastai atsistato po disconnect.

Jei vis dar neįprasta, rekomenduojama:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Palaikomos versijos gali tai konfigūruoti:

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

Paaiškinimas:

• Pagal numatytuosius nustatymus rekomenduojama auto;
• Po pakeitimo hot reconnect nebus vykdomas;
• Kad įsigaliotų naujam TCP socket, reikia reconnect;
• Node, kurie nepalaiko TFO, neturėtų rodyti akivaizdaus prisijungimo delsos pablogėjimo.

Jei dabartinėje versijoje nėra šios konfigūracijos parinkties, vadovaukitės panda config --help arba faktine CLI help.

Privacy mode galima suprasti kaip griežtesnį saugos režimą, kurį rekomenduojama laikyti lygiaverčiu:

panda mode pandavpn global
panda kill-switch on

Arba naudojant numatytąjį automatinį protocol pasirinkimą:

panda mode auto
panda kill-switch on

Privacy mode režime rekomenduojami šie apribojimai:

• Nepalaiko proxy mode;
• Nepalaiko split mode;
• Leidžia tik VPN global semantiką;
• Kill-switch turi būti įjungtas;
• Įprastas egress blokuojamas.

panda repair yra išsamesnis ir gali pataisyti:

• VPN route
• DNS snapshot
• Kill-switch guard
• su system proxy susijusią būseną

panda proxy repair daugiausia taiso dabartinio naudotojo system proxy drift.

panda repair
panda proxy repair

Fresh install metu numatytoji reikšmė yra proxy system-proxy on.
Jei naudotojas aiškiai išsaugojo off, ši konfigūracija bus išsaugota.

Peržiūrėti arba nustatyti:

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

Pastaba: naudojant mode auto, pandavpn ir wireguard, VPN runtime ignoruoja išsaugotą system proxy nuostatą; VPN companion proxy lieka pasiekiamas ir naudoja scoped egress.

Windows system proxy yra dabartinio naudotojo HKCU WinINET nustatymas ir jam reikia per-user user-agent.
Jei esate SSH arba neinteraktyvioje sesijoje, proxy repair ne visada gali automatiškai paleisti user-agent.

Rekomenduojama:

panda proxy status
panda proxy repair
panda doctor

Jei vis tiek neveikia, bandykite dar kartą desktop login session.

Linux Phase 1 daugiausia palaiko GNOME gsettings.
Tokios aplinkos kaip KDE / XFCE gali būti rodomos kaip unsupported.

Tai nebūtinai paveikia PandaVPN packet runtime, bet gali paveikti system proxy mode patirtį.

Kill-switch reikšmė yra leisti srautą tik per TUN, o kitą įprastą srautą blokuoti.

proxy mode yra standalone vietinis proxy režimas, kuriame nėra packet VPN / TUN ir nėra lygiavertės DNS bei routing apsaugos. Todėl Kill-switch nepalaiko standalone proxy mode.

Kai reikia Kill-switch, naudokite:

panda mode auto
panda kill-switch on

Arba:

panda mode pandavpn global
panda kill-switch on

Arba:

panda mode wireguard
panda kill-switch on

Ne.

Auto-connect daugiausia apima best-effort connect paleidžiant daemon / service, taip pat pending retry, kai paleidimo metu tinklas laikinai nepasiekiamas.

Įjungti:

panda config auto-connect on

Išjungti:

panda config auto-connect off

Tai nėra bendras runtime automatinio prisijungimo iš naujo mechanizmas.

Split rules naudojamos nurodyti, kad tam tikri domenai, raktažodžiai, regex ar IP eitų per proxy, direct arba block.

Taisyklių failai:

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

Dažnos komandos:

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

Dabartinis žinomas apribojimas: po login retry laukiantis pending auto-connect nebus automatiškai pažadintas.

Po login rekomenduojama paleisti rankiniu būdu:

panda connect

Paprastai nereikia. Split DNS konfigūracijos pakeitimai hot-loadinami.

Dažnos komandos:

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

Jei platforma nepalaiko kai kurių local DNS šaltinių, doctor parodys warning.

Naujose versijose Windows Kill-switch buvo atnaujintas iš daemon-held dynamic session į persistent WFP filters.
Tai reiškia, kad guard gali išlikti po nenormalaus daemon išėjimo.

Tačiau persistent WFP nėra tas pats kaip boot-time filter; labai ankstyvas paleidimo langas vis dar priklauso būsimam hardening apimčiai.

Kill-switch reikšmė yra leisti srautą tik per TUN, o kitą įprastą srautą blokuoti.

proxy mode yra standalone vietinis proxy režimas, kuriame nėra packet VPN / TUN ir nėra lygiavertės DNS bei routing apsaugos. Todėl Kill-switch nepalaiko standalone proxy mode.

Kai reikia Kill-switch, naudokite:

panda mode auto
panda kill-switch on

Arba:

panda mode pandavpn global
panda kill-switch on

Arba:

panda mode wireguard
panda kill-switch on

Taip.

mode auto + kill-switch on leidžiama, tačiau galutinis kelias turi resolve į PandaVPN / WireGuard ir negali nukristi į standalone proxy. Prisijungimo metu, jei įvyksta fallback iš WireGuard į PandaVPN, guard active taip pat turi likti aktyvus ir neturi atsirasti fail-open window.

Rekomenduojama:

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

Nerekomenduojama.

Kill-switch yra sustiprintos privatumo apsaugos parinktis ir netinka trumpiausiam naudojimo keliui. Priežastys:

• disconnect neišjungia Kill-switch;
• Įjungus gali būti užblokuotas įprastas tinklas;
• Tai taip pat susiję su LAN prieiga, DNS lockdown, firewall ir platformų leidimų skirtumais;
• Nauji naudotojai gali klaidingai manyti, kad tinklas sugedo.

Naujiems naudotojams rekomenduojama pirmiausia atlikti:

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

Patvirtinus, kad ryšys veikia normaliai, įjunkite pagal poreikį:

panda kill-switch on
panda doctor

Ne.

Tai yra numatytas elgesys. Kill-switch yra nuolatinis saugos jungiklis, o disconnect tik atjungia dabartinį runtime; jis automatiškai neišjungia Kill-switch.

Norėdami atkurti įprastą prieigą prie tinklo, vykdykite:

panda kill-switch off

Griežtuoju režimu Kill-switch blokuoja įprastą LAN / WAN srautą.
Versijos, palaikančios allow-lan, gali įjungti ribotą LAN prieigą:

panda kill-switch allow-lan on

Išjungti LAN leidimą:

panda kill-switch allow-lan off

Pastaba: allow-lan leidžia private network / link-local / ULA unicast ir v1 discovery, tačiau LAN DNS vis tiek turėtų būti blokuojamas, kad nebūtų apeitas Panda DNS lockdown.