배경
전체 서비스의 보안과 안정성을 위해 2024년 1월 1일 이후에 생성된 버킷은 COS 기본 도메인 이름을 사용하여 객체에 액세스할 경우 모든 유형 파일의 미리보기를 지원하지 않고 apk/ipa 유형 파일의 다운로드를 지원하지 않습니다. 자세한 내용은 COS 버킷 도메인 이름 사용 안전 관리 통지를 참고하시기 바랍니다.
2024년 1월 1일 이후에 생성된 버킷의 경우, 브라우저를 통한 파일 미리보기 또는 버킷 내의 apk/ipa 유형 객체 다운로르를 원하시면 사용자 정의 도메인 이름으로 객체에 액세스하시기 바랍니다. 2024년 1월 1일 이전에 생성된 버킷의 경우, 버킷 기본 도메인 이름의 미리보기, 다운로드 동작은 영향을 받지 않지만 더 나은 서비스 안정성을 위해 사용자 정의 도메인 이름을 우선적으로 사용하시기 바랍니다.
이 문서에서는 버킷에 대해 사용자 정의 도메인 이름을 구성하고, 버킷 기본 도메인 이름 액세스에서 사용자 정의 도메인 이름 액세스로 전환하는 방법에 대해 소개합니다.
첫 번째 단계: 도메인 이름 등록과 파일링
먼저, 사용자는 하나의 파일링된 사용자 정의 도메인 이름을 준비해야 합니다.
도메인 이름 등록: 사용자 정의 도메인 이름이 없으면 도메인 이름 등록으로 이동하여 도메인 이름을 구매할 수 있습니다. 도메인 이름 파일링: 당신의 사용자 정의 도메인 이름이 중국 본토 리전의 버킷에 구성하기 위한 것이면 반드시 파일링해야 합니다.
두 번째 단계: 버킷에 대해 사용자 정의 도메인 이름 구성
1. 사용자 정의 도메인 이름을 준비한 다음 COS 콘솔로그인하고, 버킷 리스트에서 구성할 버킷을 선택합니다. 2. 버킷 상세정보 페이지로 이동하여 도메인 이름과 전송 관리 > 사용자 정의 원본 서버 도메인 이름을 선택합니다.
3. 도메인 이름 추가를 클릭하여 도메인 이름 정보를 구성합니다.
도메인 이름: 준비된 사용자 정의 도메인 이름을 입력합니다.
원본 서버 유형: 다음과 같은 몇 가지로 구분됩니다.
기본 원본 서버: 사용자 정의 도메인 이름을 기본 원본 서버로 사용하려면 기본 원본 서버를 선택하십시오.
정적 웹사이트 원본 서버: 사용자 정의 도메인 이름을 정적 웹사이트로 사용하려면 먼저 버킷에 대해 정적 웹사이트 기능을 활성화한 다음 정적 웹사이트 원본 서버를 선택하십시오.
글로벌 가속 원본 서버: 사용자 정의 도메인 이름을 글로벌 가속으로 사용하려면 먼저 버킷에 대해 글로벌 가속 기능을 활성화한 다음 글로벌 가속 원본 서버를 선택하십시오.
주의:
도메인 추가, 온라인 또는 오프라인 조작은 즉시 적용되지 않습니다. 실제 구성에는 일정 시간이 걸리며 일반적으로 30분 후에 적용되며 도메인의 실제 액세스 상태를 기준으로 합니다.
4. HTTPS 인증서를 구성합니다. HTTPS 프로토콜을 사용하여 액세스해야 하는 경우 사용자 정의 도메인 이름에 대해 인증서를 구성해야 합니다.
자체 인증서를 사용해야 하는 경우 인증서 내용 및 비밀키 내용을 지정 입력 상자에 붙혀넣어야 합니다.
Tencent Cloud에서 신청한 인증서를 사용하는 경우 직접 팝업창에서 현재 계정에 있는 Tencent Cloud 인증서를 선택할 수 있습니다.
5. 사용자 정의 도메인 이름 구성 완료 후, 후속 도메인 이름 해석을 구성하기 위해 CNAME난의 정보(예: bucket-1250000000.cos.ap-beijing.myqcloud.com)를 기록합니다.
세 번째 단계: 도메인 이름 해석 구성
해당 DNS 서비스에서 CNAME 레코드를 구성합니다. 주요 작업 단계는 다음과 같습니다.
1. 도메인 추가: 해석할 사용자 정의 오리진 서버 도메인을 입력합니다. 예: www.example.com.
2. 레코드 추가: 사용자 정의 오리진 서버 도메인에 CNAME 레코드 유형의 해석 레코드를 추가합니다. 레코드 값은 CNAME이 가리키는 버킷 기본 오리진 서버 도메인입니다. 예: bucket-1250000000.cos.ap-beijing.myqcloud.com.
3. 해석이 성공했는지 확인합니다. 해석 레코드는 일정 시간이 걸릴 수 있습니다. dig 명령어 또는 COS 콘솔을 통해 해석이 성공했는지 확인할 수 있습니다. 확인 방법은 다음과 같습니다. 명령 프롬프트 창에 명령을 입력합니다. dig mydomain.com. CNAME 레코드가 제대로 작동하는지 확인합니다. (사용 시 mydomain.com을 사용자 정의 도메인으로 바꿉니다.)
COS 콘솔에 로그인하여 버킷 사용자 정의 도메인을 확인합니다. 도메인 이름의 CNAME이 성공적으로 적용되지 않으면 해당 메시지가 표시됩니다. 네 번째 단계: 사용자 정의 도메인 이름 액세스
상기 단계를 거쳐 사용자 정의 도메인 이름의 구성을 완료하였습니다. 아래에서는 사용자 정의 도메인 이름을 사용하여 COS에 액세스하는 방법에 대해 설명합니다.
객체 액세스 링크 확인
1. COS 콘솔에 로그인하여 사용자 정의 도메인 이름이 구성된 버킷을 찾고 클릭하여 파일 목록으로 들어갑니다. 하나의 객체를 선택하고 객체 상세정보로 들어갑니다. 조작 안내는 객체 정보 조회를 참고하시기 바랍니다. 2. 지정된 도메인 이름을 사용자 정의 원본 서버 도메인 이름으로 전환합니다. 아래의 객체 주소, 임시 링크는 사용자 정의 도메인 이름의 링크로 전환됩니다. 공개 읽기 객체에 액세스할 때 객체 주소(서명 없음)를 사용하고 비공개 읽기 객체에 액세스할 때 임시 링크(서명 있음)를 사용할 수 있습니다.
API 액세스를 위한 사용자 정의 도메인 이름 전환
직접 API를 사용하여 COS에 액세스하는 경우 액세스할 때 요청 Host를 사용자 정의 도메인 이름으로 전환하면 됩니다.
GET /\\<0bjectKey> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
SDK 액세스를 위한 사용자 정의 도메인 이름 전환
SDK를 사용하는 경우 Client를 초기화할 때 domain 매개변수를 사용자 정의 도메인 이름으로 설정하면 됩니다. Python SDK로 예를 들면, 코드 예는 다음과 같습니다.
domain = 'user-define.example.com'
config = CosConfig(Region=region, SecretId=secret_id, SecretKey=secret_key, Token=token, Domain=domain, Scheme=scheme)
client = CosS3Client(config)
각 언어의 COS SDK에서 사용자 정의 도메인 이름으로 전환하는 코드 예는 다음 문서를 참고하시기 바랍니다.