如何在 Nextcloud 中將 S3 相容存儲掛載為外部存儲

若要在 Nextcloud 中掛載與 S3 相容的儲存桶，請啟用內建的「外部儲存支援」應用，在管理員的「外部儲存」設定中新增Amazon S3儲存項目，並提供儲存桶憑證以及提供者的終端節點詳細資訊。 Nextcloud 使用 Amazon S3 後端來支援相容服務；您無需為每個 S3 供應商安裝單獨的應用程式。具體的主機名稱、區域和路徑樣式設定取決於物件儲存提供者。

本指南遵循 Nextcloud 針對 S3 和外部儲存後端的最新管理文檔，更新於 2026 年 10 月 6 日。不同伺服器版本和主題的標籤可能略有差異。掛載點可能可以訪問，但其行為可能與本地 Nextcloud 資料夾有所不同，尤其是在直接修改儲存桶中的檔案時。

在添加水桶之前應該檢查哪些內容？

在開啟 Nextcloud 設定之前，請先與您的 S3 提供者確認以下資訊：

• 儲存桶名稱和存取金鑰的憑證。
• 提供者的通用 S3 端點主機名，例如s3.example.net。請使用端點本身，而不是已經包含儲存桶名稱的特定於儲存桶的 URL。
• 如果服務提供者要求，則填寫區域或簽名區域。
• 請求應該使用虛擬主機樣式（https://bucket.endpoint/）還是路徑樣式（https://endpoint/bucket）。
• HTTPS 連接埠通常為 443，以及您的伺服器是否可以透過其防火牆和 DNS 存取該端點。

為該掛載點建立一個專用的存取金鑰，並將其權限限制在所需的儲存體桶和操作範圍內。切勿將金鑰貼到工單、螢幕截圖或 shell 歷史記錄中。 Nextcloud 的 S3 設定需要存取金鑰 ID 和秘密存取金鑰；它不會為您驗證每個提供者特定的權限策略。

這和將 S3 設為 Nextcloud 的主要儲存是一樣的嗎？

不。外部儲存掛載會將現有的儲存桶作為 Nextcloud 中的一個資料夾公開。當您想要瀏覽或管理儲存桶中的文件，同時又希望其他 S3 工具能夠存取該儲存桶時，此功能非常有用。主物件儲存採用的是不同的伺服器級架構，其運作假設也不同。如果您需要在兩者之間進行選擇，請在更改生產資料設計之前查閱 Nextcloud 的主物件儲存文件。

如何在網頁介面中加入與 S3 相容的掛載點？

1. 啟用外部儲存支援

以 Nextcloud 管理員身份登錄，開啟「應用」，然後啟用捆綁的外部儲存支援應用程式。該應用程式已包含在 Nextcloud 中，但預設情況下可能處於停用狀態。如果該應用程式已啟用，請繼續進行儲存設定。

2. 開啟管理員的外部儲存頁面

開啟個人資料選單，選擇「設定」，然後在「管理」部分找到「外部儲存」。此頁面用於管理員配置的掛載點。使用者在個人設定中配置的儲存空間僅供該使用者使用；管理員掛載的儲存點可以對選定的使用者和使用者群組開放。

3. 建立掛載點並選擇 S3 後端

在新行中，輸入一個簡單的資料夾名稱，例如 ` <folder_name> Archive`。這將在 Nextcloud 中顯示為資料夾名稱，並且必須是名稱，而不是路徑；請勿在其中輸入斜線。在儲存類型選擇器中，選擇“Amazon S3”。在「身份驗證」下，選擇「存取金鑰」。

4. 輸入儲存桶和憑證

請輸入提供者提供的確切儲存桶名稱、存取金鑰 ID 和秘密存取金鑰。請將此秘密存取密鑰視為密碼。 Nextcloud 文件指出，即使服務託管在其他位置，從後端儲存桶的名稱也必須符合 AWS S3 的命名要求；名稱中不能包含底線。如果提供者的儲存桶名稱包含底線，請在排查憑證問題之前，先檢查提供者是否提供相容的儲存桶名稱。

5. 設定端點、區域和請求樣式

對於 Amazon 託管的 S3，請指定正確的區域。對於非 Amazon 服務，請設定提供者的通用主機名稱。請使用提供者發佈的端點和區域值；並非所有 S3 相容產品都使用通用的區域值。

