如何在 ownCloud 伺服器中轉移共享文件的所有權

同事離職、專案轉移到其他團隊，或共用資料夾仍屬於即將被停用的帳戶。檔案可能出現在收件者的 ownCloud 視圖中，但收件者可能只能透過共用存取。如果原始帳戶被刪除，這種差異就可能造成問題。

對於 ownCloud Server 10.x 版本，管理員可以使用命令列工具轉移所有權occ files:transfer-ownership。 Server 10.16 文件中沒有提到面向使用者的「將我設為擁有者」按鈕。該命令會將一個帳戶擁有的文件及其傳出的共享文件移至另一個帳戶；傳入的共享文件不會被轉移。以下步驟使用目前的 ownCloud Server 10.16 指令參考。在執行所有權變更之前，請務必查閱文檔，以確認您執行的版本和儲存配置。

首先，確定哪些東西需要移動。

「與我共享」並不一定意味著「歸我所有」。在ownCloud中，建立或擁有檔案的帳戶可以與其他使用者共用檔案。接收者可能無需擁有該檔案即可讀取或編輯共用項目。如果您是接收者，通常下一步正確的做法是請求原始所有者或管理員移動該項目。

傳輸命令是 ownCloud 伺服器主機上的管理員操作。它可以移動來源使用者擁有的所有文件，或移動選定的資料夾及其內容。選定的路徑必須位於該使用者的檔案目錄中。它不會傳輸傳入的共享檔案、回收站內容或舊版本的檔案。官方的ownCloud 伺服器 10.16 OCC 命令參考文件詳細介紹了該命令及其選項。

本指南適用於 ownCloud Server（經典的 10.x 產品）。 ownCloud Infinite Scale 是不同的產品，具有不同的架構和使用者介面。請勿假定此 Server 指令或其結果適用於 Infinite Scale 部署；請參閱您已安裝產品的文件以確認。

選擇合適的傳輸範圍

在運行命令之前

1. 確認產品和版本。確認是 ownCloud Server 10.x，而不是 ownCloud Infinite Scale，並閱讀已安裝版本的命令參考文件。
2. 確認兩個帳戶 ID。請使用實際的 ownCloud 使用者 ID，除非顯示名稱或電子郵件地址本身就是 ID，否則請勿使用它們。仔細檢查拼字：來源和目標位址是位置參數。
3. 查看共享影響。此命令會移動屬於來源帳戶的已發出共用。接收共享除外。請將任何預期的所有權或存取權限變更告知協作者。
4. 建立並驗證備份。請遵循貴公司資料庫和資料儲存的常規備份流程。檔案傳輸會改變所有權和共享關係；可復原的備份是更安全的回滾方案。
5. 檢查儲存和部署詳情。確認 ownCloud 安裝目錄和正確的 Web 伺服器帳戶。在標準的 Linux 安裝中，該帳戶通常是 `/etc/owncloud` www-data，但軟體包和容器可能有所不同。

如果您使用支援 S3 的主儲存空間並配置了多個儲存桶，請先停止操作，並查看ownCloud 官方 S3 相容主儲存文件中針對該儲存的警告。文件指出，在這種情況下不建議進行所有權轉移，因為份額可能會遺失。

傳輸選定的共用資料夾

當目標位置只需要一個項目或少量文件，而不是來源使用者的整個文件集時，請使用選擇性傳輸。以下範例將名為「資料夾名稱」的資料夾Projects/Proposal從使用者 ID傳輸alice到使用者 ID bob。

1. 在 ownCloud 伺服器主機上開啟 shell，並進入包含occ腳本的目錄。使用與您的安裝路徑相符的路徑。
2. 運行命令前請檢查其選項：

sudo -u www-data ./occ files:transfer-ownership --help

3. 運行選擇性傳輸。範例路徑是相對於aliceownCloud 檔案目錄的相對路徑；它不是伺服器檔案系統路徑：

sudo -u www-data ./occ files:transfer-ownership \
  --path="Projects/Proposal" \
  alice \
  bob

如果您的安裝使用了不同的服務帳戶，請進行替換www-data。在容器部署中，請使用容器文件中提供的命令格式，而不是直接複製主機命令。例如，ownCloud 開發者文件中展示了一個 Docker Compose 格式，例如docker compose exec owncloud occ ...：服務名稱會因部署而異。

此指令會將選定的資料夾及其內容放置在目標使用者的檔案區域中，並命名為指定模式的資料夾transferred from alice on [timestamp]。它不會保留原始的根目錄位置。命令完成後，請檢查目標帳戶中是否存在此傳輸資料夾。

轉移一個帳戶下的所有資產

如果使用者即將離開，並且目標是移動其所有擁有的文件和要傳出的共享文件，則省略--path：

sudo -u www-data ./occ files:transfer-ownership \
  alice \
  bob

接受命令前請仔細閱讀確認輸出。該命令可能會報告無法傳輸的共享。此--accept-skipped-shares選項指示 ownCloud 在跳過共享時繼續執行；僅當您瞭解並接受此結果時才使用此選項。請勿僅為了抑制提示而新增此選項。

此外，還有--destination-use-user-folder特定完整使用者遷移場景的選項。目標使用者必須已創建，但從未登入；ownCloud 建議在該操作中使用維護模式。由於它有更嚴格的前提條件，並且會改變資料儲存位置，因此請勿將其用於普通的交接或選擇性遷移。

核實結果並處理跳過的份額

1. 以目標使用者登入，或請他們查看其文件區域。如需選擇性傳輸，請確認帶有時間戳記的transferred from …資料夾並開啟代表性檔案。
2. 請檢查預期的資料夾結構和最新文件內容是否存在。 Server 10.16 指令參考文件指出，文件版本不會被傳輸；目標帳號中只會顯示最新版本。
3. 與依賴這些共享資訊的人員核對重要的共享資訊。由於轉出的共享資訊會轉移，而轉入的共享資訊不會轉移，因此轉帳並不表示目標帳戶會收到所有已與來源帳戶共享的資訊。
4. 在目標帳戶擁有者和受影響的協作者確認存取權限之前，請保持來源帳戶可用。只有在確認無誤並通過正常的保留審查後，才能完成帳戶停用。

如果傳輸報告異常或提前結束，ownCloud 文件files:troubleshoot-transfer-ownership會記錄與傳輸相關的問題。其預設行為是進行一次模擬運行，並報告結果。例如：

sudo -u www-data ./occ files:troubleshoot-transfer-ownership --uid bob

請先查看其輸出。該命令還提供了一個--fix嘗試修復的選項，因此在查看報告的問題並擁有最新備份之前，請勿新增該選項。可用的檢查和選項列在同一份官方 OCC 參考文件中。

最終自檢

• 您是否使用了正確的 ownCloud 伺服器實例、版本、來源 ID 和目標 ID？
• 您選擇的範圍是指定路徑，還是指定來源擁有的所有檔案？
• 您是否考慮了跳過的已發出共享、已接收共享、回收站內容和舊版本？
• 目標用戶能否找到並開啟傳輸的檔案？受影響的協作者是否還能獲得所需的內容？
• 您是否保留了經過驗證的備份，並在確認交接後才刪除帳戶？

命令執行成功只是交接的開始。在確認所有權轉移完成之前，請確認新的文件位置、文件內容和協作存取權。