故障排除指南
啟動與安裝
| 現象 | 可能原因 | 處理 |
|---|---|---|
| 客戶端無法啟動 | 核心元件未完成初始化 | 等待首次初始化，或重新下載安裝 |
| macOS 無法開啟 | 隔離屬性阻擋 | xattr -d com.apple.quarantine /Applications/VirtualBrowser.app |
| 更新失敗 | 網路或權限不足 | 以系統權限重新執行，檢查代理設定 |
環境與指紋
| 現象 | 可能原因 | 處理 |
|---|---|---|
| 兩次檢測結果不同 | 存在隨機化設定 | 改用穩定／一致模式 |
| UA 版本與實際核心不符 | 手動修改過 UA | 恢復預設或同步為實際版本 |
| 時區與代理地區不符 | 代理地區設定後未同步時區 | 依出口城市重新設定時區與語言 |
| WebRTC 洩漏本機 IP | 未限制 WebRTC | 在指紋設定中將 WebRTC 限制為代理 IP |
代理
| 現象 | 可能原因 | 處理 |
|---|---|---|
| 顯示本機 IP | 代理未生效或 DNS 洩漏 | 檢查代理設定並啟用 DNS 接管 |
| 代理連線失敗 | 協定不符或憑證過期 | 核對協定（HTTP／HTTPS／SOCKS5）與帳密 |
| 時不時斷線 | 代理不穩定 | 改用固定 IP 的住宅或 ISP 代理 |
外掛與自動化
| 現象 | 可能原因 | 處理 |
|---|---|---|
| 外掛在環境中不生效 | 外掛依環境隔離 | 在目標環境內單獨安裝 |
| API 回傳錯誤碼 | 參數或端點不符 | 查閱 API 錯誤碼對照 |
| Playwright 無法連線 | CDP 埠位未開啟 | 確認本地 API 服務與 CDP 連線埠位 |
