PandaVPN CLI KKK

Panda CLI on Panda käsureaklient ja toetab terminali kaudu järgmisi toiminguid:

• Sisselogimine ja konto haldus
• Sõlmede värskendamine ja sõlmedega ühendamine
• PandaVPN / Proxy / WireGuard / Auto režiimide vahetamine
• Süsteemi puhverserveri seadistamine
• Split rules liikluse jagamise reeglid
• Split DNS seadistamine
• Kill-switch kaitse
• Auto-connect
• Logid ja diagnostika

See sobib sisetestijatele, arendajatele, kogenud kasutajatele ja testistsenaariumidele, mis nõuavad skriptitud toiminguid.

PandaVPN CLI sobib paremini automatiseeritud testimiseks, kaugdiagnostikaks ja skriptidega juhitavate ühenduste jaoks.

Panda Desktop ja PandaVPN CLI on sama PandaVPN daemon kaks juhtimisliidest ning jagavad sama ühenduse olekut, seega saab neid koos kasutada.

Ärge käivitage vanemaid töölauarakendusi, nagu Panda-Qt või vana Linux AppImage, samal ajal PandaVPN CLI-ga, kuna see võib põhjustada võrgukonfiguratsiooni konflikte.

Mõned võimalused vajavad süsteemitaseme õigusi, näiteks:

• TUN / WireGuard võrguliideste loomine
• DNS-i muutmine
• Süsteemi puhverserveri seadistamine
• Kill-switchi rakendamine
• Marsruutide parandamine
• packet VPN runtime haldamine

Seetõttu teeb CLI need toimingud platvormile vastava daemon / service kaudu.

daemon vormid eri platvormidel:

Põhierinevus on järgmine: Windowsis ja macOS-is installitakse teenus tavaliselt automaatselt paigalduspaketi kaudu, Linuxis peab kasutaja tavaliselt käsitsi käivitama sudo panda service install.

Windowsis tuleb administraatori PowerShellis järgmine käsk käivitada ainult siis, kui paigalduspaketti ei kasutata ja binaarfailid paigutatakse käsitsi:

panda service install windows

macOS-is on seda vaja ainult arenduse ja silumise ajal, kui .pkg paigalduspaketti ei kasutata või kui daemon ei käivitu automaatselt:

sudo panda start

Linuxis on soovitatav:

sudo panda service install
panda service status

Jah, need on samad. Peamine erinevus on allalaaditava installipaketi arhitektuuris.

Installimissammud, käsud ja teenuse haldamise viis on samad. Installipakett tõstab õigused automaatselt ja registreerib Windows Service’i.

Jah, need on samad. Peamine erinevus on allalaaditava .pkg paketi arhitektuuris.

Installisammud on samad. Pärast .pkg abil installimist installitakse ja käivitatakse LaunchDaemon / helper tavaliselt automaatselt.

Ülemaailmsete kasutajate jaoks soovitame vaikimisi kasutada mode auto:

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

Kui uus install kasutab juba vaikimisi mode auto, võib kasutada ka lihtsamat versiooni:

panda login
panda node refresh
panda connect
panda doctor

Vastav lühiversioon:

panda login
panda no re
panda conn
panda do

Ametlikul allalaadimislehel ja algajate juhendis tuleks eelistatult näidata täielikke käske; lühivorme võib näidata hiljem edasijõudnute dokumentatsioonis või interaktiivse režiimi selgitustes.

gfwlist on konkreetne split-reeglite allikas ega sobi globaalsete kasutajate vaikerežiimiks.

Globaalsetele kasutajatele on vaikimisi soovitatav:

panda mode auto

Või kasutage püsivalt PandaVPN-i globaalset režiimi:

panda mode pandavpn global

gfwlist võib jääda täiustatud split-routing dokumentatsiooni, kuid seda ei soovitata kuvada ametliku veebisaidi esimesel ekraanil, allalaadimislehe Hero osas ega algajate kiirjuhendis.

Soovitatav on kõigepealt ühendus katkestada ja Kill-switch välja lülitada:

panda disconnect
panda kill-switch off

Kui tegemist on käsitsi uuendamise või Linux service’i uuendamisega, on soovitatav ka daemon peatada:

sudo panda stop

