Skip to main content
커스텀 도메인을 사용하면 www.my-incredible-app.com과 같은 자신만의 도메인 이름을 게시된 Replit 앱에 지정할 수 있습니다. Replit은 <your-live-app-subdomain-name>.replit.app 형식의 무료 서브도메인을 제공하지만, 커스텀 도메인은 방문자에게 브랜드 인지도와 신뢰를 심어주는 더 기억하기 쉬운 주소를 제공합니다. 도메인 도구는 필요한 모든 것을 한곳에서 제공합니다. 프로젝트 편집기에서 도구를 선택한 다음 Replit Cloud 아래의 도메인을 선택하세요. 다음을 할 수 있습니다.
  • 새 도메인 구매하기: Replit을 통해 새로운 도메인을 구매하고 한 번에 프로젝트에 연결합니다.
  • 이미 소유한 도메인 연결하기: 다른 등록기관에서 소유한 도메인을 연결합니다.
  • 관리하기: 연결된 도메인이 어떤 프로젝트를 가리키는지 확인하고, 갱신을 추적하고, 도메인 연결을 해제합니다.
커스텀 도메인 설정에 대한 간단한 개요는 다음 영상을 참조하세요.
다음 표는 Replit의 서브도메인과 커스텀 도메인을 비교합니다.
게시하기 전에 도메인을 설정할 수 있지만, 앱을 게시하기 전까지는 도메인이 앱을 제공하지 않습니다. 그때까지 도메인 도구에는 프로젝트가 아직 게시되지 않았다는 안내가 표시됩니다.

Replit에서 새 도메인 구매하기

이미 소유한 도메인이 없다면 Replit을 벗어나지 않고도 도메인을 검색하고 구매할 수 있습니다. 새 도메인은 자동으로 프로젝트를 가리킵니다.
1

도메인 도구 열기

프로젝트 편집기에서 도구를 선택한 다음 Replit Cloud 아래의 도메인을 선택하세요.
2

도메인 검색하기

새 도메인 구매 아래의 검색 필드에 원하는 이름을 입력하거나 추천 도메인을 선택하세요. Replit은 .com, .ai 등 다양한 확장자에서 사용 가능한 옵션을 보여줍니다. 어떤 이름을 지어야 할지 모르겠다면 Replit이 앱의 기능을 바탕으로 사용 가능한 이름을 제안하므로, 처음부터 시작하지 않고도 하나를 선택할 수 있습니다.
사용 가능한 도메인을 .com, .ai 등의 확장자와 함께 보여주는 도메인 검색 인터페이스
3

구매 및 연결

원하는 도메인을 선택하고 Replit 계정의 결제 수단을 사용해 구매를 완료하세요. 앱이 게시되면 추가적인 DNS 구성 없이 새 도메인에서 접근할 수 있습니다.
Replit을 통해 구매한 도메인에는 추가 비용 없이 WHOIS 프라이버시 보호가 포함되고, 자동으로 갱신되며, 커스텀 DNS 레코드(예: 이메일용 MX 레코드)를 추가할 수 있습니다. 도메인 구매에 대한 가격, 갱신, 이전, 커스텀 DNS 레코드 등의 전체 참조 자료는 도메인 구매하기를 참조하세요.

이미 소유한 도메인 연결하기

다른 등록기관에서 도메인을 이미 소유하고 있다면 도메인 도구에서 프로젝트에 연결하세요. Replit은 DNS를 대신 구성해 주는 안내형 설정을 제공하며, 대체 방법으로 수동 설정도 지원합니다.

안내형 설정 (권장)

기존 도메인을 연결하는 가장 간단한 방법은 Replit이 대신 설정하도록 하는 것입니다. Replit은 서드파티 도메인 연결 서비스인 Entri를 사용합니다. 권한을 부여하면 Entri가 DNS 제공업체에 로그인해 필요한 DNS 레코드를 대신 작성하므로, 직접 레코드를 복사할 필요가 없습니다.
DNS 레코드는 인터넷에 도메인이 어디를 가리켜야 하는지 알려주는 설정입니다. 예전에는 이를 직접 설정하는 것이 도메인 연결에서 가장 까다로운 부분이었습니다. Replit은 이제 대부분의 도메인과 제공업체에 대해 이 단계를 대신 처리합니다.
1

도메인 도구 열기

