How to Mount a Samba/CIFS Share in ownCloud Server

The current ownCloud Classic release notes list version 11.0.1 as a security release and recommend upgrading. The 11.0.0 major release also raised the minimum PHP version to 8.3 and removed deprecated features, so administrators upgrading from 10.x should verify PHP and app compatibility first. The SMB/CIFS workflow itself remains an External Storage mount; this guide follows the ownCloud Server 10.16 SMB documentation, and menu labels or dependencies may differ on 11.x.

To connect a Samba or Windows file share, enable External Storage Support, make sure the ownCloud server can reach the SMB server, and add an SMB/CIFS mount from the admin storage settings. This creates a remote storage entry inside ownCloud; it does not mount the share in the Linux filesystem with /etc/fstab. Use this approach when users should reach files through ownCloud’s Files page and permissions should be controlled by the ownCloud mount and the SMB account.

What you need before you start

• Administrator access to ownCloud Server and the SMB file server.
• The SMB server’s DNS name or address, share name, optional subfolder, and any domain or workgroup required for sign-in.
• A dedicated SMB account with only the read or write permissions the ownCloud users need. The account must also be allowed by the share and filesystem ACLs on the SMB server.
• A network route and firewall policy that allow the ownCloud host to reach the SMB server.
• The SMB support dependency required by your ownCloud package. For a manual Linux installation, the matching ownCloud guide may require the PHP smbclient module; container images and packaged installs can supply dependencies differently. Check the guide for your exact ownCloud and PHP versions instead of copying an old package command.

ownCloud documents a command-line access test before configuring the external storage. On a Linux installation where smbclient is available, test server discovery and credentials first. The password prompt is interactive, so the password is not embedded in shell history.

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

If this fails, resolve DNS, routing, firewall, domain syntax, or share permissions before troubleshooting ownCloud. A server that cannot reach the share cannot make it available to users.

Mount the SMB/CIFS share in ownCloud

1. Enable External Storage Support

ownCloud 관리자 계정으로 로그인합니다. 설정 > 앱을 열고 외부 저장소 지원을 찾아 활성화합니다(활성화되어 있지 않은 경우). 그런 다음 저장소 관리 페이지(일반적으로 설정 > 관리 > 저장소 또는 해당 버전에 맞는 메뉴)를 엽니다. 사용자 생성 외부 저장소 마운트도 필요한 경우, 사용자의 네트워크 액세스 권한을 검토한 후 별도의 '사용자가 외부 저장소를 마운트할 수 있도록 허용' 설정을 활성화합니다 .

중앙에서 관리되는 공유 마운트의 경우 관리자 저장소 페이지에서 구성하십시오. 관리자 마운트는 기본적으로 모든 사용자가 사용할 수 있도록 설정되어 있으므로 공유 콘텐츠의 개인 정보 보호를 위해 ' 사용 가능 사용자' 필드를 특정 사용자 또는 그룹으로 제한해야 합니다.

2. SMB/CIFS 백엔드를 추가합니다.

외부 저장소 테이블에서 저장소 추가 에서 SMB/CIFS를 선택합니다 . 알아보기 쉬운 폴더 이름을 입력합니다 (예: ). 이 이름은 ownCloud에서 사용자가 보게 되는 마운트 지점 이름입니다. SMB 서버의 공유 이름과는 다릅니다.Projects

3. 서버 및 공유 경로를 입력하십시오.

SMB 백엔드에 필요한 필드를 모두 입력하세요. ownCloud 10.16 가이드에 따르면, 이러한 필드에는 서버 URL, 공유 이름, 원격 하위 폴더, 마운트를 사용할 수 있는 사용자 또는 그룹, 그리고 필요한 경우 도메인이 포함됩니다. 예를 들어, `<server_name>`이라는 서버 fileserver.example.com, `<share_name>` 이라는 공유 projects, 그리고 `<sub_folder_name>`이라는 하위 team폴더를 입력하면 ownCloud 마운트 지점 아래에 해당 원격 하위 폴더가 노출됩니다. 전체 공유를 마운트해야 하는 경우에는 원격 하위 폴더를 기본 루트 위치에 그대로 두세요.

사용 중인 버전에 표시된 필드 형식에 맞춰 서버 값을 입력하십시오. /mnt/shareSMB 서버 필드에 ownCloud 사용자 표시 URL 전체 또는 로컬 경로(예: 도메인)를 붙여넣지 마십시오. Active Directory에서 도메인이 필요한 경우, 도메인 필드를 사용하거나 선택한 인증 방법에 대한 문서화된 도메인-사용자 이름 형식을 사용하십시오.

4. 자격 증명 제공 방식을 선택하세요

계정 모델에 맞는 인증 방법을 선택하세요. 중앙에서 관리되는 서비스 계정은 여러 사용자가 동일한 공유 폴더에 액세스해야 할 때 유용합니다. SMB 구성에 서비스 계정의 사용자 이름과 암호를 입력하고, 파일 서버에서 도메인이 필요한 경우에만 도메인을 추가하세요. 암호는 ownCloud의 보호된 구성 흐름에 저장하고, 개인 관리자 로그인 대신 전용 계정을 사용하세요.

' 로그인 자격 증명을 세션에 저장'하는 방식은 각 사용자의 ownCloud 로그인 자격 증명을 원격 공유에 사용하며 서버에 저장하지 않습니다. ownCloud는 이 방식의 중요한 장단점을 다음과 같이 설명합니다. ownCloud가 저장소 자격 증명을 보관하지 않기 때문에 해당 마운트를 직접 공유하거나 백그라운드 파일 스캔을 수행하는 기능은 정상적으로 작동하지 않습니다. 팀 공유 액세스 또는 자동화된 백그라운드 작업을 위해서는 필요한 자격 증명을 안전하게 저장하는 지원되는 자격 증명 방식을 선택하십시오.

