Soalan Lazim PandaVPN CLI

Panda CLI ialah klien baris perintah Panda dan menyokong perkara berikut melalui terminal:

• Log masuk dan pengurusan akaun
• Muat semula nod dan sambungan nod
• Bertukar antara mod PandaVPN / Proxy / WireGuard / Auto
• Konfigurasi proksi sistem
• Split rules untuk pemisahan trafik
• Konfigurasi Split DNS
• Perlindungan Kill-switch
• Auto-connect
• Log dan diagnostik

Ia sesuai untuk pengguna ujian dalaman, pembangun, pengguna lanjutan dan senario ujian yang memerlukan operasi berskrip.

PandaVPN CLI lebih sesuai untuk ujian automatik, penyelesaian masalah jarak jauh dan sambungan yang dikendalikan melalui skrip.

Panda Desktop dan PandaVPN CLI ialah dua antara muka kawalan untuk PandaVPN daemon yang sama dan berkongsi status sambungan yang sama, jadi kedua-duanya boleh digunakan bersama.

Jangan jalankan aplikasi desktop lama, seperti Panda-Qt atau Linux AppImage lama, pada masa yang sama dengan PandaVPN CLI kerana ini boleh menyebabkan konflik konfigurasi rangkaian.

Sesetengah keupayaan memerlukan kebenaran peringkat sistem, contohnya:

• Mencipta antara muka rangkaian TUN / WireGuard
• Mengubah suai DNS
• Menetapkan proksi sistem
• Menggunakan Kill-switch
• Membaiki laluan
• Mengurus packet VPN runtime

Oleh itu, CLI menjalankan operasi ini melalui daemon / service yang sepadan dengan platform.

Bentuk daemon pada platform berbeza:

Perbezaan utama ialah: Pada Windows dan macOS, service biasanya dipasang secara automatik melalui pakej pemasang, manakala pada Linux pengguna biasanya perlu menjalankan sudo panda service install secara manual.

Pada Windows, hanya apabila anda tidak menggunakan pakej pemasang dan meletakkan binary secara manual, anda perlu menjalankan yang berikut dalam PowerShell pentadbir:

panda service install windows

Pada macOS, ini hanya diperlukan semasa pembangunan dan penyahpepijatan, apabila tidak menggunakan pakej pemasang .pkg, atau apabila daemon tidak bermula secara automatik:

sudo panda start

Pada Linux, disyorkan:

sudo panda service install
panda service status

Ya, sama. Perbezaan utama ialah seni bina pakej pemasangan yang dimuat turun.

Langkah pemasangan, arahan dan cara pengurusan perkhidmatan adalah sama. Pakej pemasangan akan menaikkan keistimewaan secara automatik dan mendaftarkan Windows Service.

Ya, sama. Perbezaan utamanya ialah seni bina pakej .pkg yang dimuat turun.

Langkah pemasangan adalah sama. Selepas memasang menggunakan .pkg, LaunchDaemon / helper biasanya dipasang dan dimulakan secara automatik.

Untuk pengguna global, kami mengesyorkan penggunaan mode auto secara lalai:

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

Jika pemasangan baharu sudah menggunakan mode auto secara lalai, anda juga boleh menggunakan versi yang lebih ringkas:

panda login
panda node refresh
panda connect
panda doctor

Versi ringkas yang sepadan:

panda login
panda no re
panda conn
panda do

Halaman muat turun rasmi dan panduan pengguna baharu disarankan untuk mengutamakan paparan arahan penuh; bentuk ringkas boleh dipaparkan kemudian dalam dokumentasi lanjutan atau penerangan mod interaktif.

gfwlist ialah sumber peraturan split yang khusus dan tidak sesuai sebagai mod lalai untuk pengguna global.

Untuk pengguna global, lalai yang disyorkan ialah:

panda mode auto

Atau gunakan mod global PandaVPN secara tetap:

panda mode pandavpn global

gfwlist boleh dikekalkan dalam dokumentasi split routing lanjutan, tetapi tidak disyorkan untuk muncul pada skrin pertama laman rasmi, Hero halaman muat turun, atau quick start untuk pemula.

Disyorkan untuk disconnect dahulu dan mematikan Kill-switch:

panda disconnect
panda kill-switch off

