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

# 도메인 (Domain)

> 커스텀 도메인 연결과 GEO 페이지 라우팅 작동 방식

도메인 설정에서는 GEO 페이지를 기본 Anymorph 서브도메인 대신 브랜드 자체 도메인에서 서비스할 수 있습니다. 이는 SEO 권위에 매우 중요합니다. 브랜드 도메인의 페이지는 Anymorph가 아닌 **브랜드의** 백링크 프로필과 인용 권위를 강화합니다.

## 왜 도메인 연결이 중요한가

AI 엔진이 페이지를 인용할 때, 인용 링크는 해당 페이지가 위치한 **도메인**을 가리킵니다. GEO 페이지가 `yourdomain.com/a/best-crm-tools`에 있다면, 인용 권위가 `yourdomain.com`으로 흘러갑니다. 이는 [도메인 권위](/ko/concepts/how-geo-works)를 강화하며, 도메인 권위는 향후 AI 인용의 1순위 예측 지표입니다.

## 3가지 라우팅 모드

Anymorph는 호스팅 플랫폼에 따라 세 가지 도메인 연결 방식을 지원합니다.

### A 레코드 라우팅 (대부분 권장)

apex 도메인 (예: `example.com`) 또는 URL 리라이트를 지원하지 않는 플랫폼의 서브도메인에 적합합니다.

**작동 방식:**

```
사용자가 yourdomain.com/a/page 방문
    → DNS가 Anymorph 프록시로 해석 (A 레코드)
    → Anymorph가 경로 확인:
        /a/* → GEO 페이지 서빙
        기타  → 원본 사이트로 포워딩
```

Anymorph가 **리버스 프록시** 역할을 합니다. GEO 페이지 경로는 Anymorph가 서빙하고, 나머지 모든 경로는 원본 웹사이트로 투명하게 포워딩됩니다. 방문자는 차이를 알 수 없습니다.

**필요한 DNS 레코드:**

| 타입    | 이름                               | 값                                                                 | 용도                             |
| ----- | -------------------------------- | ----------------------------------------------------------------- | ------------------------------ |
| A     | `@` 또는 서브도메인                     | `99.83.186.151`                                                   | 기본 서버 (AWS Global Accelerator) |
| A     | `@` 또는 서브도메인                     | `75.2.96.173`                                                     | 보조 서버 (고가용성)                   |
| CNAME | `_acme-challenge.yourdomain.com` | `_acme-challenge.yourdomain.com.challenges.saascustomdomains.com` | SSL 인증서 프로비저닝                  |

<Warning>
  고가용성을 위해 A 레코드를 **두 개 모두** 추가하세요. 무중단 SSL 프로비저닝을 위해 ACME 챌린지 CNAME을 A 레코드 **이전에** 추가하세요.
</Warning>

### CNAME 라우팅 (서브도메인용)

`blog.example.com`이나 `geo.example.com` 같은 서브도메인에 적합합니다.

**DNS 레코드:**

| 타입    | 이름               | 값                    |
| ----- | ---------------- | -------------------- |
| CNAME | 서브도메인 (예: `geo`) | `proxy.anymorph.app` |

SSL은 Cloudflare를 통해 자동 프로비저닝됩니다. 설정이 간단하지만 서브도메인에서만 작동합니다 (apex 도메인은 불가).

### Path 라우팅 (Vercel, Netlify 등)

URL 리라이트를 지원하는 플랫폼에서 사이트를 운영 중이라면, 플랫폼에서 직접 GEO 페이지 경로를 라우팅할 수 있습니다. DNS 변경이 필요 없습니다.

**지원 플랫폼:**

| 플랫폼                  | 설정 방법                                                                                     |
| -------------------- | ----------------------------------------------------------------------------------------- |
| **Vercel**           | `vercel.json`에 리라이트 추가: `"/a/:path*"` → `"https://your-slug.proxy.anymorph.app/a/:path*"` |
| **Netlify**          | `netlify.toml` 또는 `_redirects`에 추가: `/a/*` → 프록시 URL (status 200)                         |
| **Cloudflare Pages** | `_routes.json`에 추가하거나 Worker 사용                                                           |
| **AWS CloudFront**   | `/a/*` 경로 패턴에 대한 오리진 + 캐시 동작 추가                                                           |

<Tip>
  Path 라우팅이 가장 빠른 설정 방법입니다. DNS 변경도, SSL 대기도 필요 없습니다. 플랫폼이 지원한다면 여기서 시작하세요.
</Tip>

## Origin URL 설정

A 레코드 또는 CNAME 라우팅 사용 시, **Origin URL** – 사이트가 원래 호스팅되는 플랫폼 URL – 을 지정해야 합니다. Anymorph는 GEO가 아닌 트래픽을 이 주소로 포워딩합니다.

