修正 ONLYOFFICE 行動應用連線到自架伺服器的逾時問題

您在 ONLYOFFICE Documents 中輸入自託管伺服器位址，點擊「下一步」，應用程式會一直載入直到顯示連線逾時。同一個帳戶在桌面瀏覽器中可能仍然可以正常使用，這使得問題看起來像是應用程式本身的 bug。實際上，超時通常意味著手機無法存取您輸入的確切服務 URL，或者 URL 指向了錯誤的 ONLYOFFICE 元件，又或者網路層阻止了請求。

首先要先明確您的伺服器實際提供的功能。文件行動應用程式可以連接到 ONLYOFFICE 入口網站（例如 DocSpace 或 Workspace），也可以連接到支援的第三方雲端平台（例如 Nextcloud、ownCloud 或其他 WebDAV 服務）。 ONLYOFFICE Docs（也稱為文件伺服器）是一種與儲存平台配合使用的編輯服務；它與使用者入口網站或 WebDAV 檔案帳戶並非完全相同。 ONLYOFFICE 的Android 文件概述和iOS 文件概述介紹了支援的帳戶類型。

1. 確認行動應用程式應使用哪個位址

請勿將文件伺服器 URL 貼到每個連線欄位中。如果您的文件儲存在自託管的 DocSpace 或 Workspace 入口網站中，請使用該入口網站的公共位址並使用入口網站帳號登入。如果您的檔案位於 Nextcloud 或 ownCloud 中，請在應用程式中選擇該服務，並輸入儲存伺服器的 WebDAV 位址及其帳戶憑證。對於通用 WebDAV 服務，請在可用時選擇應用程式中的「其他 WebDAV」選項。

對於 Nextcloud 和 ownCloud，URL 可以包含網域以外的路徑。請複製雲端帳戶設定中顯示的 WebDAV 位址，而不是根據舊教學猜測路徑。 ONLYOFFICE 的行動連線指南提供了一個 Nextcloud 範例，並指導使用者貼上包含協定的完整 URL。該應用程式的 Android 說明也同樣要求提供 WebDAV 儲存的連接 URL、登入名稱和密碼。有關目前的連線流程，請參閱官方的Nextcloud 整合指南或ownCloud 整合指南。

• 請使用入口網站 URL 作為入口網站帳戶的 URL，而不是編輯器服務位址。
• 對於 Nextcloud、ownCloud 或其他 WebDAV 帳戶，請使用完整的 WebDAV URL。
• 包含https://或http://完全按照伺服器上的配置執行。
• 不要添加未經驗證的後綴，例如/webdav或/remote.php/dav；複製伺服器顯示的 WebDAV URL。

2. 在應用外部測試同一位址

在手機上，使用行動瀏覽器開啟該位址。如果是入口網站 URL，預期結果是登入頁面或重新導向到該入口網站。如果是 WebDAV 端點，瀏覽器可能會顯示登入提示、授權回應或錯誤訊息，而不是正常的網站；重要的是瀏覽器能夠及時回應，並且不會報告找不到或無法存取該主機。

分別在 Wi-Fi 和行動數據網路下重複測試一次。如果僅在一個網路下有效，則應用程式本身可能並非首要的故障排查點。請檢查故障的網路上的路由器、VPN、DNS 過濾、行動電信商限製或防火牆策略。如果兩個網路下都無效，請確認主機名稱可以公開解析，且反向代理或防火牆已將服務的 HTTPS 流量轉送至預期的後端伺服器。

如果伺服器只能透過私人位址訪問，那麼192.168.x.x當手機離開本地網路時，通常無法存取該伺服器，除非裝置透過 VPN 或其他安全的遠端存取方式連接。切勿為了測試應用程式而將內部服務暴露在公共互聯網上；請使用組織認可的遠端存取方式。

3. 檢查 URL、重新導向和反向代理

逐字比較應用程式中的位址和瀏覽器中有效的位址。尋找缺少的子目錄、過時的主機名稱、錯誤的連接埠、從其他服務複製的尾部路徑，或重定向到手機無法解析的內部主機名稱。如果您的伺服器位於反向代理之後，則公共 URL 應路由到正確的應用程序，並且轉送的協定和主機資訊應與使用者存取的 HTTPS 位址一致。

當入口網站或 WebDAV 服務發佈在子路徑下時，請驗證代理程式是否保留了所需的路徑並將請求轉送到該應用程式。顯示反向代理歡迎頁面的根 URL 僅證明 Web 伺服器已回應，但並不能證明應用程式的入口網站或 WebDAV 端點已正確路由。如果可能，請測試複製到行動應用程式中的完整 URL，而不僅僅是網域主頁。

如果應用程式報告逾時，但瀏覽器很快就能存取登入頁面，請在嘗試重新連線時檢查代理存取和錯誤經驗。 502 或 504 回應表示上游或代理逾時；404 通常表示路徑或路由不符；401 或 403 表示端點已回應，但驗證或存取被拒絕。這些狀態碼有助於縮小調查範圍，但其具體含義可能取決於 ONLYOFFICE 前端的代理和雲端軟體。

4. 驗證 HTTPS 和憑證鏈

