PandaVPN CLI ЖҚС

Panda CLI — Panda-ның пәрмен жолы клиенті және терминал арқылы келесі әрекеттерді орындауды қолдайды:

• Кіру және аккаунтты басқару
• Түйіндерді жаңарту және түйіндерге қосылу
• PandaVPN / Proxy / WireGuard / Auto режимдері арасында ауысу
• Жүйелік проксиді конфигурациялау
• Трафикті бөлуге арналған Split rules ережелері
• Split DNS конфигурациясы
• Kill-switch қорғанысы
• Auto-connect
• Журналдар және диагностика

Ол ішкі тест пайдаланушыларына, әзірлеушілерге, тәжірибелі пайдаланушыларға және скрипттелген операцияларды қажет ететін тест сценарийлеріне қолайлы.

Panda CLI пәрмен жолы арқылы басқарылады және келесі әрекеттерге көбірек қолайлы:

• Автоматтандырылған тестілеу
• Қашықтан ақаулықтарды жою
• Скрипт арқылы қосылу
• Толық диагностикалық ақпаратты көру
• Kill-switch, DNS, бағыттау және жүйелік прокси сияқты төмен деңгейлі әрекеттерді тексеру

Үстелдік клиент қарапайым пайдаланушылардың күнделікті графикалық әрекеттеріне көбірек қолайлы.

Ескерту: ескі Qt үстелдік клиенті мен CLI-ге VPN / жүйелік проксиді бір уақытта басқару ұсынылмайды, себебі конфигурациялар бірін-бірі қайта жазуы мүмкін.

Кейбір мүмкіндіктер жүйелік деңгейдегі рұқсаттарды қажет етеді, мысалы:

• TUN / WireGuard желілік интерфейстерін жасау
• DNS-ті өзгерту
• Жүйелік проксиді баптау
• Kill-switch қолдану
• Маршруттарды түзету
• packet VPN runtime басқару

Сондықтан CLI бұл операцияларды платформаға сәйкес daemon / service арқылы орындайды.

Әртүрлі платформалардағы daemon түрлері:

Негізгі айырмашылық: Windows және macOS жүйелерінде қызмет әдетте орнату пакеті арқылы автоматты түрде орнатылады, ал Linux жүйесінде пайдаланушы әдетте sudo panda service install пәрменін қолмен орындауы керек.

Windows жүйесінде тек орнату пакетін пайдаланбай, бинарлық файлдарды қолмен орналастырған жағдайда ғана administrator PowerShell ішінде келесіні орындау керек:

panda service install windows

macOS жүйесінде бұл тек әзірлеу және debugging кезінде, .pkg орнату пакеті пайдаланылмаған кезде немесе daemon автоматты түрде іске қосылмаған кезде қажет:

sudo panda start

Linux үшін ұсынылады:

sudo panda service install
panda service status

Иә, бірдей. Негізгі айырмашылық жүктелетін орнату пакетінің архитектурасында.

Орнату қадамдары, пәрмендер және қызметті басқару тәсілі бірдей. Орнату пакеті құқықтарды автоматты түрде жоғарылатып, Windows Service-ті тіркейді.

Негізінен мыналарды қолдайды:

Жиі қолданылатын параметрлер:

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

Қазіргі уақытта openvpn пайдаланушы құжаттамасында негізгі режим ретінде көрсетілуі ұсынылмайды.

Ұсыныс:

Ескерту: mode proxy және Kill-switch бір-бірімен үйлеспейді.

mode auto — жаңа нұсқадағы әдепкі режим.

Оның әрекеті:

• API node / smart connect meta.protocol негізінде runtime-ды басымдықпен таңдайды;
• Егер WireGuard ұсынылса, алдымен WireGuard қолданып көреді;
• WireGuard метадеректері, мекенжай бөлу, runtime іске қосу, handshake немесе байланыс тексерісі сәтсіз болса, SS payload-тен құрастырылған PandaVPN global-ға қайтады;
• SS, OPENVPN, белгісіз немесе жоқ протоколдар fallback ретінде PandaVPN global қолданады;
• mode auto policy параметрін қабылдамайды, ал анықталған runtime әрқашан global болады.

Жаңа пайдаланушыларға ұсынылады:

panda mode auto
panda connect

direct-region — ұсынылатын жазылу түрі; bypass-region / bypass — үйлесімділік alias-тары.

Мысалы:

panda mode pandavpn direct-region in

Үйлесімділік alias-ымен баламасы:

panda mode pandavpn bypass-region in

Жаңа нұсқа split profile жазуының толықтау түрін қолдайды:

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

Жиі қолданылатын token:

Мысалдар:

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

Жаңадан бастаушылар құжаттамасында ұзын пәрмендерді көрсету ұсынылмайды; олар кеңейтілген split құжаттамасына қолайлы.

doctor — тек оқуға арналған диагностикалық команда, ол Panda CLI-дің ағымдағы негізгі күйлерін көру үшін қолданылады.

panda doctor
panda doctor --json

Қысқа жазылуы:

panda do

