ownCloud 10에서 S3 외부 스토리지 백엔드를 설정하는 방법

ownCloud Server 10은 외부 스토리지 지원 앱을 통해 Amazon S3 버킷을 보조 스토리지 위치로 마운트할 수 있습니다. 설정하려면 외부 스토리지를 활성화하고 관리자 스토리지 설정에서 Amazon S3 마운트를 추가한 다음 버킷과 액세스 자격 증명을 입력하고 ownCloud에서 마운트가 준비되었다고 보고하는지 확인하십시오. 이렇게 하면 버킷이 사용자의 파일 보기에서 계속 사용 가능하며 ownCloud의 기본 데이터 디렉터리가 S3로 이동되지는 않습니다.

이 가이드는 ownCloud 10의 S3 외부 스토리지 백엔드에 대해 설명합니다. Amazon S3에 적용되며, 엔드포인트, 리전 및 주소 지정 옵션이 공급자의 요구 사항과 일치하는 경우 S3 호환 서비스에서도 작동할 수 있습니다. 공급자 호환성은 다를 수 있으므로 사용자가 마운트를 사용할 수 있도록 설정하기 전에 스토리지 공급자에게 해당 값을 확인하십시오.

외부 S3 저장소 또는 기본 저장소?

외부 S3 마운트를 사용하면 버킷이 ownCloud 가상 파일 시스템에 추가 폴더로 추가됩니다. 사용자는 마운트 권한에 따라 일반 ownCloud 스토리지의 파일과 함께 해당 폴더에 액세스할 수 있습니다. 별도의 S3 기본 객체 스토리지 앱은 다른 배포 방식입니다. 이 방식은 ownCloud에서 기본 파일 콘텐츠를 저장하는 위치를 변경하며, 설정 및 마이그레이션에 추가적인 고려 사항이 있습니다. 보조 마운트를 사용하려는 경우에만 이 가이드를 따르십시오.

시작하기 전에 ownCloud Server 10 설치가 사용 환경에 맞게 지원되고 최신 버전인지, 서버가 S3 엔드포인트로 HTTPS 연결을 설정할 수 있는지, 그리고 관리자 권한이 있는지 확인하십시오. 버킷 이름, 공급자가 승인한 액세스 키와 비밀 키가 필요하며, 호환되는 서비스를 사용하는 경우 올바른 엔드포인트, 지역 및 경로 스타일 설정도 필요합니다.

1. 버킷과 자격 증명을 준비하세요.

스토리지 공급자 콘솔에서 버킷을 생성하거나 선택하세요. Amazon S3의 경우, 사용할 AWS 리전을 선택하고 버킷의 액세스 제어, 암호화, 수명 주기 규칙, 백업 또는 보존 요구 사항을 검토하세요. 버킷은 별도의 백업 계획을 대체할 수 없습니다.

ownCloud 마운트에 전용 자격 증명을 사용하고, 일반 파일 액세스에 필요한 버킷 및 작업으로 제한하십시오. 루트 계정 액세스 키는 사용하지 마십시오. AWS는 임시 자격 증명으로 충분한 경우 장기 액세스 키 사용을 지양할 것을 권장합니다. ownCloud 설정에 액세스 키 쌍이 필요한 경우, 비밀 키를 안전하게 보관하고 조직의 자격 증명 순환 정책을 준수하십시오. 많은 공급자가 키 생성 시에만 비밀 키를 표시하므로, 비밀 키를 안전하게 보관하십시오. 자격 증명을 티켓, 스크린샷, 셸 기록 또는 이 문서의 예시에 붙여넣지 마십시오.

네트워크 규칙, DNS 및 TLS 검사 정책이 ownCloud 서버가 공급자에게 연결할 수 있도록 허용하는지 확인하십시오. 호환되는 엔드포인트에 개인 인증서 또는 자체 서명 인증서를 사용하는 경우 외부 저장소 문서에 따라 해당 인증서를 ownCloud의 신뢰할 수 있는 인증서 저장소로 가져오십시오. 인증서 오류를 해결하기 위해 TLS 검증을 비활성화하지 마십시오.

2. 외부 저장 장치 지원 활성화

관리자 계정으로 ownCloud에 로그인합니다. 설정 > 앱을 열고 외부 저장소 지원을 찾아 활성화합니다(활성화되어 있지 않은 경우). 그런 다음 설정 > 관리자 > 저장소 (정확한 메뉴 명칭은 ownCloud 10 버전 및 테마에 따라 약간 다를 수 있음)를 열고 외부 저장소 구성이 가능한지 확인합니다.

