QuObject 튜토리얼

QuObjects는 사용자가 Amazon S3 또는 OpenStack Swift 개체 스토리지 프로토콜을 통해 QNAP NAS의 데이터에 원격으로 액세스할 수 있게 해주는 QNAP 애플리케이션입니다.

QuObjects를 통해 NAS의 공유 폴더, 하위 폴더 및 파일에 원격으로 액세스하여 각각 스토리지 공간, 버킷 및 개체로 관리할 수 있습니다. 데이터 전송, API 콜 개수를 포함하여 다양한 통계를 모니터링하기 위한 동적 대시보드를 탑재한 QuObjects는 서비스를 독립형 서버 또는 가상 호스트 웹 서버로 구성하고, 다양한 사용자 및 프로젝트에 대한 여러 보안 자격 증명을 생성할 수 있도록 지원합니다.

요구 사항	세부 정보
NAS 모델	모든 x86 기반 QNAP NAS 모델 다음의 64비트 ARM QNAP NAS 모델: TS-x32 시리즈 TS-1635AX
운영 체제	QTS 5.0.0(이상) QuTS hero h5.0.0(이상) 참고: QuTS hero는 QuObjects 2.3(이전)에서만 지원됩니다. QuTScloud c5.0.0(이상)

관리자로 NAS에 로그인합니다.
App Center를 연 다음 를 클릭합니다.

검색 상자가 나타납니다.
QuObjects를 입력합니다.

검색 결과에 QuObjects 애플리케이션이 나타납니다.
설치를 클릭합니다.

확인 창이 나타납니다.
확인을 클릭합니다.

시스템이 QuObjects를 설치합니다.

데이터 전송을 활성화하려면 서버 연결에서 을 클릭해야 합니다.

QuObjects를 독립형 서버 또는 가상 호스트 웹 서버로 구성할 수 있습니다.

QuObjects를 엽니다.
서버 설정으로 이동합니다.

서버 유형을 선택합니다.

서버 종류	설명
독립형 서버	QuObjects를 시스템에서 독립형 서버로 실행합니다. 다음 설정을 구성합니다. 포트 번호: 포트 번호를 지정합니다. 참고: 기본 포트 번호는 8010입니다. 연결 유형: HTTP 또는 HTTPS를 선택합니다.
가상 호스트 웹 서버	QuObjects 스토리지 서비스를 시스템의 웹 서버와 통합합니다. 중요: 이 설정을 적용하려면 제어판 > 애플리케이션 > 웹 서버에서 웹 서버를 활성화해야 합니다. 자세한 내용은 QNAP 운영 체제의 사용 설명서를 참조하십시오. 다음 설정을 구성합니다. 호스트 이름: 가상 호스트 웹 서버의 고유 이름을 입력합니다.

서버 종류

설명

독립형 서버

QuObjects를 시스템에서 독립형 서버로 실행합니다.

다음 설정을 구성합니다.

포트 번호: 포트 번호를 지정합니다.

참고:
기본 포트 번호는 8010입니다.
연결 유형: HTTP 또는 HTTPS를 선택합니다.

가상 호스트 웹 서버

QuObjects 스토리지 서비스를 시스템의 웹 서버와 통합합니다.

중요:

이 설정을 적용하려면 제어판 > 애플리케이션 > 웹 서버에서 웹 서버를 활성화해야 합니다.

자세한 내용은 QNAP 운영 체제의 사용 설명서를 참조하십시오.

다음 설정을 구성합니다.

호스트 이름: 가상 호스트 웹 서버의 고유 이름을 입력합니다.

적용을 클릭합니다.

QuObjects가 설정을 저장하고 Amazon S3 및 OpenStack 서비스 엔드포인트 URL을 업데이트합니다.

QuObjects에서는 NAS 사용자와 도메인 사용자를 추가할 수 있으며, 따라서 각 사용자에 대한 액세스 키를 생성할 수 있습니다.

