> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ale.run/llms.txt
> Use this file to discover all available pages before exploring further.

# 도메인 연결

> `ale`은 커스텀 도메인 연결을 위해 CNAME과 APEX 도메인 레코드를 지원합니다. 도메인 설정 방법은 사용 중인 도메인 제공업체에 따라 다르며, 본 가이드에서는 [AWS Route 53](https://aws.amazon.com/ko/route53/)과 [Cloudflare](https://www.cloudflare.com)를 통해 관리되는 도메인 설정 방법을 다룹니다.

<Info>
  이외의 DNS 제공서비스의 경우, DNS 사업자마다 레코드 등록 방법 및 세부 설정이 상이하므로 보유하고 있는 도메인의 제공업체 가이드에서 **DNS 설정 > CNAME 설정 방법** 을 참고하세요.
</Info>

<Tip>
  `ale`에서 배포된 서비스는 SSL 인증서가 자동으로 발급 및 적용됩니다. 프리뷰 URL뿐만 아니라 사용자가 연결한 커스텀 도메인에도 적용되며, 수동으로 SSL 설정을 할 필요가 없습니다.
</Tip>

***

## 도메인 연결 정보 조회

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/developers/images/domain01.png" />
</Frame>

> 도메인을 연결하려는 **서비스 상세페이지의 리소스탭**에서 인그레스 항목의 `도메인 연결`을 클릭하세요. 연결하려는 도메인의 이름(예: `example.com` 또는 `www.example.com` 등)을 입력하면 DNS 설정에 필요한 CNAME, TXT 레코드 값을 조회할 수 있습니다.

## AWS Route 53

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/developers/images/domain02.png" />
</Frame>

> 연결하려는 도메인의 Route 53 대시보드 Hosted Zones 항목에서 `Create record`를 클릭한 후, 레코드 값을 입력하세요.

* **Record Name** : `ale`에서 설정한 도메인(예: `www.example.com`)의 프리픽스(예: `www`)

* **Record Type** : CNAME

* **Value** : `ale` 에서 조회한 CNAME 레코드 값

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/developers/images/domain03.png" />
</Frame>

> `ale` 에 돌아와서 `인증하기`를 클릭하고 **도메인 인증이 성공**되면 `연결하기`를 클릭하는 것으로 도메인이 연결됩니다.

<Info>
  **연결된 도메인에 SSL 인증서가 자동으로 발급됩니다.** DNS 레코드 전파와 SSL 인증서 검증이 완료될 때까지 도메인 접속이 일시적으로 제한되거나 SSL 보안 경고가 표시될 수 있습니다.
</Info>

<Warning>
  "현재 DNS 설정값이 다릅니다. CNAME을 찾을 수 없습니다" 의 메시지는 입력된 레코드의 등록에 약간의 시간이 걸리기 때문에 나올 수 있는 오류 메시지 입니다. 잠시 후 인증하기를 다시 시도해 보세요.
</Warning>

<Tip>
  `연결하기` 클릭 후 'domain connection limit exceeded' 문구와 함께 도메인이 연결되지 않는 경우는, 서비스가 속한 스페이스에 연결 가능한 커스텀 도메인 수가 부족하기 때문입니다. [스페이스에 리소스 부여하기 페이지](/ko/operations/spaces#%EC%9D%BC%EB%B0%98-%EC%84%A4%EC%A0%95-%EB%8F%84%EB%A9%94%EC%9D%B8-%EC%97%B0%EA%B2%B0%2C-%ED%8C%80%EC%9B%90-%EC%88%98-%EB%93%B1)를 참고해 리소스를 부여하세요.
</Tip>

## Cloudflare

### 서브도메인 연결하기

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/developers/images/domain04.png" />
</Frame>

> `ale` 에서 [CNAME 레코드 값을 조회](/ko/developers/domain#%EB%8F%84%EB%A9%94%EC%9D%B8-%EC%97%B0%EA%B2%B0-%EC%A0%95%EB%B3%B4-%EC%A1%B0%ED%9A%8C)한 후, Cloudflare에서 구매한 도메인의 **DNS Records**메뉴에서 레코드를 추가하세요.

* **Type** : CNAME

* **Name** : `ale`에서 설정한 도메인(예: `www.example.com`)의 프리픽스(예: `www`)

* **Target** : `ale` 에서 조회한 CNAME 레코드 값

* **Proxy status** : DNS only(비활성화)

<Warning>
  Proxy status가 **프록싱 됨** 상태인 경우, `ale`이 자동화한 SSL인증서 발급 등의 도메인 규칙이 적용되지 않아 도메인이 연결되지 않습니다. **반드시 DNS only(비활성화) 상태로 정해주세요.**
</Warning>

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/developers/images/domain05.png" />
</Frame>

> `ale`에 돌아와서 `인증하기`를 클릭하고 **도메인 인증이 성공**되면 `연결하기`를 클릭하는 것으로 도메인이 연결됩니다.

<Info>
  **연결된 도메인에 SSL 인증서가 자동으로 발급됩니다.** DNS 레코드 전파와 SSL 인증서 검증이 완료될 때까지 도메인 접속이 일시적으로 제한되거나 SSL 보안 경고가 표시될 수 있습니다.
</Info>

<Warning>
  "현재 DNS 설정값이 다릅니다. CNAME을 찾을 수 없습니다" 의 메시지는 입력된 레코드의 등록에 약간의 시간이 걸리기 때문에 나올 수 있는 오류 메시지 입니다. 잠시 후 인증하기를 다시 시도해 보세요.
</Warning>

<Tip>
  `연결하기` 클릭 후 'domain connection limit exceeded' 문구와 함께 도메인이 연결되지 않는 경우는, 서비스가 속한 스페이스에 연결 가능한 커스텀 도메인 수가 부족하기 때문입니다. [스페이스에 리소스 부여하기 페이지](/ko/operations/spaces#%EC%9D%BC%EB%B0%98-%EC%84%A4%EC%A0%95-%EB%8F%84%EB%A9%94%EC%9D%B8-%EC%97%B0%EA%B2%B0%2C-%ED%8C%80%EC%9B%90-%EC%88%98-%EB%93%B1)를 참고해 리소스를 부여하세요.
</Tip>

### 루트도메인 연결하기

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/developers/images/domain06.png" />
</Frame>

> `ale`의 도메인 연결 화면에서 **루트도메인**을 입력하고 CNAME, TXT 레코드 값을 확인하세요.

<Info>
  루트도메인을 연결하기 위해 2개의 레코드를 모두 등록해야합니다. 아래의 항목을 참고하세요.
</Info>

<AccordionGroup>
  <Accordion title="CNAME record 등록하기">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/developers/images/domain07.png" />
    </Frame>

    > `ale`에서 조회한 CNAME 레코드 값을 활용해, Cloudflare에서 구매한 도메인의 **DNS Records**메뉴에서 CNAME 레코드를 추가하세요.

    * **Type** : CNAME

    * **Name** : @

    * **Target** : `ale` 에서 조회한 CNAME 레코드값

    * **Proxy status** : DNS only(비활성화)

    <Info>
      **Name** 항목에 입력하는 **@** 기호는 루트도메인을 의미하는 Cloudflare의 규칙입니다. 공란으로 비우면 연결되지 않습니다.
    </Info>

    <Warning>
      Proxy status가 **프록싱 됨** 상태인 경우, `ale`이 자동화한 SSL인증서 발급 등의 도메인 규칙이 적용되지 않아 도메인이 연결되지 않습니다. **반드시 DNS only(비활성화) 상태로 정해주세요.**
    </Warning>
  </Accordion>

  <Accordion title="TXT record 등록하기">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/developers/images/domain08.png" />
    </Frame>

    > `ale`에서 조회한 TXT 레코드 값을 활용해, Cloudflare에서 구매한 도메인의 **DNS Records**메뉴에서 TXT 레코드를 추가하세요.

    * **Type** : TXT

    * **Name** : @

    * **Content** : `ale` 에서 조회한 TXT 레코드 값

    <Info>
      **Name** 항목에 입력하는 **@** 기호는 루트도메인을 의미하는 Cloudflare의 규칙입니다. 공란으로 비우면 연결되지 않습니다.
    </Info>
  </Accordion>
</AccordionGroup>

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/developers/images/domain09.png" />
</Frame>

> `ale`에 돌아와서 `인증하기`를 클릭하고 **도메인 인증이 성공**되면 `연결하기`를 클릭하는 것으로 도메인이 연결됩니다.

<Info>
  **연결된 도메인에 SSL 인증서가 자동으로 발급됩니다.** DNS 레코드 전파와 SSL 인증서 검증이 완료될 때까지 도메인 접속이 일시적으로 제한되거나 SSL 보안 경고가 표시될 수 있습니다.
</Info>

<Warning>
  "현재 DNS 설정값이 다릅니다. CNAME을 찾을 수 없습니다" 의 메시지는 입력된 레코드의 등록에 약간의 시간이 걸리기 때문에 나올 수 있는 오류 메시지 입니다. 잠시 후 인증하기를 다시 시도해 보세요.
</Warning>

<Tip>
  `연결하기` 클릭 후 'domain connection limit exceeded' 문구와 함께 도메인이 연결되지 않는 경우는, 서비스가 속한 스페이스에 연결 가능한 커스텀 도메인 수가 부족하기 때문입니다. [스페이스에 리소스 부여하기 페이지](/ko/operations/spaces#%EC%9D%BC%EB%B0%98-%EC%84%A4%EC%A0%95-%EB%8F%84%EB%A9%94%EC%9D%B8-%EC%97%B0%EA%B2%B0%2C-%ED%8C%80%EC%9B%90-%EC%88%98-%EB%93%B1)를 참고해 리소스를 부여하세요.
</Tip>