Jika ia upgrade manual atau upgrade Linux service, disyorkan juga untuk menghentikan daemon:

sudo panda stop

Apabila menaik taraf macOS dan Windows menggunakan installer, installer biasanya mengurus pemasangan service dan restart secara automatik. Selepas upgrade selesai, disyorkan menjalankan:

panda version
panda doctor
panda connect

Selepas upgrade manual di Linux, disyorkan:

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

panda connect us

Ini bermaksud bare group selector; ia tidak menetapkan VIP / SVIP / FREE tab, dan API akan memilih tab yang sesuai.

panda connect svip us

Ini bermaksud menggunakan us secara tetap di bawah SVIP tab.

Bentuk bertitik dua adalah setara dan sesuai untuk scripts:

panda connect svip:us

favorite tab pada masa ini ialah flat favorite channel list dan tidak menyokong favorite group smart connect seperti connect fav us; untuk favorite, gunakan:

panda connect fav

atau:

panda connect --node <NODE_ID>

Terutamanya menyokong:

Tetapan biasa:

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

openvpn pada masa ini tidak disarankan untuk dipaparkan sebagai mod utama dalam dokumentasi pengguna.

Cadangan:

Nota: mode proxy dan Kill-switch saling eksklusif.

mode auto ialah mod lalai dalam versi baharu.

Tingkah lakunya ialah:

• API node / smart connect memilih runtime mengikut keutamaan berdasarkan meta.protocol;
• Jika WireGuard disyorkan, WireGuard akan dicuba terlebih dahulu;
• Jika metadata WireGuard, peruntukan alamat, permulaan runtime, handshake atau semakan sambungan gagal, ia akan kembali kepada PandaVPN global yang dikompil daripada SS payload;
• SS, OPENVPN, protokol yang tidak diketahui atau tiada akan menggunakan PandaVPN global sebagai fallback;
• mode auto tidak menerima parameter policy, dan runtime yang diselesaikan sentiasa global.

Disyorkan untuk pengguna baharu:

panda mode auto
panda connect

direct-region ialah penulisan yang disyorkan; bypass-region / bypass ialah alias keserasian.

Contoh:

panda mode pandavpn direct-region in

Bersamaan dengan alias keserasian:

panda mode pandavpn bypass-region in

Versi baharu menyokong sintaks split profile yang lebih lengkap:

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

Token biasa:

Contoh:

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

Dokumentasi pengguna baharu tidak disarankan memaparkan arahan panjang; ia lebih sesuai untuk dokumentasi split lanjutan.

Lihat semua node:

panda node list

Refresh dan lihat semula:

panda node refresh
panda node list

Bentuk pendek:

panda no re
panda no list

Lihat region atau group tertentu:

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

Lihat node groups:

panda node group

Lihat butiran group tertentu:

panda node group show us

Cari node dahulu:

panda node list us

Kemudian sambung:

panda connect --node 1822

Anda juga boleh menyambung mengikut nama:

panda connect --node "US Node"

Singkatan:

panda no list us
panda conn --node 1822

panda connect akan menggunakan target terakhir.
Jika tiada target terdahulu, ia akan mencuba global smart connect.

Smart connect memerlukan:

• anda sudah log masuk;
• direktori node telah dicache;
• jika perlu, jalankan panda node refresh dahulu.

Bentuk pendek:

panda conn

Sebab biasa:

• anda belum log masuk;
• direktori node belum di-refresh;
• akaun semasa tiada node yang tersedia;
• rangkaian tidak tersedia;
• daemon tidak berjalan;
• mode semasa tidak serasi dengan node sasaran;
• di bawah mode auto, protokol yang disyorkan gagal dimulakan dan fallback juga gagal.

Semakan yang disyorkan:

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

panda status

Output berstruktur:

panda status --json

Singkatan:

panda stat

doctor ialah perintah diagnostik read-only yang digunakan untuk melihat status penting semasa Panda CLI.

panda doctor
panda doctor --json

Bentuk pendek:

panda do

Fokus pada:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

trace digunakan untuk melihat rule, DNS action dan route yang akan digunakan oleh sesuatu target.

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

Nota: keupayaan trace penuh memerlukan active PandaVPN packet runtime. Jika tiada runtime yang serasi, hanya validasi terhad boleh dibuat atau fallback ke legacy trace.

