PandaVPN CLI命令列用戶端

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

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

panda@terminal
panda>mode pandavpn globalpanda>connect[Success] Connected to <NODE_ID>.panda>doctor[OK] Runtime healthy.

選擇適合你的 CLI 版本

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

macOS

版本:2.1.1更新時間:

系統說明

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

更新內容

  • 1. 改善 Automatic、PandaVPN 與 WireGuard 模式切換,讓連線更順暢。
  • 2. 最佳化流量路由與區域網路設定,減少不必要的重新連線。
  • 3. 新增 VPN 出口 IP 資訊,適用於支援的 IPv4 與 IPv6 連線。
  • 4. 改善連線復原能力,提升整體網路可靠性。
檢視版本說明 →

安裝說明

  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

# 8. 修復網路設定異常
panda repair

Linux

版本:2.1.1更新時間:

系統說明

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

下載

更新內容

  • 1. 改善 Automatic、PandaVPN 與 WireGuard 模式切換,讓連線更順暢。
  • 2. 最佳化流量路由與區域網路設定,減少不必要的重新連線。
  • 3. 新增 VPN 出口 IP 資訊,適用於支援的 IPv4 與 IPv6 連線。
  • 4. 改善連線復原能力,提升整體網路可靠性。
檢視版本說明 →

安裝說明

  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

# 9. 修復網路設定異常
panda repair

Windows

版本:2.1.1更新時間:

系統說明

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

更新內容

  • 1. 改善 Automatic、PandaVPN 與 WireGuard 模式切換,讓連線更順暢。
  • 2. 最佳化流量路由與區域網路設定,減少不必要的重新連線。
  • 3. 新增 VPN 出口 IP 資訊,適用於支援的 IPv4 與 IPv6 連線。
  • 4. 改善連線復原能力,提升整體網路可靠性。
檢視版本說明 →

安裝說明

  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

# 8. 修復網路設定異常
panda repair

建議先執行 panda help 查看支援的命令。互動模式下可不帶參數執行 panda,並按 Tab 補全命令。若 routes、DNS、system proxy 或 Kill Switch 狀態被意外修改或遺失,請執行 panda repair 恢復 Panda 管理的網路配置。

為進階網路場景而生

智慧連線與執行階段支援

自動選擇推薦的連線方式,並在需要時進行 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 和桌面用戶端有什麼差別?

PandaVPN CLI 更適合自動化測試、遠端疑難排解,以及透過指令碼控制連線。

Panda Desktop 和 PandaVPN CLI 是同一個 PandaVPN daemon 的兩個控制介面,共用相同的連線狀態,因此可以搭配使用。

請勿同時執行 PandaVPN CLI 與 Panda-Qt、舊版 Linux AppImage 等舊版桌面用戶端,否則可能造成網路設定衝突。

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

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

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

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