Mga FAQ ng PandaVPN CLI

Ang Panda CLI ay command-line client ng Panda at sumusuporta sa mga sumusunod sa pamamagitan ng terminal:

• Pag-login at pamamahala ng account
• Pag-refresh ng mga node at pagkonekta sa mga node
• Paglipat sa pagitan ng mga mode na PandaVPN / Proxy / WireGuard / Auto
• Pag-configure ng system proxy
• Mga Split rules para sa paghahati ng trapiko
• Pag-configure ng Split DNS
• Proteksyon ng Kill-switch
• Auto-connect
• Mga log at diagnostic

Angkop ito para sa mga internal beta user, developer, advanced user, at mga testing scenario na nangangailangan ng scripted operations.

Mas angkop ang PandaVPN CLI para sa automated testing, remote troubleshooting, at mga koneksyong pinapatakbo gamit ang scripts.

Ang Panda Desktop at PandaVPN CLI ay dalawang control interface para sa iisang PandaVPN daemon at pareho nilang ginagamit ang parehong connection state, kaya maaari silang gamitin nang sabay.

Huwag patakbuhin ang mga lumang desktop app, gaya ng Panda-Qt o ang lumang Linux AppImage, kasabay ng PandaVPN CLI dahil maaari itong magdulot ng conflict sa network configuration.

May ilang kakayahan na nangangailangan ng system-level na pahintulot, tulad ng:

• Paglikha ng mga TUN / WireGuard network interface
• Pagbabago ng DNS
• Pagtatakda ng system proxy
• Paglalapat ng Kill-switch
• Pag-aayos ng mga ruta
• Pamamahala sa packet VPN runtime

Kaya isinasagawa ng CLI ang mga operasyong ito sa pamamagitan ng daemon / service na tumutugma sa platform.

Mga anyo ng daemon sa iba't ibang platform:

Ang pangunahing pagkakaiba ay: Sa Windows at macOS, karaniwang awtomatikong ini-install ang service sa pamamagitan ng installer, samantalang sa Linux, karaniwang kailangang manu-manong patakbuhin ng user ang sudo panda service install.

Sa Windows, kailangan mo lang patakbuhin ang sumusunod sa administrator PowerShell kung hindi ka gumagamit ng installer at manu-mano mong inilalagay ang binary:

panda service install windows

Sa macOS, kailangan lang ito para sa development at debugging, kapag hindi ginagamit ang .pkg installer, o kapag hindi awtomatikong nagsisimula ang daemon:

sudo panda start

Sa Linux, inirerekomenda namin:

sudo panda service install
panda service status

Oo, pareho ang mga ito. Ang pangunahing pagkakaiba ay ang arkitektura ng installation package na ida-download.

Pareho ang mga hakbang sa pag-install, mga command, at paraan ng pamamahala sa serbisyo. Awtomatikong magtataas ng pribilehiyo ang installer at irerehistro ang Windows Service.

Oo, pareho. Ang pangunahing pagkakaiba ay ang architecture ng dina-download na .pkg package.

Pareho ang mga hakbang sa pag-install. Pagkatapos mag-install gamit ang .pkg, karaniwang awtomatikong ini-install at sinisimulan ang LaunchDaemon / helper.

Para sa mga global user, inirerekomenda naming gamitin ang mode auto bilang default:

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

Kung ang bagong pag-install ay naka-default na sa mode auto, maaari ring gamitin ang mas simpleng bersyon:

panda login
panda node refresh
panda connect
panda doctor

Kaugnay na shorthand na bersyon:

panda login
panda no re
panda conn
panda do

Dapat unahin ng opisyal na download page at beginner onboarding ang pagpapakita ng buong commands; ipakita na lang ang shorthand sa advanced documentation o sa paliwanag ng interactive mode.

Ang gfwlist ay isang partikular na source ng split rules at hindi angkop bilang default mode para sa mga global user.

Para sa mga global user, ang inirerekomendang default ay:

panda mode auto

O gumamit nang fixed ng PandaVPN global mode:

panda mode pandavpn global

Maaaring panatilihin ang gfwlist sa advanced split-routing documentation, pero hindi ito inirerekomendang lumabas sa unang screen ng official website, sa download page Hero, o sa beginner quick start.

Inirerekomenda munang mag-disconnect at i-off ang Kill-switch:

panda disconnect
panda kill-switch off

Kung manual upgrade ito o Linux service upgrade, inirerekomenda ring ihinto ang daemon:

sudo panda stop