액세스 키를 사용하면 애플리케이션이 사용자 대신 QuObjects를 통해 NAS 데이터에 자동으로 액세스할 수 있으며, 보다 안전한 로그인 자격 증명을 제공합니다. 각 사용자가 서로 다른 프로젝트에 액세스하여 관리할 수 있도록 여러 개의 액세스 키를 만들 수 있습니다.

사용자 및 액세스 키를 추가하면 사용자가 QuObjects를 통해 NAS의 데이터에 액세스할 수 있습니다.

QuObjects를 엽니다.
사용자 관리로 이동합니다.
사용자 추가를 클릭합니다.

권한 있는 사용자 추가 창이 나타납니다.
로컬 사용자 또는 도메인 사용자를 선택합니다.

로컬 NAS 사용자 또는 도메인 사용자 목록이 나타납니다.
하나 이상의 사용자를 선택합니다.
추가를 클릭합니다.

QuObjects가 선택한 사용자를 추가합니다.

사용자의 액세스 키를 추가하려면 사용자의 액세스 키 추가를 참조하십시오.

사용자를 제거하면 QuObjects를 통해 NAS의 데이터에 대한 액세스가 중지됩니다.

중요:

사용자가 운영 체제에서 삭제된 경우, QuObjects에서 제거될 때까지 사용자 및 해당 액세스 키가 유효한 상태로 유지됩니다.

QuObjects를 엽니다.
사용자 관리로 이동합니다.
하나 이상의 사용자를 선택합니다.
제거를 클릭합니다.

QuObjects가 선택한 사용자를 제거합니다.

액세스 키는 사용자를 대신해 원격으로 데이터에 액세스하기 위해 애플리케이션에서 사용됩니다. 사용자의 로그인 자격 증명을 요구하는 대신, 무작위로 생성된 매우 긴 일련의 문자 두 개(즉, 공개 키와 개인 키)가 암호화 및 암호 해독에 사용됩니다. 이들 키는 악의를 가진 공격자들이 추측하기 어렵고 사용자 암호보다 더 안전합니다.

QuObjects에서 각 사용자에 대해 여러 개의 액세스 키를 만들고 각 스토리지 공간 또는 프로젝트에 별도의 키를 할당할 수 있습니다. 액세스 키가 손상된 경우, 다른 스토리지 공간 또는 프로젝트에 영향을 주지 않으면서 키를 삭제할 수 있습니다. QNAP는 주기적으로 오래된 액세스 키를 교체할 것을 권장합니다.

QuObjects를 엽니다.
사용자 관리로 이동합니다.
사용자를 식별합니다.
를 클릭합니다.

QuObjects가 사용자의 액세스 키를 생성합니다.

액세스 키를 관리하려면 액세스 키 관리를 참조하십시오.

액세스 키 세부 정보를 보거나 액세스 키를 삭제할 수 있습니다.

QuObjects를 엽니다.
사용자 관리로 이동합니다.
사용자를 식별합니다.
를 클릭합니다.

QuObjects가 관련 액세스 키를 표시합니다.
액세스 키를 식별합니다.

다음 작업 중 하나를 수행하십시오.

작업	사용자 동작
Secret Key /API 키 숨기기 취소	Secret Key/API 키 숨기기를 취소하려면 을 클릭합니다.
Secret Key /API 키 숨기기	Secret Key/API 키를 숨기려면 을 클릭합니다.
액세스 키 세부 정보 보기	Amazon S3 및 OpenStack Swift 프로토콜에 대한 액세스 키 생성일, 서비스 엔드포인트, 액세스 키 세부 정보를 보려면 을 클릭합니다.
액세스 키 삭제	액세스 키를 삭제하려면 을 클릭합니다.

QuObjects가 작업을 수행합니다.

QuObjects에서는 QNAP 운영 체제의 공유 폴더를 스토리지 공간으로서 원격으로 액세스할 수 있습니다. QuObjects에서 스토리지 공간으로 나열된 시스템상의 최다 공유 폴더를 찾을 수 있습니다. QuObjects에서 스토리지 공간을 만들거나 삭제할 때 해당하는 작업이 시스템상의 공유 폴더에도 적용됩니다.

