如何在 ownCloud 伺服器中掛載 Samba/CIFS 共享

目前 ownCloud Classic 版本說明將 11.0.1 列為安全性更新版本，並建議升級。 11.0.0 版本也將最低 PHP 版本要求提升至 8.3，並移除了已棄用的功能，因此從 10.x 版本升級的管理員應先驗證 PHP 版本與應用程式的相容性。 SMB/CIFS 工作流程本身仍然是外部儲存掛載；本指南遵循 ownCloud Server 10.16 的 SMB 文檔，選單標籤或依賴項在 11.x 版本中可能有所不同。

要連接 Samba 或 Windows 檔案共享，請啟用外部儲存支持，確保 ownCloud 伺服器可以存取 SMB 伺服器，然後從管理儲存設定中新增 SMB/CIFS 掛載點。這會在 ownCloud 中建立一個遠端儲存條目；它不會將共用掛載到 Linux 檔案系統中/etc/fstab。當使用者需要透過 ownCloud 的「文件」頁面存取文件，並且權限需要由 ownCloud 掛載點和 SMB 帳戶控制時，請使用此方法。

開始之前你需要準備什麼

管理員可存取 ownCloud 伺服器和 SMB 檔案伺服器。
SMB 伺服器的 DNS 名稱或位址、共用名稱、選用子資料夾以及登入所需的任何網域或工作群組。
一個專用的 SMB 帳戶，僅具有 ownCloud 使用者所需的讀寫權限。該帳戶還必須被 SMB 伺服器上的共用和檔案系統 ACL 允許存取。
允許 ownCloud 主機存取 SMB 伺服器的網路路由和防火牆策略。
您的 ownCloud 軟體包需要 SMB 支援依賴項。對於手動 Linux 安裝，對應的 ownCloud 指南可能需要 PHPsmbclient模組；容器鏡像和軟體包安裝提供的依賴項可能有所不同。請查閱指南以確認您的 ownCloud 和 PHP 版本，而不要複製舊的軟體包命令。

ownCloud 文件中介紹了在配置外部儲存之前進行命令列存取測試的步驟。在 Linux 系統上，如果smbclient可以使用該功能，請先測試伺服器發現和憑證。密碼提示是互動的，因此密碼不會嵌入到 shell 歷史記錄中。

smbclient -L fileserver.example.com -U 'CORP/owncloud-reader'

如果此方法失敗，請先解決 DNS、路由、防火牆、網域語法或共用權限問題，然後再檢查 ownCloud 相關問題。無法存取共享資源的伺服器無法將其提供給使用者。

ownCloud 設定應用程式頁面，並啟用外部儲存支援應用程式。 — 在管理員儲存設定中新增 SMB/CIFS 掛載點之前，請先在應用程式中啟用外部儲存支援。

在 ownCloud 中掛載 SMB/CIFS 共享

1. 啟用外部儲存支援

以 ownCloud 管理員身分登入。開啟「設定」>「應用」，找到「外部儲存支援」，如果尚未啟用，請啟用它。然後開啟儲存管理頁面，通常是「設定」>「管理」>「儲存」或對應版本中的對應選項。如果還需要使用者建立的外部掛載點，請先啟用「允許使用者掛載外部儲存」設置，然後再查看此設定賦予使用者的網路存取權限。

對於集中管理的共用掛載點，請在管理儲存頁面進行設定。預設情況下，管理員掛載點對所有使用者可見，因此在確保共享內容的私密性之前，請將「可用物件」欄位限制為目標使用者或使用者群組。

2. 新增 SMB/CIFS 後端

在外部儲存表中，從「新增儲存」中選擇SMB/CIFS。輸入一個易於理解的資料夾名稱，例如 ` <folder_name>`。此名稱是使用者在 ownCloud 中看到的掛載點名稱，而不是 SMB 伺服器的共用名稱。Projects

ownCloud 管理儲存頁面，在「新增儲存」功能表中反白顯示了 SMB / CIFS。 — 選擇 SMB / CIFS 作為外部儲存後端；這將新增一個掛載行，其連接欄位取決於身份驗證方法。

3. 輸入伺服器和共用路徑

請填寫 SMB 後端的相應欄位。在 ownCloud 10.16 指南中，這些欄位包括伺服器 URL、共用名稱、遠端子資料夾、允許使用該掛載點的使用者或群組，以及（如果需要）網域名稱。例如，伺服器名稱為 `<server_name>` fileserver.example.com，共用名為 `<share_name>` projects，子資料夾名為 `<subfolder_name>` team，則會將該遠端子資料夾暴露在 ownCloud 掛載點下。如果需要掛載整個共享，請將遠端子資料夾保留在其預設根目錄。

請依照您版本中所示欄位的格式輸入伺服器值。請勿將完整的使用者可見的 ownCloud URL 或本機路徑（例如 `/etc/ownCloud/username/`）貼/mnt/share到 SMB 伺服器欄位中。如果 Active Directory 需要網域，請使用網域欄位或您所選驗證方法的文件中規定的網域和使用者名稱格式。

ownCloud 外部儲存表單，包含資料夾名稱、SMB / CIFS 後端、URL、共用、遠端子資料夾和可用欄位。 — 將 ownCloud 資料夾名稱對應到伺服器、共用和可選子資料夾；可見資料夾名稱是使用者開啟的掛載點。

4. 選擇提供憑證的方式