Kapag nag-upgrade ng macOS at Windows gamit ang installer, karaniwang awtomatikong hinahandle ng installer ang service installation at restart. Pagkatapos makumpleto ang upgrade, inirerekomendang patakbuhin:

panda version
panda doctor
panda connect

Pagkatapos ng manual upgrade sa Linux, inirerekomenda:

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

panda connect us

Ibig sabihin nito ay bare group selector; hindi nito pini-pin ang VIP / SVIP / FREE tab, at ang API ang pumipili ng angkop na tab.

panda connect svip us

Ibig sabihin nito ay fixed na gagamitin ang us sa ilalim ng SVIP tab.

Katumbas ang colon form at angkop para sa mga script:

panda connect svip:us

Ang favorite tab ay kasalukuyang flat favorite channel list at hindi sumusuporta sa favorite group smart connect gaya ng connect fav us; para sa favorite, gamitin:

panda connect fav

o:

panda connect --node <NODE_ID>

Pangunahing sinusuportahan ang:

Mga karaniwang setting:

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

Sa kasalukuyan, hindi inirerekomendang ipakita ang openvpn bilang pangunahing mode sa dokumentasyon ng user.

Rekomendasyon:

Tandaan: Magkasalungat ang mode proxy at Kill-switch.

Ang mode auto ang bagong default mode.

Ganito ang behavior nito:

• Pinipili ng API node / smart connect ang runtime batay sa meta.protocol bilang prioridad;
• Kung WireGuard ang inirerekomenda, susubukan muna nito ang WireGuard;
• Kung mabigo ang WireGuard metadata, address allocation, runtime startup, handshake, o connectivity probing, babalik ito sa PandaVPN global na binuo mula sa SS payload;
• Gagamitin ng SS, OPENVPN, unknown, o missing protocols ang PandaVPN global bilang fallback;
• Hindi tumatanggap ang mode auto ng policy parameter, at ang na-resolve na runtime ay palaging global.

Inirerekomenda para sa mga bagong user:

panda mode auto
panda connect

direct-region ang inirerekomendang syntax; ang bypass-region / bypass ay compatibility aliases.

Halimbawa:

panda mode pandavpn direct-region in

Katumbas ito ng compatibility alias:

panda mode pandavpn bypass-region in

Sinusuportahan ng bagong bersyon ang mas kumpletong split profile syntax:

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

Mga karaniwang token:

Mga halimbawa:

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

Hindi inirerekomendang ipakita ang mahahabang command sa beginner documentation; mas angkop ang mga ito sa advanced split documentation.

Tingnan ang lahat ng node:

panda node list

Mag-refresh at tingnan muli:

panda node refresh
panda node list

Maikling sulat:

panda no re
panda no list

Tingnan ang isang partikular na rehiyon o group:

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

Tingnan ang mga node group:

panda node group

Tingnan ang detalye ng isang partikular na group:

panda node group show us

Hanapin muna ang node:

panda node list us

Pagkatapos ay kumonekta:

panda connect --node 1822

Maaari ka ring kumonekta ayon sa pangalan:

panda connect --node "US Node"

Shorthand:

panda no list us
panda conn --node 1822

Gagamitin ng panda connect ang huling target.
Kung walang dating target, susubukan nito ang global smart connect.

Kailangan ng Smart connect:

• naka-login ka;
• naka-cache ang node directory;
• kung kailangan, patakbuhin muna ang panda node refresh.

Maikling sulat:

panda conn

Mga karaniwang dahilan:

• hindi ka pa naka-login;
• hindi pa na-refresh ang node directory;
• walang available na node ang kasalukuyang account;
• hindi available ang network;
• hindi tumatakbo ang daemon;
• hindi compatible ang kasalukuyang mode sa target node;
• sa mode auto, nabigong mag-start ang recommended protocol at nabigo rin ang fallback.

Inirerekomendang suriin:

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

panda status

Structured output:

panda status --json

Shorthand:

panda stat

Ang doctor ay read-only diagnostic command na ginagamit para tingnan ang kasalukuyang key status ng Panda CLI.

panda doctor
panda doctor --json

Maikling sulat:

panda do

Bigyang-pansin ang:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

Ginagamit ang trace para makita kung aling rule, DNS action, at route ang gagamitin ng isang target.

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

Tandaan: kailangan ng full trace capability ang active PandaVPN packet runtime. Kapag walang compatible runtime, limited validation lang ang magagawa o magfa-fallback sa legacy trace.

Karaniwan itong nangyayari dahil naka-install ang opisyal na service / LaunchDaemon, at manu-mano mo ring pinatakbo ang:

sudo panda start

Ang sudo panda start ay magsisimula ng unmanaged / hindi pinamamahalaang daemon, na maaaring sabay na mamahala kasama ng opisyal na daemon ng:

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

Ang prinsipyo sa pag-aayos ay: magpanatili lang ng isang daemon.

Karaniwang pag-aayos sa macOS / Linux:

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

Sa Linux, kung gumagamit ng systemd service, pagkatapos ay i-restart ang opisyal na service:

sudo panda service restart
panda doctor

Sa macOS, kung naka-install gamit ang .pkg, karaniwang hayaan ang LaunchDaemon / helper na mamahala sa daemon, at huwag gamitin ang sudo panda start nang pangmatagalan bilang araw-araw na paraan ng pagsisimula.

Kung gusto mo lang i-disconnect ang VPN, hindi kailangang i-exit ang daemon:

panda disconnect
panda kill-switch off

Kung talagang gusto mong ihinto ang daemon:

sudo panda stop

Kumpirmahin:

panda status

Kung lumabas ang panda daemon unavailable, ibig sabihin ay tumigil na ang main daemon.

Tandaan: Ang LaunchDaemon / helper na naka-install sa pamamagitan ng macOS .pkg ay maaaring pinamamahalaan ng system; hindi inirerekomenda sa karaniwang users na madalas na manu-manong ihinto ang service.

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

I-clear ang logs:

panda log clear

Pansamantalang i-enable ang debug:

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

Ibalik sa default:

panda log level reset

Sa no-tunnel IPv6 scenario, maaaring ma-block ang awdl0 / llw0, kaya pansamantalang hindi magagamit ang AirDrop / Continuity.
Karaniwan itong bumabalik pagkatapos ng disconnect.

Kung abnormal pa rin, inirerekomenda:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Maaaring i-configure ito sa mga supported version:

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

Paliwanag:

• Inirerekomenda bilang default ang auto;
• Hindi magkakaroon ng hot reconnect pagkatapos baguhin;
• Kailangan ng reconnect bago mag-take effect sa bagong TCP socket;
• Ang mga node na hindi sumusuporta sa TFO ay hindi dapat magkaroon ng kapansin-pansing connection latency regression.

Kung walang ganitong config option ang kasalukuyang version, sundin ang panda config --help o ang aktwal na CLI help.

Ang Privacy mode ay maaaring unawain bilang mas mahigpit na security mode, at inirerekomendang katumbas ng:

panda mode pandavpn global
panda kill-switch on

O sa ilalim ng default na awtomatikong pagpili ng protocol:

panda mode auto
panda kill-switch on

Sa Privacy mode, inirerekomenda ang mga sumusunod na limitasyon:

• Hindi sinusuportahan ang proxy mode;
• Hindi sinusuportahan ang split mode;
• VPN global semantics lang ang pinapayagan;
• Dapat naka-enable ang Kill-switch;
• Naka-block ang normal na egress.

Mas comprehensive ang panda repair at maaaring ayusin ang:

• VPN route
• DNS snapshot
• Kill-switch guard
• system proxy-related state

Pangunahing inaayos ng panda proxy repair ang system proxy drift ng kasalukuyang user.

panda repair
panda proxy repair

Sa Fresh install, ang default ay proxy system-proxy on.
Kung tahasang na-save ng user ang off, pananatilihin ang configuration na iyon.

Tingnan o i-set:

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

Tandaan: sa mode auto, pandavpn, at wireguard, ii-ignore ng VPN runtime ang naka-persist na system proxy preference; available pa rin ang VPN companion proxy at gagamit ng scoped egress.

Ang Windows system proxy ay HKCU WinINET setting ng kasalukuyang user at nangangailangan ng per-user user-agent.
Kung nasa SSH o non-interactive session ka, maaaring hindi palaging awtomatikong masimulan ng proxy repair ang user-agent.

Inirerekomenda:

panda proxy status
panda proxy repair
panda doctor

Kung hindi pa rin ito gumagana, subukang muli sa desktop login session.

Pangunahing sinusuportahan ng Linux Phase 1 ang GNOME gsettings.
Maaaring lumabas na unsupported ang mga environment gaya ng KDE / XFCE.

Hindi ito kinakailangang makaapekto sa PandaVPN packet runtime, pero maaari nitong maapektuhan ang karanasan sa system proxy mode.

Ang kahulugan ng Kill-switch ay payagan lamang ang traffic na dumaan sa TUN, habang bina-block ang ibang normal na traffic.