QuObjects를 엽니다.
스토리지 공간으로 이동합니다.
만들기를 클릭합니다.

스토리지 공간 만들기 창이 나타납니다.
폴더 이름을 지정합니다.

중요:
OpenStack Swift에 대해 CloudBerry를 사용할 경우, 폴더 이름에 공백을 포함시키면 예기치 않은 오류가 발생할 수 있습니다.
스토리지 공간을 저장할 볼륨을 선택합니다.
자동 새로 고침 사용 옆에서 자동 새로 고침 빈도를 선택합니다.
스토리지 공간에 대한 액세스 권한을 부여할 사용자를 한 명 이상 선택합니다.
만들기를 클릭합니다.

QuObjects가 스토리지 공간을 생성합니다.

QuObjects를 엽니다.
스토리지 공간으로 이동합니다.
스토리지 공간을 식별합니다.
을 클릭하고 편집을 선택합니다.

스토리지 공간 편집 창이 나타납니다.
스토리지 공간 권한에서 액세스 권한을 부여할 사용자를 한 명 이상 선택합니다.
적용을 클릭합니다.

QuObjects가 액세스 권한 설정을 적용합니다.

QuObjects를 엽니다.
스토리지 공간으로 이동합니다.
스토리지 공간을 식별합니다.

다음 작업 중 하나를 수행하십시오.

작업	사용자 동작
편집	을 클릭하고 편집을 선택합니다.
삭제	을 클릭하고 제거를 선택합니다. 참고: 일부 기본 시스템 폴더는 삭제할 수 없습니다.
File Station에서 열기	을 클릭하고 File Station으로 이동을 선택합니다.
새로고침	를 클릭합니다.

QuObjects가 작업을 수행합니다.

QuObjects에서 스토리지 공간의 버킷은 QNAP 운영 체제에 있는 공유 폴더에서 최상위 레벨 폴더입니다.

버킷 화면에서 스토리지 공간에 버킷을 추가하고 관리할 수 있습니다.

또한 개체 탐색기 화면의 어느 버킷에서나 개체 및 개체 버전을 보고 관리할 수 있습니다.

QuObjects를 엽니다.
버킷으로 이동합니다.
스토리지 공간을 선택합니다.
만들기를 클릭합니다.

버킷 만들기 창이 열립니다.
버킷 이름을 지정합니다.

권한 설정을 구성합니다.

옵션	설명
개인	사용자가 버킷 및 해당 개체에 액세스하려면 서명한 URL을 사용해야 합니다.
공용	어떤 사용자든 익명으로 버킷과 해당 개체에 액세스할 수 있습니다.

선택 사항: 버저닝 활성화.

버저닝을 이용하면 동일 버킷에 여러 개의 개체 버전을 보관할 수 있습니다.
1. 선택 사항: 각 버전을 유지할 일수를 선택하고 지정합니다.
2. 선택 사항: 유지할 일수를 선택하고 지정합니다.

선택 사항: 개체 잠금 활성화.

참고:

개체 잠금을 통해 WORM(Write Once Ready Many) 모델을 사용하여 개체를 저장할 수 있고, 이를 통해 지정된 시간 동안 개체의 삭제 또는 덮어쓰기를 방지할 수 있습니다.
개체 잠금이 활성화되면 버저닝이 자동으로 활성화됩니다.

보관 활성화.

보관은 버킷에 추가된 새로운 개체가 삭제되거나 덮어쓰지 않도록 보호합니다.

보관 모드를 선택합니다.

보관 모드	설명
거버넌스	특정 권한을 가진 사용자(예: 관리자)는 보관 기간 중 보호된 개체를 삭제하거나 덮어쓸 수 있습니다.
규정 준수	보관 기간 중 사용자가 보호된 개체를 삭제하거나 덮어쓸 수 없습니다.

개체를 보관할 일수를 선택합니다.

만들기를 클릭합니다.

QuObjects가 버킷을 생성합니다.

