PandaVPN CLI BUJ

Panda CLI ir Panda komandrindas klients, kas terminālī atbalsta tālāk norādītās darbības:

• Pieteikšanos un konta pārvaldību
• Mezglu atsvaidzināšanu un savienojumu ar mezgliem
• Pārslēgšanos starp PandaVPN / Proxy / WireGuard / Auto režīmiem
• Sistēmas starpniekservera konfigurēšanu
• Split rules trafika sadalīšanas noteikumus
• Split DNS konfigurēšanu
• Kill-switch aizsardzību
• Auto-connect
• Žurnālus un diagnostiku

Tas ir piemērots iekšējiem testēšanas lietotājiem, izstrādātājiem, pieredzējušiem lietotājiem un testēšanas scenārijiem, kuros nepieciešamas skriptētas darbības.

PandaVPN CLI ir piemērotāks automatizētai testēšanai, attālinātai problēmu novēršanai un savienojumiem, ko pārvalda ar skriptiem.

Panda Desktop un PandaVPN CLI ir divas viena un tā paša PandaVPN daemon vadības saskarnes un koplieto vienu un to pašu savienojuma stāvokli, tāpēc tās var izmantot kopā.

Nedarbiniet vecākas darbvirsmas lietotnes, piemēram, Panda-Qt vai veco Linux AppImage, vienlaikus ar PandaVPN CLI, jo tas var izraisīt tīkla konfigurācijas konfliktus.

Dažām iespējām ir nepieciešamas sistēmas līmeņa atļaujas, piemēram:

• TUN / WireGuard tīkla interfeisu izveide
• DNS modificēšana
• Sistēmas starpniekservera iestatīšana
• Kill-switch piemērošana
• Maršrutu labošana
• packet VPN runtime pārvaldība

Tāpēc CLI šīs darbības veic, izmantojot platformai atbilstošu daemon / service.

daemon formas dažādās platformās:

Galvenā atšķirība ir šāda: Windows un macOS sistēmās serviss parasti tiek automātiski instalēts ar instalēšanas pakotni, savukārt Linux lietotājam parasti manuāli jāizpilda sudo panda service install.

Windows sistēmā tikai tad, ja neizmantojat instalēšanas pakotni un bināros failus ievietojat manuāli, administratora PowerShell jāizpilda:

panda service install windows

macOS sistēmā tas nepieciešams tikai izstrādes un atkļūdošanas laikā, ja netiek izmantota .pkg instalēšanas pakotne, vai ja daemon nesāk darboties automātiski:

sudo panda start

Linux sistēmā ieteicams:

sudo panda service install
panda service status

Jā, tās ir vienādas. Galvenā atšķirība ir lejupielādētās instalācijas pakotnes arhitektūrā.

Instalēšanas darbības, komandas un pakalpojuma pārvaldības veids ir vienādi. Instalēšanas pakotne automātiski paaugstinās privilēģijas un reģistrēs Windows Service.

Jā, tās ir vienādas. Galvenā atšķirība ir lejupielādētās .pkg pakotnes arhitektūra.

Instalēšanas darbības ir vienādas. Pēc instalēšanas ar .pkg, LaunchDaemon / helper parasti tiek automātiski instalēts un palaists.

Lietotājiem visā pasaulē iesakām pēc noklusējuma izmantot mode auto:

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

Ja jaunā instalācijā mode auto jau ir noklusējuma režīms, var izmantot arī vienkāršāku versiju:

panda login
panda node refresh
panda connect
panda doctor

Atbilstošā saīsinātā versija:

panda login
panda no re
panda conn
panda do

Oficiālajā lejupielādes lapā un iesācēju ievadā ieteicams vispirms rādīt pilnās komandas; saīsinājumus var rādīt vēlāk paplašinātajā dokumentācijā vai interaktīvā režīma skaidrojumos.

gfwlist ir konkrēts split rules avots un nav piemērots kā noklusējuma režīms globāliem lietotājiem.

Globāliem lietotājiem pēc noklusējuma ieteicams:

panda mode auto

Vai arī pastāvīgi izmantot PandaVPN globālo režīmu:

panda mode pandavpn global

gfwlist var saglabāt paplašinātajā split routing dokumentācijā, taču nav ieteicams to rādīt oficiālās vietnes pirmajā ekrānā, lejupielādes lapas Hero sadaļā vai iesācēju quick start ceļvedī.

Ieteicams vispirms atvienoties un izslēgt Kill-switch:

