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

# 사용자 지정 도메인 연결

> 공유 GetQR 단축 도메인 대신 qr.yourbrand.com 같은 자체 하위 도메인에서 QR 코드 링크를 제공하세요.

`qr.yourbrand.com`처럼 소유한 하위 도메인을 연결하면 새 QR 코드가 공유 GetQR 단축 도메인 대신 내 도메인을 사용합니다. 사람들은 스캔할 때 내 브랜드를 보게 되며, GetQR이 HTTPS 인증서를 발급하고 갱신합니다.

> [!NOTE]
>
> 사용자 지정 도메인은 베타 기능이며 아직 모든 워크스페이스에서 사용할 수 있는 것은 아닙니다. 계정 설정에 **Domains** 탭이 보이지 않는다면 워크스페이스에서 이 기능이 활성화되지 않은 것입니다.

## 시작하기 전에

* **Admin** 또는 **Editor** 역할이 필요합니다. **Viewer**는 도메인 목록을 볼 수 있지만 아무것도 변경할 수 없습니다.
* 등록 기관 또는 DNS 제공업체(예: Cloudflare, GoDaddy, Namecheap, Squarespace)에서 도메인의 DNS 설정에 접근할 수 있어야 합니다. 다른 사람이 DNS를 관리한다면 설정 중에 정확한 값을 다운로드하여 전달할 수 있습니다.
* 워크스페이스당 최대 3개의 도메인을 연결할 수 있습니다.
* 루트 도메인이 아닌 **하위 도메인**을 연결합니다. `qr.yourbrand.com`은 사용할 수 있지만 `yourbrand.com`과 `www.yourbrand.com`은 사용할 수 없습니다. 루트 도메인의 웹사이트와 이메일에는 영향이 없습니다.

## 도메인 연결하기

**1. Domains 탭 열기**

사이드바에서 프로필 메뉴를 열고 **My Account**를 클릭합니다. 그런 다음 **Domains** 탭을 선택합니다.

**2. 설정 시작**

**Connect a domain**을 클릭합니다.

> [!TIP]
>
> QR 코드 빌더에서 시작할 수도 있습니다. **Custom short link** 필드의 도메인 드롭다운을 열고 **Connect a domain**을 클릭하세요.

**3. 하위 도메인 선택**

**Choose a subdomain**에서 접두사 **qr**, **go**, **scan**, **link** 중 하나를 선택합니다. 원하는 접두사를 사용하려면 **Custom**을 클릭하고 **Subdomain** 필드에 입력합니다.

**4. 루트 도메인 입력**

**Your domain**에 루트 도메인만 입력합니다(예: `yourbrand.com`). GetQR이 전체 호스트 이름을 자동으로 확인하고 \*\*Checking availability…\*\*를 표시합니다.

**5. 호스트 이름 사용 가능 여부 확인**

호스트 이름을 사용할 수 있다는 메시지가 표시될 때까지 기다립니다. **Your codes will look like** 아래의 미리보기에서 링크가 어떻게 보일지 확인할 수 있습니다. **Continue**를 클릭합니다.

**6. DNS 레코드 복사**

**Add one DNS record**에서 복사 버튼으로 **Name** 및 **Target** 값을 복사합니다. 레코드 유형은 항상 **CNAME**이며, **Proxy**는 반드시 **DNS only — grey cloud**여야 합니다.

> [!TIP]
>
> DNS를 직접 관리하지 않나요? **Download instructions**를 클릭하면 개발자나 IT 팀에 전달할 정확한 값이 담긴 파일을 받을 수 있습니다.

**7. DNS 제공업체에서 CNAME 레코드 추가**