行動作業系統會驗證伺服器憑證。過期的憑證、為其他主機名稱頒發的憑證、缺少中間憑證或由裝置不信任的機構簽發的憑證都可能導致連線不安全。請在手機上開啟正確的 HTTPS 位址，並檢查瀏覽器是否出現憑證警告。同時，請檢查設備的日期和時間是否正確，因為錯誤的時鐘設定可能會導致有效的憑證顯示為過期或尚未生效。

使用為公共主機名稱頒發的證書，並在面向公眾的代理或伺服器上安裝完整的證書鏈。 ONLYOFFICE 的文檔介紹如何為文件伺服器設定 HTTPS；憑證必須與用戶端使用的 URL 相符。切勿將停用證書驗證作為永久解決方案。 ONLYOFFICE 在其整合文件中指出，停用憑證驗證是不安全的，即使連線繞過了憑證檢查，仍然需要正確的憑證設定。

5. 將應用程式登入問題與編輯器連線問題區分開來

使用者可能成功登入入口網站，但仍無法開啟文件。這是因為登入和開啟文件是兩個獨立的連線。應用程式首先需要連接到儲存伺服器或入口網站。開啟文件時，整合過程可能還會涉及到文件伺服器。因此，行動端登入成功並不能證明編輯器服務可以連接到儲存伺服器，也不能證明儲存伺服器可以連接到編輯器。

如果逾時僅在開啟檔案後出現，請管理員從伺服器端測試整合。 ONLYOFFICE 的 Nextcloud 和 ownCloud 指南解釋說，位於受限網路後面的安裝可能需要配置內部位址，以便儲存伺服器向 ONLYOFFICE Docs 發送請求，以及 ONLYOFFICE Docs 向儲存服務發送請求。公共位址可以在手機瀏覽器中正常運作，但伺服器之間的通訊仍然會失敗。

對於管理員而言，請檢查兩個服務是否能夠解析彼此配置的主機名，防火牆規則是否允許所需的流量，以及連接器在啟用 JWT 時是否使用與文件伺服器相同的 JWT 金鑰。切勿隨意更改金鑰或停用 JWT；請先參考雲端平台的官方整合指南，比較配置值。

6. 重新檢查憑證和應用程式狀態

確認連線性和憑證有效後，請在相同入口網站或儲存帳戶的 Web 介面中驗證使用者名稱和密碼。 WebDAV 端點可能需要帳戶的實際憑證或應用程式密碼，具體取決於伺服器的驗證原則。如果啟用了多因素身份驗證，請按照該伺服器的說明進行操作；不要想當然地認為所有 WebDAV 實作都接受普通的 Web 登入密碼。

請從官方應用程式商店更新 ONLYOFFICE Documents，關閉並重新開啟應用，然後再次嘗試新增帳戶。如果先前儲存的帳戶地址有誤，請刪除已儲存的連接，並使用已驗證的 URL 建立新的連接。此操作不會刪除伺服器上的檔案：在行動應用程式中斷開雲端帳戶連線只會刪除本機連線項目，而不會刪除遠端儲存內容。在重新安裝應用程式或清除其資料之前，請確保已儲存或備份所有未同步的本機文件。

7. 只有在排除了更簡單的故障原因後，才檢查伺服器。

如果多個裝置和網路存取同一個公用 URL 均逾時，則故障很可能出在伺服器或其網路路徑上。請確認入口網站、儲存服務、反向代理程式和文件伺服器是否正在運作。對於 Docker 安裝，管理員可以使用以下命令檢查容器狀態和最近的日誌：

docker compose ps
docker compose logs --tail=100 <service-name>

請使用部署 Compose 檔案中實際的服務名稱；不同安裝中的服務名稱可能有所不同。檢查是否有重複重新啟動、DNS 故障、上游連線錯誤、資源耗盡或憑證續約問題。在捕獲日誌之前，請避免重新啟動所有元件，因為重新啟動可能會清除故障的有用資訊。

針對文件伺服器，官方幫助中心提供了一個/info/頁面，管理員可以使用該頁面檢查服務是否已啟用且可存取。此頁面是針對文件伺服器的診斷工具，不能取代在行動應用中輸入的入口網站或 WebDAV 位址的測試。請參閱ONLYOFFICE 提供的文件伺服器資訊頁面說明。

透過手機驗證修復是否成功

按以下順序進行檢查：在手機瀏覽器中開啟正確的入口網站或 WebDAV URL；分別使用 Wi-Fi 和行動資料重複上述步驟；在 ONLYOFFICE Documents 中新增具有匹配服務類型的帳戶；登入；瀏覽資料夾；並開啟一個小型測試文件。如果瀏覽功能正常但編輯功能失效，請檢查 ONLYOFFICE Docs 伺服器端的整合問題。如果瀏覽器和應用程式都逾時，請繼續檢查 DNS、防火牆、代理程式和伺服器，而不是重複更改密碼。

成功配置是指在您計劃工作的網路上能夠穩定登入並正常顯示資料夾清單。在將此配置用於重要文件之前，請先測試開啟和儲存非關鍵文件。如果問題仍然存在，請向管理員提供確切的 URL 類型（入口網站、WebDAV 或文件伺服器）、手機作業系統、使用的網路、時間戳記以及任何 HTTP 狀態或代理程式記錄條目。請勿在支援請求中傳送密碼、存取權杖或文件內容。