panda disconnect
panda kill-switch off

Ja tas ir manuāls jauninājums vai Linux service jauninājums, ieteicams arī apturēt daemon:

sudo panda stop

Ja macOS un Windows jaunināšanai izmanto instalētāju, instalētājs parasti automātiski apstrādā service instalēšanu un restartēšanu. Pēc jaunināšanas pabeigšanas ieteicams izpildīt:

panda version
panda doctor
panda connect

Pēc manuāla Linux jauninājuma ieteicams:

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

panda connect us

Tas nozīmē bare group selector; tas nefiksē VIP / SVIP / FREE tab, un API izvēlas piemērotu tab.

panda connect svip us

Tas nozīmē fiksētu us izmantošanu zem SVIP tab.

Forma ar kolu ir ekvivalenta un piemērota skriptiem:

panda connect svip:us

favorite tab pašlaik ir flat favorite channel list un neatbalsta favorite group smart connect, piemēram, connect fav us; favorite izmantojiet:

panda connect fav

vai:

panda connect --node <NODE_ID>

Galvenokārt atbalsta:

Bieži izmantotie iestatījumi:

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

Pašlaik nav ieteicams lietotāju dokumentācijā rādīt openvpn kā galveno režīmu.

Ieteikums:

Piezīme: mode proxy un Kill-switch ir savstarpēji izslēdzoši.

mode auto ir jaunās versijas noklusējuma režīms.

Tā darbība ir šāda:

• API node / smart connect prioritāri izvēlas runtime pēc meta.protocol;
• Ja tiek ieteikts WireGuard, vispirms tiks mēģināts WireGuard;
• Ja WireGuard metadati, adreses piešķiršana, runtime palaišana, handshake vai savienojamības pārbaude neizdodas, tas atgriežas pie PandaVPN global, kas kompilēts no SS payload;
• SS, OPENVPN, nezināmi vai trūkstoši protokoli izmantos PandaVPN global kā rezerves variantu;
• mode auto nepieņem policy parametru, un atrisinātais runtime vienmēr ir global.

Ieteicams jauniem lietotājiem:

panda mode auto
panda connect

direct-region ir ieteicamā rakstība; bypass-region / bypass ir saderības aliasi.

Piemēram:

panda mode pandavpn direct-region in

Atbilst saderības aliasam:

panda mode pandavpn bypass-region in

Jaunā versija atbalsta pilnīgāku split profile sintaksi:

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

Bieži izmantotie token:

Piemēri:

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

Iesācēju dokumentācijā nav ieteicams rādīt garās komandas; tās labāk piemērotas paplašinātai split dokumentācijai.

Skatīt visus node:

panda node list

Atsvaidzināt un skatīt vēlreiz:

panda node refresh
panda node list

Īsā forma:

panda no re
panda no list

Skatīt konkrētu reģionu vai grupu:

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

Skatīt node grupas:

panda node group

Skatīt konkrētas grupas informāciju:

panda node group show us

Vispirms meklējiet node:

panda node list us

Pēc tam izveidojiet savienojumu:

panda connect --node 1822

Varat izveidot savienojumu arī pēc nosaukuma:

panda connect --node "US Node"

Īsā forma:

panda no list us
panda conn --node 1822

panda connect izmantos pēdējo mērķi.
Ja iepriekšēja mērķa nav, tas mēģinās global smart connect.

Smart connect nepieciešams:

• būt pieteikušamies;
• node direktorijam jābūt kešotam;
• ja nepieciešams, vispirms palaidiet panda node refresh.

Īsā forma:

panda conn

Biežākie iemesli:

• jūs vēl neesat pieteicies;
• node direktorijs nav atsvaidzināts;
• pašreizējam kontam nav pieejamu node;
• tīkls nav pieejams;
• daemon nedarbojas;
• pašreizējais mode nav saderīgs ar mērķa node;
• mode auto režīmā ieteicamais protokols neizdevās palaisties, un arī fallback neizdevās.

Ieteicamā pārbaude:

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

panda status

Strukturēta izvade:

panda status --json

Īsā forma:

panda stat

doctor ir tikai lasāma diagnostikas komanda, ko izmanto, lai skatītu Panda CLI pašreizējos galvenos statusus.

panda doctor
panda doctor --json

Īsā forma:

panda do

Īpaši pievērsiet uzmanību:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace izmanto, lai redzētu, kuru noteikumu, DNS action un route izmantos konkrēts mērķis.

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