選擇與帳戶模型相符的身份驗證方法。當同一共用資料夾需要供一組使用者使用時，集中管理的服務帳戶非常有用。在 SMB 設定中輸入其使用者名稱和密碼，僅當檔案伺服器需要時才新增網域。將密碼儲存在 ownCloud 的受保護配置流程中，並使用專用帳戶而不是個人管理員登入帳戶。

「登入憑證保存於會話」方法使用每個使用者的 ownCloud 登入憑證進行遠端共用，但不會儲存在伺服器上。 ownCloud 文件中指出，這種方法存在一些重要的權衡：由於 ownCloud 不保留儲存憑證，因此直接共用該掛載點和背景檔案掃描功能無法正常運作。對於團隊共享存取或自動化後台操作，請選擇受支援的憑證保存方法，該方法能夠安全地儲存所需的憑證。

ownCloud SMB/CIFS 身份驗證表單，包含使用者名稱和密碼欄位以及可選的網域名稱欄位。 — 提供專用的 SMB 帳戶，並且僅當檔案伺服器的身份驗證設定需要時才新增網域。

5. 限制存取權限並設定掛載選項

使用「可用」選項選擇哪些 ownCloud 使用者或使用者群組可以查看掛載點。如果共用包含受限文件，請避免將管理員掛載點設定為對所有人可用。 SMB 伺服器本身的權限仍然有效：ownCloud 使用者無法獲得超出 SMB 帳戶和伺服器 ACL 允許的檔案存取權限。

開啟掛載點的選項，將使用者瀏覽或下載遠端檔案時設定為“唯讀”，但不能變更檔案內容。 ownCloud 管理掛載點選項中預設禁用外部掛載點共享；僅當用戶需要透過 ownCloud 共享此掛載點的文件，且您的權限模型允許時，才啟用「啟用共享」。在掛載點的可用性欄位中選擇使用者和啟用檔案共用是兩個獨立的操作。

選擇專案團隊群組後，ownCloud 可用選擇器會展開。 — 將管理員掛載權限限制為有權存取遠端檔案的 ownCloud 使用者或使用者群組。

ownCloud掛載選項彈出視窗顯示「唯讀」和「啟用共享」複選框。 — 如果不需要編輯，請將掛載點設定為唯讀；另行決定是否允許使用者共用其中的檔案。

6. 檢查掛載狀態

管理儲存表中已標記必填字段，ownCloud 會在您提供所需配置後保存掛載點。綠色狀態點表示外部儲存已準備就緒。紅色或黃色圖示表示 ownCloud 無法連線；請重新檢查主機名稱、共用資料夾、子資料夾、憑證、帳戶權限和網路連線。文件指出，連線問題可能會導致掛載點在十分鐘內顯示為不可用。點擊狀態圖示或重新載入管理頁面，在解決問題後重試。

以管理員和使用者身份驗證掛載點

以允許群組內的使用者身分開啟 ownCloud 檔案頁面，並確認掛載資料夾出現。使用無害文件進行測試：開啟或下載現有文件，然後，如果掛載點是可寫入的，則建立或上傳一個小的測試文件，重命名該文件，然後將其刪除。確認 SMB 伺服器上也出現了相同的變更。如果掛載點是唯讀的，則驗證讀取操作是否正常，以及寫入操作是否如預期般被阻止。

對於命令列診斷，ownCloud 的occ工具可以列出外部掛載點，並透過其 ID 驗證掛載點。請以 Web 伺服器帳戶身份，從 ownCloud 安裝目錄執行命令；請根據您的系統調整帳戶和路徑。首先從清單中取得實際的掛載點 ID，然後驗證該 ID。請勿在共享的命令輸出中洩漏掛載點密碼。

cd /var/www/owncloud
sudo -u www-data ./occ files_external:list
sudo -u www-data ./occ files_external:verify 3

該數字3僅為示例。請將其替換為您實際files_external:list輸出的 ID。在容器中，請occ使用部署文件中提供的容器命令運行，而不是假設主機具有相同的路徑或 Web 使用者。

ownCloud 檔案頁面，導覽列中有「項目」掛載點，以及幾個範例資料夾和檔案。 — 作為授權用戶，確認掛載點出現在「文件」中，並使用非關鍵文件測試存取。

Linux 終端機顯示 ownCloud occ files_external:verify 和 files_external:list 指令。 — 執行 files_external:verify 時，請使用您自己的 files_external:list 輸出中的掛載 ID；路徑和服務帳戶因安裝而異。

透過故障點進行故障排除

你所看到的	需要檢查什麼
`SMB / CIFS`後端清單中缺少該項	確認已啟用外部儲存支援和 SMB 後端，然後檢查 ownCloud 軟體包和 PHP 運行時的依賴項。變更 PHP 模組後，請重新啟動相關的 PHP 或 Web 服務。
`smbclient`無法列出伺服器或共享	檢查 ownCloud 主機上的伺服器名稱、防火牆和路由、憑證、網域語法以及共用及其底層檔案的權限。
坐騎行保持紅色或黃色	請重新檢查 SMB URL、共用名稱、遠端子資料夾、帳戶和網路路徑。如果主機使用 SELinux，請在更改策略之前查看 ownCloud 官方的 SELinux 出站網路存取指南。
安裝座是綠色的，但使用者看不到它。	檢查「可用使用者/群組」選項，並確認該使用者確實是該群組的成員。管理員掛載點和個人掛載點的權限範圍不同。
直接新增到 SMB 伺服器的檔案不會立即顯示。	ownCloud 可能無法一次偵測到所有遠端更改，尤其是在資料夾樹的更深層。請查看您所選機制的外部儲存後台作業指南和驗證限制。