PandaVPN CLI FAQ များ

Panda CLI သည် Panda ၏ command-line client ဖြစ်ပြီး terminal မှတစ်ဆင့် အောက်ပါအရာများကို ဆောင်ရွက်နိုင်ရန် ပံ့ပိုးထားသည်:

• လော့ဂ်အင်ဝင်ခြင်းနှင့် အကောင့်စီမံခန့်ခွဲခြင်း
• Node များကို refresh လုပ်ခြင်းနှင့် node များသို့ ချိတ်ဆက်ခြင်း
• PandaVPN / Proxy / WireGuard / Auto မုဒ်များအကြား ပြောင်းလဲခြင်း
• System proxy ကို configure လုပ်ခြင်း
• Traffic ခွဲဝေရန် Split rules
• Split DNS ကို configure လုပ်ခြင်း
• Kill-switch ကာကွယ်မှု
• Auto-connect
• Logs နှင့် diagnostics

၎င်းသည် internal beta users၊ developers၊ advanced users နှင့် scripted operations လိုအပ်သော testing scenarios များအတွက် သင့်လျော်သည်။

Panda CLI သည် command line မှတစ်ဆင့် လုပ်ဆောင်သဖြင့် အောက်ပါအတွက် ပိုမိုသင့်လျော်သည်:

• အလိုအလျောက် စမ်းသပ်ခြင်း
• အဝေးမှ ပြဿနာရှာဖွေဖြေရှင်းခြင်း
• Script ဖြင့် ချိတ်ဆက်ခြင်း
• အသေးစိတ် diagnostic information ကြည့်ရှုခြင်း
• Kill-switch, DNS, routing, system proxy စသည့် low-level behavior များကို စစ်ဆေးအတည်ပြုခြင်း

Desktop client သည် သာမန်အသုံးပြုသူများ၏ နေ့စဉ် graphical operations များအတွက် ပိုမိုသင့်လျော်သည်။

မှတ်ချက်: Qt desktop client အဟောင်းနှင့် CLI ကို VPN / system proxy ကို တစ်ချိန်တည်း စီမံခန့်ခွဲရန် မအကြံပြုပါ။ configuration များ အပြန်အလှန် overwrite ဖြစ်ခြင်းကို ရှောင်ရှားရန်ဖြစ်သည်။

အချို့သော လုပ်ဆောင်နိုင်စွမ်းများသည် စနစ်အဆင့် ခွင့်ပြုချက်များ လိုအပ်သည်၊ ဥပမာ:

• TUN / WireGuard ကွန်ရက် interface များ ဖန်တီးခြင်း
• DNS ပြင်ဆင်ခြင်း
• စနစ် proxy သတ်မှတ်ခြင်း
• Kill-switch အသုံးပြုခြင်း
• route များ ပြုပြင်ခြင်း
• packet VPN runtime စီမံခြင်း

ထို့ကြောင့် CLI သည် ဤလုပ်ဆောင်ချက်များကို platform နှင့်ကိုက်ညီသော daemon / service မှတစ်ဆင့် ဆောင်ရွက်ပါသည်။

platform မျိုးစုံရှိ daemon ပုံစံများ:

အဓိက ကွာခြားချက်မှာ: Windows နှင့် macOS တွင် service ကို installation package မှတစ်ဆင့် ပုံမှန်အားဖြင့် အလိုအလျောက် install လုပ်ပေးသော်လည်း Linux တွင် အသုံးပြုသူက sudo panda service install ကို ပုံမှန်အားဖြင့် manual run လုပ်ရန် လိုအပ်သည်။

Windows တွင် installer ကို မသုံးဘဲ binary ကို manual ထားသည့်အခါမှသာ administrator PowerShell တွင် အောက်ပါ command ကို run လုပ်ရန် လိုအပ်သည်:

panda service install windows

macOS တွင် development နှင့် debugging အတွက်၊ .pkg installer မသုံးသည့်အခါ၊ သို့မဟုတ် daemon အလိုအလျောက် မစတင်သည့်အခါမှသာ လိုအပ်သည်:

sudo panda start

Linux အတွက် အကြံပြုချက်:

sudo panda service install
panda service status

တူညီပါသည်။ အဓိကကွာခြားချက်မှာ ဒေါင်းလုဒ်လုပ်သည့် installation package ၏ architecture ဖြစ်သည်။

ထည့်သွင်းခြင်းအဆင့်များ၊ command များနှင့် service စီမံခန့်ခွဲမှုနည်းလမ်းများမှာ တူညီပါသည်။ Installer သည် privilege ကို အလိုအလျောက်မြှင့်ပြီး Windows Service ကို register လုပ်ပါမည်။