QuObjects를 엽니다.
버킷으로 이동합니다.
스토리지 공간을 선택합니다.
버킷을 식별합니다.

다음 작업 중 하나를 수행하십시오.

작업	사용자 동작
편집	을 클릭하고 편집을 선택합니다.
삭제	을 클릭하고 제거를 선택합니다.
File Station에서 열기	을 클릭하고 File Station으로 이동을 선택합니다.
새로고침	를 클릭합니다.

QuObjects가 작업을 수행합니다.

개체 탐색기 화면에서 버킷에 있는 모든 개체 및 개체 버전을 보고 관리할 수 있습니다.

QuObjects를 엽니다.
개체 탐색기로 이동합니다.
스토리지 공간을 선택합니다.
버킷 선택.
선택 사항: 폴더를 클릭하여 폴더 내의 파일을 확인합니다.

팁:
상위 폴더로 되돌아가려면 목록 위의 폴더 경로에서 상위 폴더를 클릭하십시오.
하나 이상의 파일 또는 파일 버전을 선택합니다.

다음 작업 중 하나를 수행하십시오.

작업	사용자 동작
삭제	버킷 및 스토리지 공간에서 선택한 파일 또는 파일 버전을 삭제하려면 삭제를 클릭합니다.
다운로드	선택한 파일 또는 파일 버전으로 컴퓨터에 다운로드하려면 다운로드를 클릭합니다.

QuObjects가 작업을 수행합니다.

CloudBerry Explorer는 MSP360에서 개발한 애플리케이션으로, 사용자가 로컬 스토리지 및 클라우드 스토리지 전체에서 데이터를 액세스, 관리 및 이동할 수 있도록 허용합니다. 컴퓨터에서 CloudBerry Explorer를 사용하여 NAS에서 QuObjects 내의 스토리지 공간과 개체를 관리할 수 있습니다.

CloudBerry Explorer는 Windows 및 macOS용으로 사용할 수 있습니다. 제품 및 설치 정보에 대해서는 https://www.msp360.com/explorer/를 참조하십시오.

CloudBerry Explorer에서 QuObjects 스토리지 공간에 액세스하려면 계정을 만들어야 합니다. CloudBerry Explorer 내의 각 계정은 QuObjects의 단일 스토리지 공간에만 액세스할 수 있습니다.

액세스할 스토리지 공간을 식별합니다.
Amazon S3 액세스 키 세부 정보를 획득합니다.
1. NAS에서 QuObjects를 엽니다.
2. 사용자 관리로 이동합니다.
3. 스토리지 공간에 액세스할 수 있는 권한을 가진 사용자를 식별합니다.
  
  자세한 내용은 스토리지 공간 액세스 권한 구성을 참조하십시오.
4. 를 클릭합니다.
  
  QuObjects가 사용자에 속하는 모든 액세스 키를 표시합니다.
5. 사용할 액세스 키를 식별합니다.
  
  액세스 키를 추가하려면 사용자의 액세스 키 추가를 참조하십시오.
6. 를 클릭합니다.
  
  키 세부 정보 창이 열립니다.
7. Amazon S3에서 서비스 엔드포인트, 액세스 키 및 Secret Key를 적어 둡니다.
  
  중요:
  나중에 CloudBerry Explorer에 이 정보를 입력해야 합니다.
  
  팁:
  항목을 클릭보드로 복사하려면 커서를 항목 위로 가져가서 을 클릭하십시오.
컴퓨터에서 CloudBerry Explorer를 엽니다.
파일 > 새 계정 추가로 이동합니다.

클라우드 스토리지 선택 창이 열립니다.
S3 호환을 두 번 클릭합니다.

새로운 S3 호환 스토리지 계정 추가 창이 열립니다.
계정 세부 정보를 입력합니다.
1. 계정의 표시 이름을 지정합니다.
2. 서비스 엔드포인트 옆에서 이전에 획득한 서비스 엔드포인트를 입력합니다.
  
  참고:
  QuObjects를 가상 호스트 웹 서버로 구성한 경우, DNS를 구성하거나 컴퓨터의 호스트 파일을 수정하여 가상 호스트 이름을 NAS의 IP 주소에 매핑해야 합니다.
