Nextcloud 大檔案上傳指南 | IT人生

Nextcloud 是一個功能強大的自託管雲端儲存解決方案，讓您可以掌控自己的資料。然而，當您嘗試上傳大型檔案時，可能會遇到一些挑戰。這篇文章將探討這些常見問題，並提供解決方案，幫助您順利上傳大檔案到您的 Nextcloud 伺服器。

為什麼上傳大檔案會遇到問題？

上傳大檔案時遇到的問題通常不是 Nextcloud 本身造成的，而是受到以下幾個因素的限制：

瀏覽器和前端服務限制： 網頁瀏覽器在處理大型檔案上傳時可能會有穩定性或記憶體方面的限制。此外，如果上傳是作為一個單一請求進行，並且前端服務（如瀏覽器本身或其前的任何反向代理）在檔案完全上傳到伺服器之前就因為超時或其他原因斷開連接，那麼即使後端伺服器配置允許，整個上傳會話也會中斷，導致檔案上傳失敗。對於單一超過 3GB 的檔案，這種單一請求超時的可能性會顯著增加。
PHP 設定： Nextcloud 是基於 PHP 運行的，而 PHP 有一些關於檔案上傳大小和執行時間的預設限制。
網頁伺服器設定： 您使用的網頁伺服器（如 Apache 或 Nginx）也可能有請求體大小的限制。
網路穩定性： 不穩定的網路連線會導致上傳中斷。
Nextcloud 設定： 雖然 Nextcloud 支援檔案分塊上傳，但某些設定可能會影響其效能。

解決方案與設定調整

要成功上傳大檔案（例如 15GB），您可能需要調整伺服器的一些設定，並考慮使用更適合大檔案上傳的方法。請注意，修改伺服器設定需要相應的權限，如果您不是伺服器管理員，請聯繫您的管理員。

1. 調整 PHP 設定

這些設定通常在您的 php.ini 檔案中。如果您使用 PHP-FPM，這些設定也可能在 PHP-FPM 的設定檔中（例如 www.conf），使用 php_admin_value 或 php_value 指令。您需要找到並修改以下參數：

upload_max_filesize: 設定允許上傳的最大檔案大小。例如，要允許上傳 15GB 的檔案，您可以設定為 15G。
post_max_size: 設定通過 POST 方法發送的最大數據量。這個值應該大於或等於 upload_max_filesize。例如，15G。
memory_limit: 設定 PHP 腳本可以消耗的最大記憶體量。對於大檔案上傳，建議將其設定為足夠大的值，例如 512M 或更高。如果您使用 PHP-FPM，可以設定 php_admin_value[memory_limit] = 512M。
max_execution_time: 設定腳本的最大執行時間（秒）。上傳大檔案可能需要較長時間，請將此值設定得足夠大，例如 3600 (1小時) 或 0 (無限制，但不建議)。
max_input_time: 設定腳本解析輸入數據的最大時間（秒）。同樣需要設定得足夠大，例如 3600 或 -1 (無限制)。

如果您使用 PHP-FPM，以下是針對 15GB 檔案上傳的常見相關設定範例：

php_admin_value[memory_limit] = 512M
php_admin_value[upload_max_filesize] = 15G
php_admin_value[post_max_size] = 15G

修改 PHP 設定後，請記得重啟您的網頁伺服器（Apache 或 Nginx）和 PHP-FPM (如果使用)。
您可以在 Nextcloud 設定頁面的「管理」->「概覽」中檢查當前的 PHP 設定值。

2. 調整網頁伺服器設定

根據您使用的網頁伺服器，您需要修改不同的設定：

Apache: 在您的 Apache 設定檔（例如 apache2.conf 或虛擬主機設定檔）中，您可能需要調整 LimitRequestBody 指令。
例如，要允許 15GB 的請求體，您可以設定 LimitRequestBody 16106127360 (15GB 轉換為位元組)。
Nginx: 在您的 Nginx 設定檔（例如 nginx.conf 或站點設定檔）的 http, server, 或 location 區塊中，您需要調整 client_max_body_size 指令。
例如，要允許 15GB 的請求體，您可以設定 client_max_body_size 15G;。如果您使用 Nginx 作為反向代理並與 PHP-FPM 配合使用，您可能還需要調整 fastcgi_read_timeout 來減少因長時間上傳導致的超時問題。
例如：fastcgi_read_timeout 1800s; # 設定為 1800 秒 (30 分鐘) 或根據需要調整

修改網頁伺服器設定後，請記得重載或重啟網頁伺服器。

3. 使用 Nextcloud 桌面客戶端

對於大型檔案或大量檔案的上傳，強烈建議使用 Nextcloud 桌面客戶端。桌面客戶端通常比網頁介面上傳更穩定，並且支援斷點續傳。桌面客戶端通常會自動處理檔案分塊和上傳過程中的潛在中斷，這能有效避免單一請求超時導致上傳失敗的問題。

