릴리스 노트
제품 공지
정적 웹 사이트 설정
기본 개념
정적 웹사이트는 HTML과 같은 정적 콘텐츠 또는 클라이언트 스크립트를 포함하는 웹사이트를 의미합니다. 사용자는 COS 콘솔을 통해 사용자 정의 도메인이 연결된 버킷에 정적 웹사이트를 구성할 수 있습니다.동적 웹 사이트에는 PHP, JSP 또는 ASP.NET과 같은 서버 스크립트가 포함되어 있으며 서버에서 처리되어야 합니다. Tencent Cloud COS(Cloud Object Storage)에서 정적 웹사이트를 호스팅할 수 있지만 서버 스크립트를 작성할 수는 없습니다. 동적 웹 사이트를 배포해야 하는 경우 서버 측 코드 배포에는 Cloud Virtual Machine(CVM) 사용을 권장합니다.
여기에서는 정적 웹사이트 호스팅 기능을 예시로 소개합니다.
사용자가 examplebucket-1250000000라는 이름의 버킷을 생성하여 다음과 같은 파일을 업로드하였습니다.
index.html404.html403.htmltest.htmldocs/a.htmlimages/
정적 웹 사이트
활성화 전: 다음 기본 액세스 도메인으로 버킷에 액세스하여 다운로드 알림을 팝업하면
index.html 파일을 로컬에 저장할 수 있습니다.https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com/index.html
활성화 후: 다음 액세스 노드로 버킷에 액세스하면 브라우저에서
index.html의 페이지 콘텐츠를 조회할 수 있습니다.https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com/index.html
주의:
2024년 1월 1일 이후 생성된 버킷은 COS 기본 도메인(정적 웹사이트 도메인 포함)을 통해 객체에 직접 접근하는 것을 더 이상 지원하지 않습니다. 자세한 내용은 COS 버킷 도메인 사용 보안 관리 공지(2024년 1월 시행) 를 참고하십시오. 사용자 정의 도메인을 통해 객체에 접근할 수 있습니다. 자세한 내용은 사용자 정의 원본 서버 도메인 활성화하기를 참고하십시오.
강제 HTTPS
활성화 전: HTTP로부터 요청이 온 경우 노드 URL에 액세스하여 HTTP의 암호화가 되지 않은 전송 프로토콜을 유지합니다.
https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com/index.html
활성화 후: HTTP나 HTTPS로부터 요청이 온 경우 노드에 액세스하여 HTTPS의 암호화 된 전송 프로토콜을 계속 유지합니다.
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com
인덱스 문서
정적 웹 사이트의 첫 페이지인 인덱스 문서는 사용자가 웹 페이지의 루트 디렉터리 혹은 서브 디렉터리에 요청을 보낼 때 반환되는 웹 페이지로
index.html로 불립니다.
사용자가 버킷 액세스 도메인(예시로 https://examplebucketbucket-1250000000.cos-website.ap-guangzhou.myqcloud.com)으로 정적 웹 사이트에 액세스할 경우 특정 웹 페이지가 요청되지 않으며 웹 서버는 첫 화면을 반환합니다.사용자가 버킷의 루트 디렉터리를 포함한 모든 디렉터리에 접근할 때, URL 주소가
/로 끝나는 경우 해당 디렉터리의 인덱스 문서가 우선적으로 자동으로 일치됩니다. 루트 URL의 /는 선택 사항이며, 다음 URL 중 어느 하나라도 인덱스 문서를 반환합니다.http://www.examplebucket.com/http://www.examplebucket.com
주의：
버킷에 폴더가 생성되면 폴더의 각 레벨에 인덱스 파일을 추가해야 합니다.
오류 문서
오류 문서를 설정하기 전이라고 가정한 후 아래 페이지에 액세스하면 404 상태 코드가 반환되며 페이지에 기본 오류 페이지 정보가 보입니다.
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com/webpage.html
오류 문서를 설정한 후 아래 페이지에 액세스하면 똑같이 404 상태 코드가 반환되지만 페이지에 특정 오류 페이지 정보가 보입니다.
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com/webpage.html
리디렉션 규칙
설명：
호스팅된 정적 웹사이트에 대해 리디렉션 규칙을 구성할 때, 대체 문서 경로는 반드시 버킷 내 객체 경로여야 합니다.
리디렉션 규칙 우선순위는 강제 HTTPS 또는 접두사 일치 리디렉션이 먼저 트리거되고, 마지막으로 오류 코드 이동이 트리거됩니다.
에러 코드 리디렉션 설정하기
webpage.html 문서로 개인 읽기/쓰기 공개 액세스 권한을 설정하고 사용자가 이 문서에 액세스할 경우 403 오류가 반환됩니다.
403 에러 코드가 403.html에 리디렉션되면 브라우저는 403.html 콘텐츠를 반환합니다.
403.html 문서를 설정하지 않으면 브라우저는 오류 문서 혹은 기본 오류 정보를 반환합니다.
접두사 매칭 설정
주의：
접두사 매칭은 와일드카드를 지원하지 않습니다. 접두사가 index1/ 및 index2/인 두 폴더를 리디렉션하려면
index*/를 매칭 규칙으로 사용할 수 없으며 각각 해당하는 매칭 규칙을 생성해야 합니다.docs/ 폴더를 documents/로 이름을 변경한 후 사용자가 docs/ 폴더에 접근할 때 오류가 발생하므로 docs/ 접두사 요청을 documents/로 리디렉션할 수 있습니다.
images/ 폴더를 삭제한 경우(즉, images/ 접두사를 가진 모든 객체를 삭제한 경우), images/ 접두사를 가진 모든 객체 요청을 test.html 페이지로 리디렉션하는 규칙을 추가할 수 있습니다. 
작업 시나리오
COS 콘솔을 통해 버킷을 호스팅 정적 웹사이트으로 설정하고, 버킷의 정적 웹사이트 도메인을 통해 정적 웹사이트에 접근할 수 있습니다.
주의 사항
정적 웹사이트가 비공개인 경우, 버킷의 접근 권한을 비공개 읽기/쓰기로 설정하고 CDN Origin-pull 인증 및 CDN 인증 방식을 통해 데이터의 전 과정 보호를 구현하는 것이 좋습니다. 자세한 내용은 CDN 가속 구성을 참고하십시오.
정적 웹사이트를 모든 사람이 접근할 수 있도록 하려면 버킷의 접근 권한을 공개 읽기/비공개 쓰기로 설정할 수 있습니다. 단, 리소스가 도용될 가능성이 있으므로 구성 시 주의하시길 바랍니다. 도용 위험을 줄이기 위해 도용 방지 가이드를 참고할 수 있습니다.
정적 웹사이트 구성을 활성화하고 사용자 정의 도메인을 설정한 후에는 COS 원본 서버에 접근하기 위해 사용자 정의 도메인을 사용해야 합니다. COS 기본 도메인으로 접근하면 정적 웹사이트 효과가 나타나지 않습니다(예: 레이아웃 효과가 정상적으로 표시되지 않음).
전제 조건
작업 절차
정적 웹사이트 활성화
1. COS 콘솔에 로그인합니다.
2. 왼쪽 네비게이션 바에서 버킷 목록을 클릭하여 버킷 목록 페이지로 이동합니다.
3. 정적 웹사이트 호스팅에 사용할 버킷을 찾아 해당 버킷 이름을 클릭하여 버킷 상세 페이지로 이동합니다.
4. 왼쪽 네비게이션 바에서 권한 관리 > 버킷 접근 권한을 선택하고, 공개 권한란에서 공개 읽기/비공개 쓰기를 선택한 후 저장합니다.
5. 왼쪽 네비게이션 바에서 기본 구성 > 정적 웹사이트를 선택하고, 정적 웹사이트란에서 편집을 클릭한 후 현재 상태의 활성화 버튼을 켭니다.
6. 정적 웹사이트 구성 항목을 순서대로 입력합니다.
구성 설명은 다음과 같습니다.
접근 노드: 정적 웹사이트를 활성화하면 해당 버킷과 연결된 정적 웹사이트 접근 노드(정적 웹사이트 도메인)를 얻게 됩니다. 이 접근 노드는 GET/HEAD Object 작업만 지원합니다.
주의:
정적 웹사이트의 접근 노드는 영문 대소문자를 구분합니다. 인덱스 파일, 오류 파일, 리디렉션 규칙 접두사 일치를 구성할 때 입력한 파일 이름과 확장자의 영문 대소문자가 버킷의 파일과 일치해야 함에 유의하십시오.
강제 HTTPS(선택 사항): 강제 HTTPS를 활성화하면 사용자가 정적 웹사이트에 접근할 때 정적 웹사이트 접근 노드가 HTTPS 프로토콜 방식으로 강제로 열립니다.
주의:
사용자 정의 도메인을 통해 정적 웹사이트에 접근하고 정적 웹사이트에서 강제 HTTPS가 활성화된 경우 해당 사용자 정의 도메인에 관련 인증서가 올바르게 구성되었는지 확인하십시오. 인증서에 이상이 있으면 기본 도메인으로 리디렉션되어 접근됩니다.
html 확장자 무시(선택 사항): 접근 경로가 index인 경우 index.html 객체를 자동으로 일치시켜 반환합니다.
인덱스 문서(필수): 인덱스 문서는 정적 웹사이트의 홈페이지로, 사용자가 웹사이트의 루트 디렉터리 또는 하위 디렉터리에 요청을 보낼 때 반환되는 웹페이지입니다. 일반적으로 이 페이지는 index.html로 명명됩니다.
주의:
버킷에 폴더가 생성되고 웹페이지가 해당 폴더를 참조하는 경우, 이러한 폴더 계층 구조 모두에 인덱스 문서를 추가해야 합니다.
2024년 1월 1일 이후 생성된 버킷의 경우 정적 웹사이트 도메인으로 접근할 때 인덱스 문서가 요청 시 웹 콘텐츠를 직접 반환하지 않고 다운로드됩니다.
오류 문서(선택): 오류 문서는 정적 웹사이트 접근 시 오류가 발생한 후 반환되는 페이지입니다. 이 구성 항목을 통해 사용자가 직접 오류 문서를 정의할 수 있습니다. 정적 웹사이트가 사용자의 요청에 응답할 수 없을 때 지정된 사용자 정의 오류 페이지가 반환됩니다. 예를 들어 error.html이라는 이름의 오류 문서를 구성한 경우, 사용자가 접근 시 HTTP 오류가 발생하면 error.html 페이지가 반환되어 도움말 안내를 제공합니다. 오류 문서를 구성하지 않은 경우, 사용자가 접근 시 HTTP 오류가 발생하면 기본 오류 메시지가 반환됩니다.
주의:
오류 문서 구성은 버킷 루트 디렉터리 또는 하위 디렉터리의 파일을 지원하며, 브라우저에서 인식할 수 있는
.html 또는 .htm 형식의 파일을 사용하십시오. 브라우저에서 인식할 수 없는 .zip과 같은 형식을 사용할 경우 대부분의 브라우저에서 오류가 발생하거나 접근이 거부될 수 있습니다.오류 문서 응답 코드: 오류 문서가 설정된 경우 해당 항목이 표시됩니다. 오류 문서 반환 시 HTTP 응답 코드를 원본 오류 코드 또는 200으로 구성할 수 있습니다.
리디렉션 규칙(선택): 리디렉션 규칙을 사용하면 특정 파일 경로, 요청의 접두사 또는 응답 코드에 따라 조건부로 요청을 리디렉션할 수 있습니다.
예를 들어, 버킷에서 특정 파일을 삭제하거나 이름을 변경한 경우 해당 파일에 대한 접근 요청을 다른 파일로 리디렉션하도록 리디렉션 규칙을 추가할 수 있습니다.
유형: 리디렉션 규칙의 원본 유형을 의미합니다.
오류 코드: 현재 리디렉션 규칙은
4xx 오류 코드(예: 404)에 대한 리디렉션 구성만 지원합니다. 특정 오류 페이지를 사용자 정의할 수 있으며, 사용자가 해당 HTTP 오류를 트리거하는 경우 해당 오류 페이지에서 사용자에게 다른 안내를 제공할 수 있습니다.접두사 일치: 버킷 내 파일 또는 폴더에 대한 리디렉션 설정을 위해 접두사 일치 규칙을 사용할 수 있습니다. 구체적인 예시는 리디렉션 규칙 예시를 참고하십시오.
주의:
접두사 일치는 와일드카드를 지원하지 않습니다. 접두사가 index1/, index2/인 두 폴더에 대해 리디렉션을 원하는 경우
index*/를 일치 규칙으로 사용할 수 없으며, 각각에 해당하는 일치 규칙을 설정해야 합니다.설명: 리디렉션 규칙의 원본 오류 코드 또는 접두사.
규칙: 리디렉션 규칙의 대체 규칙으로, 대체 경로 및 대체 접두사를 포함합니다.
유형을 오류 코드로 선택한 경우, 규칙은 기본적으로 '대체 경로'로 설정됩니다. 대체 경로는 해당 리디렉션 규칙이 트리거된 후 원본 요청 주소가 새 페이지의 경로로 대체되는 것을 의미합니다.
유형을 접두사로 선택한 경우, 규칙은 '대체 경로' 또는 '대체 접두사'를 선택할 수 있습니다.
주의:
대체 경로는 버킷 내 객체 경로여야 합니다.
대체 내용: 대체될 파일 경로 또는 접두사.
7. 설정 완료 후 저장을 클릭하면 됩니다.
사용자 정의 도메인 설정
2024년 1월 1일 이후 생성된 버킷의 경우, 사용자가 기본 도메인(정적 웹사이트 도메인 포함)으로 파일에 접근하면 미리보기가 지원되지 않습니다. 따라서 정적 웹사이트 활성화한 후 정적 웹사이트를 미리 보려면 사용자 정의 도메인을 구성하고 사용해야 합니다. 작업 단계는 다음과 같습니다.
1. COS 콘솔에 로그인하여 버킷 상세 페이지로 이동한 후 도메인 및 전송 관리 > 사용자 정의 원본 서버 도메인을 선택합니다.
2. 사용자 정의 원본 서버 도메인 영역에서 도메인 추가를 클릭하고 사용자 정의 도메인을 입력합니다(없는 경우 도메인을 등록한 후 입력). 원본 서버 유형은 정적 웹사이트 원본 서버를 선택합니다. 구성 항목에 대한 자세한 내용은 사용자 정의 원본 서버 도메인 활성화하기를 참고하십시오.
3. 사용자 정의 도메인이 적용되도록 정적 웹사이트 CNAME 도메인으로 사용자 정의 도메인 해석도 설정해야 합니다. HTTPS로 접근하려면 HTTPS 인증서를 바인딩해야 합니다. 자세한 내용은 도메인 해석 구성 및 인증서 바인딩을 참고하십시오.
피드백