Studio

커스텀 도메인

커스텀 도메인을 사용하면 랜딩 페이지, 법률 문서 페이지, 프레스 키트, QR 코드, 딥 링크가 get.habitly.app 주소처럼 직접 소유한 도메인에서 제공되며, HTTPS도 자동으로 설정돼요. 커스텀 도메인은 Studio 플랜에 포함되며, 워크스페이스당 최대 25개의 도메인을 사용할 수 있어요. 워크스페이스 소유자와 관리자가 도메인을 추가할 수 있어요.

커스텀 도메인에서 제공되는 항목

각 도메인은 앱 하나에 연결돼요.

URL	제공 내용
`https://get.habitly.app/`	랜딩 페이지
`/go/{store}`	`/go/google_play` 경로처럼 스토어로 이동하는 추적 리디렉션
`/open/{path}`	딥 링크
`/privacy`, `/terms`	개인정보 처리방침과 이용약관(선택적으로 `/{language}` 경로 추가 가능)
`/press`, `/press.zip`	프레스 키트
`/qr.svg`, `/qr.png`	QR 코드
`/.well-known/apple-app-site-association` `/.well-known/assetlinks.json`	Universal Links 및 Android App Links용 연결 파일

루트에서는 모든 방문자에게 랜딩 페이지가 표시돼요. mapps.one/habitly 링크와 달리 휴대폰을 스토어로 리디렉션하지 않아요. 기기 감지가 필요하면 스마트 링크를, 특정 스토어 하나로 보내려면 get.habitly.app/go/app_store 주소를 사용하세요. 대시보드와 API에 표시되는 스마트 링크 및 QR 코드 URL은 계속 mapps.one을 사용해요.

시작하기 전에

하위 도메인을 사용하세요(예: get., download., app.). DNS 표준에서는 habitly.app 같은 루트 도메인에 CNAME 레코드를 허용하지 않아요.
등록기관이나 DNS 제공업체에서 도메인의 DNS 설정에 접근할 수 있어야 해요.
하나의 도메인은 mapps.one 전체에서 한 번만 연결할 수 있어요.

1. 도메인 추가하기

대시보드에서 도메인을 열고 도메인 추가를 선택한 다음, get.habitly.app 주소를 입력하고 이 도메인에서 제공할 앱을 고르세요. 그러면 대시보드에 만들어야 할 DNS 레코드가 표시되며, 여기에는 도메인마다 고유한 인증 토큰이 포함돼요.

2. DNS 레코드 만들기

유형	이름	값	용도
TXT	`_mapps-verify.get.habitly.app`	`mapps-verify=your-token`	도메인을 관리하고 있음을 증명해요
CNAME	`get.habitly.app`	`domains.mapps.one`	트래픽을 mapps.one으로 보내요

DNS 제공업체에서 해당 이름으로 CNAME 레코드를 만들 수 없다면, 대신 대시보드에 표시된 IP 주소를 가리키는 A 레코드를 만드세요.

많은 DNS 제공업체는 루트 도메인을 자동으로 붙여요. 이 경우 루트 도메인 앞부분만 입력하세요. TXT 레코드에는 _mapps-verify.get 값을, CNAME 레코드에는 get 값을 입력하면 돼요.

Cloudflare를 사용하나요? CNAME 레코드를 DNS only(회색 구름)로 설정하세요. 레코드가 프록시되면 인증서를 발급할 수 없어 방문자에게 오류가 표시돼요.

3. 인증하기

도메인 옆의 지금 인증을 선택하세요. TXT 레코드와 도메인이 가리키는 대상을 확인해요. 대기 중인 도메인은 10분마다 자동으로도 확인되므로, 페이지를 닫고 나중에 다시 와도 돼요. DNS 변경 사항은 보통 몇 분 안에 반영되지만, 일부 제공업체에서는 몇 시간이 걸리기도 해요.

상태	의미
대기 중	DNS 레코드가 반영되기를 기다리는 중이에요
인증됨	도메인에서 앱을 제공하고 있어요
실패	레코드가 없거나 잘못되었어요. 대시보드에 원인이 표시돼요. 레코드를 수정하고 다시 인증하세요.

인증에 성공하면 domain.verified 웹훅이 전송돼요.

HTTPS

도메인이 인증된 후 누군가 처음으로 HTTPS로 도메인을 열 때 TLS 인증서가 자동으로 발급돼요. 이 첫 요청은 몇 초 걸릴 수 있지만, 이후 요청은 빨라요. 업로드하거나 갱신할 것은 없어요.

문제 해결

dig 명령이나 온라인 DNS 조회 도구로 외부에서 보이는 설정을 확인하세요.

dig +short TXT _mapps-verify.get.habitly.app
"mapps-verify=your-token"

dig +short CNAME get.habitly.app
domains.mapps.one.

이름이 중복된 경우(예: get.habitly.app.habitly.app): 제공업체가 루트 도메인을 덧붙였어요. get 값만 입력하세요.
같은 이름에 다른 레코드가 있는 경우(예: 이전 A 레코드): CNAME은 다른 레코드와 이름을 함께 쓸 수 없으므로 해당 레코드를 삭제하세요.
앞단에 프록시나 CDN이 있는 경우: 레코드를 DNS only로 바꾸세요.
도메인에 특정 인증 기관만 허용하는 CAA 레코드가 있으면 인증서 발급이 막힐 수 있어요. 해당 레코드를 삭제하거나 허용 범위를 넓히세요.

도메인 삭제하기

대시보드에서 도메인을 삭제한 다음, DNS 제공업체에서 DNS 레코드를 삭제하세요. 워크스페이스가 Studio 플랜이 아닌 플랜으로 바뀌면, 다시 업그레이드할 때까지 커스텀 도메인에서 페이지가 제공되지 않아요. mapps.one의 링크는 계속 작동해요.