3. 이전에 획득한 액세스 키를 입력합니다.
  
  참고:
  액세스 키의 시작 부분에 있는(콜론 앞) 를 스토리지 공간의 이름으로 바꿉니다.
  
  아래 스크린샷 예시에서 스토리지 공간 이름은 cloudberry입니다.
4. 이전에 획득한 Secret Key를 입력합니다.
계정 설정을 구성합니다.
1. 선택 사항: SSL 사용을 선택합니다.
  
  참고:
  이 설정을 활성화하면 NAS가 자체 서명 인증서를 사용할 때 나중에 경고 메시지가 나타납니다.
2. 선택 사항: 기본 멀티 파트 업로드 사용을 선택합니다.
3. 서명 버전을 선택합니다.
연결 테스트를 클릭하여 설정을 확인합니다.
확인을 클릭합니다.

CloudBerry Explorer가 계정을 추가합니다.

이제 CloudBerry Explorer의 계정을 통해 스토리지 공간에 액세스할 수 있습니다.

CloudBerry Explorer에서 QuObjects 스토리지 공간에 액세스하려면 계정을 만들어야 합니다. CloudBerry Explorer 내의 각 계정은 QuObjects의 단일 스토리지 공간에만 액세스할 수 있습니다.

액세스할 스토리지 공간을 식별합니다.
OpenStack Swift 액세스 키 세부 정보를 획득합니다.
1. NAS에서 QuObjects를 엽니다.
2. 사용자 관리로 이동합니다.
3. 스토리지 공간에 액세스할 수 있는 권한을 가진 사용자를 식별합니다.
  
  자세한 내용은 스토리지 공간 액세스 권한 구성을 참조하십시오.
4. 를 클릭합니다.
  
  QuObjects가 사용자에 속하는 모든 액세스 키를 표시합니다.
5. 사용할 액세스 키를 식별합니다.
  
  액세스 키를 추가하려면 사용자의 액세스 키 추가를 참조하십시오.
6. 를 클릭합니다.
  
  키 세부 정보 창이 열립니다.
7. OpenStack Swift에서 서비스 엔드포인트, 사용자 이름 및 API 키를 적어 둡니다.
  
  중요:
  나중에 CloudBerry Explorer에 이 정보를 입력해야 합니다.
  
  팁:
  항목을 클릭보드로 복사하려면 커서를 항목 위로 가져가서 을 클릭하십시오.
컴퓨터에서 CloudBerry Explorer를 엽니다.
파일 > 새 계정 추가로 이동합니다.

클라우드 스토리지 선택 창이 열립니다.
OpenStack을 두 번 클릭합니다.

새로운 OpenStack 스토리지 계정 추가 창이 열립니다.
계정 세부 정보를 입력합니다.
1. 계정의 표시 이름을 지정합니다.
2. 이전에 획득한 사용자 이름을 입력합니다.
  
  참고:
  사용자 이름의 시작 부분에 있는(콜론 앞) 를 스토리지 공간의 이름으로 바꿉니다.
  
  아래 스크린샷 예시에서 스토리지 공간 이름은 cloudberry입니다.
3. 이전에 획득한 API 키를 입력합니다.
4. 인증 서비스 옆에서 이전에 획득한 서비스 엔드포인트를 입력합니다.
  
  참고:
  QuObjects를 가상 호스트 웹 서버로 구성한 경우, DNS를 구성하거나 컴퓨터의 호스트 파일을 수정하여 가상 호스트 이름을 NAS의 IP 주소에 매핑해야 합니다.
계정 설정을 구성합니다.
1. 키스톤 버전을 선택합니다.
  
  참고:
  NAS가 자체 서명 인증서를 사용할 경우, 사용 안 함을 선택해야 합니다.
2. 선택 사항: 내부 URLS 사용을 선택합니다.
연결 테스트를 클릭하여 설정을 확인합니다.
확인을 클릭합니다.