| 플랫폼         | Origin URL                            | 참고                                              |
| ----------- | ------------------------------------- | ----------------------------------------------- |
| Webflow     | `https://your-site.webflow.io`        | `cdn.webflow.com`이 아닌 `.webflow.io` 스테이징 URL 사용 |
| Framer      | `https://your-site.framer.app`        | Framer 설정의 기본 URL                               |
| Wix         | `https://username.wixsite.com/mysite` | 기본 도메인                                          |
| Squarespace | `https://your-site.squarespace.com`   | 기본 도메인                                          |
| Shopify     | `https://your-store.myshopify.com`    | Shopify 서브도메인                                   |

<Warning>
  Webflow의 경우: Origin에 `cdn.webflow.com`을 사용하지 **마세요**. DNS를 Webflow의 CNAME에서 Anymorph의 A 레코드로 변경하면 Webflow가 커스텀 도메인을 비활성화하여 404 에러가 발생합니다. `.webflow.io` 스테이징 URL은 DNS 설정과 관계없이 작동합니다.
</Warning>

## 도메인 인증 상태

DNS 설정 후, 도메인은 세 단계를 거쳐 활성화됩니다:

| 상태              | 진행 내용                                    | 소요 시간 |
| --------------- | ---------------------------------------- | ----- |
| **Pending SSL** | DNS 레코드 감지됨, ACME 챌린지 검증 중, SSL 인증서 발급 중 | 5–15분 |
| **SSL Active**  | 인증서 발급 완료, 도메인 서빙을 위한 프록시 구성 중           | 1–5분  |
| **Active**      | 완전히 연결됨 – GEO 페이지가 도메인에서 라이브             | 완료    |

대시보드는 15초마다 상태를 폴링하며 자동으로 업데이트됩니다.

<Note>
  DNS 전파는 보통 5–30분이 걸리지만, DNS 제공업체와 TTL 설정에 따라 최대 48시간이 소요될 수 있습니다. 도메인이 1시간 이상 "Pending SSL" 상태라면 DNS 레코드를 다시 확인하세요.
</Note>

## IndexNow 연동

도메인이 연결되면 **IndexNow**를 활성화할 수 있습니다. IndexNow는 새 GEO 페이지가 발행될 때 검색 엔진 (Bing, Yandex 등)에 즉시 알리는 프로토콜로, 인덱싱 속도를 며칠에서 몇 시간으로 단축합니다.

## 연결 테스트

설정 완료 후 헬스 체크 엔드포인트로 확인하세요:

```bash theme={null}
curl https://yourdomain.com/__check__
```

| 응답                           | 의미                 |
| ---------------------------- | ------------------ |
| `"status": "connected"`      | 정상 작동              |
| `"status": "not_configured"` | 프록시에서 도메인을 찾을 수 없음 |
| `"status": "disabled"`       | 도메인 비활성화됨          |

## 트러블슈팅

<AccordionGroup>
  <Accordion title="도메인이 Pending SSL에서 멈춤">
    * `_acme-challenge` CNAME이 정확한지 확인하세요 (`.challenges.saascustomdomains.com` 접미사 포함)
    * Cloudflare를 사용 중이라면 CNAME을 프록시가 아닌 **DNS Only** (회색 구름)로 설정하세요
    * 인증서 발급을 차단할 수 있는 CAA 레코드가 있는지 확인하세요
    * DNS 전파 완료까지 최대 48시간을 기다리세요
  </Accordion>

  <Accordion title="Anymorph에서는 페이지가 로드되지만 커스텀 도메인에서는 안 됨">
    * 설정에서 도메인 상태가 **Active**인지 확인하세요
    * A 레코드가 `99.83.186.151`과 `75.2.96.173`을 가리키는지 확인하세요
    * GEO 페이지가 실제로 [발행](/ko/dashboard/geo-pages)되어 있는지 확인하세요
  </Accordion>

  <Accordion title="원본 사이트가 로드되지 않음 (GEO 외 경로 오류)">
    * **Origin URL**이 정확한지 확인하세요 (CDN이 아닌 스테이징/기본 URL 사용)
    * Webflow의 경우 `cdn.webflow.com`이 아닌 `.webflow.io` 사용
    * 브라우저에서 Origin URL에 직접 접속하여 접근 가능한지 테스트하세요
  </Accordion>

  <Accordion title="Mixed content 또는 HTTPS 오류">
    * SSL 상태가 **Active**로 표시될 때까지 기다리세요
    * 원본 사이트가 HTTPS를 지원하는지 확인하세요
    * Cloudflare를 사용 중이라면 프록시를 비활성화하세요 (DNS Only 모드 사용)
  </Accordion>
</AccordionGroup>

## 관련 페이지

<CardGroup cols={2}>
  <Card title="GEO 페이지" icon="file-lines" href="/ko/dashboard/geo-pages">
    커스텀 도메인에서 서비스할 페이지를 생성하고 발행합니다.
  </Card>

  <Card title="GEO 작동 방식" icon="gears" href="/ko/concepts/how-geo-works">
    도메인 권위가 AI 인용을 이끄는 이유를 이해합니다.
  </Card>
</CardGroup>
