프로젝트에 커스텀 도메인 추가하기

Every Orbit project serves on a free kaps.run address, and you can attach your own domains alongside it with an SSL certificate provisioned automatically. This guide covers adding a domain, the DNS…

궤도 프로젝트에 사용자 정의 도메인 추가하기

모든 Orbit 프로젝트는 무료 kaps.run 주소에서 제공되며, SSL 인증서가 자동으로 프로비저닝되어 자신의 도메인을 함께 연결할 수 있습니다. 이 가이드에서는 도메인 추가, 필요한 DNS 레코드, 확인 상태 읽기, 기본 도메인 선택 및 도메인이 멈춘 상태일 때 확인할 사항을 다룹니다.

시작하기 전에

최소 하나의 성공적인 배포를 거친 Orbit 프로젝트, DNS를 제어할 수 있는 도메인, 사용자 정의 도메인이 포함된 요금제가 필요합니다. 사용자 정의 도메인은 Liftoff 및 Apex에 포함되어 있으며, 무료 Launch 요금제에는 포함되지 않습니다. Orbit 요금제 제한을 참조하세요.

1단계: Orbit에 도메인 추가하기

Orbit에서 프로젝트를 엽니다.
Domain 탭을 열거나 Settings의 Custom domains 카드에서 Manage domains를 클릭합니다.
Add a domain에서 호스트명을 입력합니다. 예: app.example.com.
Add를 클릭합니다.

일반 호스트명을 입력하세요. https://, 후행 슬래시 또는 경로를 포함하지 마세요. 양식은 "Enter a valid hostname like app.example.com"이라는 메시지와 함께 단순 호스트명이 아닌 것을 거부합니다.

Orbit 프로젝트의 Domain 탭

프로젝트에 최대 25개의 도메인을 추가할 수 있습니다. 추가하는 첫 번째 도메인이 primary 도메인이 됩니다.

도메인이 이미 다른 Orbit 프로젝트에 연결되어 있으면 Orbit이 거부합니다. 먼저 다른 프로젝트에서 제거하세요.

2단계: DNS 레코드 추가하기

Orbit은 생성해야 할 정확한 레코드를 보여주는 DNS setup 패널을 표시합니다: CNAME이며, 사용할 Name과 Value가 있습니다. 대상은 DNS를 호스팅하는 곳에 관계없이 동일합니다.

도메인이 Kapsule DNS를 사용하는 경우

KPanel 사이드바에서 Domains를 클릭합니다.
도메인을 클릭합니다.
DNS 편집기에서 Orbit Domain 탭에 표시된 Name과 Value를 사용하여 CNAME 레코드를 추가합니다.

도메인이 다른 DNS 제공자를 사용하는 경우

해당 제공자에 로그인하고 동일한 CNAME 레코드를 추가합니다. 인터페이스는 다르지만 레코드 유형, 이름 및 값은 동일합니다.

Apex 도메인(example.com 서브도메인 없음)은 DNS 표준에 따라 일반 CNAME을 사용할 수 없습니다. 많은 제공자가 CNAME 플래트닝 또는 동일한 결과를 달성하는 ALIAS 또는 ANAME 레코드를 제공합니다. 있으면 사용하세요. 없으면 www.example.com와 같은 서브도메인에 게시하고 DNS 제공자 또는 등록기관에서 apex를 해당 서브도메인으로 리다이렉트하세요.

3단계: 확인 및 SSL 대기

Orbit은 DNS를 자체적으로 확인하고 Domain 탭이 진행 상황을 보고합니다:

표시되는 내용	의미
Checking DNS…	현재 확인이 실행 중입니다
CNAME not detected yet	레코드가 전파되지 않았거나 올바르지 않습니다
CNAME verified: SSL provisioning…	레코드가 확인되었고, 인증서를 발급 중입니다
SSL active: CNAME verified	도메인이 라이브 상태이며 HTTPS를 통해 제공됩니다

자동으로 다음 확인을 기다리지 않고 확인을 강제하려면 Re-check DNS를 클릭하세요.

DNS 전파는 이전 레코드의 TTL에 따라 몇 분에서 몇 시간이 걸립니다. 인증서는 CNAME이 감지된 후 1, 2분 이내에 발급되며, 도메인이 연결된 상태를 유지하는 한 자동으로 갱신됩니다.

레코드를 추가하기 전에 해당 호스트명의 기존 레코드에서 TTL을 낮추고 이전 TTL이 만료될 때까지 기다리세요. 그러면 전환이 시간이 아닌 분 단위로 진행됩니다. 이는 새로운 호스트명을 추가하는 것이 아니라 라이브 호스트명을 이동할 때 가장 중요합니다.

기본 도메인 선택하기

둘 이상의 도메인이 연결된 경우, 하나가 Primary로 표시됩니다. 확인된 도메인에서 Set as primary domain을 클릭하여 변경하세요. 기본 도메인은 프로젝트의 표준 주소이며, 다른 도메인은 계속 제공됩니다.

도메인 제거하기

행에서 Remove domain을 클릭합니다.

도메인을 제거하면 즉시 서비스에서 제외됩니다. 방문자가 즉시 해당 호스트명에서 프로젝트에 도달할 수 없으며, 해당 인증서는 더 이상 유지되지 않습니다. DNS 제공자의 DNS 레코드는 제거되지 않습니다. 더 이상 필요 없으면 직접 삭제하거나, 더 이상 응답하지 않는 호스트명을 계속 가리킵니다.

프로젝트는 kaps.run 주소에서 계속 제공됩니다.

SSL은 자동이며 무료입니다

Orbit 도메인에 대해 인증서를 구매, 업로드 또는 갱신할 필요가 없습니다. CNAME이 확인되면 인증서가 발급되고 자동으로 갱신됩니다. 관리할 항목이 없으므로 인증서 관리 화면은 없습니다.

문제 해결

"CNAME not detected yet"에서 멈춤.

레코드 유형을 확인하세요. IP 주소를 가리키는 A 레코드는 확인되지 않습니다. Orbit이 제공한 값으로의 CNAME이어야 합니다.
레코드 이름을 확인하세요. 많은 DNS 편집기가 영역을 자동으로 추가하므로 app.example.com를 입력하면 app.example.com.example.com를 생성할 수 있습니다. 편집기가 영역을 접미사로 표시하면 app만 입력하세요.
충돌하는 레코드가 있는지 확인하세요. 동일한 이름에 있는 기존 A, AAAA 또는 CNAME은 우선하거나 영역을 무효화합니다. 제거하세요.
실제로 권한이 있는 영역을 편집했는지 확인하세요. 최근에 네임서버를 이동했다면 이전 제공자의 복사본을 편집 중일 수 있습니다.
교체한 레코드의 TTL을 기다리세요.

확인되었지만 인증서가 활성화되지 않습니다. 도메인의 CAA 레코드는 발급을 방지할 수 있습니다. 제거하거나 Kapsule이 사용하는 인증서 기관을 허용하는 항목을 추가하세요. 확실하지 않으면 도메인 이름과 함께 지원팀에 문의하세요.

"This domain is already attached to another project." 정확히 그 의미입니다. 다른 Orbit 프로젝트를 찾아서 먼저 도메인을 제거하세요.

"Domain limit reached." 이 프로젝트에서 25개 도메인 상한에 도달했습니다. 더 이상 필요 없는 하나를 제거하세요.

도메인이 확인되었지만 잘못된 사이트를 표시합니다. CNAME 대상을 문자 단위로 확인하세요. 도메인을 한 프로젝트에 연결하고 DNS를 다른 프로젝트로 가리키기 쉽습니다.