ownCloud Web 開啟後出現空白頁面時應該檢查什麼

當 ownCloud Web 開啟後顯示空白頁面時,請先嘗試在隱私權視窗中使用目前支援的瀏覽器存取相同的 URL。如果仍然失敗,請開啟瀏覽器開發者工具,檢查「控制台」和「網頁」面板;根據失敗的請求結果,判斷是清除瀏覽器網站資料、修復缺少的 Web 資源,還是檢查 Infinite Scale 和反向代理服務。在此檢查之前,請勿刪除伺服器資料或重新安裝實例。

ownCloud Web 是 Infinite Scale 自帶的 Web 介面,但管理員可以將已編譯的資源替換為自訂建置。因此,空白頁面可能是由於瀏覽器錯誤、缺少或不匹配的 JavaScript 資源,或是伺服器/代理回應阻止了介面載入造成的。以下步驟將分別說明這些情況。介面面板僅為範例,請將其與實際瀏覽器和部署輸出進行比較。

1. 確定問題是本地問題還是伺服器範圍問題

請另一位使用者開啟同一個公共 URL,然後您自己在隱私視窗中嘗試存取。例如,如果一位員工看到空白頁面,而另一位同事可以瀏覽文件,則先檢查瀏覽器相關的問題。如果所有人都看到相同的頁面,則直接檢查網路和伺服器。

  1. 請使用 ownCloud Web 支援的桌面瀏覽器。目前系統需求頁面列出了最新版本的 Chrome、Firefox 和 Edge 瀏覽器,以及在支援的桌面作業系統上執行的 Safari 16 或更高版本。
  2. 在隱私視窗中開啟實例。如果介面載入成功,請在常規設定檔中逐一停用擴充程序,然後僅清除 ownCloud 主機名稱對應的網站資料。清除網站資料可能會導致您登出登入;但不會刪除伺服器上儲存的檔案。
  3. 停用瀏覽器快取並開啟開發者工具,刷新空白頁面。如果多個支援的瀏覽器和多個使用者都出現同樣的問題,則很可能是伺服器端或部署問題。

範例瀏覽器視窗顯示範例雲端主機名稱處的完全空白頁面。

症狀範例:瀏覽器已連接至雲端主機,但頁面內容區域仍為空白。

2. 利用失敗的請求選擇修復方案

開啟開發者工具(Windows/Linux 系統通常按 F12 或 Ctrl+Shift+I,macOS 系統按 Option+Command+I)。選擇「控制台」查看 JavaScript 錯誤,然後選擇「網路」,重新整理頁面,尋找失敗的請求。狀態碼和請求類型比單純的白螢幕更有幫助。

  • JavaScript 或 CSS 請求傳回 404 錯誤:瀏覽器請求的資源在該 URL 處不存在。如果此問題僅出現在一個瀏覽器設定檔中,請清除網站的快取檔案並重新載入頁面。如果所有瀏覽器都出現相同的資源請求失敗,請檢查資源路徑、反向代理路由以及任何自訂的 Web 建置。
  • 請求傳回 502、503 或連線錯誤:代理無法從上游服務取得可用回應,或該服務無法使用。變更瀏覽器設定前,請檢查部署狀態和日誌。
  • 控制台報告請求被封鎖、憑證錯誤或混合內容警告:請將瀏覽器使用的公共主機名稱和 HTTPS 協定與 URL 和代理設定進行比較。如果您最近變更了網域名稱、TLS 終止規則或代理程式規則,請先測試該變更。
  • 頁面載入資源並傳回 200 回應,但 JavaScript 仍然失敗:請記錄第一個控制台錯誤以及 ownCloud Web/Infinite Scale 版本資訊。語法或運行時錯誤可能指向不相容的自訂版本或擴充;不要僅憑 200 回應就推斷出這一點。

瀏覽器開發者工具控制台範例,展示了 JavaScript 資源的 404 回應。

診斷範例說明:JavaScript 資源的 404 個錯誤提示需要檢查資源 URL 和執行路徑,但並不能證明有特定原因。

3. 檢查網站資產和服務運作狀況

如果失敗的請求涉及資產,請先確定您的實例使用的是已捆綁的 ownCloud Web 檔案還是自訂編譯的檔案。 ownCloud 8.2 管理員指南指出,WEB_ASSET_PATH指向自訂編譯的 Web 用戶端資產。如果您設定了此變量,請檢查該路徑是否存在於正在執行的部署中,是否包含完整的建置版本,以及是否對提供 Web 介面服務的進程具有可讀性。如果您未使用自訂資產,請勿新增此變數作為臨時解決方案。

對於 Docker Compose 部署,請在包含 Compose 檔案的目錄中執行以下命令:

docker compose ps
docker compose logs --tail=100 ocis