4. 使用 WebDAV

Nextcloud 支援 WebDAV 協定，這允許您將 Nextcloud 掛載為電腦上的網路磁碟機。通過 WebDAV 複製檔案通常比通過網頁介面上傳更可靠，特別是對於大檔案。WebDAV 客戶端通常也具備更好的錯誤處理和續傳能力。

5. 檢查 Nextcloud 內部設定

在 Nextcloud 的 config/config.php 檔案中，有一些與檔案上傳相關的設定，例如 chunking_enabled。確保這些設定沒有被不正確地禁用。通常情況下，預設設定已經足夠，不建議隨意修改。

您也可以在 config/config.php 中設定檔案分塊的最大大小，例如：

'files.chunked_upload.max_size' => 100 * 1024 * 1024, // 設定每個分塊最大為 100MB

這個設定有助於將大檔案分割成較小的塊進行上傳。這對於避免單一大型請求因前端或網路超時而中斷至關重要，因為即使一個分塊上傳失敗，其他分塊可能已經成功，並且通常可以嘗試重新上傳失敗的分塊。

6. 檢查伺服器磁碟空間與儲存機制

確保您的 Nextcloud 伺服器有足夠的磁碟空間來存放您要上傳的大檔案。特別需要注意的是，如果您的 Nextcloud 儲存不是直接使用 S3 等物件儲存，當上傳大於 2GB 的檔案時，Nextcloud 會使用一個臨時目錄來儲存檔案分塊，並在所有分塊上傳完成後將其拼接成完整檔案。這意味著在拼接過程中，您需要額外的磁碟空間來暫存這些分塊，所需空間大約是原始檔案大小的雙倍。因此，在規劃磁碟空間時，請務必考慮到這一點，特別是如果您預期會上傳大型檔案（例如 15GB 的檔案可能需要約 30GB 的暫存空間）。

7. 檢查伺服器日誌與 502 錯誤排查

如果上傳失敗，查看 Nextcloud 的日誌檔案（通常在 data/nextcloud.log）以及網頁伺服器（Apache 或 Nginx）和 PHP 的日誌檔案，可以幫助您診斷問題的根本原因。

特別是當您遇到 502 Bad Gateway 錯誤，但 Nextcloud 或 PHP 日誌中沒有明確記錄時，這可能表示問題發生在網頁伺服器與 PHP-FPM 之間，或者由於網路不穩定、前端中斷等原因導致請求未能被 Nextcloud 應用層完整處理。如前所述，如果前端服務在單一大型請求完成前超時斷開，就可能導致這種情況。 針對這種情況，請重點排查以下日誌和方面：

網頁伺服器錯誤日誌 (Apache error.log 或 Nginx error.log): 這是最可能記錄 502 錯誤詳細資訊的地方，查找與上游伺服器（PHP-FPM）通訊失敗相關的錯誤。
PHP-FPM 日誌: 如果啟用，檢查 PHP-FPM 的日誌，看是否有進程崩潰或錯誤記錄。
反向代理/負載均衡器日誌 (如果使用): 如果您在 Nextcloud 前使用了其他代理，檢查其日誌以確定問題是否發生在代理層。
伺服器資源監控: 在上傳時監控 CPU、記憶體、磁碟 I/O 和網路使用率，資源耗盡可能導致服務異常。
網路穩定性: 不穩定的網路連線可能導致上傳中斷，進而引發網頁伺服器端的超時或錯誤。

總結

上傳大檔案到 Nextcloud 可能需要對伺服器的一些設定進行調整。最常見的限制來自 PHP 和網頁伺服器。調整 php.ini 或 PHP-FPM 設定（如 upload_max_filesize, post_max_size, memory_limit, max_execution_time）以及網頁伺服器設定（如 Nginx 的 client_max_body_size, fastcgi_read_timeout 或 Apache 的 LimitRequestBody）是關鍵步驟。
特別需要注意的是，前端服務（瀏覽器或代理）的超時設定對單一大型檔案上傳影響很大，一旦超時會中斷整個上傳會話。
利用 Nextcloud 內部的檔案分塊設定 (files.chunked_upload.max_size) 能有效將大檔案分割成小塊，顯著降低單一請求超時的風險，提高上傳的穩定性。
在規劃伺服器儲存空間時，請注意如果不是使用 S3 等物件儲存，上傳大於 2GB 的檔案可能需要約雙倍於檔案大小的暫存空間進行拼接。
當遇到難以診斷的 502 錯誤時，擴大日誌檢查範圍至網頁伺服器和任何代理層是重要的排查方向。
對於大型或重要的上傳任務，使用 Nextcloud 桌面客戶端或 WebDAV 是更穩定和可靠的選擇，它們通常能更好地處理分塊和斷點續傳。
通過仔細檢查和調整相關設定並選擇合適的上傳方式，您可以確保順利地將您的重要檔案上傳到 Nextcloud。