# 사이트 도메인 탭

Source: https://support.kapsulehost.com/ko-kr/site-domains-tab

도메인 탭은 사이트에 도메인 이름을 연결하고, 어느 것을 기본 URL로 사용할지 결정하며, DNS가 아직 적용되었는지 확인하는 곳입니다. 사이트 하나에 여러 도메인을 동시에 연결할 수 있으며, 그중 하나가 기본 주소로 지정됩니다.

## 도메인 탭 위치

**웹사이트**를 열고, 사이트를 클릭한 다음, 사이트 왼쪽 메뉴에서 **설정** 그룹을 열고 **도메인**를 선택하세요. 페이지 제목은 **도메인**이며, 이 사이트에 연결된 도메인을 관리한다고 설명되어 있습니다.

같은 메뉴에 있는 이웃 항목인 **DNS**는 사이트와 도메인의 연결 상태가 아니라 도메인의 레코드를 보여줍니다. 이에 대해서는 [사이트 DNS 탭](https://support.kapsulehost.com/ko-kr/site-dns-tab)을 참고하세요.

![KPanel에서 사이트에 연결된 도메인을 관리하는 사이트의 Domains 페이지](https://support.kapsulehost.com/help/screenshots/site-domains-tab.43432689.webp)

## 도메인 목록 읽는 법

사이트에 연결된 각 도메인은 다음을 보여주는 행으로 표시됩니다.

- 도메인 이름
- **DNS 활성** 또는 **DNS 대기 중** 표시
- 사이트의 기본 URL인 도메인에는 **Primary** 표시와 *이 사이트의 기본 URL*이라는 안내
- 나머지 도메인에는 **주 도메인으로 변경** 버튼
- 제거 컨트롤

**DNS 활성**은 해당 도메인이 현재 이 사이트의 서버로 연결(resolve)됨을 의미합니다. **DNS 대기 중**은 아직 그렇지 않다는 뜻입니다. 새로 추가한 외부 도메인은 항상 대기 중 상태로 시작합니다.

다른 곳에서 DNS를 변경한 뒤에는 페이지 전체를 새로고침하기보다, 오른쪽 상단의 **Refresh**를 클릭하세요. 이 확인은 실시간으로 이루어지며 캐시된 값이 아닙니다.

## KapsuleHost에 등록한 도메인 연결하기

이 방법이 가장 쉽습니다. KapsuleHost가 이미 해당 도메인의 DNS를 운영하고 있기 때문입니다.

1. 추가 카드에서 **내 도메인** 탭을 선택합니다.
2. **Select a domain** 목록에서 도메인을 선택합니다.
3. **Connect**를 클릭합니다.

DNS, SSL, CDN이 자동으로 설정되며, 해당 도메인이 사이트의 기본 URL이 됩니다. 확인 메시지에도 그대로 나타납니다. 도메인이 연결되어 기본으로 설정되었고, CDN은 백그라운드에서 활성화 중이라는 내용입니다.

> **Note:** CDN 부분은 호스팅 플랜에 따라 다릅니다. CDN 등급이 포함된 플랜은 엣지 캐싱이 자동으로 활성화되며, 포함되지 않은 플랜은 이 단계를 건너뛸 뿐 도메인은 평소대로 정상 작동합니다. 어떤 플랜에 어떤 등급이 포함되는지는 [CDN 활성화하기](https://support.kapsulehost.com/ko-kr/cdn-enabling)에서 설명합니다.

목록에는 계정 내 도메인 중 아직 다른 곳에 연결되지 않은 도메인만 표시됩니다. 원하는 도메인이 목록에 없다면, 이 계정에 등록되어 있지 않거나 이미 다른 사이트에 연결되어 있는 것입니다.

아직 도메인이 없으신가요? 페이지에는 도메인 검색으로 바로 연결되는 **Register or transfer a domain** 링크가 있습니다.

## 외부 도메인 추가하기

도메인이 다른 곳에 등록되어 있다면 순서가 반대입니다. 먼저 DNS를 저희 쪽으로 연결한 다음, 여기에 추가하세요.

1. 추가 카드에서 **외부 도메인** 탭을 선택합니다.
2. 도메인을 입력합니다. 전체 URL을 붙여넣어도 되며, 앞의 `https://`과 끝의 슬래시는 자동으로 제거됩니다.
3. **Add**를 클릭합니다.

도메인은 즉시 추가되며 **DNS 대기 중** 표시가 붙고, DNS가 저희 쪽으로 연결되면 인증서가 자동으로 발급됩니다.

### 생성해야 할 레코드

페이지에는 필요한 레코드와 복사 버튼이 있는 서버 IP 주소가 표시됩니다. 현재 사용 중인 DNS 호스트에 다음 두 레코드를 생성하세요.

| 레코드 | 이름 | 연결 대상 |
|---|---|---|
| A | `@` (루트 도메인) | 페이지에 표시된 IP 주소 |
| A | `www` | 동일한 IP 주소 |

IP 주소는 다른 출처가 아닌 반드시 이 페이지에서 복사하세요. 이 특정 사이트가 위치한 서버의 주소이기 때문입니다.

변경 사항은 보통 몇 분 안에 적용되지만, 이전 TTL 값에 따라 몇 시간이 걸릴 수도 있습니다. 페이지가 스스로 알아챌 때까지 기다리기보다 **Refresh**를 클릭해 다시 확인하세요.

> **Warning:** DNS를 저희 쪽으로 연결하기 전에 외부 도메인을 여기에 추가한 뒤 사이트가 바로 작동한다고 생각하지 마세요. 표시가 **DNS 활성**으로 바뀌기 전까지는 방문자가 여전히 기존 레코드가 가리키는 곳으로 연결되며, 인증 기관이 저희 쪽으로 연결되지 않는 도메인을 확인할 수 없으므로 인증서도 발급되지 않습니다.

도메인 전체를 KapsuleHost로 이전해 이 모든 과정을 대신 처리하고 싶으시다면, [KapsuleHost로 도메인 이전하기](https://support.kapsulehost.com/ko-kr/domain-transfer-in)와 [네임서버](https://support.kapsulehost.com/ko-kr/nameservers)를 참고하세요.

## 기본 도메인 변경하기

기본 주소로 사용하려는 도메인에서 **주 도메인으로 변경**을 클릭한 다음 확인합니다. KPanel은 그 결과를 명확히 안내합니다. WordPress 사이트의 경우 사이트 URL이 새 도메인으로 업데이트되며, 두 도메인 모두 계속 작동합니다.

이 두 번째 부분이 중요합니다. 도메인을 기본으로 설정해도 다른 도메인이 꺼지는 것은 아닙니다. 연결된 모든 도메인이 계속 사이트를 서비스하며, 기본 도메인은 애플리케이션이 공식 주소로 취급하는 도메인일 뿐입니다.

> **Warning:** WordPress 사이트에서 기본 도메인을 변경하면 사이트 URL이 다시 작성되며, 이는 링크, 캐노니컬 태그, 그리고 이전 주소를 하드코딩한 모든 것에 영향을 줍니다. 먼저 백업을 받아두고, 변경 후 관리자 화면이 정상적으로 로드되는지, 내부 링크가 올바르게 연결되는지 확인하세요. [백업 받기](https://support.kapsulehost.com/ko-kr/taking-a-backup)와 [WordPress에서 찾기 및 바꾸기](https://support.kapsulehost.com/ko-kr/wordpress-search-replace) 두 페이지를 열어두면 좋습니다.

## 도메인 제거하기

해당 행의 제거 컨트롤을 클릭하고 확인합니다. 확인 메시지에는 이 도메인이 더 이상 이 사이트를 가리키지 않게 된다는 효과가 명확히 안내됩니다.

여기서 도메인을 제거해도 계정에서 도메인이 삭제되거나, 등록이 취소되거나, 등록기관의 DNS 레코드가 변경되지는 않습니다. 단지 이 도메인과 이 사이트 사이의 연결만 끊어집니다. 이후에도 DNS가 여전히 저희 쪽을 가리키고 있다면 방문자는 사이트 대신 오류 화면을 보게 되므로, 해당 레코드도 함께 업데이트하거나 제거하세요.

도메인은 한 번에 하나의 사이트에만 연결할 수 있으므로, 다른 사이트에 연결하기 전에 먼저 제거하세요.

## 문제 해결

**표시가 계속 DNS 대기 중 상태입니다.** 조회 도구를 사용해 DNS 호스트의 레코드를 확인하고, A 레코드 값이 이 페이지에 표시된 IP와 정확히 일치하는지 확인하세요. 아주 흔한 실수는 루트 도메인에 CNAME을 생성하는 것인데, 대부분의 제공업체는 이를 지원하지 않습니다.

**`www` 없이는 사이트가 로드되지만 있으면 로드되지 않거나, 그 반대입니다.** 두 A 레코드 중 하나만 생성한 상태입니다. 루트 도메인과 `www` 모두 같은 주소를 가리켜야 합니다.

**인증서가 나타나지 않습니다.** 인증서는 DNS가 저희 쪽으로 연결된 이후에 발급되며, 그 전에는 발급되지 않습니다. 표시가 **DNS 활성**으로 바뀌면 몇 분 정도 기다려 보세요. 그래도 나타나지 않으면 [SSL 인증서](https://support.kapsulehost.com/ko-kr/ssl-certificates)를 참고하세요.

**Connect 버튼이 비활성화되어 있거나 목록에 도메인이 없습니다.** 해당 도메인이 다른 사이트에 연결되어 있는 상태입니다. 먼저 그곳에서 제거하세요.

**이전 사이트가 계속 표시됩니다.** 브라우저 또는 중간 리졸버에 이전 응답이 캐시되어 있는 상태입니다. 변경 사항이 적용되지 않았다고 판단하기 전에 다른 네트워크나 비공개 창에서 확인해 보세요.

## 다음으로 볼 내용

- [사이트 DNS 탭](https://support.kapsulehost.com/ko-kr/site-dns-tab): 레코드 자체를 보고 편집하려면
- [도메인 추가하기](https://support.kapsulehost.com/ko-kr/adding-your-domain): 전반적인 도메인 설정 안내
- [사이트 설정](https://support.kapsulehost.com/ko-kr/site-settings): 인증서가 적용되면 켜고 싶은 Force HTTPS 스위치에 대한 안내
