S3 호환 버킷을 Nextcloud 외부 스토리지에 연결하기

Nextcloud에서 S3 호환 버킷을 표시하려면 번들로 제공되는 외부 스토리지 지원 앱을 활성화하고 관리 설정에서 Amazon S3 마운트를 추가한 다음 공급자 버킷, 액세스 키, 비밀 키 및 엔드포인트 정보를 입력하세요. Amazon 이외의 공급자를 사용하는 경우 호스트 이름과 경로 스타일 설정이 가장 중요한 필드입니다. 마운트가 정상적으로 작동하는지 확인한 후, 임시 파일을 사용하여 테스트한 다음 전체 액세스 권한을 부여하세요.

준비할 사항

이 절차는 외부 마운트를 생성합니다. Nextcloud는 기존 버킷에 연결하여 파일 탐색기에서 해당 버킷을 폴더로 표시합니다. 이 과정에서 파일이 버킷으로 마이그레이션되거나, 버킷이 Nextcloud의 기본 저장소로 설정되거나, Nextcloud 데이터 디렉터리가 교체되지는 않습니다.

• 관리자 접근 권한: 시스템 전체 마운트는 Nextcloud의 관리자 설정에서 구성됩니다.
• 버킷 이름 및 자격 증명: 스토리지 제공업체로부터 S3 액세스 키 ID와 비밀 액세스 키를 받으세요. 해당 버킷과 그 용도에 맞는 작업에 필요한 권한만 있는 전용 키를 사용하는 것이 좋습니다.
• 연결 세부 정보: 일반 S3 엔드포인트 호스트 이름과, ​​공급자가 요구하는 경우 지역 및 경로 형식 요구 사항을 확인하세요. 호스트 이름을 요청하는 곳에 버킷별 URL을 붙여넣지 마세요.
• 네트워크 및 TLS: Nextcloud 서버는 엔드포인트에 연결할 수 있어야 합니다. 제공업체에서 다른 구성을 요구하는 특정하고 문서화된 이유가 없는 한 HTTPS를 사용하십시오.

Nextcloud 35 관리 설명서에는 Amazon S3 및 호환 서비스의 Amazon S3 백엔드에 대한 내용이 나와 있습니다. 제공업체마다 S3 API 동작, 엔드포인트 형식, 서명 지역 및 필요한 권한이 다르므로 해당 값은 제공업체의 설정 페이지를 참조하십시오. 기존 객체가 어떻게 표시되는지 확실하지 않은 경우 새 버킷이나 빈 버킷, 또는 명확하게 격리된 테스트 접두사를 사용하여 시작하십시오.

외부 저장 장치 지원을 활성화합니다.

1. Nextcloud 관리자 계정으로 로그인하고 앱을 엽니다 .
2. Nextcloud에 포함된 외부 저장소 지원 앱을 찾아 비활성화되어 있으면 활성화하십시오. 이 앱은 Nextcloud에 포함되어 있지만 기본적으로 비활성화되어 있습니다.
3. 프로필 메뉴를 열고 설정을 선택한 다음 관리 메뉴에서 외부 저장소를 선택하세요 .

백엔드가 스토리지 드롭다운 메뉴에 나타나지 않으면 앱이 활성화되어 있고 계정에 관리자 권한이 있는지 확인하십시오. 메뉴 레이블은 릴리스에 따라 약간씩 다를 수 있습니다. 설치 버전이 35가 아닌 경우 해당 버전의 Nextcloud 관리 설명서를 참조하십시오.

S3 마운트를 추가하고 구성합니다.

1. 새 스토리지 행에 마운트할 간단한 폴더 이름을 지정하세요 (예: Archive). 이 이름은 Nextcloud에서 사용자에게 표시되는 이름이며, 버킷 이름이나 경로가 아닙니다. 슬래시(/)는 포함하지 마세요.
2. 스토리지 백엔드 드롭다운 메뉴에서 Amazon S3를 선택 하고 인증 방법으로 액세스 키를 선택하세요.
3. 버킷 이름, 액세스 키 ID 및 비밀 액세스 키를 발급받은 그대로 입력하십시오. 복사 및 붙여넣기 과정에서 공백이 추가되지 않도록 주의하십시오. 비밀 키는 암호처럼 취급해야 하며, 공개 티켓, 셸 기록 또는 문서 스크린샷에 저장하지 마십시오.
4. Amazon에서 호스팅하는 스토리지의 경우 버킷의 리전을 입력하세요. Amazon 이외의 서비스를 사용하는 경우 일반 S3 호스트 이름 (버킷 접두사를 제외한 엔드포인트 호스트)을 입력하세요. 공급자가 서명 리전을 특별히 요구하는 경우 리전을 입력하세요. 해당 공급자의 설명서를 참조하여 와 같은 값을 사용하세요 auto.
5. HTTPS의 경우 SSL 사용을 선택한 상태로 유지하십시오 . 서비스 제공업체에서 다른 포트를 지정하지 않는 한 포트는 기본값으로 두십시오.
6. 먼저 기본 가상 호스트 요청 스타일을 사용해 보세요. 공급자가 대신 와 같은 형태의 요청을 요구하는 경우 경로 스타일을 활성화하세요 . 이 설정에 대한 자세한 내용은 공급자의 S3 가이드를 참조하세요.https://endpoint.example/buckethttps://bucket.endpoint.example
7. 공급자가 명시적으로 요구하지 않는 한 레거시(v2) 인증은 비활성화 하십시오 . Nextcloud는 v4를 기본값으로 지정하고 v2는 거의 필요하지 않다고 명시하고 있습니다.
8. '사용 가능 대상' 에서 이 마운트를 볼 수 있는 사용자 또는 그룹만 선택하십시오. 관리자 설정에서 생성된 마운트는 기본적으로 모든 사용자에게 공개되므로 개인 정보나 공유 데이터를 노출하기 전에 접근을 제한해야 합니다.