အဓိကအားဖြင့် အောက်ပါတို့ကို ထောက်ပံ့သည်:

အသုံးများသော ဆက်တင်များ:

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

လက်ရှိတွင် openvpn ကို user documentation ထဲတွင် mainline mode အဖြစ် ပြသရန် မအကြံပြုပါ။

အကြံပြုချက်:

မှတ်ချက်: mode proxy နှင့် Kill-switch ကို တစ်ပြိုင်နက် အသုံးမပြုနိုင်ပါ။

mode auto သည် ဗားရှင်းအသစ်၏ မူရင်း mode ဖြစ်သည်။

၎င်း၏ လုပ်ဆောင်ပုံမှာ:

• API node / smart connect သည် meta.protocol အပေါ်မူတည်၍ runtime ကို ဦးစားပေးရွေးချယ်သည်;
• WireGuard ကို အကြံပြုထားပါက WireGuard ကို ဦးစွာစမ်းသပ်မည်;
• WireGuard metadata, address allocation, runtime startup, handshake သို့မဟုတ် connectivity probing မအောင်မြင်ပါက SS payload မှ compile လုပ်ထားသော PandaVPN global သို့ fallback လုပ်မည်;
• SS, OPENVPN, မသိသော သို့မဟုတ် ပျောက်ဆုံးနေသော protocol များသည် PandaVPN global ကို fallback အဖြစ် အသုံးပြုမည်;
• mode auto သည် policy parameter ကို လက်မခံပါ၊ resolve လုပ်ထားသော runtime သည် အမြဲ global ဖြစ်သည်။

အသုံးပြုသူအသစ်များအတွက် အကြံပြုသည်:

panda mode auto
panda connect

direct-region သည် အကြံပြုထားသောရေးနည်းဖြစ်သည်; bypass-region / bypass သည် compatibility aliases ဖြစ်သည်။

ဥပမာ:

panda mode pandavpn direct-region in

compatibility alias နှင့် တူညီသည်:

panda mode pandavpn bypass-region in

ဗားရှင်းအသစ်သည် ပိုမိုပြည့်စုံသော split profile syntax ကို ထောက်ပံ့သည်:

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

Beginner documentation တွင် long commands ကို ပြသရန် မအကြံပြုပါ; advanced split documentation တွင် ထည့်ရန် ပိုသင့်တော်သည်။

doctor သည် Panda CLI ၏ လက်ရှိ အဓိက status များကို ကြည့်ရန် အသုံးပြုသော read-only diagnostic command ဖြစ်သည်။

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 သည် target တစ်ခုက မည်သည့် rule, DNS action နှင့် route ကို အသုံးပြုမည်ကို ကြည့်ရန် အသုံးပြုသည်။

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

မှတ်ချက်: trace အပြည့်အစုံအတွက် active PandaVPN packet runtime လိုအပ်သည်။ compatible runtime မရှိပါက limited validation သို့မဟုတ် legacy trace သို့ fallback သာ လုပ်နိုင်သည်။

ပုံမှန်အားဖြင့် official service / LaunchDaemon ကို install လုပ်ထားပြီး ထို့အပြင် ကိုယ်တိုင် run လုပ်ထားသောကြောင့် ဖြစ်တတ်သည်:

sudo panda start

sudo panda start သည် unmanaged / မစီမံထားသော daemon တစ်ခုကို စတင်ပြီး official daemon နှင့်အတူ တချိန်တည်းတွင် အောက်ပါတို့ကို manage လုပ်နိုင်သည်:

• 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 ကို အသုံးပြုပါက ထို့နောက် official service ကို restart လုပ်ပါ:

sudo panda service restart
panda doctor

macOS တွင် .pkg ဖြင့် install လုပ်ထားပါက ပုံမှန်အားဖြင့် LaunchDaemon / helper ကို daemon manage လုပ်စေပြီး sudo panda start ကို နေ့စဉ် startup နည်းလမ်းအဖြစ် ရေရှည်မသုံးပါနှင့်။

VPN ကို disconnect လုပ်ချင်ရုံသာဆိုရင် daemon မှ ထွက်ရန် မလိုအပ်ပါ:

panda disconnect
panda kill-switch off

daemon ကို တကယ်ရပ်ချင်ပါက:

sudo panda stop

အတည်ပြုရန်:

panda status

panda daemon unavailable ပြပါက main daemon ရပ်ပြီးဖြစ်သည်ဟု ဆိုလိုသည်။

