如何在 ONLYOFFICE 工作區中變更預設儲存位置

簡而言之：在 ONLYOFFICE Workspace 中，控制面板可以將入口網站靜態資料從預設本機磁碟移至支援的第三方儲存服務。目前的官方管理指南列出了 Amazon S3、Google Cloud Storage、Rackspace Cloud Storage 和 Selectel Cloud Storage 等服務。指南中沒有提供控制台欄位供您輸入任意本機路徑，例如/mnt/storage.

本指南通篇使用一個明確的假設範例。假設有一家名為 Northstar Studio 的小型設計公司。由於上傳的檔案和其他入口網站靜態資料持續成長，其自架的 ONLYOFFICE Workspace 伺服器本機磁碟空間即將耗盡。管理員希望將入口網站儲存移轉到 Amazon S3 儲存桶，同時將 Workspace 入口網站本身保留在同一台伺服器上。 Northstar Studio 僅用於說明，並非真實測試或客戶案例。

在進行任何更改之前，區分兩種通常被描述為「更改預設儲存位置」的不同任務很有幫助。第一種是將入口網站的靜態資料儲存體從本機磁碟切換到控制面板中受支援的物件儲存提供者。第二種是行動自託管 Docker 安裝所使用的主機檔案系統目錄。 ONLYOFFICE 將這兩種操作記錄為不同的層級，因此以下步驟首先重點介紹支援的控制面板方法，然後再單獨解釋本機磁碟的情況。

選擇新的儲存提供者後，會發生哪些變化？

預設情況下，ONLYOFFICE Workspace 將入口網站資料儲存在安裝了 Workspace 的電腦的本機磁碟上。官方的「儲存」頁面指出，可以使用連接的第三方服務來儲存靜態入口網站資料。選擇並連接新的服務提供者後，頁面將重新載入並啟動資料遷移程序。根據資料量的大小，此遷移過程可能需要一些時間。

因此，對於 Northstar Studio 而言，其目標並非“讓每個用戶將未來的文檔保存到特定資料夾”，而是“將門戶網站的儲存後端從預設磁碟遷移到 S3 儲存桶”。這種區別至關重要，因為用戶資料夾組織、文件模組中連接的第三方資料夾、備份目標以及管理員級別的儲存後端都是不同的功能。

官方參考：ONLYOFFICE 幫助中心：連接第三方儲存。

步驟 1：在變更儲存位置之前，請備份入口網站。

儲存變更會啟動遷移，因此請先建立可復原的備份。 ONLYOFFICE 在控制台中提供備份和復原控制。備份可以暫時儲存在「文件」模組中、電腦路徑中，或根據部署和配置儲存在支援的第三方儲存中。

對於假設的 Northstar Studio 伺服器，管理員會先建立一個新的備份，並在存取「儲存」頁面之前確認備份檔案的儲存位置。這並不能保證遷移一定會失敗；它只是為管理員提供了一個恢復路徑，以防憑證、儲存桶策略、網路存取或其他依賴項出現問題。

官方參考：ONLYOFFICE 幫助中心：控制面板備份和還原。

步驟 2：打開控制面板並檢查整合情況

使用具有入口網站管理權限的帳號登入。從工作區起始頁開啟控制面板，或開啟入口網站設置，然後點選左側區域的控制面板連結。第三方服務必須先在入口網站的「整合」部分連接；否則，其儲存選項將在「儲存」頁面中被停用。

Northstar Studio計劃使用Amazon S3，因此管理員首先需要確認Amazon S3已配置為第三方服務。選擇Google Cloud Storage、Rackspace Cloud Storage或Selectel Cloud Storage時，也需要滿足相同的前提條件。

步驟 3：開啟“通用設定”→“儲存”

在控制台中，前往「通用設定」下的「儲存」頁面。預設會選擇“磁碟預設”。在這裡，您可以選擇哪個受支援的後端來儲存入口網站的靜態資料。

如果您只想將資料保存在伺服器的本機磁碟上，請不要選擇雲端服務提供者。 「磁碟預設」仍然是本機儲存選項。如果您的真正需求是將本機資料移至同一伺服器上的不同掛載點，請跳至下文關於 Docker 和主機路徑的部分；「儲存」頁面並非通用的檔案系統路徑選擇器。

步驟 4：輸入提供者特定的設置