외부 스토리지 지원은 보조 마운트를 제공합니다. ownCloud 관리자 문서에 따르면 필수 필드를 모두 입력하면 마운트가 자동으로 저장됩니다. 녹색 상태 표시기는 구성된 스토리지가 준비되었음을 의미하고, 빨간색 또는 노란색 표시기는 ownCloud가 연결에 실패했거나 구성을 검증할 수 없었음을 의미하므로 아직 마운트를 사용할 수 없음을 나타냅니다.

3. 아마존 S3 마운트를 추가하세요

관리자 저장소 설정에서 '저장소 추가'를 사용하고 'Amazon S3'를 선택합니다 . 마운트 지점에 사용할 폴더 이름을 입력합니다. 이 이름은 사용자가 파일 목록에 표시될 이름입니다. 그런 다음 제공된 S3 액세스 키, 비밀 키 및 버킷 이름을 정확하게 입력합니다. 비밀 키 필드는 비공개로 유지하고, 해당 필드가 표시되는 동안에는 화면 공유를 하지 마십시오.

표준 AWS S3 버킷의 경우, 공급자의 일반적인 엔드포인트 및 리전 동작부터 시작하세요. 요청에 HTTPS가 사용되도록 SSL을 활성화합니다. S3 호환 서비스의 경우, 해당 서비스에 필요한 호스트 이름, 포트 및 리전 값을 입력합니다. 버킷 이름에서 URL을 추측하는 대신 서비스에서 제공하는 공식 엔드포인트를 사용하세요.

경로형 주소 지정을 언제 활성화해야 합니까?

경로 스타일 주소 지정은 버킷별 호스트 이름에서 버킷이 URL 경로에 포함된 서비스 호스트 이름으로 요청을 변경합니다. ownCloud의 S3 백엔드 문서에 따르면 일반적으로 Amazon S3에서는 필요하지 않으며 최신 Amazon 데이터 센터에서는 작동하지 않을 수 있습니다. 가상 호스트 DNS 라우팅을 사용할 수 없는 일부 비 Amazon 엔드포인트에서 유용할 수 있습니다. 호환되는 공급자의 지침을 따르십시오. 마운트가 실패하면 여러 설정을 한 번에 변경하지 말고 엔드포인트와 주소 지정 모드를 함께 확인하십시오.

4. 마운트 사용 권한을 제한하세요

' 사용 가능 대상' 에서 S3 폴더를 볼 수 있는 ownCloud 사용자 또는 그룹을 선택하세요. 관리자 수준 마운트는 제한되지 않은 경우 기본적으로 모든 사용자에게 제공됩니다. 특히 버킷에 공유 데이터, 규제 데이터 또는 운영 데이터가 포함된 경우 의도된 사용자에게만 액세스 권한을 부여하세요.

해당 행이 표시된 후 마운트 옵션을 검토하십시오. 구성 및 ownCloud 릴리스에 따라 읽기 전용 액세스, 미리 보기, 암호화 통합, 파일 시스템 검사 및 공유 활성화 여부와 같은 옵션이 포함될 수 있습니다. 외부 마운트 지점에서의 공유는 기본적으로 문서화된 구성에서 비활성화되어 있습니다. 사용자가 ownCloud를 통해 해당 파일을 공유할 수 있어야 하고 조직 정책에서 허용하는 경우에만 활성화하십시오.

5. 제어된 테스트를 통해 연결을 확인합니다.

마운트 옆에 있는 상태 아이콘을 기다리세요. 녹색 표시등이 켜지면 첫 번째 성공 신호이지만, 데이터 경로 테스트가 완료된 것은 아닙니다. 사용 가능한 사용자 목록 에 포함된 사용자로 로그인하고, 파일 메뉴를 열어 마운트 폴더가 나타나는지 확인하세요. 민감하지 않은 작은 테스트 파일을 업로드하고, 파일을 열거나 다운로드한 후, 의도된 워크플로의 일부라면 파일 이름을 변경하고, 테스트 정책에서 삭제를 허용하는 경우에만 삭제하세요. 공급자 콘솔 또는 감사 로그에서 결과 객체를 확인하세요.

마운트에 할당되지 않은 사용자로 읽기 테스트를 반복하십시오. 마운트가 생성되었다는 이유만으로 해당 계정이 액세스 권한을 얻어서는 안 됩니다. 마운트가 읽기 전용인 경우 쓰기 시도가 차단되는지 확인하십시오. 운영 문서에 엔드포인트, 지역, 마운트 이름, 대상 그룹 및 자격 증명 소유자를 기록하되, 비밀 키 자체는 기록하지 마십시오.

마운트가 빨간색이거나 사용할 수 없는 문제 해결