Негізінен мыналарға назар аударыңыз:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace белгілі бір мақсаттың қай rule, DNS action және route арқылы өтетінін көру үшін қолданылады.

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

Ескерту: толық trace мүмкіндігі үшін active PandaVPN packet runtime қажет. Үйлесімді runtime болмаса, тек шектеулі тексеру жасалады немесе legacy trace-ке fallback болады.

Әдетте бұл ресми service / LaunchDaemon орнатылып, сонымен қатар қолмен мына пәрмен орындалғандықтан болады:

sudo panda start

sudo panda start unmanaged / басқарылмайтын daemon іске қосады, ол ресми daemon-мен қатар мыналарды бір уақытта басқаруы мүмкін:

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

Шешу қағидасы: тек бір daemon қалдырыңыз.

macOS / Linux үшін жиі қолданылатын өңдеу:

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

Linux-та systemd service қолдансаңыз, одан кейін ресми service-ті қайта іске қосыңыз:

sudo panda service restart
panda doctor

macOS-та .pkg арқылы орнатылған болса, әдетте daemon-ды LaunchDaemon / helper басқарсын; sudo panda start пәрменін күнделікті іске қосу тәсілі ретінде ұзақ уақыт қолданбаңыз.

Егер тек VPN-ді ажыратқыңыз келсе, daemon-нан шығудың қажеті жоқ:

panda disconnect
panda kill-switch off

Егер шынымен daemon-ды тоқтатқыңыз келсе:

sudo panda stop

Растау:

panda status

Егер panda daemon unavailable көрсетілсе, бұл негізгі daemon тоқтағанын білдіреді.

Ескерту: macOS .pkg арқылы орнатылған LaunchDaemon / helper жүйе тарапынан басқарылуы мүмкін; қарапайым пайдаланушыларға қызметті жиі қолмен тоқтату ұсынылмайды.

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

Logs тазалау:

panda log clear

Debug-ті уақытша қосу:

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

Әдепкіге қайтару:

panda log level reset

panda repair анағұрлым кешенді және мыналарды түзетуі мүмкін:

• VPN route
• DNS snapshot
• Kill-switch guard
• system proxy-ге қатысты күй

panda proxy repair негізінен ағымдағы пайдаланушының system proxy drift мәселесін түзетеді.

panda repair
panda proxy repair

Fresh install кезінде әдепкі мән proxy system-proxy on болады.
Егер пайдаланушы off мәнін нақты сақтаған болса, сол конфигурация сақталады.

Көру немесе орнату:

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

Ескерту: mode auto, pandavpn және wireguard режимдерінде VPN runtime сақталған system proxy баптауын елемейді; VPN companion proxy қолжетімді болып қалады және scoped egress арқылы жұмыс істейді.

Windows system proxy — ағымдағы пайдаланушының HKCU WinINET параметрі және per-user user-agent талап етеді.
Егер SSH немесе интерактивті емес сессияда болсаңыз, proxy repair user-agent-ті әрдайым автоматты түрде іске қоса алмауы мүмкін.

Ұсынылады:

panda proxy status
panda proxy repair
panda doctor

Егер әлі де күшіне енбесе, desktop login session ішінде қайта көріңіз.

Linux Phase 1 негізінен GNOME gsettings-ті қолдайды.
KDE / XFCE сияқты орталар unsupported болып көрсетілуі мүмкін.

Бұл міндетті түрде PandaVPN packet runtime-ға әсер етпейді, бірақ system proxy mode тәжірибесіне әсер етуі мүмкін.

Kill-switch мәні — тек TUN арқылы өтетін traffic-ке рұқсат беру, ал басқа қалыпты traffic-ті бұғаттау.

proxy mode — standalone жергілікті proxy режимі; онда packet VPN / TUN жоқ және DNS пен routing үшін балама қорғаныс қамтамасыз етілмейді. Сондықтан Kill-switch standalone proxy mode-ты қолдамайды.

Kill-switch қажет болғанда пайдаланыңыз:

panda mode auto
panda kill-switch on

Немесе:

panda mode pandavpn global
panda kill-switch on

Немесе:

panda mode wireguard
panda kill-switch on

Жоқ.

Auto-connect негізінен daemon / service іске қосылғандағы best-effort connect-ті және іске қосылу кезінде желі уақытша қолжетімсіз болса pending retry-ді қамтиды.

Қосу:

panda config auto-connect on

Өшіру:

panda config auto-connect off

Бұл жалпы runtime автоматты қайта қосылу механизмі емес.

Split rules белгілі бір домендер, кілт сөздер, regex немесе IP proxy, direct немесе block арқылы өтетінін көрсету үшін қолданылады.

Rules файлдары:

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

Жиі қолданылатын командалар:

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

Қазіргі белгілі шектеу: login-нен кейін retry күтіп тұрған pending auto-connect автоматты түрде wake болмайды.

Login-нен кейін қолмен орындау ұсынылады:

panda connect

Әдетте қажет емес. Split DNS конфигурациясының өзгерістері hot-load болады.

Жиі қолданылатын командалар:

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

Егер платформа кейбір local DNS көздерін қолдамаса, doctor warning көрсетеді.