새 탭에서 DNS 제공업체를 열고 복사한 **Name**과 **Target**으로 CNAME 레코드 하나를 추가합니다. TTL은 Auto(기본값)로 설정합니다. 아래 [제공업체별 팁](#provider-tips)을 참조하세요.

**8. GetQR이 요청하는 경우 CAA 레코드 추가**

설정 화면에 CAA 경고가 표시되면 루트 도메인에 GetQR의 인증 기관을 차단하는 CAA 레코드가 있는 것입니다. 경고에 표시된 추가 레코드를 추가하세요. 다음과 같은 형태입니다.

```text theme={null}
yourbrand.com. CAA 0 issue "letsencrypt.org"
```

경고가 없다면 이 단계를 건너뜁니다.

**9. 레코드를 추가했다고 GetQR에 알리기**

GetQR로 돌아와 **I've added the record**를 클릭합니다. GetQR이 즉시 DNS를 확인하고 인증 화면으로 이동합니다.

**10. 인증 대기**

GetQR이 자동으로 확인하고 HTTPS를 설정합니다. 인증은 DNS 제공업체와 지역에 따라 보통 최대 1시간이 걸립니다. 창을 닫아도 됩니다. GetQR은 계속 확인하며 도메인이 활성화되면 이메일을 보냅니다.

더 빨리 확인하려면 **Check now**를 클릭합니다.

**11. 도메인 테스트**

도메인이 활성화되면 HTTPS로 활성화되었다는 표시가 나타납니다. 테스트 링크(`your-subdomain/test`)를 열어 기기에서 작동하는지 확인한 다음 **Done**을 클릭합니다.

## 제공업체별 팁

제공업체마다 레이블이 조금씩 다르지만 레코드는 항상 같습니다. GetQR에 표시된 **Name**과 **Target**으로 된 **CNAME** 레코드 하나입니다.

**Cloudflare**

1. 루트 도메인의 DNS 레코드를 엽니다.
2. **CNAME** 유형의 레코드를 추가합니다.
3. GetQR의 **Name**(예: `qr`)과 **Target**을 붙여넣습니다.
4. 주황색 구름을 꺼서 프록시 상태가 **DNS only**로 표시되도록 합니다.
5. 레코드를 저장합니다.

> [!WARNING]
>
> Cloudflare는 기본적으로 새 레코드를 프록시합니다. 레코드가 프록시되는 동안(주황색 구름)에는 인증서를 발급할 수 없으며 스캔이 실패합니다.

**GoDaddy**

1. 루트 도메인의 DNS 설정을 엽니다.
2. **CNAME** 유형의 새 레코드를 추가합니다.
3. 이름(호스트) 필드에 GetQR의 **Name**을 입력합니다(예: `qr`).
4. 값(가리키는 대상) 필드에 GetQR의 **Target**을 붙여넣습니다.
5. TTL은 기본값으로 두고 저장합니다.

**Namecheap**

1. 루트 도메인의 DNS 설정을 엽니다.
2. **CNAME** 유형의 새 레코드를 추가합니다.
3. 호스트 필드에 GetQR의 **Name**을 입력합니다(예: `qr`).
4. 값(대상) 필드에 GetQR의 **Target**을 붙여넣습니다.
5. TTL은 Automatic으로 두고 저장합니다.

**Google / Squarespace**

Google Domains에 등록된 도메인은 이제 Squarespace에서 관리합니다.

1. 루트 도메인의 DNS 설정을 엽니다.
2. **CNAME** 유형의 사용자 지정 레코드를 추가합니다.
3. 호스트 필드에 GetQR의 **Name**을 입력합니다(예: `qr`).
4. 데이터(값) 필드에 GetQR의 **Target**을 붙여넣습니다.
5. 레코드를 저장합니다.

> [!TIP]
>
> 대부분의 제공업체는 이름에 루트 도메인을 자동으로 추가합니다. `qr.yourbrand.com`이 아닌 하위 도메인 부분(`qr`)만 입력하세요. 그렇지 않으면 `qr.yourbrand.com.yourbrand.com`이 될 수 있습니다.

## QR 코드에 도메인 사용하기

도메인이 활성화되면 빌더에서 QR 코드별로 도메인을 선택합니다. **Custom short link** 필드에서 도메인 드롭다운을 열고 내 도메인을 선택하세요. 아직 설정 중인 도메인은 목록에 **Setting up** 레이블과 함께 표시되며 아직 선택할 수 없습니다. [사용자 지정 단축 링크 만들기](/ko/short-links/create-short-link)를 참조하세요.

> [!WARNING]
>
> QR 코드는 생성 시 사용한 도메인을 유지합니다. 기존 코드는 새 도메인으로 이동하지 않으며, 도메인을 제거하면 해당 도메인의 모든 QR 코드가 스캔되지 않습니다.

## 설정

| 설정 | 기능 |
| - | - |
| **Subdomain** | 호스트 이름의 접두사(예: `qr`). 문자, 숫자, 하이픈만 사용할 수 있습니다. `www`는 허용되지 않습니다. |
| **Your domain** | 루트 도메인(예: `yourbrand.com`). 여기에 하위 도메인을 포함하지 마세요. |
| **Type** | 항상 **CNAME**. |
| **Name** | DNS 제공업체에 입력할 하위 도메인 레이블. |
| **Target** | 레코드가 가리키는 GetQR 호스트 이름. 도메인마다 고유하므로 항상 앱에서 복사하세요. |
| **Proxy** | 반드시 **DNS only — grey cloud**여야 합니다. 프록시된 레코드는 인증서 발급을 차단합니다. |

## 활용 사례

* **브랜드 신뢰.** 사람들이 스캔할 때 링크 미리보기에 타사 도메인이 아닌 `qr.yourbrand.com`이 표시됩니다.
* **캠페인.** 도메인을 사용자 지정 단축 링크와 결합합니다(예: `qr.yourbrand.com/summer-menu`).
* **작은 인쇄물.** 짧은 호스트 이름은 덜 조밀한 QR 코드를 만들어 작은 크기에서도 더 안정적으로 스캔됩니다.

## 자주 발생하는 문제

> **Domains 탭이 보이지 않습니다**
>
> 사용자 지정 도메인은 베타 기능이며 워크스페이스별로 활성화됩니다. 계정 설정에 탭이 없다면 아직 워크스페이스에서 이 기능을 사용할 수 없습니다.

> **Connect a domain 버튼이 비활성화되어 있습니다**
>
> 워크스페이스에 이미 최대 개수인 3개의 도메인이 있습니다. 다른 도메인을 연결하려면 하나를 제거하세요. 버튼이 전혀 보이지 않는다면 **Viewer** 역할입니다. Admin 또는 Editor에게 요청하세요.

> **“Use a subdomain such as qr.yourbrand.com”**
>
> 루트 도메인을 입력했습니다. 루트 도메인은 다른 레코드가 필요하며 웹사이트와 이메일에 영향을 줄 수 있습니다. 하위 도메인 접두사를 선택하고 **Your domain**에는 루트 도메인만 입력하세요.

> **“www is reserved for your website”**
>
> `www`는 웹사이트를 가리키므로 GetQR에서 사용할 수 없습니다. `qr` 같은 다른 접두사를 선택하세요.

> **“already includes a subdomain”**
>
> **Your domain**에 하위 도메인을 입력했습니다(예: `qr.yourbrand.com`). 루트 도메인(`yourbrand.com`)만 입력하고 **Subdomain**에서 접두사를 선택하세요.

> **“This domain is already connected to another GetQR account”**
>
> 다른 GetQR 워크스페이스가 이미 이 호스트 이름을 사용하고 있습니다. 다른 하위 도메인을 선택하거나, 오류라고 생각되면 [help@getqr.com](mailto:help@getqr.com)으로 문의하세요.

> **“That domain can't be connected”**
>
> 호스트 이름이 예약되어 있거나 허용되지 않습니다. 다른 하위 도메인을 선택하세요.

> **인증에 시간이 오래 걸립니다**
>
> DNS 변경 사항이 전파되는 데 시간이 걸릴 수 있습니다. 레코드 유형, 이름, 대상이 앱과 정확히 일치하는지, 레코드가 프록시되지 않았는지 확인하세요. 각 상태의 의미는 [도메인 인증](/ko/custom-domains/verify-and-troubleshoot)을 참조하세요.

## 다음 단계

> **[도메인 인증](/ko/custom-domains/verify-and-troubleshoot)**
>
> 상태를 확인하고 DNS 또는 인증서 문제를 해결하세요.

> **[사용자 지정 단축 링크 만들기](/ko/short-links/create-short-link)**
>
> QR 코드에 내 도메인과 원하는 슬러그를 적용하세요.

> **[역할 및 권한](/ko/members/roles-and-permissions)**
>
> 도메인을 연결하고 제거할 수 있는 사람을 확인하세요.

> **[QR 코드 인쇄](/ko/downloads/printing)**
>
> 도메인이 활성화된 후에만 인쇄하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.