logo 你的 IP: 未知 · 你的狀態: 未受保護 要隱藏你的 IP 地址,你需要獲取 PandaVPN 並連接到其中一個伺服器。

PandaVPN CLI 命令列客戶端

面向開發者、進階用戶與自動化測試場景打造。透過終端即可完成登入、節點刷新、VPN 模式切換、Kill-switch 配置、連線與日誌診斷。

Windows 和 macOS 安裝包會自動註冊背景服務,Linux 用戶可透過命令手動安裝 systemd service。

獲取 PandaVPN
panda@terminal
panda> mode pandavpn global panda> connect [Success] Connected to <NODE_ID>. panda> doctor [OK] Runtime healthy. |

選擇適合你的 CLI 版本

根據你的作業系統和處理器架構下載 PandaVPN CLI,並按照對應系統的快速開始步驟完成安裝、登入、節點刷新、模式切換、連線和診斷。

macOS

系統說明

適用於 macOS 用戶。安裝包會自動完成必要的權限申請、背景 daemon 安裝與啟動。

安裝說明

  1. 下載對應架構的 .pkg 安裝包。
  2. 按兩下開啟安裝包,並按提示完成安裝。
  3. 安裝包會自動安裝並啟動背景 daemon。
  4. 安裝完成後,開啟 Terminal 即可使用 panda 命令。

快速開始

# 1. 查看幫助
panda help

# 2. 登入帳號
panda login

# 3. 刷新節點目錄
panda node refresh

# 4. 設定 PandaVPN 全域模式
panda mode pandavpn global

# 5. 可選開啟 Kill-switch
panda kill-switch on

# 6. 一鍵連線
panda connect

# 7. 查看診斷狀態
panda doctor

Linux

系統說明

適用於 Linux 用戶。Linux 版本提供 CLI 二進制檔,需要用戶手動安裝背景 systemd service。

安裝說明

  1. 下載對應架構的 Linux CLI 檔案。
  2. 解壓或放置到系統可執行路徑。
  3. 執行 sudo panda service install 安裝背景 systemd service。
  4. 安裝完成後,即可使用 panda 命令登入、刷新節點、連線和診斷。

快速開始

# 1. 安裝背景服務
sudo panda service install

# 2. 查看幫助
panda help

# 3. 登入帳號
panda login

# 4. 刷新節點目錄
panda node refresh

# 5. 設定 PandaVPN 全域模式
panda mode pandavpn global

# 6. 可選開啟 Kill-switch
sudo panda kill-switch on

# 7. 一鍵連線
panda connect

# 8. 查看診斷狀態
panda doctor

Windows

系統說明

適用於 Windows 用戶。安裝包會自動申請管理員權限,並註冊 PandaVPN CLI 背景 Windows Service。

安裝說明

  1. 下載對應架構的 Windows 安裝包。
  2. 按兩下執行安裝包,並按提示完成安裝。
  3. 安裝包會自動申請管理員權限,並註冊背景 Windows Service。
  4. 安裝完成後,開啟 PowerShell 或 Terminal 即可使用 panda 命令。

快速開始

# 1. 查看幫助
panda help

# 2. 登入帳號
panda login

# 3. 刷新節點目錄
panda node refresh

# 4. 設定 PandaVPN 全域模式
panda mode pandavpn global

# 5. 可選開啟 Kill-switch
panda kill-switch on

# 6. 一鍵連線
panda connect

# 7. 查看診斷狀態
panda doctor

建議先透過 panda help 熟悉命令,再完成登入、節點刷新和連線測試。Kill-switch 可在 VPN 斷開或客戶端異常退出時阻斷非 PandaVPN 流量,幫助避免 IP 洩露。

為進階網絡場景而生

智能連接與運行時支持

自動選擇推薦的連接方式,並在需要時進行 fallback。支援 PandaVPN 和 WireGuard runtime,適配不同網絡環境。

路由、DNS 與防洩露保護

支援全局路由、GFWList、direct-region、proxy-region、自定義分流規則、DNS 策略、fake-IP DNS,以及帶 LAN 訪問控制的嚴格 Kill-switch。

自動化與診斷友好

支援 JSON 輸出,並提供 doctor、status、trace、watch、log 等命令,便於腳本化、監控和故障排查。

常見問題解答

Panda CLI 和桌面客戶端有什麼區別?

CLI 更適合自動化測試、遠端排查和腳本化連線。不建議將舊 Qt 桌面客戶端與 CLI 同時運行,以避免網絡配置衝突。

為什麼安裝後需要系統級權限?

建立 TUN 介面、修改系統 DNS、應用 Kill-switch 等進階防護功能均需系統級權限,因此會在背景運行對應的平台 daemon / service。

為什麼 Kill-switch 不能和 proxy 模式一起用?

Kill-switch 旨在只允許流量經過 TUN 隧道並阻斷其餘流量。standalone proxy 模式沒有 TUN 介面,因此二者互斥,請切換至 pandavpn 或 wireguard 模式使用。