Piezīme: pilna trace funkcionalitāte prasa active PandaVPN packet runtime. Bez saderīga runtime iespējama tikai ierobežota validācija vai fallback uz legacy trace.

Parasti tas notiek tāpēc, ka ir instalēts oficiālais service / LaunchDaemon, un papildus manuāli ir palaists:

sudo panda start

sudo panda start palaiž unmanaged / nepārvaldītu daemon, kas vienlaikus ar oficiālo daemon var pārvaldīt:

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

Risināšanas princips ir: atstājiet tikai vienu daemon.

Parasta rīcība macOS / Linux:

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

Linux vidē, ja izmantojat systemd service, pēc tam restartējiet oficiālo service:

sudo panda service restart
panda doctor

macOS vidē, ja instalēts ar .pkg, parasti ļaujiet LaunchDaemon / helper pārvaldīt daemon un neizmantojiet sudo panda start ilgtermiņā kā ikdienas palaišanas veidu.

Ja vēlaties tikai atvienot VPN, nav nepieciešams iziet no daemon:

panda disconnect
panda kill-switch off

Ja tiešām vēlaties apturēt daemon:

sudo panda stop

Apstipriniet:

panda status

Ja tiek rādīts panda daemon unavailable, tas nozīmē, ka galvenais daemon ir apturēts.

Piezīme: LaunchDaemon / helper, kas instalēts ar macOS .pkg, var tikt pārvaldīts sistēmas līmenī; parastiem lietotājiem nav ieteicams bieži manuāli apturēt pakalpojumu.

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

Notīrīt logs:

panda log clear

Īslaicīgi ieslēgt debug:

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

Atjaunot noklusējumu:

panda log level reset

no-tunnel IPv6 scenārijā awdl0 / llw0 var tikt block, kā rezultātā AirDrop / Continuity īslaicīgi nav pieejami.
Parasti tas atjaunojas pēc disconnect.

Ja situācija joprojām ir neparasta, ieteicams:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Atbalstītās versijās to var konfigurēt:

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

Skaidrojums:

• Pēc noklusējuma ieteicams auto;
• Pēc izmaiņas hot reconnect nenotiks;
• Lai tas stātos spēkā jaunam TCP socket, nepieciešams reconnect;
• Node, kas neatbalsta TFO, nevajadzētu parādīt acīmredzamu savienojuma latentuma pasliktināšanos.

Ja pašreizējā versijā nav šīs konfigurācijas opcijas, izmantojiet panda config --help vai faktisko CLI help.

Privacy mode var saprast kā stingrāku drošības režīmu, un ieteicams to uzskatīt par ekvivalentu šim:

panda mode pandavpn global
panda kill-switch on

Vai ar noklusējuma automātisko protocol izvēli:

panda mode auto
panda kill-switch on

Privacy mode režīmā ieteicami šādi ierobežojumi:

• Neatbalsta proxy mode;
• Neatbalsta split mode;
• Atļauj tikai VPN global semantiku;
• Kill-switch ir jābūt iespējotam;
• Parastais egress tiek bloķēts.

panda repair ir visaptverošāks un var labot:

• VPN route
• DNS snapshot
• Kill-switch guard
• ar system proxy saistītu stāvokli

panda proxy repair galvenokārt labo pašreizējā lietotāja system proxy drift.

panda repair
panda proxy repair

Fresh install gadījumā noklusējums ir proxy system-proxy on.
Ja lietotājs nepārprotami ir saglabājis off, šī konfigurācija tiks saglabāta.

Skatīt vai iestatīt:

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

Piezīme: mode auto, pandavpn un wireguard režīmos VPN runtime ignorē saglabāto system proxy izvēli; VPN companion proxy joprojām ir pieejams un izmanto scoped egress.

Windows system proxy ir pašreizējā lietotāja HKCU WinINET iestatījums, un tam nepieciešams per-user user-agent.
Ja atrodaties SSH vai neinteraktīvā sesijā, proxy repair ne vienmēr var automātiski palaist user-agent.

Ieteicams:

panda proxy status
panda proxy repair
panda doctor

Ja tas joprojām nestājas spēkā, mēģiniet vēlreiz desktop login session.

Linux Phase 1 galvenokārt atbalsta GNOME gsettings.
Tādas vides kā KDE / XFCE var tikt rādītas kā unsupported.

Tas ne vienmēr ietekmē PandaVPN packet runtime, taču var ietekmēt system proxy mode pieredzi.