မှတ်ချက်: macOS .pkg ဖြင့် install လုပ်ထားသော LaunchDaemon / helper ကို system က manage လုပ်နိုင်ပါသည်။ သာမန် users များအနေဖြင့် service ကို မကြာခဏ manually stop မလုပ်ရန် အကြံပြုပါသည်။

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

Logs ကို ရှင်းလင်းရန်:

panda log clear

Debug ကို ယာယီဖွင့်ရန်:

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

Default ကို ပြန်ထားရန်:

panda log level reset

panda repair သည် ပိုမိုအကျယ်အဝန်းရှိပြီး အောက်ပါတို့ကို ပြင်ဆင်နိုင်သည်:

• VPN route
• DNS snapshot
• Kill-switch guard
• system proxy နှင့်ဆိုင်သော state

panda proxy repair သည် အဓိကအားဖြင့် လက်ရှိအသုံးပြုသူ၏ system proxy drift ကို ပြင်ဆင်သည်။

panda repair
panda proxy repair

Fresh install တွင် default သည် proxy system-proxy on ဖြစ်သည်။
အသုံးပြုသူက off ကို အတိအလင်း save လုပ်ထားပါက ထို configuration ကို ဆက်လက်ထိန်းသိမ်းပါမည်။

ကြည့်ရန် သို့မဟုတ် သတ်မှတ်ရန်:

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

မှတ်ချက်: mode auto, pandavpn, wireguard တို့တွင် VPN runtime သည် persist လုပ်ထားသော system proxy preference ကို လျစ်လျူရှုပါမည်; VPN companion proxy ကို ဆက်လက်အသုံးပြုနိုင်ပြီး scoped egress ကို အသုံးပြုပါမည်။

Windows system proxy သည် လက်ရှိအသုံးပြုသူ၏ HKCU WinINET setting ဖြစ်ပြီး per-user user-agent လိုအပ်သည်။
SSH သို့မဟုတ် non-interactive session ထဲတွင်ရှိပါက proxy repair သည် user-agent ကို အမြဲတမ်း အလိုအလျောက် စတင်နိုင်မည်မဟုတ်ပါ။

အကြံပြုချက်:

panda proxy status
panda proxy repair
panda doctor

မထိရောက်သေးပါက desktop login session ထဲတွင် ပြန်လည်စမ်းကြည့်ပါ။

Linux Phase 1 သည် အဓိကအားဖြင့် GNOME gsettings ကို support လုပ်သည်။
KDE / XFCE ကဲ့သို့သော environment များသည် unsupported အဖြစ် ပြသနိုင်သည်။

၎င်းသည် PandaVPN packet runtime ကို မဖြစ်မနေ ထိခိုက်စေမည်မဟုတ်သော်လည်း system proxy mode အတွေ့အကြုံကို ထိခိုက်စေနိုင်သည်။

Kill-switch ၏ အဓိပ္ပါယ်မှာ TUN မှတစ်ဆင့် သွားသော traffic ကိုသာ ခွင့်ပြုပြီး အခြားပုံမှန် traffic များကို ပိတ်ဆို့ခြင်းဖြစ်သည်။

proxy mode သည် standalone local proxy mode ဖြစ်ပြီး 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 နှင့် startup အချိန်တွင် network ယာယီမရနိုင်ပါက pending retry ကို အဓိက အကျုံးဝင်စေသည်။

ဖွင့်ရန်:

panda config auto-connect on

ပိတ်ရန်:

panda config auto-connect off

၎င်းသည် runtime automatic reconnect mechanism အထွေထွေမဟုတ်ပါ။

Split rules ကို domain, keyword, regex သို့မဟုတ် IP တချို့ကို proxy, direct သို့မဟုတ် block မှတစ်ဆင့် သွားရန် သတ်မှတ်ဖို့ အသုံးပြုသည်။

Rules ဖိုင်များ:

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

အသုံးများသော 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

လက်ရှိ သိထားသော ကန့်သတ်ချက်: login ပြီးနောက် retry ကို စောင့်နေသော pending auto-connect ကို အလိုအလျောက် wake လုပ်မည်မဟုတ်ပါ။

login ပြီးနောက် ကိုယ်တိုင် run လုပ်ရန် အကြံပြုသည်:

panda connect

ပုံမှန်အားဖြင့် မလိုအပ်ပါ။ Split DNS configuration ပြောင်းလဲမှုများကို hot-load လုပ်ပါသည်။

အသုံးများသော 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

platform သည် local DNS sources အချို့ကို မထောက်ပံ့ပါက doctor သည် warning ပြပါမည်။