배경
전체 서비스의 보안과 안정성을 위해 2024년 1월 1일 이후에 생성된 버킷은 COS 기본 도메인 이름을 사용하여 객체에 액세스할 경우 모든 유형 파일의 미리보기를 지원하지 않고 apk/ipa 유형 파일의 다운로드를 지원하지 않습니다. 자세한 내용은 COS 버킷 도메인 이름 사용 안전 관리 통지를 참고하시기 바랍니다.
2024년 1월 1일 이후에 생성된 버킷의 경우, 브라우저를 통한 파일 미리보기 또는 버킷 내의 apk/ipa 유형 객체 다운로르를 원하시면 사용자 정의 도메인 이름으로 객체에 액세스하시기 바랍니다. 2024년 1월 1일 이전에 생성된 버킷의 경우, 버킷 기본 도메인 이름의 미리보기, 다운로드 동작은 영향을 받지 않지만 더 나은 서비스 안정성을 위해 사용자 정의 도메인 이름을 우선적으로 사용하시기 바랍니다.
이 문서에서는 버킷에 대해 사용자 정의 도메인 이름을 구성하고, 버킷 기본 도메인 이름 액세스에서 사용자 정의 도메인 이름 액세스로 전환하는 방법에 대해 소개합니다.
첫 번째 단계: 도메인 이름 등록과 파일링
먼저, 사용자는 하나의 파일링된 사용자 정의 도메인 이름을 준비해야 합니다.
도메인 이름 등록: 사용자 정의 도메인 이름이 없으면 도메인 이름 등록으로 이동하여 도메인 이름을 구매할 수 있습니다. 도메인 이름 파일링: 당신의 사용자 정의 도메인 이름이 중국 본토 리전의 버킷에 구성하기 위한 것이면 반드시 파일링해야 합니다.
두 번째 단계: 버킷에 대해 사용자 정의 도메인 이름 구성
1. 사용자 정의 도메인 이름을 준비한 다음 COS 콘솔로그인하고, 버킷 리스트에서 구성할 버킷을 선택합니다. 2. 버킷 상세정보 페이지로 이동하여 도메인 이름과 전송 관리 > 사용자 정의 원본 서버 도메인 이름을 선택합니다.
3. 도메인 이름 추가를 클릭하여 도메인 이름 정보를 구성합니다.
도메인 이름: 준비된 사용자 정의 도메인 이름을 입력합니다.
원본 서버 유형: 다음과 같은 몇 가지로 구분됩니다.
기본 원본 서버: 사용자 정의 도메인 이름을 기본 원본 서버로 사용하려면 기본 원본 서버를 선택하십시오.
정적 웹사이트 원본 서버: 사용자 정의 도메인 이름을 정적 웹사이트로 사용하려면 먼저 버킷에 대해 정적 웹사이트 기능을 활성화한 다음 정적 웹사이트 원본 서버를 선택하십시오.
글로벌 가속 원본 서버: 사용자 정의 도메인 이름을 글로벌 가속으로 사용하려면 먼저 버킷에 대해 글로벌 가속 기능을 활성화한 다음 글로벌 가속 원본 서버를 선택하십시오.
4. HTTPS 인증서를 구성합니다. HTTPS 프로토콜을 사용하여 액세스해야 하는 경우 사용자 정의 도메인 이름에 대해 인증서를 구성해야 합니다.
자체 인증서를 사용해야 하는 경우 인증서 내용 및 비밀키 내용을 지정 입력 상자에 붙혀넣어야 합니다.
Tencent Cloud에서 신청한 인증서를 사용하는 경우 직접 팝업창에서 현재 계정에 있는 Tencent Cloud 인증서를 선택할 수 있습니다.
5. 사용자 정의 도메인 이름 구성 완료 후, 후속 도메인 이름 해석을 구성하기 위해 CNAME난의 정보(예: bucket-1250000000.cos.ap-beijing.myqcloud.com)를 기록합니다.
세 번째 단계: 도메인 이름 해석 구성
Tencent Cloud 도메인 이름
도메인 이름 DNS 제공업체가 Tencent Cloud인 경우 DNS 콘솔로 이동하여 CNAME 해석 기록을 구성할 수 있습니다.
1. DNS 콘솔로 이동하여 대응하는 도메인 이름을 찾고 해석 버튼을 클릭합니다. 2. 빠른 해석 추가를 클릭하여 해당 도메인 이름에 하나의 해석 기록을 추가합니다.
3. 팝업창에서 웹사이트 해석을 선택하고, 웹사이트 주소는 **도메인 이름 매핑(CNAME)**을 선택합니다. 두 번째 단계에서 기록독 CNAME 정보, 예를 들어 bucket-1250000000.cos.ap-beijing.myqcloud.com을 입력합니다.
4. 해석 기록은 일정한 시간이 지나야 적용됩니다. dig 명령을 사용하거나 COS 콘솔을 통해 해석이 성공적으로 적용되었는지 여부를 확인할 수 있습니다. 검증 방법은 다음과 같습니다. 명령행 창에 명령: dig mydomain.com
을 입력하여 CNAME 기록이 정확하게 적용되었는지 여부를 확인합니다. (사용 시 mydomain.com
을 사용자 정의 도메인 이름으로 교체하세요)
COS 콘솔에 로그인하여 버킷 사용자 정의 도메인 이름을 확인하며, 도메인 이름의 CNAME이 성공적으로 적용되지 않았으면 해당 알림이 뜨게 됩니다. 타업체 도메인 이름
도메인 이름 DNS 제공업체가 Tencent Cloud 아닌 경우 해당 DNS 서비스로 이동하여 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에서 사용자 정의 도메인 이름으로 전환하는 코드 예는 다음 문서를 참고하시기 바랍니다.
문제 해결에 도움이 되었나요?