macOS-i ja Windowsi uuendamisel installeriga haldab installer tavaliselt service’i installimist ja taaskäivitamist automaatselt. Pärast uuenduse lõpetamist on soovitatav käivitada:

panda version
panda doctor
panda connect

Pärast käsitsi Linuxi uuendamist on soovitatav:

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

panda connect us

See tähendab bare group selector’it; VIP / SVIP / FREE tab ei fikseerita ja API valib sobiva tab’i.

panda connect svip us

See tähendab us fikseeritud kasutamist SVIP tab’i all.

Kooloniga vorm on samaväärne ja sobib skriptidele:

panda connect svip:us

favorite tab on praegu flat favorite channel list ja ei toeta favorite group smart connect’i nagu connect fav us; favorite jaoks kasutage:

panda connect fav

või:

panda connect --node <NODE_ID>

Peamiselt toetab:

Levinud seaded:

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

openvpn ei ole praegu soovitatav kasutajadokumentatsioonis põhiliini režiimina näidata.

Soovitus:

Märkus: mode proxy ja Kill-switch välistavad teineteist.

mode auto on uue versiooni vaikerežiim.

Selle käitumine on järgmine:

• API node / smart connect valib runtime’i eelisjärjekorras meta.protocol alusel;
• Kui soovitatakse WireGuardi, proovitakse kõigepealt WireGuardi;
• Kui WireGuardi metaandmed, aadressi eraldamine, runtime’i käivitamine, handshake või ühenduvuse kontroll ebaõnnestub, lülitub see tagasi PandaVPN globalile, mis on koostatud SS payloadist;
• SS, OPENVPN, tundmatud või puuduvad protokollid kasutavad varuna PandaVPN globali;
• mode auto ei aktsepteeri policy parameetrit ja lahendatud runtime on alati global.

Soovitatav uutele kasutajatele:

panda mode auto
panda connect

direct-region on soovitatud kirjaviis; bypass-region / bypass on ühilduvusaliased.

Näiteks:

panda mode pandavpn direct-region in

See on samaväärne ühilduvusaliasega:

panda mode pandavpn bypass-region in

Uus versioon toetab täielikumat split profile süntaksit:

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

Levinud tokenid:

Näited:

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

Pikki käske ei soovitata algajate dokumentatsioonis näidata; need sobivad paremini täpsemasse split-dokumentatsiooni.

Kuva kõik node’id:

panda node list

Värskenda ja kuva uuesti:

panda node refresh
panda node list

Lühivorm:

panda no re
panda no list

Kuva konkreetne piirkond või grupp:

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

Kuva node’i grupid:

panda node group

Kuva konkreetse grupi üksikasjad:

panda node group show us

Kõigepealt otsige node:

panda node list us

Seejärel looge ühendus:

panda connect --node 1822

Saate ühenduse luua ka nime järgi:

panda connect --node "US Node"

Lühivorm:

panda no list us
panda conn --node 1822

panda connect kasutab viimast sihtmärki.
Kui varasemat sihtmärki pole, proovib see global smart connecti.

Smart connect nõuab:

• oled sisse logitud;
• node’i kataloog on vahemällu salvestatud;
• vajaduse korral käivita esmalt panda node refresh.

Lühivorm:

panda conn

Levinud põhjused:

• te pole veel sisse logitud;
• node’i kataloogi pole värskendatud;
• praegusel kontol pole saadaval node’e;
• võrk pole saadaval;
• daemon ei tööta;
• praegune mode ei ühildu siht-node’iga;
• mode auto all ei õnnestunud soovitatud protokolli käivitada ja ka fallback ebaõnnestus.

Soovitatav kontroll:

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

panda status

Struktureeritud väljund:

panda status --json

Lühivorm:

panda stat

doctor on kirjutuskaitstud diagnostikakäsk, mida kasutatakse Panda CLI praeguste põhiolekute vaatamiseks.

panda doctor
panda doctor --json

Lühivorm:

panda do

Pöörake erilist tähelepanu järgmistele:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace kasutatakse selleks, et näha, millist reeglit, DNS actionit ja route’i konkreetne sihtmärk kasutab.

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

Märkus: täielik trace-võimekus nõuab active PandaVPN packet runtime’i. Kui ühilduvat runtime’i pole, saab teha ainult piiratud valideerimist või langeda tagasi legacy trace’ile.

