Cloudflare에서 DNS 자동 설정하기

TrekMail은 Cloudflare에서 DNS를 관리하는 도메인에 이메일 DNS 레코드를 만들 수 있습니다. 두 방법 모두 레코드를 쓰기 전에 확인 단계를 보여 주며 DNS 검증은 그 뒤에 진행됩니다. 도메인에 맞는 방법을 선택하세요.

방법 1: 조건을 충족하는 단일 도메인 자동 설정

DNS 및 상태 탭에 이 기능이 표시된다면 Cloudflare 도메인 하나를 설정하는 가장 빠른 방법입니다. API 토큰이 필요하지 않습니다. 발송 전용 도메인이나 다른 DKIM 선택자가 필요한 도메인처럼 일부 구성에서는 버튼이 나타나지 않습니다.

1. 도메인의 DNS 및 상태 탭을 엽니다.
2. DNS 자동 설정을 클릭합니다.
3. Cloudflare로 이동하여 추가될 레코드를 검토합니다.
4. Cloudflare에서 변경 사항을 승인합니다.
5. TrekMail로 돌아옵니다. 제공업체 절차가 끝나면 DNS 검사가 시작됩니다. TrekMail 상태가 갱신될 때까지 설정이 완료된 것으로 보지 마세요.

이 방법은 Domain Connect 프로토콜을 사용합니다. 도메인은 Cloudflare DNS와 네임서버를 사용해야 합니다.

AI 에이전트가 도메인을 추가했다면 get_domain_connect_setup을 호출하도록 요청하세요. 받은 링크를 브라우저에서 열고 직접 변경을 승인하세요. 링크를 사용할 수 없으면 도구가 확인할 사항을 설명합니다.

White Label 스위치는 브랜드 포털에만 적용되며 해당 포털의 브랜드 프로필을 사용합니다. TrekMail 기본 대시보드에서는 DNS 관리 권한이 있는 사용자가 스위치가 꺼져 있어도 원클릭 설정을 사용할 수 있습니다. 도메인 호환성과 Cloudflare 승인은 계속 필요합니다.

방법 2: API 토큰으로 단일 또는 여러 도메인 설정

여러 도메인을 한 번에 설정하거나 해당 도메인에서 Domain Connect를 사용할 수 없을 때 이 방법을 이용하세요.

작동 방식

1. Cloudflare에서 API 토큰을 만듭니다.
2. TrekMail이 토큰으로 접근할 수 있는 Cloudflare 영역을 찾아 추가하거나 연결할 수 있는 도메인을 보여 줍니다.
3. 변경 사항을 검토하고 적용합니다. TrekMail이 도메인을 추가하고 DNS 레코드를 자동으로 생성합니다.

단계별 안내

1단계: Cloudflare 연결

1. TrekMail에서 도메인을 열고 '도메인 추가' 카드의 Cloudflare 탭을 클릭합니다. /app/domains?add=cloudflare로 바로 이동할 수도 있습니다.
2. Cloudflare 열기를 클릭해 토큰 생성 페이지를 엽니다.
3. Cloudflare에서 다음 작업을 합니다.
   • Create Token을 클릭합니다.
   • Edit zone DNS 템플릿을 사용하거나 Zone → DNS → Edit 권한의 사용자 지정 토큰을 만듭니다.
   • Zone Resources에서 TrekMail이 관리할 영역만 선택합니다. 많은 영역을 의도적으로 한꺼번에 연결할 때만 All zones를 사용하세요.
   • 이 작업과 관련 없는 권한은 추가하지 않습니다.
   • Continue to summary → Create Token을 클릭합니다.
   • 토큰을 복사합니다. Cloudflare는 토큰을 한 번만 보여 줍니다.
4. TrekMail에 토큰을 붙여 넣습니다. 녹색 확인 표시가 나오면 유효합니다.

2단계: 도메인 선택

TrekMail이 토큰으로 접근할 수 있는 Cloudflare 영역을 표시합니다. 계속하기 전에 선택을 확인하고 연결하지 않을 도메인은 체크를 해제하세요.

• DNS 설정: 도메인이 이미 TrekMail에 있으며 DNS 레코드만 설정합니다.
• 추가 및 DNS 설정: 새 도메인을 TrekMail에 추가하고 DNS도 자동으로 설정합니다.

