Dropstone 疑難排解指南 - 診斷與修復問題

本指南提供系統化的方法來診斷與解決 Dropstone.io 的常見問題。請依照下列步驟收集必要資訊，再聯絡支援團隊。

疑難排解的必要資訊

以下資訊對於 Dropstone 內大多數疑難排解情境至關重要：

1. 視覺化文件

問題截圖（請遮蔽任何敏感資訊）

• 擷取顯示錯誤的整個應用程式視窗
• 包含任何錯誤訊息或對話方塊
• 如有時間戳記，請確保其可見

2. 重現步驟

提供詳細的重現步驟：

1. 採取的操作（例如：「點擊『部署』按鈕」）
2. 預期行為
3. 實際行為
4. 發生頻率（總是、有時、僅一次）

3. 系統資訊

從以下位置取得系統資訊：

Dropstone → 說明 → 關於

這包含：

• Dropstone 版本
• 作業系統
• 架構（x64、arm64）
• Electron 版本
• Node.js 版本

4. 網路設定

您是否使用以下任何項目？

• VPN（虛擬私人網路）
• Zscaler 或其他安全代理伺服器
• 公司防火牆
• 自訂 DNS 設定

5. 開發人員工具主控台

存取開發人員工具以檢查 JavaScript 錯誤：

Dropstone → 說明 → 切換開發人員工具

前往主控台標籤頁並檢查：

• 紅色錯誤訊息
• 與您的問題相關的警告訊息
• 網路請求失敗

複製任何相關的錯誤堆疊追蹤。

6. 應用程式日誌

Windows

日誌位於：

C:\Users\<您的使用者名稱>\AppData\Roaming\Dropstone\logs

透過命令面板存取：

1. 按下 Ctrl + Shift + P
2. 輸入並選取：開發人員：開啟日誌資料夾

macOS

日誌位於：

~/Library/Application Support/Dropstone/logs

透過命令面板存取：

1. 按下 Cmd + Shift + P
2. 輸入並選取：開發人員：開啟日誌資料夾

Linux

日誌位於：

~/.config/Dropstone/logs

在應用程式中檢視日誌

前往： Dropstone → 終端機 → 輸出

從下拉式選單中選取：

• 視窗 - 一般應用程式日誌
• Dropstone Core - 核心功能日誌
• Dropstone Deployment - 部署相關日誌
• Dropstone Storage - 儲存與資料庫日誌
• Dropstone API - API 請求/回應日誌

常見問題與解決方案

連線問題

問題：無法連線至 Dropstone 服務

症狀：

• 「連線逾時」錯誤
• 「無法連線至伺服器」訊息
• 無限載入狀態

解決方案：

1. 檢查網際網路連線

   # Windows
   ping dropstone.io
   
   # macOS/Linux
   ping dropstone.io
   

2. 驗證防火牆設定

   • 確保 Dropstone 已獲准通過您的防火牆
   • 檢查公司網路政策
   • 將 *.dropstone.io 網域加入白名單

3. 代理伺服器設定

   設定代理伺服器：

   Dropstone → 設定 → 網路 → 代理伺服器設定

   或設定環境變數：

   export HTTP_PROXY=http://proxy.example.com:8080
   export HTTPS_PROXY=http://proxy.example.com:8080
   

4. DNS 解析

   • 清除 DNS 快取
   • 嘗試替代 DNS（8.8.8.8、1.1.1.1）

驗證問題

問題：登入失敗或權杖過期

症狀：

• 「驗證失敗」錯誤
• 重複的登入提示
• 401 未授權回應

解決方案：

1. 清除驗證快取

   Dropstone → 命令面板 → 清除驗證快取

2. 重新驗證

   1. 從 Dropstone 登出
   2. 清除 dropstone.io 的瀏覽器 Cookie
   3. 重新登入
   

3. 檢查權杖有效性

   前往：設定 → 帳戶 → 工作階段管理

   檢視作用中的工作階段並撤銷可疑的工作階段。

4. SSO 問題

   如果使用單一登入：

   • 驗證 SSO 提供者是否可存取
   • 檢查 SAML 宣告是否過期
   • 聯絡您的身分提供者管理員

效能問題

問題：應用程式回應緩慢或 CPU 使用率過高

症狀：

• 輸入或點擊時延遲
• CPU/記憶體使用率過高
• UI 凍結或無回應