프로젝트 편집기에서 도구를 선택한 다음 Replit Cloud 아래의 도메인을 선택하세요.
게시되지 않은 프로젝트 안내와 이미 소유한 도메인 사용 입력란이 표시된 도메인 도구, 입력된 도메인 없음
2

연결할 도메인 입력하기

이미 소유한 도메인 사용 아래에 이미 소유한 도메인(예: www.my-incredible-app.com)을 입력한 다음 다음을 선택하세요.
3

안내형 설정 승인하기

연결을 확인하세요. Replit이 안내형 흐름을 열고, DNS 제공업체에 로그인하여 DNS 레코드가 자동으로 계정에 적용되도록 합니다. 안내형 흐름이 사용 중인 제공업체에서 레코드를 작성할 수 없다면 직접 추가해야 할 레코드를 보여줍니다.
4

도메인 확인 대기하기

설정이 완료되면 도메인이 확인됨 상태로 표시됩니다. 보통 몇 분이면 완료되지만, DNS 변경은 전파되는 데 최대 48시간이 걸릴 수 있습니다. 브라우저에서 도메인을 열어 작동하는지 확인하세요.
사용 중인 제공업체가 안내형 설정을 지원하지 않거나 직접 레코드를 추가하는 것을 선호한다면 도메인을 수동으로 연결할 수 있습니다. 아래 도메인 수동 연결하기를 참조하세요.

도메인 수동 연결하기

사용 중인 제공업체가 안내형 설정을 지원하지 않거나 직접 레코드를 추가하는 것을 선호한다면 아래 단계를 따라 커스텀 도메인을 수동으로 설정하세요.
다음 중 하나에 해당하면 설정 문제가 발생할 수 있습니다.
  • 같은 도메인 이름에 대해 서로 다른 서버를 가리키는 여러 개의 A 레코드가 있는 경우.
  • Replit은 A 레코드만 지원하므로 같은 도메인에 A와 AAAA 레코드가 함께 존재하는 경우.
  • Cloudflare가 프록시하는 도메인 레코드인 경우, Replit이 해당 유형에 대해 보안 인증서를 자동으로 갱신할 수 없기 때문입니다. 레코드를 DNS only(회색 클라우드)로 설정하세요.
  • replit-verify TXT 레코드가 없거나 제거된 경우. SSL/TLS 인증서를 갱신하려면 Replit에 이 레코드가 그대로 유지되어야 합니다. 아래 TXT 레코드 유지하기를 참조하세요.
1

커스텀 도메인 추가하기

텍스트 필드에 커스텀 도메인 이름을 입력하세요. 등록된 도메인을 사용하거나 서브도메인을 포함할 수 있습니다.예를 들어 hat-tip.cc는 등록된 도메인이고 my.hat-tip.cc는 서브도메인 my를 포함합니다.
DNS 설정 화면 스크린샷
2

도메인 등록기관에 DNS 레코드 추가하기

Replit은 도메인 등록기관에 제공해야 하는 DNS 레코드를 생성합니다. 도메인 등록기관은 GoDaddy나 Namecheap처럼 도메인 이름을 관리하는 서비스입니다.Replit에서 A와 TXT 레코드 값을 복사해 도메인 등록기관의 DNS 관리 섹션에 붙여넣으세요. 도메인 등록기관이 호스트명으로 @를 지원하지 않는다면 등록된 도메인 이름을 사용하세요.
TXT 레코드를 그대로 유지하세요. Replit은 DNS 검증을 통해 커스텀 도메인의 SSL/TLS 인증서를 발급하고 갱신합니다. replit-verify=... TXT 레코드는 초기 설정 중뿐만 아니라 도메인이 존재하는 전체 기간 동안 DNS에 남아 있어야 합니다. 검증 후 레코드를 제거하거나 변경하면 다음 인증서 갱신이 실패하고, 결국 도메인이 만료된 인증서를 제공하게 되어 브라우저에서 앱에 접근할 수 없게 됩니다. TXT 레코드를 A 레코드와 함께 영구적인 것으로 취급하세요.
3

선택 사항: 서브도메인 추가하기

