Skip to main content

​
登入時瀏覽器未開啟

執行 panguard login 時，CLI 會嘗試開啟您的預設瀏覽器進行身份驗證。如果瀏覽器未開啟：
跳過自動瀏覽器啟動並手動登入：
panguard login --no-browser
CLI 會列印一個 URL。將其複製並貼上到您的瀏覽器中，然後在 CLI 提示中輸入回傳的 token。
在沒有桌面環境的伺服器上，請始終使用 --no-browser：
panguard login --no-browser
或者，在有瀏覽器的機器上登入並複製憑證檔案：
# 在有瀏覽器的機器上：
panguard login
cat ~/.panguard/credentials.json

# 在伺服器上：
mkdir -p ~/.panguard
# 將憑證 JSON 貼上到：
nano ~/.panguard/credentials.json
chmod 600 ~/.panguard/credentials.json
WSL 可能無法啟動 Windows 瀏覽器。設定瀏覽器路徑：
export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
panguard login
或如上所述使用 --no-browser。

​
登入逾時

如果在您完成身份驗證前登入流程逾時： 
Error: Login timed out. Please try again.
解決方案：
  1. 重試登入 — 預設逾時為 120 秒： 
    panguard login
  2. 檢查您的網路連線 — CLI 必須連線到 auth.panguard.ai
  3. 如果在企業代理後面，設定代理環境變數： 
    export HTTPS_PROXY=http://proxy.example.com:8080
panguard login

​
Token 已過期

Error: Authentication token has expired. Please log in again.
JWT token 在 24 小時後到期。重新驗證： 
panguard login
對於自動化腳本和 CI/CD 管線，請使用 API token 而非 JWT token。API token 在明確撤銷前不會過期。從您的帳號儀表板產生一個，或使用 panguard token create。

​
方案層級不足

Error: This feature requires the Pro tier or higher. Current tier: community
某些功能受訂閱層級限制：
功能最低層級
基本掃描Community
第一層 GuardCommunity
完整 Guard（3 層）Solo
Chat 通知Solo
Trap（蜜罐）Pro
報告產生Pro
自訂 AI 模型Business
API 存取Business
解決方案：
  1. 升級您的訂閱： 
    panguard upgrade
  2. 檢查您目前的層級： 
    panguard whoami
  3. 如果您最近升級了，重新登入以更新您的工作階段： 
    panguard logout
panguard login

​
憑證檔案權限

~/.panguard/credentials.json 中的憑證檔案儲存您的身份驗證 token。它應該只有您的使用者可以讀取。
如果憑證檔案的權限過於寬鬆（其他使用者可讀取），Panguard 將拒絕使用它並顯示安全警告。
修復權限： 
chmod 600 ~/.panguard/credentials.json
驗證： 
ls -la ~/.panguard/credentials.json
# 應顯示：-rw------- 1 youruser yourgroup ... credentials.json

​
無效或損壞的憑證

如果您看到 Error: Invalid token format 或 Error: Failed to parse credentials 等錯誤： 
# 移除損壞的憑證檔案
rm ~/.panguard/credentials.json

# 重新登入
panguard login

​
Google OAuth 問題

如果 Google 登入失敗：
在您的瀏覽器設定中允許來自 auth.panguard.ai 的彈出視窗。
這是伺服器端的設定問題。如果您在 auth.panguard.ai 上遇到此問題，請聯繫支援。
確保 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET 已正確設定，且 Google Cloud Console 中的重新導向 URI 與您的 auth server URL 匹配。

​
雙因素驗證 (2FA) 問題

使用您的備用代碼之一登入：
panguard login
# 當提示輸入 TOTP 代碼時，改為輸入備用代碼
每個備用代碼為一次性使用。登入後，停用 2FA 並重新啟用以取得新的備用代碼。
  • 確認您的裝置時鐘已同步（TOTP 是基於時間的）
  • 確保您使用的是正確帳號的代碼
  • 代碼每 30 秒輪換 — 嘗試等待下一個代碼
  • 如果問題持續，請使用備用代碼