技術支援
購買前有疑問,或遇到了問題?請寄信給我們,並附上下列資訊。
聯絡我們
寄信至 support@heapdeck.app。建議附上:
- iOS 與 HeapDeck 的版本(App 內的「設定 › 關於」);
- PostgreSQL 版本及執行環境:自行架設、RDS、Cloud SQL、Azure、Supabase;
- 完整的錯誤訊息原文,或隱藏主機名稱的截圖。
切勿傳送密碼、私密金鑰或連線字串。
常見問題
畫面顯示「僅部分可見」或 <insufficient privilege>
此角色無法讀取其他工作階段的詳細資料。請以 superuser 或服務供應商的管理員角色執行一次:
GRANT pg_monitor TO your_role;
pg_monitor 只授予統計檢視表的讀取權限,沒有其他權限。
「慢查詢」畫面顯示「pg_stat_statements 未安裝」
此擴充功能必須在伺服器啟動時載入,再於資料庫中建立:
- 自行架設:將
pg_stat_statements加入shared_preload_libraries,重新啟動 PostgreSQL,然後執行CREATE EXTENSION pg_stat_statements;。 - Amazon RDS 與 Cloud SQL:檢查參數群組或資料庫旗標,然後執行
CREATE EXTENSION pg_stat_statements;。 - Supabase:已經啟用。
「慢查詢」畫面會說明屬於哪種情況,並提供可拷貝的指令。
SSH 通道失敗,顯示「SSH 驗證失敗」
請確認該金鑰的公開金鑰部分已加入該主機上對應使用者的 ~/.ssh/authorized_keys。HeapDeck 可使用密碼、Secure Enclave 金鑰,或 OpenSSH、PEM、PKCS#8、PuTTY PPK v2/v3 格式的 Ed25519、ECDSA 或 RSA 金鑰(有無金鑰密碼皆可)登入。將 HeapDeck 顯示的金鑰指紋與電腦上輸出的指紋比對:
ssh-keygen -lf heapdeck_ed25519
如果匯入金鑰時顯示「無法使用此金鑰」,卡片會說明原因(例如 DSA 金鑰或 PuTTY v1 檔案),並提供轉換用的指令。在包含跳板主機的路由上,「測試連線」會標示拒絕連線的主機。
「此伺服器的憑證已變更」
HeapDeck 在首次連線時釘選了憑證指紋,而伺服器現在出示的是另一張憑證。憑證更新後會出現這種情況,連線遭到攔截時看起來也是如此。
將新指紋與伺服器上的指紋比對,例如使用 openssl x509 -in server.crt -noout -fingerprint -sha256。兩者相符才信任;否則請點一下「取消——不連線」。
「Local Network 存取已關閉」
伺服器、堡壘主機或 Ollama 位於區域網路內時,iOS 會要求「區域網路」(Local Network)權限。請到「設定 › HeapDeck › 區域網路」中開啟,然後點一下「重試」。網際網路上的伺服器不需要此權限。
每次開啟都顯示「HeapDeck 已鎖定」
App 鎖定預設為開啟。可使用 Face ID、Touch ID 或裝置密碼解鎖。在「設定 › 安全性」中,可以關閉「需要 Face ID」,或在「自動鎖定」中選擇何時再次鎖定:立即、1 分鐘後、5 分鐘後或從不。
如何在新的 iPhone 上回復 Pro?
開啟任一連線或示範,在「健康狀態」畫面點一下齒輪圖示,然後前往「設定 › HeapDeck Pro › 回復購買項目」。Pro 畫面本身也有「回復購買項目」。Pro 跟隨 Apple ID;不適用家人共享。
如何申請退款?
購買透過 Apple 進行,退款也是:請到 reportaproblem.apple.com 申請。Apple 退還 Pro 款項後,App 會回到 Free。