Kill-switch nozīme ir atļaut trafiku tikai caur TUN, bet bloķēt citu parasto trafiku.

proxy mode ir standalone vietējais proxy režīms, bez packet VPN / TUN un bez līdzvērtīgas DNS un routing aizsardzības. Tāpēc Kill-switch neatbalsta standalone proxy mode.

Kad nepieciešams Kill-switch, izmantojiet:

panda mode auto
panda kill-switch on

Vai:

panda mode pandavpn global
panda kill-switch on

Vai:

panda mode wireguard
panda kill-switch on

Nē.

Auto-connect galvenokārt aptver best-effort connect, kad startē daemon / service, kā arī pending retry, ja startēšanas brīdī tīkls īslaicīgi nav pieejams.

Ieslēgt:

panda config auto-connect on

Izslēgt:

panda config auto-connect off

Tas nav vispārīgs runtime automātiskas atkārtotas savienošanās mehānisms.

Split rules tiek izmantoti, lai norādītu, ka noteikti domēni, atslēgvārdi, regex vai IP iet caur proxy, direct vai block.

Rules faili:

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

Biežākās komandas:

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

Pašreiz zināmais ierobežojums: pēc login pending auto-connect, kas gaida retry, netiks automātiski wake.

Pēc login ieteicams palaist manuāli:

panda connect

Parasti nav nepieciešams. Split DNS konfigurācijas izmaiņas tiek hot-load.

Biežākās komandas:

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

Ja platforma neatbalsta dažus local DNS avotus, doctor parādīs warning.

Jaunajās versijās Windows Kill-switch ir jaunināts no daemon-held dynamic session uz persistent WFP filters.
Tas nozīmē, ka guard var saglabāties pēc daemon neparastas iziešanas.

Tomēr persistent WFP nav tas pats, kas boot-time filter; ļoti agrīnais startēšanas logs joprojām ietilpst turpmākā hardening tvērumā.

Kill-switch nozīme ir atļaut trafiku tikai caur TUN, bet bloķēt citu parasto trafiku.

proxy mode ir standalone vietējais proxy režīms, bez packet VPN / TUN un bez līdzvērtīgas DNS un routing aizsardzības. Tāpēc Kill-switch neatbalsta standalone proxy mode.

Kad nepieciešams Kill-switch, izmantojiet:

panda mode auto
panda kill-switch on

Vai:

panda mode pandavpn global
panda kill-switch on

Vai:

panda mode wireguard
panda kill-switch on

Jā.

mode auto + kill-switch on ir atļauts, taču gala ceļam ir jāresolve uz PandaVPN / WireGuard, un tas nedrīkst nonākt pie standalone proxy. Savienojuma laikā, ja notiek fallback no WireGuard uz PandaVPN, arī guard active ir jāsaglabā, un nedrīkst parādīties fail-open window.

Ieteicams:

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

Nav ieteicams.

Kill-switch ir pastiprinātas privātuma aizsardzības opcija, un tā nav piemērota īsākajam lietojamajam ceļam. Iemesli:

• disconnect neizslēdz Kill-switch;
• Pēc ieslēgšanas parastais tīkls var tikt bloķēts;
• Tas ietver arī LAN piekļuvi, DNS lockdown, firewall un platformu atļauju atšķirības;
• Jauni lietotāji var kļūdaini domāt, ka tīkls ir bojāts.

Jauniem lietotājiem ieteicams vispirms pabeigt:

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

Pēc tam, kad apstiprināts, ka savienojums darbojas normāli, ieslēdziet pēc vajadzības:

panda kill-switch on
panda doctor

Nē.

Tā ir paredzētā darbība. Kill-switch ir pastāvīgs drošības slēdzis, un disconnect tikai atvieno pašreizējo runtime; tas automātiski neizslēdz Kill-switch.

Lai atjaunotu parasto piekļuvi tīklam, izpildiet:

panda kill-switch off

Stingrajā režīmā Kill-switch bloķē parasto LAN / WAN trafiku.
Versijas, kas atbalsta allow-lan, var ieslēgt ierobežotu LAN piekļuvi:

panda kill-switch allow-lan on

Izslēgt LAN atļaušanu:

panda kill-switch allow-lan off

Piezīme: allow-lan atļauj private network / link-local / ULA unicast un v1 discovery, taču LAN DNS joprojām jābloķē, lai izvairītos no Panda DNS lockdown apiešanas.