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.

Ginagamit ang Panda CLI sa pamamagitan ng command line at mas angkop ito para sa:

• Automated testing
• Remote troubleshooting
• Scripted connections
• Pagtingin ng detalyadong diagnostic information
• Pag-validate ng low-level behaviors gaya ng Kill-switch, DNS, routing, at system proxy

Mas angkop ang desktop client para sa pang-araw-araw na graphical operations ng karaniwang mga user.

Tandaan: Hindi inirerekomenda na sabay na pamahalaan ng lumang Qt desktop client at CLI ang VPN / system proxy, upang maiwasan ang pag-overwrite ng configuration ng isa’t isa.

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.

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.

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

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.