www를 포함한 서브도메인은 apex 도메인을 연결할 때 자동으로 확인되지 않습니다. 서비스하려는 각 서브도메인은 도메인 도구에서 별도의 항목으로 추가하고 자체 DNS 레코드를 등록기관에 부여해야 합니다.서브도메인을 추가하려면 apex 도메인을 연결했던 것과 같은 방식으로 도메인 도구에서 연결한 다음, Replit이 생성한 DNS 레코드를 도메인 등록기관에 추가하세요. 예를 들어 my-subdomain.hat-tip.cc를 추가하려면:
  • 도구를 선택한 다음 Replit Cloud 아래의 도메인을 선택하고 my-subdomain.hat-tip.cc를 연결하세요.
  • 등록기관에서 호스트명이 my-subdomain이고 Replit이 새 항목에 대해 보여주는 IP 주소를 가리키는 새 A 레코드를 추가하세요.
  • 등록기관에서 호스트명 my-subdomain에 일치하는 replit-verify=... TXT 레코드를 추가하세요 — 각 서브도메인은 apex와는 별도로 자체 TXT 레코드를 가집니다.
www는 서브도메인입니다. hat-tip.cc를 연결해도 자동으로 www.hat-tip.cc가 서비스되지는 않습니다. 방문자가 hat-tip.cc와 www.hat-tip.cc 모두에서 앱에 접근하도록 하려면 www.hat-tip.cc를 도메인 도구에 별도의 항목으로 추가하고 호스트명 www에 대해 생성된 A와 TXT 레코드를 게시하세요. www 주소를 원하는 대부분의 빌더는 등록기관에서 apex에서 www로(또는 반대로) 리디렉션도 함께 구성합니다.
apex 도메인과 마찬가지로, 각 서브도메인에 대해 추가하는 replit-verify=... TXT 레코드도 DNS에 영구적으로 유지되어야 합니다. 아래 TXT 레코드 유지하기를 참조하세요.
4

DNS 전파 완료 대기하기

레코드를 추가한 후 온라인으로 전파될 때까지 기다려야 합니다. 몇 분에서 최대 48시간이 걸릴 수 있습니다.전파가 완료되면 도메인 도구에 아래와 같이 도메인 이름 옆에 “확인됨” 상태가 표시됩니다.
확인된 도메인 상태 스크린샷
브라우저에서 도메인을 열어 작동하는지 확인하세요.

Replit이 DNS 레코드를 확인하는 기간

도메인을 추가하면 Replit은 약 6시간 동안 1~2분마다 해당 도메인의 DNS 레코드를 확인합니다. 이 기간 안에 레코드가 나타나면 Replit이 도메인을 확인하고 SSL/TLS 인증서를 자동으로 발급합니다. 다른 작업은 필요하지 않습니다. 약 6시간이 지나도 레코드가 없으면 Replit은 확인을 중단하고 도메인이 Failed로 표시됩니다. Replit은 그 이후에 추가한 레코드를 감지하지 않습니다. 다시 시도하려면 DNS 조회 도구로 레코드가 올바른지 확인한 다음 도메인 도구에서 도메인을 제거하고 다시 추가하세요. 도메인이 실패하지 않도록 하려면:
  • Replit에 도메인을 추가하기 전이나 직후에 DNS 레코드를 추가하세요. 시작하기 전에 DNS 제공업체에 접근할 수 있도록 준비해 두세요.
  • A 레코드와 TXT 레코드를 동시에 추가하세요. Replit은 A 레코드가 Replit을 가리킨 후에만 인증서를 발급할 수 있습니다.
DNS 전파와 Replit의 확인 기간은 별개입니다. 대부분의 DNS 변경은 몇 분 안에 반영되지만 일부 제공업체는 더 오래 걸립니다. 전파가 느릴 것으로 예상된다면 먼저 DNS 제공업체에서 레코드를 추가한 다음 Replit에 도메인을 추가하세요.

하나의 도메인에 많은 서브도메인 연결하기

Replit은 연결하는 각 도메인과 서브도메인마다 Let’s Encrypt에서 별도의 인증서를 발급합니다. 와일드카드 인증서(*.example.com)는 지원되지 않으므로 모든 서브도메인이 각자의 인증서를 받습니다. Let’s Encrypt는 발급할 수 있는 인증서 수를 제한합니다. 이 제한은 <location>.example.com 사이트 수십 개처럼 같은 도메인 아래 많은 서브도메인을 연결할 때 중요합니다.

계획 시 고려해야 할 인증서 한도

기존 인증서의 갱신은 일반적으로 50개 인증서 한도에 포함되지 않습니다. 자세한 내용은 Let’s Encrypt 요청 한도를 참조하세요.

