當 ownCloud 上傳進度停滯在 99% 時,請檢查這些限制。

當 ownCloud 文件頁面顯示進度為 99% 時,請先檢查目標資料夾中是否已存在完整文件,然後再重試。如果檔案缺失或不完整,請管理員檢查使用者配額、PHP 暫存目錄和 ownCloud 程式碼區塊目錄的可用空間,以及 PHP 和 Web 伺服器的請求限制。僅憑 99% 的進度指示不足以確定是哪個環節出了問題。

本實用參考指南涵蓋透過 ownCloud Server (Classic) 10.16 Web 介面進行的上傳操作。 Infinite Scale 和桌面同步上傳使用不同的伺服器路徑和日誌。範例遵循官方 10.16 文件;請根據您自己的部署情況使用相應的設定和文件路徑。

快速分診

你所看到的先檢查
刷新資料夾後,文件似乎已完整。請將其大小與本機檔案進行比較,並在重新上傳前開啟該檔案。
只有大檔案才會卡住或失敗。將檔案大小與 PHP、Web 伺服器和代理程式的限制進行比較;檢查暫存空間。
某個使用者或某個資料夾的上傳失敗檢查該使用者的配額、資料夾權限,以及目標位置是否為外部儲存。
許多用戶上傳失敗檢查共享磁碟空間、PHP/Web伺服器日誌以及任何代理或主機限制。
ownCloud 風格的文件視圖範例顯示了 LargeArchive.zip,上傳進度條顯示為 99%。
文件範例視圖:上傳行幾乎已滿,但僅憑百分比無法顯示伺服器是否已提交文件。

1. 重試前請確認上傳狀態

在第二個標籤頁中開啟目標資料夾,或在上傳停止後重新整理頁面。如果檔案存在,請將其位元組大小與本地原始檔案進行比較並開啟它。如果檔案已完成但進度條仍顯示不全,則表示上傳未完成或瀏覽器顯示有問題;這種情況無需上傳第二個副本。

如果文件不存在或文件較小,請嘗試在同一資料夾中上傳較小的測試文件,然後嘗試從其他瀏覽器或網路(如有)上傳原始文件。記錄檔案大小、使用者、目標位置、大致時間、測試是否失敗。這些對比有助於區分單一檔案或客戶端問題與伺服器端問題。避免在伺服器仍在處理大型上傳任務時重複取消和重新開始上傳。

2. 檢查配額、臨時空間和權限

請 ownCloud 管理員檢查受影響使用者的配額以及目標資料夾的寫入權限。配額限制可能會導致即使瀏覽器已發送大部分數據,也無法儲存新文件。如果目標位置是外部掛載點,請同時檢查該後端可用空間和寫入權限。

在伺服器上,檢查資料目錄和所有相關臨時目錄的可用區塊數和 inode 數。 inode 是用來建立檔案的檔案系統記錄;一個磁碟區可能擁有數 GB 的可用空間,但沒有剩餘的 inode。請使用 PHP 和 ownCloud 配置中的實際路徑:

df -h /path/to/owncloud-data /path/to/php-temp /path/to/chunk-temp
df -i /path/to/owncloud-data /path/to/php-temp /path/to/chunk-temp

PHP 目錄upload_tmp_dir必須對 PHP/Web 伺服器帳號具有寫入權限。 ownCloud 還具有臨時目錄設置,預設情況下,分塊上傳的文件會暫存在用戶的上傳目錄中。在組裝過程中,ownCloud 可能需要佔用與最終檔案大小大致相等的臨時空間。配置dav.chunk_base_dir可以變更此位置。請檢查所有這些卷,而不僅僅是主資料磁碟。

Linux 終端機顯示 df -h 和 df -i 指令,用於檢查檔案系統空間和 inode。
檢查資料檔案系統、PHP 臨時檔案系統和分塊上傳檔案系統的可用磁碟空間和 inode 數量。

3. 將上傳限制和逾時時間與檔案相符

如果小檔案可以正常打開,但大檔案卻不行,請將其大小與有效的 Web PHP 設定進行比較:` <filename>`upload_max_filesize和 ` <filename> post_max_size`。 PHP 要求post_max_size`<filename>` 大於 `<filename> upload_max_filesize`。檢查 Web 伺服器或 PHP-FPM 使用的 PHP 配置;命令列 PHP 配置可能有所不同。 ownCloud 指出,在 PHP-FPM 設定中,PHP 設定應位於 `<filename>`.user.ini或 FPM 配置中,而不僅僅是 `<filename>` .htaccess。

此外,也要檢查max_input_time上傳耗時過長的情況,以及日誌中是否顯示逾時,並檢查 PHP 執行逾時時間。根據預期工作負載設定限制,而不是直接複製範例數字;更改配置後,請重新啟動或重新載入 PHP 和 Web 伺服器。請參閱 ownCloud 的大檔案上傳配置和 PHP上傳指令參考。

PHP 設定編輯器列出了 upload_max_filesize、post_max_size、upload_tmp_dir、max_input_time 和 max_execution_time。
比較 PHP 上傳限制和逾時時間與受影響的檔案大小和上傳時長。