Nextcloud 目前的 S3 指南明確指出，對於非 Amazon 存儲，應使用通用端點主機名稱。指南也指出，路徑式尋址方式取決於服務提供者。如果可以從服務提供者的 S3 文件中取得預期的尋址模式，請不要隨意切換路徑式尋址方式。

6. 限制坐騎的使用對象

使用「可用」選項僅將掛載點指派給指定的 Nextcloud 使用者或使用者群組。否則，管理員配置的掛載點可能被廣泛存取。儲存後，請檢查掛載點的選項：唯讀模式和共用控制可能適用於歸檔檔案或共用儲存桶。共享行為會影響哪些使用者可以透過 Nextcloud 存取文件，因此請謹慎設定。

7. 確認 Nextcloud 可以連接

當必填欄位有效時，儲存記錄將自動儲存。綠色狀態指示器表示 Nextcloud 可以使用已配置的儲存；紅色或黃色表示連接或配置需要注意。管理頁面可能會暫時將故障儲存標記為不可用，持續十分鐘。更正值後，點擊其狀態圖示或重新整理頁面即可觸發再次檢查。

8. 使用無害文件進行測試

以具有掛載權限的使用者身分開啟檔案。確認資料夾出現，建立或上傳一個小的測試文件，再次下載該文件，如果該儲存桶是可寫入的，則將其刪除。如果該掛載點是唯讀的，則測試使用者是否可以讀取文件，並驗證寫入操作是否已被封鎖。僅憑綠色指示器並不能確認所有使用者權限或預期的讀取/寫入行為都正確無誤。

如何透過命令列檢查掛載點？

對於需要您管理伺服器的安裝，Nextcloud 還提供了occ外部儲存的命令。請從 Nextcloud 安裝目錄執行命令，並使用與您的系統對應的 Web 伺服器帳戶。在許多 Linux 系統中，此方法通常適用www-data，但軟體包和容器安裝可能有所不同。

sudo -E -u www-data php occ files_external:list
sudo -E -u www-data php occ files_external:verify <mount_id>

替換<mount_id>為 list 指令顯示的 ID。驗證成功後，確認 Nextcloud 可以建立已設定的連線。對於 Nextcloud AIO 或其他容器部署，請使用部署文件中說明的方法occ在應用程式容器內執行命令，而不是直接複製主機命令。

為什麼即使數值看起來正確，掛載也可能失敗？

當服務使用自簽名憑證時，伺服器必須信任該憑證；停用憑證驗證並非安全的替代方案。 Nextcloud 的當前手冊也警告說，Photos//cat.png不支援重複的分隔符號（例如 `\`），並且受影響的前綴可能會被忽略。

當儲存桶中的檔案直接發生變更時會發生什麼？

Nextcloud 會為外部儲存維護一個內部檔案快取。如果其他工具直接在 S3 中新增、編輯或刪除對象，Nextcloud 可能無法立即偵測到這些變更。目前的外部儲存指南建議定期對不支援推播通知的儲存類型進行重新掃描。您可以使用以下命令尋找掛載 ID files_external:list：

sudo -E -u www-data php occ files_external:scan <mount_id>

根據您所需的資料新鮮度和伺服器負載能力安排掃描。掃描與即時變更通知不同。 Nextcloud 還記錄了一個元資料風險：重新掃描可能會將外部重命名操作解讀為刪除舊對象並建立一個新對象，從而刪除與舊條目關聯的 Nextcloud 端共用、標籤、評論和活動記錄。因此，如果保留元資料至關重要，請透過 Nextcloud 執行重新命名操作。

如何判斷設定已完成？

• S3 掛載點在管理員的外部儲存頁面顯示為綠色狀態。
• 指定群組內的使用者可以查看掛載點，而未分配群組的使用者則看不到。
• 測試上傳、下載和刪除操作均如預期進行—或對於只讀掛載點，寫入操作會被封鎖。
• 伺服器可以發現配置的掃描間隔之後，Nextcloud 外部所做的變更。
• 憑證僅儲存在 Nextcloud 配置和提供者帳戶中，存取權限僅限於所需的儲存桶。

有關特定版本的詳細信息，請參閱Nextcloud 官方 S3 外部儲存指南、外部儲存管理指南和官方 occ 命令參考。由於不同服務提供者在端點、區域、權限和尋址要求方面存在差異，因此其 S3 設定文件對於這些值仍然具有權威性。