서브도메인을 나눠서 추가하기

한도에 걸리지 않고 많은 서브도메인을 연결하려면:
  1. 도메인에 이미 인증서가 몇 개 있는지 확인하세요. crt.sh에서 등록된 도메인을 검색하고 지난 7일 동안 발급된 Let’s Encrypt 인증서를 세어 보세요. 마케팅 사이트나 이메일 제공업체 같은 다른 호스트의 인증서도 포함하세요. crt.sh는 각 인증서를 두 번(사전 인증서와 최종 인증서) 나열하는 경우가 많으므로 고유한 발급 건수를 세세요.
  2. 남은 허용량만큼 한 번에 추가하세요. 도메인에 최근 Let’s Encrypt 인증서가 없다면 새 서브도메인을 한 번에 최대 50개까지 추가할 수 있습니다.
  3. 그 후에는 하루에 약 7개씩 서브도메인을 더 추가하세요. 허용량은 7일에 걸쳐 점진적으로 풀립니다.

실패한 도메인 안전하게 재시도하기

도메인을 제거하고 다시 추가할 때마다 Replit은 새 인증서를 요청합니다. 도메인이 인증서를 받은 적이 없다면 이 요청은 위의 두 한도에 모두 포함됩니다. 받은 적이 있다면 호스트명당 5개 한도에만 포함됩니다. 반복해서 재시도하면 요청 한도가 더 오래 지속될 수 있습니다.
  • 한 번에 하나의 도메인만 재시도하고, 한도 내로 돌아온 후에만 시도하세요.
  • 이미 작동하는 도메인은 제거했다가 다시 추가하지 마세요. 이미 인증서가 있으며, 다시 추가하면 해당 호스트명의 허용량 일부가 사용됩니다.
  • 같은 서브도메인을 반복해서 재시도하지 마세요. 각 호스트명은 7일 동안 새 인증서를 5개까지만 받을 수 있습니다.
여러 서브도메인이 동시에 실패하고 DNS 레코드가 올바르다면 인증서 한도에 도달했을 수 있습니다. crt.sh에서 도메인의 최근 인증서를 확인하거나, 도메인 이름과 영향을 받은 서브도메인을 알려 Replit 지원팀에 문의하세요.

도메인 관리하기

도메인 도구에는 프로젝트에 연결된 모든 도메인이 나열되며, 각각을 관리할 수 있습니다. 도메인을 선택하고 관리를 선택하면 다음을 할 수 있습니다.
  • 도메인이 어떤 프로젝트를 가리키는지 확인합니다. 이미 다른 프로젝트에 연결된 도메인을 연결하려고 하면 Replit이 경고를 표시하고 대신 현재 프로젝트로 옮길 수 있게 해줍니다.
  • 갱신 내역을 확인합니다(Replit에서 구매한 도메인의 경우). 관리 화면에서 갱신 날짜와 갱신 가격을 확인할 수 있으며, 도메인이 자동으로 갱신되는 것을 원하지 않는다면 자동 갱신을 끌 수 있습니다.
  • DNS 레코드를 편집합니다(Replit에서 구매한 도메인의 경우). 예를 들어 도메인으로 이메일을 사용하기 위한 MX 레코드처럼 커스텀 A, TXT, MX 레코드를 추가할 수 있습니다. 커스텀 DNS 레코드를 참조하세요.
  • 도메인 연결을 해제합니다. 연결 해제하면 해당 도메인에서 앱 서비스가 중단됩니다. 도메인 자체는 삭제되지 않으며, 다른 프로젝트에 연결할 수 있는 상태로 남습니다.
연결된 도메인과 연결 상태를 보여주는 도메인 관리 인터페이스

문제 해결

도메인 연결이 실패했거나 확인 대기 상태에서 멈춘 경우