Cloudflare에서 DNS를 관리하지 않는 도메인은 목록에 나타나지 않습니다.

3단계: DNS 레코드 적용

TrekMail이 선택한 도메인별로 변경 내용을 미리 보여 줍니다.

• 추가 예정: 새 DNS 레코드를 만듭니다.
• 병합 예정: 기존 SPF 레코드에 TrekMail을 추가합니다.
• 설정됨: 변경할 내용이 없습니다.
• 교체 예정: 기존 레코드가 TrekMail 요구 사항과 충돌합니다. 해당 레코드의 교체 / 유지 선택 항목에서 결정하세요. 교체는 기존 값을 TrekMail 값으로 덮어 쓰고 유지는 현재 레코드를 그대로 둡니다.

적용하기 전에 기록할 레코드를 정확히 선택할 수도 있습니다. 각 레코드에 체크 상자가 있으므로 지금은 MX와 SPF만 적용하고 DKIM은 나중에 처리하거나, 다른 곳에서 관리하는 레코드를 제외할 수 있습니다. 체크를 해제한 내용은 변경되지 않습니다.

모든 도메인에 DNS 적용을 클릭하면 선택한 레코드가 생성됩니다. 적용이 끝나면 TrekMail이 DNS 검사를 예약합니다. 이 검사는 공개 DNS에 실제로 보이는 값을 확인하며 설정 완료 여부를 판단하는 최종 상태입니다.

일괄 설정

Cloudflare에 도메인이 많다면 안내 화면에서 한 번에 처리할 수 있습니다.

1. Cloudflare에서 API 토큰을 만들 때 Zone Resources에서 All zones를 선택합니다.
2. 2단계에서 포함할 도메인을 선택하고 다시 검토합니다.
3. TrekMail이 새 도메인을 추가하고 각 도메인에 DNS 레코드를 차례로 적용합니다.

요금제 제한

현재 요금제의 도메인 수 제한이 적용됩니다.

• Nano: 전체 최대 10개 도메인
• Starter: 전체 최대 50개 도메인
• Pro: 전체 최대 100개 도메인
• Agency: 전체 최대 1,000개 도메인

한 번에 최대 50개 도메인을 연결할 수 있습니다. 새 도메인도 요금제 한도에 포함됩니다.

보안

• API 토큰은 암호화하여 저장하며 TrekMail은 토큰 값을 로그에 기록하지 않습니다.
• 미리보기에 표시된 내용이 TrekMail에서 생성하거나 수정할 수 있는 범위입니다. SPF 병합이나 충돌 레코드가 있다면 특히 주의해서 확인하세요.
• Cloudflare 연결을 해제하면 TrekMail이 이후 DNS를 변경할 수 없습니다. 이미 기록된 레코드는 되돌리지 않습니다.

문제 해결

'이 API 토큰은 유효하지 않거나 만료되었습니다'

Cloudflare에서 새 토큰을 만드세요. Cloudflare가 표시할 때 복사하여 TrekMail에 붙여 넣습니다. 비밀번호처럼 안전하게 보관하세요.

'Cloudflare 계정에서 도메인을 찾을 수 없습니다'

도메인이 Cloudflare에 추가되어 있고 상태가 Active인지 확인하세요.

'DNS 레코드를 수정할 권한이 없습니다'

토큰에 DNS 수정 권한이 필요합니다. Permissions → Add more → Zone → DNS → Edit 권한으로 새 토큰을 만드세요.

설정 후에도 DNS가 대기 중으로 표시됨

DNS 검사가 실행될 시간을 준 뒤 필요하면 도메인의 DNS 페이지에서 DNS 확인을 사용하세요. 캐시 시간은 레코드 TTL과 확인자에 따라 달라지므로 몇 분이나 몇 시간처럼 고정된 시간을 보장으로 생각하면 안 됩니다. 변경 사항을 다시 적용하기 전에 TrekMail이 누락 또는 충돌로 표시하는 구체적인 레코드를 확인하세요.

Cloudflare의 최신 절차와 권한은 DNS 레코드 관리 및 API 토큰 권한 문서를 참고하세요.