Biasanya ini berlaku kerana service / LaunchDaemon rasmi telah dipasang, dan anda juga menjalankan secara manual:

sudo panda start

sudo panda start akan memulakan daemon unmanaged / tidak diurus, yang mungkin mengurus perkara berikut serentak dengan daemon rasmi:

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

Prinsip penyelesaiannya ialah: kekalkan hanya satu daemon.

Pengendalian biasa pada macOS / Linux:

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

Pada Linux, jika menggunakan systemd service, kemudian restart service rasmi:

sudo panda service restart
panda doctor

Pada macOS, jika dipasang menggunakan .pkg, biasanya biarkan LaunchDaemon / helper mengurus daemon, dan jangan gunakan sudo panda start untuk jangka panjang sebagai cara startup harian.

Jika anda hanya mahu memutuskan VPN, tidak perlu keluar daripada daemon:

panda disconnect
panda kill-switch off

Jika anda benar-benar mahu menghentikan daemon:

sudo panda stop

Sahkan:

panda status

Jika memaparkan panda daemon unavailable, ini bermaksud daemon utama telah berhenti.

Nota: LaunchDaemon / helper yang dipasang melalui macOS .pkg mungkin diurus oleh sistem; pengguna biasa tidak disarankan kerap menghentikan service secara manual.

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

Kosongkan logs:

panda log clear

Aktifkan debug sementara:

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

Pulihkan default:

panda log level reset

Dalam senario no-tunnel IPv6, awdl0 / llw0 mungkin di-block, menyebabkan AirDrop / Continuity tidak tersedia buat sementara waktu.
Biasanya pulih selepas disconnect.

Jika masih tidak normal, disyorkan:

panda disconnect
panda kill-switch off
panda repair
panda doctor

Versi yang disokong boleh mengkonfigurasi ini:

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

Penjelasan:

• Default yang disyorkan ialah auto;
• Selepas perubahan, tiada hot reconnect akan berlaku;
• Reconnect diperlukan untuk berkuat kuasa pada TCP socket baharu;
• Node yang tidak menyokong TFO tidak sepatutnya menunjukkan regression latency sambungan yang ketara.

Jika versi semasa tiada pilihan konfigurasi ini, rujuk panda config --help atau CLI help sebenar.

Privacy mode boleh difahami sebagai mode keselamatan yang lebih ketat, dan disarankan setara dengan:

panda mode pandavpn global
panda kill-switch on

Atau di bawah pemilihan protocol automatik lalai:

panda mode auto
panda kill-switch on

Dalam Privacy mode, had berikut disarankan:

• Tidak menyokong proxy mode;
• Tidak menyokong split mode;
• Hanya membenarkan semantik VPN global;
• Kill-switch mesti diaktifkan;
• egress biasa disekat.

panda repair lebih menyeluruh dan mungkin membaiki:

• VPN route
• DNS snapshot
• Kill-switch guard
• keadaan berkaitan system proxy

panda proxy repair terutamanya membaiki system proxy drift bagi pengguna semasa.

panda repair
panda proxy repair

Pada Fresh install, default ialah proxy system-proxy on.
Jika pengguna menyimpan off secara eksplisit, konfigurasi itu akan dikekalkan.

Lihat atau tetapkan:

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

Nota: di bawah mode auto, pandavpn dan wireguard, VPN runtime akan mengabaikan keutamaan system proxy yang dipersistkan; VPN companion proxy masih tersedia dan menggunakan scoped egress.

Windows system proxy ialah tetapan HKCU WinINET pengguna semasa dan memerlukan per-user user-agent.
Jika anda berada dalam SSH atau sesi bukan interaktif, proxy repair mungkin tidak selalu dapat memulakan user-agent secara automatik.

Disyorkan:

panda proxy status
panda proxy repair
panda doctor

Jika masih tidak berkesan, cuba semula dalam sesi log masuk desktop.

Linux Phase 1 terutamanya menyokong GNOME gsettings.
Environment seperti KDE / XFCE mungkin dipaparkan sebagai unsupported.

Ini tidak semestinya menjejaskan PandaVPN packet runtime, tetapi mungkin menjejaskan pengalaman system proxy mode.