5. 접근 제한 및 마운트 옵션 설정

' 사용 가능 대상' 옵션을 사용하여 마운트된 폴더를 볼 수 있는 ownCloud 사용자 또는 그룹을 선택하세요. 공유 폴더에 접근 권한이 제한된 파일이 있는 경우 관리자 마운트 폴더를 모든 사용자에게 공개하지 마세요. SMB 서버의 권한 설정이 여전히 적용됩니다. ownCloud 사용자는 SMB 계정 및 서버 접근 제어 목록(ACL)에서 허용하는 것보다 더 많은 파일 접근 권한을 얻을 수 없습니다.

마운트 옵션을 열어 사용자가 원격 파일을 변경하지 않고 탐색하거나 다운로드해야 하는 경우 읽기 전용 으로 설정하세요 . ownCloud 관리자 마운트 옵션에서 외부 마운트 공유는 기본적으로 비활성화되어 있습니다. 사용자가 ownCloud를 통해 이 마운트의 파일을 공유해야 하고 권한 모델에서 허용하는 경우에만 공유 활성화를 활성화하세요 . 마운트의 사용 가능 사용자 필드에서 사용자를 선택하는 것과 파일 공유를 활성화하는 것은 별개의 결정입니다.

6. 마운트 상태를 확인합니다.

필수 입력 항목은 관리자 저장소 테이블에서 표시되며, 필요한 구성이 입력되면 ownCloud에서 마운트를 저장합니다. 녹색 상태 표시점은 외부 저장소가 준비되었음을 나타냅니다. 빨간색 또는 노란색 아이콘은 ownCloud가 연결할 수 없음을 의미하므로 호스트 이름, 공유 폴더, 하위 폴더, 자격 증명, 계정 권한 및 네트워크 가용성을 다시 확인하십시오. 설명서에 따르면 연결 문제가 발생하면 마운트가 최대 10분 동안 사용 불가로 표시될 수 있습니다. 문제 해결 후 상태 아이콘을 클릭하거나 관리자 페이지를 새로 고침하여 다시 시도하십시오.

관리자 권한과 사용자 권한으로 마운트를 확인하십시오.

허용된 그룹에 속한 사용자로 ownCloud 파일 페이지를 열고 마운트 폴더가 표시되는지 확인합니다. 간단한 테스트 파일을 사용해 보세요. 기존 파일을 열거나 다운로드한 다음, 마운트된 폴더가 쓰기 가능하도록 설정된 경우 작은 테스트 파일을 생성하거나 업로드하고 이름을 변경한 후 삭제합니다. SMB 서버에서도 동일한 변경 사항이 반영되는지 확인합니다. 마운트된 폴더가 읽기 전용인 경우, 읽기 작업이 정상적으로 작동하고 쓰기 작업이 예상대로 차단되는지 확인합니다.

명령줄 진단을 위해 ownCloud occ도구를 사용하면 외부 마운트 목록을 확인하고 마운트 ID로 마운트를 검증할 수 있습니다. 웹 서버 계정으로 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는 예시일 뿐입니다. 실제 출력에서 ​​반환된 ID로 바꿔주세요 files_external:list. 컨테이너 환경에서는 occ호스트의 경로 또는 웹 사용자가 동일하다고 가정하지 말고, 배포 환경에 문서화된 컨테이너 명령어를 사용하여 실행하십시오.

고장 지점을 기준으로 문제를 해결하세요.

계획 수립의 한계

SMB/CIFS 외부 마운트는 ownCloud 내부 데이터의 복사본이 아니라 다른 서버에 대한 실제 연결입니다. SMB 서버를 사용할 수 없는 경우 ownCloud에서도 마운트를 사용할 수 없게 될 수 있습니다. 외부 마운트를 변경하거나 제거해도 이전 구성과 관련된 모든 메타데이터 항목이 삭제되는 것은 아니므로 테스트 중에 프로덕션 환경의 마운트를 반복적으로 삭제하고 다시 생성하는 것은 피해야 합니다.

인증 방식은 자동화에 영향을 미칩니다. 세션 전용 자격 증명은 저장된 서비스 자격 증명처럼 백그라운드 프로세스에서 사용할 수 없습니다. 또한 다른 SMB 클라이언트를 통해 직접 변경한 내용이 ownCloud의 파일 보기에 즉시 반영되지 않을 수 있습니다. 안정적인 백그라운드 검색, 공유 또는 사용자별 액세스가 필요한 경우, 배포 전에 선택한 백엔드 및 ownCloud 릴리스에서 해당 동작을 정확하게 테스트하십시오.

공식 문서

• ownCloud 서버 10.16: 삼바 파일 서버 구성(SMB/CIFS)
• ownCloud 서버 10.16: 외부 스토리지 구성
• ownCloud 서버 10.16: 외부 저장소 인증 메커니즘
• ownCloud 서버 10.16: occ 명령어 참조
• ownCloud 서버 10.16: Ubuntu 설치 가이드 및 SMB PHP 모듈 참고 사항
• ownCloud 서버 릴리스 노트

본 문서는 2026년 10월 6일에 확인되었습니다. 패키지 종속성 및 정확한 메뉴 레이블은 ownCloud 릴리스, Linux 배포판 및 컨테이너 이미지에 따라 다를 수 있습니다. 사용 중인 버전에 맞는 설치 및 관리 가이드를 따르십시오.