Tavaliselt juhtub see siis, kui ametlik service / LaunchDaemon on installitud ja lisaks on käsitsi käivitatud:

sudo panda start

sudo panda start käivitab unmanaged / halduseta daemoni, mis võib koos ametliku daemoniga samal ajal hallata:

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

Lahenduse põhimõte on: jäta alles ainult üks daemon.

Tavaline käsitlus macOS / Linux puhul:

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

Linuxis, kui kasutad systemd service’it, taaskäivita seejärel ametlik teenus:

sudo panda service restart
panda doctor

macOS-is, kui installisid .pkg abil, lase tavaliselt daemonit hallata LaunchDaemon / helperil ja ära kasuta sudo panda start pikaajaliselt igapäevase käivitusviisina.

Kui soovite ainult VPN-i katkestada, ei ole vaja daemon-ist väljuda:

panda disconnect
panda kill-switch off

Kui soovite daemon-i tõesti peatada:

sudo panda stop

Kinnitamine:

panda status

Kui kuvatakse panda daemon unavailable, tähendab see, et peamine daemon on peatatud.

Märkus: macOS .pkg kaudu installitud LaunchDaemon / helper võib olla süsteemi hallatav; tavakasutajatel ei soovitata teenust sageli käsitsi peatada.

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

Logs tühjendamine:

panda log clear

Debug ajutine lubamine:

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

Vaikeseadete taastamine:

panda log level reset

no-tunnel IPv6 stsenaariumis võidakse awdl0 / llw0 blockida, mistõttu AirDrop / Continuity võib ajutiselt muutuda kättesaamatuks.
Tavaliselt taastub see pärast disconnect.

Kui probleem püsib, soovitatakse:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Toetatud versioonides saab seda seadistada:

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

Selgitus:

• Vaikimisi on soovitatav auto;
• Pärast muutmist hot reconnect ei toimu;
• Uuele TCP socketile rakendumiseks on vaja reconnect;
• Node’id, mis TFO-d ei toeta, ei tohiks näidata märgatavat ühenduse latentsuse halvenemist.

Kui praeguses versioonis seda konfiguratsioonivalikut pole, järgi panda config --help või tegelikku CLI helpi.

Privacy mode’i võib mõista rangema turvarežiimina ning seda soovitatakse käsitleda samaväärsena järgmisega:

panda mode pandavpn global
panda kill-switch on

Või vaikimisi automaatse protokollivaliku korral:

panda mode auto
panda kill-switch on

Privacy mode’is soovitatakse järgmisi piiranguid:

• proxy mode ei ole toetatud;
• split mode ei ole toetatud;
• Lubatud on ainult VPN global semantika;
• Kill-switch peab olema lubatud;
• Tavaline egress blokeeritakse.

panda repair on terviklikum ja võib parandada:

• VPN route
• DNS snapshot
• Kill-switch guard
• system proxyga seotud olek

panda proxy repair parandab peamiselt praeguse kasutaja system proxy drift’i.

panda repair
panda proxy repair

Fresh install puhul on vaikeväärtus proxy system-proxy on.
Kui kasutaja on selgesõnaliselt salvestanud off, säilitatakse see konfiguratsioon.

Vaata või määra:

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

Märkus: mode auto, pandavpn ja wireguard all ignoreerib VPN runtime püsivalt salvestatud system proxy eelistust; VPN companion proxy jääb kättesaadavaks ja kasutab scoped egressi.

Windows system proxy on praeguse kasutaja HKCU WinINET-säte ja nõuab per-user user-agent’i.
Kui olete SSH- või mitteinteraktiivses seansis, ei pruugi proxy repair alati user-agent’i automaatselt käivitada.

Soovitatav:

panda proxy status
panda proxy repair
panda doctor

Kui see endiselt ei rakendu, proovige uuesti töölaua sisselogimisseansis.

Linux Phase 1 toetab peamiselt GNOME gsettingsit.
Keskkonnad nagu KDE / XFCE võivad kuvada oleku unsupported.

See ei pruugi mõjutada PandaVPN packet runtime’i, kuid võib mõjutada system proxy mode’i kasutuskogemust.

Kill-switchi tähendus on lubada liiklust ainult läbi TUN-i, samal ajal kui muu tavaline liiklus blokeeritakse.

