runlot
연결하기도메인

커스텀 도메인

CNAME 및 TXT 레코드를 설정하면 보유한 도메인으로 앱에 접속할 수 있습니다.

runlot domain add app.example.com

명령을 실행하면 다음 DNS 설정을 안내합니다.

DNS 에 아래 두 줄을 넣어 주세요:

  CNAME  app.example.com  →  apps.runlot.app
  TXT    _runlot-verify.app.example.com  →  <토큰>

CNAME은 앱 연결에 사용하고 TXT는 도메인 소유 확인에 사용합니다. DNS 설정이 반영된 뒤 `runlot domain verify app.example.com`으로 즉시 확인할 수 있으며, 시스템도 1분마다 자동으로 확인합니다.

TXT 레코드만 설정하면 소유 확인은 되지만 앱으로 연결할 수 없습니다. CNAME과 TXT 레코드를 모두 설정하세요.

상태 보기

runlot domain list
호스트                종류    상태
app.example.com      커스텀   연결됨
my-app.me.runlot.app  기본    연결됨

기본 행은 모든 프로젝트에 생성되는 주소입니다.

상태
확인 중DNS 레코드 반영을 기다리는 중입니다.
인증서 발급 중소유 확인을 마쳤으며 TLS 인증서를 발급하는 중입니다.
연결됨해당 주소에서 앱에 접속할 수 있습니다.
오류runlot domain list에 오류 사유가 표시됩니다.

상태가 연결됨인 주소로만 트래픽을 전달합니다.

지금 확인하기

runlot domain verify app.example.com

시스템은 1분마다 자동으로 확인합니다. 방금 DNS 레코드를 설정했다면 이 명령으로 즉시 확인하세요.

끊기

runlot domain rm app.example.com

명령을 실행하면 확인을 요청합니다. 연결을 해제하면 해당 주소로 앱에 접속할 수 없습니다.

TLS

TLS 인증서는 자동으로 발급하고 갱신합니다. 별도로 관리할 필요가 없습니다.

제약

  • *.runlot.app*.runlot.dev 하위 도메인은 연결할 수 없습니다.
  • 와일드카드 호스트(*.example.com)는 지원하지 않습니다.
  • 한글 도메인은 punycode로 정규화합니다.
  • 커스텀 도메인은 HTTP 전용입니다. psql은 커스텀 도메인 대신 프로젝트의 wire 주소(<프로젝트>--<조직>.wire.runlot.app)에 연결하세요.

소유 확인을 따로 하는 이유

TXT 소유 확인이 없으면 다른 사람의 도메인을 먼저 등록하는 문제가 생길 수 있습니다. 이를 방지하기 위해 runlot이 도메인 소유 여부를 추가로 확인합니다.

이 페이지의 목차