필수 입력란은 입력이 완료되면 저장됩니다. 녹색 상태 표시기는 Nextcloud가 연결에 성공했음을 의미하고, 노란색 또는 빨간색 표시기는 마운트 유효성 검사에 실패했음을 의미합니다. 오류 상태가 지속되면 상태 아이콘을 클릭하거나 관리자 페이지를 새로고침하여 다시 확인하십시오. Nextcloud는 오류가 발생한 마운트가 최대 10분 동안 사용 불가로 표시될 수 있음을 알려드립니다.

마운트 동작을 신중하게 선택하세요

해당 행의 옵션 메뉴를 열어 마운트 수준 설정을 확인하세요. 공유는 기본적으로 비활성화되어 있으며, 사용자가 이 마운트에서 파일을 공유해야 하는 경우에만 활성화해야 합니다. 또한 참조 데이터에 대해 마운트를 읽기 전용으로 설정하거나, 필요한 경우 미리 보기를 활성화하고, Nextcloud에서 외부 변경 사항을 확인하는 빈도를 선택할 수 있습니다. 이러한 옵션은 Nextcloud 내에서 마운트의 동작 방식에 영향을 미치며, 스토리지 공급자의 버킷 정책은 변경하지 않습니다.

마운트를 추가한다고 해서 공급자 콘솔에서 변경한 내용이 Nextcloud에 즉시 반영된다고 생각하지 마십시오. Nextcloud는 파일 캐시를 유지합니다. Nextcloud 외부에서 파일이 생성, 변경 또는 삭제되면 캐시된 목록은 스캔을 통해 업데이트될 때까지 최신 상태가 아닐 수 있습니다. 공급자 푸시 알림이 없는 S3 및 기타 백엔드의 경우 Nextcloud는 주기적인 스캔을 기록합니다 occ files_external:scan <mount_id>. 해당 ID를 찾으려면 `http:// occ files_external:listlocalhost:10 ...

연결 문제 해결

• 빨간색 또는 노란색 상태: 버킷 이름, 키 페어, 엔드포인트 호스트 이름, 리전/서명 리전 및 서버 측 네트워크 액세스 권한을 다시 확인하십시오. Nextcloud 호스트에서 DNS 및 아웃바운드 HTTPS 액세스가 허용되는지 확인하십시오.
• 서명 또는 권한 오류: 키가 활성화되어 있고 버킷 목록을 확인하고 사용자가 필요한 작업을 수행할 수 있도록 권한이 부여되었는지 확인하십시오. 지역이 공급자의 서명 지침과 일치하는지 확인하십시오. 업로드는 가능하지만 버킷 목록을 확인하거나 검사할 수 없는 자격 증명이라도 Nextcloud의 연결 테스트에 실패할 수 있습니다.
• 엔드포인트 또는 버킷을 찾을 수 없음: 호스트 이름에 버킷이 이미 포함된 URL이 아닌 일반 엔드포인트가 포함되어 있는지 확인하십시오. 공급자에게 경로 형식 요청이 필요한지 문의한 후 해당 옵션을 변경하고 다시 확인하십시오.
• 연결은 되지만 기존 객체가 누락되었습니다. 키에 버킷 목록이 포함되어 있는지, 객체 이름이 지원되는 경로를 사용하는지 확인하십시오. Nextcloud는 쉼표( Photos//cat.png,)와 같은 구분 기호가 반복되는 S3 키는 내용이 무시된다고 경고합니다.
• 제공자에서 직접 변경한 파일이 누락되었습니다. 마운트된 위치에 대한 외부 저장소 검사를 실행하세요. 가능한 한 Nextcloud 내에서 일상적인 이름 변경 및 이동 작업을 수행하세요. 재검사 시 원격 이름 변경이 삭제 후 새 파일 생성으로 인식될 수 있으며, 이로 인해 이전 항목과 연결된 Nextcloud 측 공유, 태그, 댓글 또는 활동 기록이 손실될 수 있습니다.

마운트가 안전한지 확인하십시오.

마운트 상태가 녹색으로 바뀔 때까지 기다립니다. 허용된 사용자 권한으로 파일 탐색기를 열고 마운트 폴더를 엽니다. 고유한 이름의 작은 테스트 파일을 업로드하고 다운로드한 다음 Nextcloud에서 삭제합니다. 가능하다면 공급자 버킷 보기에서 예상되는 객체가 나타나는지 확인합니다. 그룹 액세스가 계획에 포함된 경우에만 두 번째 사용자로 테스트합니다. 마지막으로 선택한 권한 범위 외부의 사용자가 마운트를 볼 수 없는지 확인합니다. 테스트 객체를 제거하고 최소 권한 자격 증명을 보관합니다.

버전별 필드 설명은 Nextcloud 35 Amazon S3 구성 및 Nextcloud 35 외부 스토리지 관리 가이드를 참조하세요 .