proxy mode on standalone kohalik proxy-režiim, millel puudub packet VPN / TUN ning samaväärne DNS-i ja marsruutimise kaitse. Seetõttu ei toeta Kill-switch standalone proxy mode’i.

Kui vajate Kill-switchi, kasutage:

panda mode auto
panda kill-switch on

Või:

panda mode pandavpn global
panda kill-switch on

Või:

panda mode wireguard
panda kill-switch on

Ei.

Auto-connect hõlmab peamiselt best-effort connecti daemon / service käivitumisel ning pending retryt, kui käivitamisel pole võrk ajutiselt saadaval.

Lülita sisse:

panda config auto-connect on

Lülita välja:

panda config auto-connect off

See ei ole üldine runtime automaatse taasühendamise mehhanism.

Split rules kasutatakse selleks, et määrata, kas teatud domeenid, märksõnad, regex või IP-d lähevad läbi proxy, direct või block.

Reeglifailid:

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

Levinud käsud:

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

Praegune teadaolev piirang: pärast login ei äratata retryt ootavat pending auto-connecti automaatselt.

Pärast login on soovitatav käsitsi käivitada:

panda connect

Tavaliselt mitte. Split DNS-i konfiguratsioonimuudatused hot-loaditakse.

Levinud käsud:

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

Kui platvorm ei toeta teatud local DNS allikaid, kuvab doctor warning.

Uutes versioonides on Windows Kill-switch uuendatud daemon-held dynamic session mudelilt persistent WFP filters peale.
See tähendab, et guard võib säilida ka pärast daemon-i ebanormaalset väljumist.

Kuid persistent WFP ei ole sama mis boot-time filter; väga varajane käivitusaken kuulub endiselt hilisema hardening ulatusse.

Kill-switchi tähendus on lubada liiklust ainult läbi TUN-i, samal ajal kui muu tavaline liiklus blokeeritakse.

proxy mode on standalone kohalik proxy-režiim, millel puudub packet VPN / TUN ning samaväärne DNS-i ja marsruutimise kaitse. Seetõttu ei toeta Kill-switch standalone proxy mode’i.

Kui vajate Kill-switchi, kasutage:

panda mode auto
panda kill-switch on

Või:

panda mode pandavpn global
panda kill-switch on

Või:

panda mode wireguard
panda kill-switch on

Jah.

mode auto + kill-switch on on lubatud, kuid lõplik tee peab resolve PandaVPN / WireGuardiks ega tohi langeda standalone proxy peale. Kui ühenduse loomise ajal toimub fallback WireGuardilt PandaVPN-ile, peab guard active samuti säilima ning fail-open window ei tohi tekkida.

Soovitatav:

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

Ei ole soovitatav.

Kill-switch on täiustatud privaatsuskaitse valik ja ei sobi kõige lühemasse kasutatavasse teekonda. Põhjused:

• disconnect ei lülita Kill-switchi välja;
• Pärast lubamist võib tavaline võrk olla blokeeritud;
• See hõlmab ka LAN-juurdepääsu, DNS lockdowni, tulemüüri ja platvormi õiguste erinevusi;
• Uued kasutajad võivad ekslikult arvata, et võrk on katki.

Uutel kasutajatel soovitatakse esmalt teha:

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

Pärast kinnitamist, et ühendus töötab normaalselt, lubage see vajaduse korral:

panda kill-switch on
panda doctor

Ei.

See on oodatud käitumine. Kill-switch on püsiv turvalüliti ja disconnect katkestab ainult praeguse runtime’i; see ei lülita Kill-switchi automaatselt välja.

Tavalise võrgujuurdepääsu taastamiseks käivitage:

panda kill-switch off

Ranges režiimis blokeerib Kill-switch tavalise LAN / WAN liikluse.
Versioonid, mis toetavad allow-lan-i, saavad lubada piiratud LAN-juurdepääsu:

panda kill-switch allow-lan on

LAN-i lubamise väljalülitamine:

panda kill-switch allow-lan off

Märkus: allow-lan lubab private network / link-local / ULA unicast ja v1 discovery, kuid LAN DNS peaks endiselt olema blokeeritud, et vältida Panda DNS lockdownist möödumist.