연결하기도메인
커스텀 도메인
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이 도메인 소유 여부를 추가로 확인합니다.