CloudBerry Explorer가 계정을 추가합니다.

이제 CloudBerry Explorer의 계정을 통해 스토리지 공간에 액세스할 수 있습니다.

QuObjects는 Amazon S3 및 OpenStack Swift API의 기본 기능을 지원합니다. 그러나 API는 순수 개체 스토리지용으로 설계된 반면, QuObjects는 개체 기반 및 파일 기반 데이터 액세스 모드를 위한 통합 지원을 갖추어 고안되었습니다. 따라서 QuObjects와 함께 사용할 때 API의 동작이 예상과는 약간 다를 수 있습니다. QNAP는 프로덕션 서비스에서 QuObjects를 사용하기 전에 테스트를 실시할 것을 권장합니다.

QuObjects는 버킷, 개체, 멀티 파트 업로드 동작에 대해 경로-스타일 및 가상 호스트 스타일 Amazon S3 API 모두를 지원합니다. API 제한이 끝에 나열되어 있습니다.

표 1. 지원되는 Amazon S3 API
유형	지원되는 API
버킷 API	DeleteBucket GetLocation GetService(모든 버킷 나열) HeadBucket ListObjects PutBucket 교차 출처 리소스 공유(CORS)
개체 API	BulkDelete CopyObject DeleteObject GetObject HeadObject PutObject 미리 서명된 URL
멀티 파트 업로드 API	CompleteMultipartUpload InitiateMultipartUpload ListParts ListUploads UploadPart

표 2. Amazon S3 API 제한
제한	사양
최대 버킷 수	제한 없음
버킷당 최대 개체 수	제한 없음
최대 개체 크기	QTS: 16 TiB QuTS hero: 48.8 TiB
최소 개체 크기	0 B
PUT 작업당 최대 개체 크기	1 TiB
업로드당 최대 파트 수	10000
부분 크기	5 MiB ~ 5 GiB. 마지막 파트는 0 B ~ 5 GiB가 될 수 있음
목록 파트 요청당 반환되는 최대 파트 수	10000
목록 개체 요청당 반환되는 최대 개체 수	10000
목록 멀티 파트 업로드 요청당 반환되는 최대 멀티 파트 업로드 수	1000

QuObjects는 계정, 컨테이너, 개체 및 엔드포인트 동작에 대해 OpenStack Swift API를 지원합니다. API 제한이 끝에 나열되어 있습니다.

표 1. 지원되는 OpenStack Swift API
유형	지원되는 API
계정 API	계정 세부 정보 표시 및 컨테이너 나열 계정 메타데이터 생성, 업데이트 또는 삭제 계정 메타데이터 표시
컨테이너 API	컨테이너 생성 컨테이너 메타데이터 생성, 업데이트 또는 삭제 컨테이너 메타데이터 표시 컨테이너 삭제
개체 API	개체 콘텐츠 및 메타데이터 가져오기 개체 생성 또는 교체 개체 복사 개체 삭제 일괄 개체 삭제 개체 메타데이터 표시 개체 메타데이터 생성 또는 업데이트
엔드포인트 API	엔드포인트 나열 컨테이너 액세스 제어 목록(ACL)

표 2. OpenStack Swift API 제한
제한	사양
최대 버킷 수	제한 없음
버킷당 최대 개체 수	제한 없음
최대 개체 크기	1 TiB
최소 개체 크기	0 B
PUT 작업당 최대 개체 크기	1 TiB

QuObjects를 엽니다.
> 디버그 로그로 이동합니다.

디버그 로그 창이 열립니다.

다음 작업 중 하나를 수행하십시오.

작업	사용자 동작
API 로그 포함	디버그 로그에 Amazon S3 및 OpenStack Swift API 로그를 포함시키려면 을 클릭합니다.
API 로그 제외	디버그 로그에 Amazon S3 및 OpenStack Swift API 로그를 제외하려면 을 클릭합니다.
디버그 로그 다운로드	디버그 로그를 컴퓨터에 다운로드하려면 디버그 로그 다운로드를 클릭합니다.