選擇您要使用的服務提供者，並填寫所需的連線詳細資訊。對於 Amazon S3，ONLYOFFICE 目前的文件描述了包括儲存桶和區域在內的字段，以及可選的服務 URL、強制路徑樣式、使用 HTTP 和加密相關設定。 Google Cloud Storage 使用儲存桶名稱；Rackspace 和 Selectel 使用它們自己的容器和區域欄位。

在 Northstar Studio 範例中，管理者需要輸入專用的 S3 儲存桶和正確的 AWS 區域。除非需要使用不同的端點，否則服務 URL 應保持不變。憑證和權限應僅限於 Workspace 所需的範圍，並且在開始遷移之前，應驗證伺服器到儲存服務的網路存取權限。

點選「連線」前的實際檢查

• 確認儲存桶或容器是否存在於預期區域。
• 確認整合憑證有效且已取得所需物件操作的授權。
• 確認 Workspace 伺服器可以連線到提供者端點。
• 請將最近的備份檔案保存在正在遷移的資料之外。
• 安排在您可以監控入口網站和儲存服務是否有錯誤或意外容量使用情況的一段時間內進行變更。

步驟 5：連接儲存空間並等待遷移完成

點選“連接”。根據 ONLYOFFICE 的官方指南，頁面將重新加載，資料遷移過程隨即開始。即使服務提供者已被接受，也不要認為變更已完成。請等待「儲存」頁面重新載入並選取新的儲存位置，然後驗證入口網站的正常使用情況。

對於 Northstar Studio 而言，合理的驗證步驟包括開啟幾個現有文件、上傳新文件、預覽圖像或其他靜態內容，以及檢查 S3 儲存桶中是否有新物件。具體的物件佈局屬於實現細節；重要的是門戶內容能夠正常運行，並且新的後端正在使用。如果入口網站報告錯誤，請在進行其他變更之前，請檢查憑證、儲存桶策略、區域、端點可達性以及伺服器日誌。

如果想要使用不同的本機磁碟或掛載點呢？

很多關於「預設儲存位置」的教學在這裡容易產生誤導。控制面板的「磁碟預設」選項並沒有提供任意主機目錄選擇器。對於基於 Docker 的工作區部署，ONLYOFFICE 本身的遷移文件明確指出，入口網站資料儲存在/app/onlyoffice主機上的某個目錄下。手動 Docker 安裝文件也指出，該目錄下會建立一些元件目錄，例如 CommunityServer、DocumentServer、MailServer、ControlPanel 以及資料庫相關的目錄。

如果需要將主機端目錄遷移到更大的磁碟，請將其視為部署遷移，而不是控制面板設定。備份安裝，停止相關容器，在保留所有權和權限的前提下複製數據，更新特定部署使用的主機端綁定掛載或 Docker Compose 磁碟區定義，然後重新啟動堆疊。特定的 Compose 檔案和磁碟區對映取決於 Workspace 的安裝方式，因此從其他部署複製通用命令可能會導致入口網站發生故障。

對於 Docker Compose 安裝，請參考您目前實際使用的部署文件，並將其與官方安裝指南進行比較：使用 Docker Compose 安裝 ONLYOFFICE Workspace Community。有關官方基於 Docker 的工作區佈局所使用的主機資料位置，請參閱ONLYOFFICE Workspace Docker 遷移指南。

更改門戶儲存空間與更改備份儲存有何不同？

它們是兩個獨立的選項。 「儲存」頁面決定了受支援的入口網站靜態資料的儲存位置。 「備份」頁面決定了備份歸檔檔案的寫入位置。例如，您可以將入口網站資料保留在「預設磁碟」上，同時將備份寫入其他位置；或者，您可以將入口網站靜態資料遷移到 S3，同時將備份保留在其他位置。為了提高系統彈性，將備份與主儲存後端邏輯分離通常更容易在復原過程中進行分析。

哪種方案更適合您的情況？

最終核查清單

• 在儲存頁面上選擇目標提供者。
• 遷移已經結束，而不僅僅是開始。
• 現有文件可以正常開啟和下載。
• 新上傳的內容有效。
• 使用者仍然可以存取入口網站，不會出現與儲存相關的錯誤。
• 新的儲存桶或容器顯示與門戶使用一致的活動。
• 最近的備份仍然可用，並且沒有意外地僅儲存在您剛剛移動的資料集中。

以 Northstar Studio 為例，只有當遷移後入口網站運作正常，且管理員確認所選 S3 後端已啟動時，儲存變更才算成功。這種更實際的定義比將「連線」按鈕本身視為任務完成的證明更有用。