Ang proxy mode ay standalone local proxy mode. Wala itong packet VPN / TUN, at wala rin itong katumbas na DNS at routing protection. Kaya hindi sinusuportahan ng Kill-switch ang standalone proxy mode.

Kapag kailangan ng Kill-switch, gamitin:

panda mode auto
panda kill-switch on

O:

panda mode pandavpn global
panda kill-switch on

O:

panda mode wireguard
panda kill-switch on

Hindi.

Pangunahing saklaw ng Auto-connect ang best-effort connect kapag nagsisimula ang daemon / service, pati ang pending retry kapag pansamantalang walang network sa startup.

I-enable:

panda config auto-connect on

I-disable:

panda config auto-connect off

Hindi ito pangkalahatang runtime automatic reconnection mechanism.

Ginagamit ang Split rules para tukuyin kung ang ilang domain, keyword, regex, o IP ay dadaan sa proxy, direct, o block.

Rule files:

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

Karaniwang commands:

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

Kasalukuyang kilalang limitasyon: pagkatapos ng login, hindi awtomatikong mawi-wake ang pending auto-connect na naghihintay ng retry.

Inirerekomendang manu-manong patakbuhin pagkatapos ng login:

panda connect

Karaniwang hindi kailangan. Ang mga pagbabago sa Split DNS configuration ay hot-loaded.

Karaniwang commands:

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

Kung hindi sinusuportahan ng platform ang ilang local DNS sources, magpapakita ang doctor ng warning.

Sa mga bagong bersyon, ang Windows Kill-switch ay na-upgrade mula daemon-held dynamic session patungo sa persistent WFP filters.
Ibig sabihin, maaaring manatili ang guard pagkatapos mag-exit nang abnormal ang daemon.

Pero ang persistent WFP ay hindi katumbas ng boot-time filter; ang napakaagang startup window ay saklaw pa rin ng susunod na hardening.

Ang kahulugan ng Kill-switch ay payagan lamang ang traffic na dumaan sa TUN, habang bina-block ang ibang normal na traffic.

Ang proxy mode ay standalone local proxy mode. Wala itong packet VPN / TUN, at wala rin itong katumbas na DNS at routing protection. Kaya hindi sinusuportahan ng Kill-switch ang standalone proxy mode.

Kapag kailangan ng Kill-switch, gamitin:

panda mode auto
panda kill-switch on

O:

panda mode pandavpn global
panda kill-switch on

O:

panda mode wireguard
panda kill-switch on

Oo.

Pinapayagan ang mode auto + kill-switch on, pero dapat ma-resolve ang final path sa PandaVPN / WireGuard at hindi dapat mapunta sa standalone proxy. Sa proseso ng koneksyon, kung magfa-fallback mula WireGuard papuntang PandaVPN, dapat manatiling guard active at hindi dapat magkaroon ng anumang fail-open window.

Inirerekomenda:

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

Hindi inirerekomenda.

Ang Kill-switch ay opsyon para sa mas mataas na privacy protection, at hindi ito angkop ilagay sa pinakamaikling usable path. Mga dahilan:

• Hindi pinapatay ng disconnect ang Kill-switch;
• Pagkatapos i-enable, maaaring ma-block ang normal na network;
• Kasama rin dito ang LAN access, DNS lockdown, firewall, at pagkakaiba ng platform permissions;
• Maaaring isipin ng mga bagong user na sira ang network.

Inirerekomenda sa mga bagong user na tapusin muna ito:

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

Pagkatapos makumpirmang normal ang koneksyon, i-enable kung kailangan:

panda kill-switch on
panda doctor

Hindi.

Ito ang inaasahang behavior. Ang Kill-switch ay isang persistent safety switch, at ang disconnect ay dini-disconnect lang ang kasalukuyang runtime; hindi nito awtomatikong io-off ang Kill-switch.

Kung gusto mong ibalik ang normal na network access, patakbuhin:

panda kill-switch off

Sa strict mode, bina-block ng Kill-switch ang normal na LAN / WAN traffic.
Maaaring mag-enable ng limitadong LAN access ang mga bersyong sumusuporta sa allow-lan:

panda kill-switch allow-lan on

I-off ang LAN allowlisting:

panda kill-switch allow-lan off

Tandaan: pinapayagan ng allow-lan ang private network / link-local / ULA unicast at v1 discovery, pero dapat pa ring i-block ang LAN DNS para maiwasan ang pag-bypass sa Panda DNS lockdown.