解決方案：

1. 檢查資源使用情況

   Dropstone → 說明 → 處理程序管理員

   找出消耗過多資源的處理程序。

2. 停用擴充功能

   暫時停用擴充功能以隔離問題：

   設定 → 擴充功能 → 全部停用 → 重新啟動

3. 清除快取

   Dropstone → 設定 → 進階 → 清除快取
   

4. 縮減專案規模

   • 從索引中排除大型檔案
   • 新增至 .dpsignore 檔案：
   node_modules/
   dist/
   build/
   *.log
   .git/
   

5. 硬體加速

   切換 GPU 加速：

   設定 → 系統 → 使用硬體加速

部署問題

問題：部署失敗

症狀：

• 建置失敗
• 部署逾時
• 「無法推送至遠端」錯誤

解決方案：

1. 檢查建置日誌

   檢視詳細的建置輸出：

   部署 → 歷史記錄 → 選取失敗的部署 → 檢視日誌

2. 驗證環境變數

   設定 → 部署 → 環境變數
   

   確保所有必要的變數都已設定。

3. 檢查部署設定

   驗證您的 dropstone.config.js：

   module.exports = {
     build: {
       command: 'npm run build',
       output: 'dist'
     },
     deployment: {
       region: 'us-east-1',
       runtime: 'nodejs18.x'
     }
   }
   

4. 儲存配額

   驗證您未超過儲存限制：

   儀表板 → 使用量 → 儲存

5. 建置逾時

   在設定中增加逾時時間：

   deployment: {
     timeout: 900 // 15 分鐘（以秒為單位）
   }
   

儲存與資料庫問題

問題：資料同步或儲存錯誤

症狀：

• 「儲存配額已超過」
• 同步衝突
• 資料未持續保存

解決方案：

1. 檢查儲存使用量

   儀表板 → 儲存 → 使用量統計

2. 解決同步衝突

   1. 前往衝突的檔案
   2. Dropstone 會顯示衝突標記
   3. 手動解決或選取要保留的版本
   

3. 資料庫連線

   測試資料庫連線：

   // 在 Dropstone 主控台中
   await dropstone.db.test()
   

4. 清除本機快取

   設定 → 儲存 → 清除本機快取
   

   警告：這會移除本機快取的資料。

5. 備份與還原

   在疑難排解前建立備份：

   Dropstone → 工具 → 備份 → 建立備份
   

進階疑難排解

安全模式

以安全模式啟動 Dropstone 以停用所有擴充功能：

Windows/Linux：

dropstone --disable-extensions

macOS：

/Applications/Dropstone.app/Contents/MacOS/Dropstone --disable-extensions

重設為預設設定

若要將所有設定重設為預設值：

1. 備份目前設定

   設定 → 進階 → 匯出設定
   

2. 重設

   設定 → 進階 → 重設所有設定
   

詳細日誌記錄

啟用詳細記錄以進行除錯：

1. 開啟命令面板（Ctrl/Cmd + Shift + P）
2. 選取：開發人員：設定日誌層級
3. 選擇：追蹤

日誌現在將包含詳細的診斷資訊。

網路診斷

執行內建的網路診斷：

Dropstone → 說明 → 執行網路診斷

這會檢查：

• DNS 解析
• API 端點可存取性
• WebSocket 連線
• CDN 可用性

取得協助

聯絡支援前

請確保您已：

• 查閱本疑難排解指南
• 檢視狀態頁面
• 收集所有必要的疑難排解資訊

聯絡支援

電子郵件： support@blankline.org

請在訊息中包含：

1. 問題摘要
2. 重現步驟
3. 系統資訊
4. 相關日誌（最後 100 行）
5. 截圖
6. 您已嘗試過的方法

其他資源

• 文件： docs.dropstone.io
• 狀態頁面： status.dropstone.io
• 銷售／企業： dropstone.io/contact

實用命令

命令面板快速參考

CLI 診斷

# 檢查 Dropstone CLI 版本
dropstone --version

# 驗證安裝
dropstone doctor

# 測試 API 連線
dropstone ping

# 檢視目前設定
dropstone config list

# 清除本機快取
dropstone cache clear

# 匯出日誌
dropstone logs export --output ./dropstone-logs.txt

附錄

日誌檔案位置

設定檔案位置

環境變數

最後更新：2025 年 9 月 29 日 版本：1.0.0