인증 오류: 액세스 키와 시크릿 키가 동일한지, 활성화되어 있는지, 버킷에 액세스할 수 있는 권한이 있는지 확인하십시오. 키가 노출되었을 가능성이 있는 경우 자격 증명 관리 절차를 통해 키를 교체하십시오.
버킷 또는 권한 오류: 버킷 이름, 지역 및 공급자 정책을 확인하십시오. 테스트 중인 작업에 필요한 버킷 수준의 추가 권한이 해당 ID에 필요할 수 있습니다.
연결 시간 초과: 아웃바운드 방화벽 규칙, DNS 확인, 프록시 구성 및 ownCloud 호스트가 HTTPS를 통해 공급자 엔드포인트에 연결할 수 있는지 여부를 확인하십시오.
TLS 또는 인증서 오류: 호스트 이름과 인증서 체인을 확인하십시오. 개인 인증서의 경우, 유효성 검사를 비활성화하는 대신 ownCloud에서 제공하는 절차에 따라 신뢰할 수 있는 인증서를 가져오십시오.
호환되는 서비스만 사용하세요. 엔드포인트 호스트 이름, 포트, 지역 문자열 및 경로 스타일 설정을 해당 공급자의 설명서와 비교하여 확인하십시오. 이러한 값은 공급자별로 다릅니다.
수정 후에도 마운트가 계속 사용 불가능한 경우: ownCloud 설명서에 따르면 외부 저장소 연결 문제는 최대 10분 동안 사용 불가능으로 표시될 수 있습니다. 상태 아이콘을 클릭하거나 관리자 페이지를 새로 고침하여 다시 확인하십시오.

중요한 제한 사항: S3에 직접 추가된 파일

S3 및 호환 파일 시스템의 경우, ownCloud 10.15 설명서에 따르면 occ files:scan수동으로 추가된 파일은 다시 스캔할 수 없습니다. 또한, 해당 설명서에서는 ownCloud가 특히 폴더 계층 구조 깊숙한 곳에서 ownCloud 외부에서 이루어진 원격 변경 사항을 항상 감지하지 못할 수 있다고 경고합니다. 안정적인 파일 가시성과 메타데이터를 확보하려면 가능한 한 ownCloud를 통해 쓰기 및 변경 작업을 수행하십시오. 외부 프로세스에서 버킷에 쓰기 작업을 수행해야 하는 경우, 해당 워크플로를 사용하기 전에 사용 중인 백엔드 및 릴리스 버전에 대한 가시성과 일관성을 테스트하십시오. 일반적인 POSIX 파일 스캔으로 문제가 해결될 것이라고 가정하지 마십시오.

프로덕션 마운트를 변경하거나 제거할 때에도 주의해야 합니다. ownCloud는 외부 스토리지 구성을 변경하거나 제거해도 데이터베이스에서 이전 메타데이터 항목이 자동으로 삭제되지 않는다고 명시하고 있습니다. 변경 작업을 계획하고, 액세스 권한과 백업을 확인하고, 정리 작업을 수행하기 전에 릴리스별 문서를 참조하십시오. 사용자가 이미 사용하고 있는 마운트를 문제 해결 목적으로 삭제하는 것은 피해야 합니다.

구성 체크리스트

외부 저장 장치 지원이 활성화되었습니다.
선택된 백엔드는 Amazon S3이며 마운트 폴더 이름은 명확합니다.
버킷, 지역, 엔드포인트 및 경로 스타일 설정이 공급자와 일치합니다.
HTTPS가 활성화되어 있으며 서버는 엔드포인트 인증서를 신뢰합니다.
해당 키는 보호되며 필요한 버킷 접근 권한으로 제한됩니다.
지정된 사용자 및 그룹만 해당 마운트에 접근할 수 있습니다.
권한이 부여된 사용자는 해당 폴더를 볼 수 있으며 필요한 읽기/쓰기 테스트를 완료할 수 있습니다.
팀은 외부 S3에 대한 직접적인 쓰기 작업이 감지되지 않거나 재검사되지 않을 수 있음을 알고 있습니다 files:scan.

공식 문서

본 문서는 2026년 10월 6일에 확인되었습니다. ownCloud 10.15 외부 스토리지 구성 페이지는 앱 동작 및 제한 사항에 대한 버전별 참조 자료로 사용됩니다. S3 전용 페이지는 ownCloud의 최신 문서에서 링크되어 있는데, 이는 10.15 S3 페이지가 현재 '찾을 수 없음' 응답을 반환하기 때문입니다. UI 레이블 및 호환 공급자 설정은 릴리스 버전에 따라 다를 수 있습니다.