연결이 실패하거나 도메인이 확인 중 상태에 머물러 있다면 다음을 확인하세요.
  1. DNS가 전파될 시간을 주세요. 확인 작업은 몇 분에서 최대 48시간까지 걸릴 수 있습니다. 다른 작업을 하기 전에 DNS 조회 도구를 사용해 레코드가 전역적으로 표시되는지 확인하세요.
  2. 충돌하는 레코드를 제거하세요. 루트 도메인에서 Replit을 가리키는 A 레코드는 하나만 유지하고, 같은 호스트명에 있는 AAAA(IPv6) 레코드는 제거하세요 — SSL을 차단할 수 있습니다.
  3. Cloudflare 프록시를 끄세요. A 레코드를 DNS only(회색 클라우드)로 설정하세요. 프록시 모드 (주황색 클라우드)는 SSL 프로비저닝을 방해합니다.
  4. TXT 레코드가 있는지 확인하세요. replit-verify=... TXT 레코드가 없거나 수정되면 확인과 인증서 갱신이 차단됩니다. TXT 레코드 유지하기를 참조하세요.
  5. 도메인 도구에서 도메인을 한 번 연결 해제한 후 다시 연결하면 새로운 인증서 발급을 유도할 수 있으니, 몇 분 기다린 후 새로고침하세요. 다시 연결할 때마다 새 인증서를 요청하므로 반복해서 시도하지 마세요. 실패한 도메인 안전하게 재시도하기를 참조하세요.
레코드를 수정한 후에도 도메인이 Failed로 표시된다면 Replit이 확인을 중단했을 수 있습니다. Replit이 DNS 레코드를 확인하는 기간을 참조하세요. Replit을 통해 도메인을 구매했는데도 여전히 확인되지 않는다면 Replit 지원팀에 문의하세요.

DNS 변경 사항이 아직 적용되지 않은 경우

DNS 변경은 즉시 적용되지 않습니다. 레코드를 추가하거나 변경한 후 전 세계에 전파되는 데 몇 분에서 최대 48시간까지 걸릴 수 있습니다. 이 기간 동안 앱은 replit.app 서브도메인에서 계속 작동합니다. 48시간이 지나도 확인됨 상태가 나타나지 않는다면 Replit이 보여주는 레코드와 자신의 레코드를 다시 비교해 보세요. 흔한 실수로는 마지막 점, 추가 서브도메인, 오래된 레코드가 있습니다.

CNAME 레코드와 인증

커스텀 도메인에서 로그인이나 인증이 작동하는 데 CNAME 레코드는 필요하지 않습니다. 도메인이 확인되면 로그인은 게시된 도메인 전반에서 자동으로 작동합니다. 커스텀 도메인의 CNAME 레코드는 이메일 전송에만 필요합니다 — 예를 들어 확인 이메일이나 트랜잭션 이메일을 도메인에서 보낼 수 있도록 하기 위한 것입니다. 게시 도구가 CNAME 레코드를 추가하라는 경고를 표시한다면 이는 이메일 전송에 관한 것이며 로그인과는 관련이 없습니다. 레코드 추가는 도메인에서 이메일을 보낼 때만 필요하며, 도메인의 확인, SSL, 로그인을 막지 않습니다. 이메일 관련 설정 단계는 Clerk 인증을 참조하세요.

TXT 레코드 유지하기

Replit은 DNS 검증을 통해 각 커스텀 도메인의 SSL/TLS 인증서를 발급하고 갱신하며, 이는 설정 중에 추가한 replit-verify=... TXT 레코드에 의존합니다. TXT 레코드는 한 번만 설정하는 것이 아니라 도메인이 존재하는 전체 기간 동안 DNS에 남아 있어야 합니다. 도메인이 확인된 후 레코드가 제거되거나, 편집되거나, 교체되면 다음 갱신이 조용히 실패하고 기존 인증서가 결국 만료됩니다. 그러면 방문자에게 브라우저 보안 경고가 표시되고 앱에 접근할 수 없게 됩니다. 계정의 오래된 도메인에서 갑자기 인증서 오류가 나타나는데 새 도메인은 정상 작동한다면, 누락되었거나 수정된 TXT 레코드가 가장 가능성 높은 원인입니다. 영향을 받은 도메인을 복구하려면:
  1. 도구를 선택한 다음 Replit Cloud 아래의 도메인을 선택하세요.
  2. Replit이 해당 도메인에 대해 보여주는 replit-verify=... TXT 레코드를 확인하세요.
  3. 표시된 그대로 호스트명과 값을 포함해 도메인 등록기관에 TXT 레코드를 다시 추가하세요.
  4. Replit에서 도메인을 제거한 다음 다시 추가해 새로운 발급을 유도하세요. 도메인당 한 번만 수행하세요. 실패한 도메인 안전하게 재시도하기를 참조하세요.
  5. DNS 전파를 기다리고 도메인 도구에서 확인됨 상태를 다시 확인하세요.