第一條指令顯示服務是否正在執行;第二個指令列印名為 `<service_name>` 的服務的最新日誌ocis。如果您的 Compose 檔案使用了不同的服務名稱或前端單獨運行,請替換為實際的服務名稱,並同時檢查代理/前端日誌。對於手動安裝或編排的部署,請改用該平台的服務和日誌命令。在頁面載入失敗時,尋找啟動失敗、資源路徑錯誤或上游連線錯誤。

範例終端顯示了 `docker compose ps` 和 `docker compose logs` 指令,但沒有範例輸出。

圖示了兩個 Compose 檢查;實際服務名稱和日誌訊息因部署而異。

4. 驗證公用 URL 和代理路由

如果請求指向舊的主機名稱、錯誤的協定或代理伺服器無法服務的路徑,請檢查公用 URL 設定和代理規則。 ownCloud 文件OCIS_URL中定義了 Infinite Scale 的存取方式。在使用反向代理的部署中,請確保瀏覽器導向的 HTTPS 位址、DNS 名稱和路由規則與設定的公共 URL 一致。如果代理程式或網域最近發生更改,請將目前配置與上次正常工作的版本進行比較,並僅修正不符的值。

WEB_ASSET_PATH僅當配置了自訂資源時才進行檢查。OCIS_URL當瀏覽器重定向到意外主機或請求來自錯誤來源的資源時,檢查代理/TLS 設定。這些設定因部署環境而異,因此請勿將通用範例值直接貼上到生產環境中。官方的ownCloud Web 自訂資源指南、代理服務文件和TLS 指南詳細介紹了這些配置方面。

範例配置編輯器突出顯示了 WEB_ASSET_PATH 和 OCIS_URL,以便進行部署檢查

圖示需要檢查的配置值;正確的值取決於公用 URL 以及是否使用自訂資源。

驗證修復是否成功

在普通瀏覽器視窗中重新載入網站,確認介面渲染正常,控制台沒有阻塞性 JavaScript 錯誤,並且所需的 JavaScript/CSS 請求不再傳回 404 或 5xx 回應。請另一位使用者測試相同的公共位址。如果頁面仍然空白但資源載入成功,請儲存第一個控制台錯誤、失敗請求詳情、Infinite Scale 版本以及相關的服務日誌,以便管理員或 ownCloud 支援團隊使用。在分享瀏覽器擷取資訊之前,請刪除 cookie、授權標頭和令牌。

留下評論

使用正確的後端解決 ownCloud 檔案鎖定逾時問題

區分資料庫鎖定和過期的 WebDAV 鎖定,然後選擇並設定正確的 ownCloud 10 修復程式。

ownCloud Web 開啟後出現空白頁面時應該檢查什麼

ownCloud Web 開啟後出現空白頁面時應該檢查什麼

透過有針對性的檢查,追蹤 ownCloud Web 空白畫面的原因,包括瀏覽器快取、缺少 Web 資源、服務錯誤或反向代理 URL 設定。

在正確的運行時清除 ownCloud PHP 記憶體警告

設定 ownCloud 的 Web PHP 記憶體限制,重新啟動對應的服務,並驗證活動值,不要將其與 CLI 設定或上傳限制混淆。

排查 ownCloud 10 MySQL 連線故障

找出 MySQL、PHP、套接字設定或資料庫權限是否阻止了 ownCloud 10 的運行,然後驗證安全修復方案。

為 ownCloud 公共連結設定嚴格的過期時間

為 ownCloud 公共連結設定嚴格的過期時間

在 ownCloud Classic 中強制設定公共連結過期時間,設定最長有效期,並檢查可能需要單獨清理的現有共享。

使用 Keycloak 為 ownCloud Infinite Scale 新增 TOTP 雙重登錄

使用 Keycloak 為 ownCloud Infinite Scale 新增 TOTP 雙重登錄

透過 Keycloak 啟用 TOTP,安全地註冊用戶,並了解 Infinite Scale 的路由級 MFA 設定何時適用。

透過將客戶端與伺服器匹配來恢復 ownCloud 同步

檢查問題是否為 OC10 和 7.x 的相容性問題,或 CSync 日誌損壞,然後套用正確的修復方法,不要刪除已同步的檔案。

使用 Let's Encrypt 和 Nginx 將 ownCloud 部署到 HTTPS。

使用 Let's Encrypt 和 Nginx 將 ownCloud 部署到 HTTPS。

選擇 HTTP-01 或 DNS-01,設定 ownCloud 反向代理,並驗證 Certbot 是否自動續訂 HTTPS 憑證。

將 ownCloud Infinite Scale 連接到 LDAP 以實現使用者登入

在部署之前,配置 oCIS LDAP 登錄,調整使用者和群組查找,並驗證 TLS 和架構設定。

將 S3 儲存桶連接到 ownCloud 10 作為外部存儲

將 S3 儲存桶連接到 ownCloud 10 作為外部存儲

將 Amazon S3 儲存桶新增至 ownCloud 10,準備相容的憑證和端點,並檢查存取權限,避免將掛載點與主儲存點混淆。