Maksud Kill-switch ialah hanya membenarkan trafik melalui TUN, manakala trafik biasa lain akan disekat.

proxy mode ialah standalone local proxy mode, tanpa packet VPN / TUN dan tanpa perlindungan DNS serta routing yang setara. Oleh itu, Kill-switch tidak menyokong standalone proxy mode.

Apabila memerlukan Kill-switch, gunakan:

panda mode auto
panda kill-switch on

Atau:

panda mode pandavpn global
panda kill-switch on

Atau:

panda mode wireguard
panda kill-switch on

Tidak.

Auto-connect terutamanya meliputi best-effort connect apabila daemon / service bermula, serta pending retry apabila rangkaian tidak tersedia buat sementara semasa permulaan.

Hidupkan:

panda config auto-connect on

Matikan:

panda config auto-connect off

Ia bukan mekanisme runtime automatic reconnect yang umum.

Split rules digunakan untuk menentukan domain, kata kunci, regex atau IP tertentu melalui proxy, direct atau block.

Fail rules:

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

Command biasa:

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

Had yang diketahui buat masa ini: selepas login, pending auto-connect yang menunggu retry tidak akan di-wake secara automatik.

Disyorkan untuk menjalankan secara manual selepas login:

panda connect

Biasanya tidak perlu. Perubahan konfigurasi Split DNS akan di-hot-load.

Command biasa:

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

Jika platform tidak menyokong sesetengah sumber local DNS, doctor akan memaparkan warning.

Dalam versi baharu, Windows Kill-switch telah dinaik taraf daripada daemon-held dynamic session kepada persistent WFP filters.
Ini bermaksud guard boleh kekal selepas daemon keluar secara tidak normal.

Namun persistent WFP tidak sama dengan boot-time filter; tetingkap startup yang sangat awal masih termasuk dalam skop hardening seterusnya.

Maksud Kill-switch ialah hanya membenarkan trafik melalui TUN, manakala trafik biasa lain akan disekat.

proxy mode ialah standalone local proxy mode, tanpa packet VPN / TUN dan tanpa perlindungan DNS serta routing yang setara. Oleh itu, Kill-switch tidak menyokong standalone proxy mode.

Apabila memerlukan Kill-switch, gunakan:

panda mode auto
panda kill-switch on

Atau:

panda mode pandavpn global
panda kill-switch on

Atau:

panda mode wireguard
panda kill-switch on

Boleh.

mode auto + kill-switch on dibenarkan, tetapi path akhir mesti resolve kepada PandaVPN / WireGuard dan tidak boleh jatuh kepada standalone proxy. Semasa proses sambungan, jika fallback daripada WireGuard kepada PandaVPN berlaku, guard active juga mesti dikekalkan dan tidak boleh ada fail-open window.

Disyorkan:

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

Tidak disyorkan.

Kill-switch ialah pilihan perlindungan privasi yang dipertingkatkan, dan tidak sesuai dimasukkan ke dalam laluan boleh guna paling pendek. Sebabnya:

• disconnect tidak mematikan Kill-switch;
• Selepas dihidupkan, rangkaian biasa mungkin disekat;
• Ia juga melibatkan akses LAN, DNS lockdown, firewall dan perbezaan kebenaran platform;
• Pengguna baharu mungkin tersalah anggap rangkaian rosak.

Pengguna baharu disyorkan melengkapkan ini dahulu:

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

Selepas mengesahkan sambungan berfungsi secara normal, hidupkan mengikut keperluan:

panda kill-switch on
panda doctor

Tidak.

Ini ialah tingkah laku yang dijangka. Kill-switch ialah suis keselamatan berterusan, dan disconnect hanya memutuskan runtime semasa; ia tidak akan mematikan Kill-switch secara automatik.

Untuk memulihkan akses rangkaian biasa, jalankan:

panda kill-switch off

Dalam strict mode, Kill-switch akan menyekat trafik LAN / WAN biasa.
Versi yang menyokong allow-lan boleh menghidupkan akses LAN terhad:

panda kill-switch allow-lan on

Matikan pelepasan LAN:

panda kill-switch allow-lan off

Nota: allow-lan membenarkan private network / link-local / ULA unicast dan v1 discovery, tetapi LAN DNS masih perlu disekat bagi mengelakkan pintasan Panda DNS lockdown.