然後檢查 PHP 前面的每個 HTTP 層。 Nginx 會client_max_body_size使用 HTTP 413 錯誤拒絕過大的請求體;請將此值設定得足夠高,以適應上傳路徑的請求大小。 ApacheLimitRequestBody也mod_reqtimeout可能限制上傳。 ownCloud 特別警告說,反向代理、Cloudflare、主機 I/O 限制和 Apache 請求逾時設定都可能影響大型上傳。僅更改日誌中提到的相關層,不要一開始就全域禁用安全模組。請參閱Nginx 官方請求體文檔。

4. 使用日誌定位故障層。

請重現問題一次,並記錄時間,然後檢查同一分鐘內的 ownCloud 日誌和 Web 伺服器或代理伺服器錯誤日誌。 ownCloud 日誌通常位於配置的資料目錄下;實際路徑可以在設定檔中變更config.php。尋找有關配額、權限、臨時檔案、鎖定、請求大小或逾時的訊息。如果該請求始終未出現在 ownCloud 日誌中,請先檢查代理伺服器或 Web 伺服器。

tail -n 100 /path/to/owncloud.log

請將佔位符替換為您安裝中配置的路徑。此命令僅顯示最近的日誌行,不會更改伺服器資料。請勿在未移除使用者名稱、檔案路徑、IP 位址和令牌的情況下公開原始日誌。 ownCloud 的調試文檔中解釋了日誌位置。

終端機在標示為「web 伺服器錯誤日誌」的視窗旁顯示了 owncloud.log 的 tail 指令。
查看上傳失敗時的 ownCloud 和 Web 伺服器日誌;路徑取決於伺服器設定。

驗證修復是否成功

  • 先上傳一個小文件,然後再重試上傳受影響的文件。
  • 確認目標檔案大小符合預期且能正常開啟。
  • 檢查上傳時是否出現配額、儲存、HTTP 413、權限或逾時錯誤。
  • 如果問題仍然存在,請將檔案大小、目標位置、時間戳記和匹配的日誌條目提供給管理員,以便他們能夠確定是哪個層阻止了請求。

不要一次性提高所有限製或關閉請求保護。先進行有針對性的更改,然後進行一次受控重試,這樣更容易確認原因,並能保持伺服器配置的其餘部分不變。

留下評論

在 ownCloud oCIS 中按使用者角色設定預設儲存配額

在 ownCloud oCIS 中按使用者角色設定預設儲存配額

按角色為新的 ownCloud Infinite Scale 使用者指派基於位元組的儲存限制,並提供 proxy.yaml 範例和安全性驗證清單。

修正 TLS 來源端的 ownCloud 同步憑證錯誤

修正 TLS 來源端的 ownCloud 同步憑證錯誤

透過檢查伺服器主機名稱、憑證鏈、私有 CA 信任和強制入口網站問題,恢復 ownCloud 桌面同步,而無需停用 TLS 驗證。

升級後清除 ownCloud 完整性警告

使用無效文件報告來識別不匹配的核心文件或應用程式簽名,恢復正確的發布文件,並安全地驗證完整性檢查。

使用 Docker Compose 安裝 ownCloud Infinite Scale

從官方 Compose 範例部署 ownCloud Infinite Scale,配置網域和持久存儲,然後驗證 TLS、容器和首次登入。

為 ownCloud Infinite Scale 配置 S3 Blob 存儲

為 ownCloud Infinite Scale 配置 S3 Blob 存儲

設定 S3NG 驅動程式、儲存桶權限、持久性元資料儲存和上傳大小,以便 ownCloud Infinite Scale 可以可靠地儲存檔案內容。

當 ownCloud 上傳進度停滯在 99% 時,請檢查這些限制。

當 ownCloud 上傳進度停滯在 99% 時,請檢查這些限制。

檢查檔案狀態、配額、臨時磁碟空間、PHP 限制和代理逾時,找出 ownCloud 伺服器上傳接近完成時停止的原因。

安全地清除 ownCloud Apache .htaccess 警告

安全地清除 ownCloud Apache .htaccess 警告

僅對 ownCloud 的 Web 根目錄設定 AllowOverride All,驗證活動的 Apache 虛擬主機,然後安全地重新載入以恢復 .htaccess 規則。

設定 ownCloud 企業審計並驗證日誌

啟用 ownCloud 的企業審計應用程序,將 admin_audit 事件路由到受保護的日誌文件,並確認正在記錄真實使用者的操作。

使用 OIDC 將 ownCloud Infinite Scale 連接到 Keycloak

使用 OIDC 將 ownCloud Infinite Scale 連接到 Keycloak

讓 Keycloak 的 realm 頒發者、Web 用戶端和使用者聲明保持一致,以便 ownCloud Infinite Scale 能夠可靠地在 Web 和行動用戶端上登入使用者。

將 ownCloud 檔案轉移給新所有者而不丟失共享份額

使用 ownCloud 的 occ 指令傳輸擁有的檔案和要傳出的共享,以了解哪些內容會保留下來,並在刪除舊帳戶之前驗證存取權限。