Supabase Custom SMTP와 Resend 연동

• 인증 메일 구성은 인증 처리, 메일 발송, 도메인 검증, 인증 결과 웹 화면을 연결한 구조
• 앱이 요청한 회원가입 확인·비밀번호 재설정 메일을 자체 도메인에서 발송하기 위한 구성
• 웹사이트 주소와 메일 발신 주소가 하나의 소유 도메인 아래에서 서로 다른 역할을 맡는 구성

해당 개념이 필요한 이유

Supabase Auth를 연결하면 별도의 메일 서비스를 설정하지 않아도 회원가입 확인 메일을 시험해 볼 수 있다. 그러나 기본 SMTP는 프로젝트 팀에 등록된 주소로만 발송하고, 현재 프로젝트당 시간당 2통으로 제한된다. 전송 SLA도 제공하지 않아 일반 사용자에게 메일을 보내는 출시 환경에는 적합하지 않다. Supabase Custom SMTP 문서

메일 내용을 바꾸려는 경우에도 조건이 있다. 2026년 6월 3일 이후 생성된 Supabase Free 프로젝트가 기본 SMTP를 사용하면 인증 메일 템플릿을 수정할 수 없다. 이것은 “Free 플랜에서는 템플릿 수정이 전부 불가능하다”는 뜻이 아니다. Free 프로젝트에 Custom SMTP를 연결하면 제목과 본문을 수정할 수 있다. 기존 Free 프로젝트와 유료 프로젝트에도 같은 제한이 일괄 적용되는 것은 아니다. Supabase 템플릿 정책 변경

AS-IS

sequenceDiagram
    autonumber
    participant App as 앱
    participant Auth as Supabase Auth
    participant Default as Supabase 기본 SMTP
    participant Inbox as 사용자 메일함

    App->>Auth: 회원가입 또는 비밀번호 재설정 요청
    Auth->>Default: 인증 메일 발송 요청
    Note over Default: 프로젝트 팀 주소만 허용<br/>현재 프로젝트당 시간당 2통
    Default-->>Inbox: 제한된 테스트 메일

TO-BE

sequenceDiagram
    autonumber
    participant App as 앱
    participant Auth as Supabase Auth
    participant DNS as Cloudflare DNS
    participant Resend as Resend SMTP
    participant Inbox as 사용자 메일함
    participant User as 사용자 브라우저
    participant Firebase as Firebase Hosting

    Note over DNS,Resend: 사전 설정: DNS에 Resend가 안내한 DKIM·발송 레코드를 등록
    Note over DNS,Firebase: 사전 설정: DNS에 Firebase가 안내한 웹·소유권·인증서 레코드를 등록
    Resend->>DNS: 발신 도메인 DNS 레코드 조회
    DNS-->>Resend: DKIM·발송 레코드 응답
    Resend->>Resend: 발신 도메인 검증
    Firebase->>DNS: 웹 도메인·인증서 레코드 조회
    DNS-->>Firebase: A·TXT 레코드 응답
    Firebase->>Firebase: 도메인 연결 및 HTTPS 인증서 확인

    App->>Auth: 가입 확인 또는 비밀번호 재설정 요청
    Auth->>Auth: 토큰 생성 및 템플릿 렌더링
    Auth->>Resend: SMTP로 인증 메일 전달
    Resend->>Inbox: 인증 메일 발송
    Inbox-->>User: 인증 메일 도착
    User->>Firebase: 메일의 인증 링크 열기
    Firebase->>Auth: 토큰 검증 요청
    Auth-->>Firebase: 검증 결과 전달
    alt 회원가입 확인
        Firebase-->>User: 가입 확인 완료 화면 표시
    else 비밀번호 재설정
        Firebase-->>User: 새 비밀번호 입력 화면 표시
        User->>Firebase: 새 비밀번호 입력
        Firebase->>Auth: 비밀번호 변경 요청
        Auth-->>Firebase: 변경 결과 전달
        Firebase-->>User: 변경 완료 화면 표시
    end

네 서비스는 각각 무엇을 하는가

컴포넌트	맡은 역할	입력	결과·다음 단계
Supabase Auth	계정 인증, 확인·재설정 토큰 생성, 인증 메일의 제목·본문·링크 구성	앱의 가입·재설정 요청, 사용자 이메일과 language 메타데이터	템플릿에 맞춘 메일을 SMTP로 전달하고, 링크에서 돌아온 토큰을 확인
Resend	SMTP 중계와 실제 이메일 발송, 발신 도메인의 이메일 인증 상태 확인	Supabase의 SMTP 연결과 메일 내용, DNS에 등록된 발신 도메인 레코드	사용자 메일함으로 이메일 전달, 발신 도메인 검증 상태 제공
Cloudflare DNS	도메인 이름별 DNS 레코드 저장 및 조회 응답	Resend가 제시하는 메일 레코드, Firebase가 제시하는 웹·인증서 레코드	메일 서버에는 발신 인증 레코드를, 웹 요청에는 Hosting 연결 정보를 응답
Firebase Hosting	가입 확인 및 비밀번호 재설정 웹 페이지 제공, HTTPS 처리	사용자가 연 인증 URL, URL에 포함된 인증 정보	가입 완료 화면 표시 또는 새 비밀번호를 받아 Supabase Auth에 변경 요청

따라서 제목과 본문을 바꿀 때는 Supabase Auth의 Email Templates를 수정한다. Resend는 그 결과물을 전달하며 메일 템플릿의 편집 장소가 아니다. Supabase 이메일 템플릿 문서

Cloudflare DNS는 웹사이트를 호스팅하거나 이메일을 발송하지 않는다. DNS 레코드를 보관하고 조회에 응답한다. Cloudflare Pages를 사용 중이어도 같은 도메인의 DNS가 Firebase Hosting을 가리키도록 구성할 수 있다. Cloudflare DNS FAQ, Firebase 커스텀 도메인 문서

도메인은 어디서 준비해야 하는가

메일을 noreply@auth.example.com에서 보내려면 먼저 상위 도메인 example.com을 소유하고 있어야 한다. Resend에 auth.example.com을 입력하는 것만으로 example.com의 소유권이 생기지는 않는다. example.com의 DNS를 수정할 수 있어야 Resend가 요구한 레코드를 추가하고 검증을 통과할 수 있다.

도메인 구매·갱신, DNS 관리, 메일 발송은 별개의 일이다. Cloudflare Registrar 또는 다른 등록업체에서 도메인을 구입하고, DNS는 Cloudflare에서 관리하며, 메일은 Resend에서 보내는 구성이 가능하다. Cloudflare의 무료 DNS 이용과 도메인의 등록·갱신 비용도 구분해야 한다. Cloudflare Registrar

example.com 하나를 소유했다면 dev.example.com, auth-dev.example.com, auth.example.com 등의 하위 도메인을 용도에 따라 만들 수 있다. 각 하위 도메인을 별도로 구매하는 방식이 아니다. 반면 Firebase가 제공한 프로젝트명.web.app 또는 프로젝트명.firebaseapp.com은 내 소유 도메인이 아니므로, 그 아래 임의의 주소를 Resend 발신 도메인으로 검증하는 용도로 사용할 수 없다.

웹 주소와 메일 주소를 분리하는 이유

용도	개발 환경 예시	운영 환경 예시
사용자가 방문할 웹 주소	dev.example.com	example.com
인증 메일 발신 도메인	auth-dev.example.com	auth.example.com
인증 메일 발신 주소	noreply@auth-dev.example.com	noreply@auth.example.com
가입 확인 화면	dev.example.com/auth/verified	example.com/auth/verified
비밀번호 재설정 화면	dev.example.com/auth/reset-password	example.com/auth/reset-password

auth.example.com은 메일 발신 주소의 도메인이다. 메일 속 링크가 열릴 웹사이트까지 반드시 auth.example.com이어야 한다는 뜻은 아니다. 위 예시에서는 웹 화면을 example.com과 dev.example.com의 Firebase Hosting에서 제공한다.

개발·운영은 Resend 계정 하나에 발신 도메인 두 개를 등록할 수 있다. 현재 Resend Free는 검증된 도메인 3개를 허용한다. 두 환경의 발송량은 같은 Resend 계정의 일·월 한도를 함께 사용한다. Resend 요금제, 무료 도메인 한도 변경

실제 설정 순서

1. Resend에서 발신 도메인 등록

Resend의 Domains에서 개발용 auth-dev.example.com과 운영용 auth.example.com을 등록한다. Resend가 각 도메인에 대해 제시하는 DNS 레코드를 확인한다. 도메인을 등록했다고 즉시 발송할 수 있는 것은 아니며, DNS 레코드를 게시한 뒤 Resend의 검증을 통과해야 한다.

2. Cloudflare DNS에 메일 레코드 게시

Resend가 보여 주는 DKIM TXT와 발송용 CNAME 등을 Cloudflare에 추가한다. 레코드의 이름과 값은 Resend 화면의 값을 그대로 사용한다. 지역과 도메인 설정에 따라 값이 달라질 수 있다. 메일 검증용 CNAME은 Cloudflare의 프록시를 끄고 DNS only로 둔다. 프록시를 켜면 검증 과정에서 원래 CNAME 값이 보이지 않을 수 있다. Cloudflare CNAME 검증 안내

3. Firebase Hosting에 웹 도메인 연결

Firebase Hosting의 커스텀 도메인 설정에서 개발·운영 웹 주소를 각각 연결한다. Firebase가 요구하는 소유권 TXT, HTTPS 인증서 확인용 레코드, 웹 연결용 A 레코드를 Cloudflare DNS에 추가한다.

DNS를 추가했다는 사실과 Firebase 화면에 Connected로 표시되는 것은 다르다. DNS 전파와 인증서 발급에 시간이 걸릴 수 있다. Firebase에서 Connected 상태를 확인하고, 실제 https:// 주소에서 예상한 웹 페이지가 열리는지 확인해야 한다. Firebase의 일반적인 A 레코드 예시는 199.36.158.100이지만, 설정할 때는 Firebase 콘솔이 해당 도메인에 제시한 값을 따른다. Firebase 커스텀 도메인 설정

4. Resend API key 준비

Supabase가 Resend SMTP에 접속할 때 사용하는 Password는 Resend 계정 로그인 비밀번호가 아니라 Resend API key다. SMTP 설정값은 Host smtp.resend.com, Port 465, Username resend, Password Resend API key다. Resend SMTP 안내

메일 발송만 필요하므로 API key 권한은 Sending access면 된다. 하나의 키에 All domains를 허용하면 등록된 발신 도메인들에 함께 사용할 수 있다. 개발·운영 키를 따로 만들고 각각 해당 도메인으로 범위를 제한하면 키를 교체하거나 문제가 발생했을 때 영향 범위를 좁히기 쉽다. 키의 실제 값은 문서·저장소·스크린샷에 기록하지 않는다.

5. Supabase Custom SMTP와 템플릿 설정

각 환경의 Supabase Auth에서 Emails → SMTP Settings로 이동해 Custom SMTP를 켠다. 발신 주소와 이름을 입력하고, Resend의 SMTP 설정값 및 API key를 저장한다.

메일의 제목과 내용은 Emails → Templates에서 Confirm sign up, Reset password를 각각 수정한다. Supabase는 Go 템플릿을 지원하므로 앱이 회원가입 때 전달한 language 메타데이터에 따라 한국어와 영어를 나눌 수 있다. 예를 들어 ko일 때 한국어, 그 밖의 값과 값이 없을 때 영어로 처리하면 프랑스어 같은 미지원 언어가 한국어로 표시되는 일을 막는다. 앱이 kr, ko-KR 등의 입력을 받는다면 템플릿과 클라이언트 중 어디에서 ko로 정규화할지도 정해야 한다. Supabase 언어별 템플릿 안내

{{ if eq .Data.language "ko" }}
  <p>이메일 주소를 확인해 주세요.</p>
{{ else }}
  <p>Please confirm your email address.</p>
{{ end }}

6. 인증 링크와 웹 화면 연결

Supabase의 URL Configuration에는 기본 Site URL과 허용할 Redirect URL을 설정한다. 앱이 회원가입 확인에는 /auth/verified, 비밀번호 재설정에는 /auth/reset-password를 지정한다면, 두 주소가 각각 실제 웹 화면으로 연결되어야 한다.

가입 확인 화면은 토큰을 확인한 뒤 완료 안내를 보여 준다. 비밀번호 재설정 화면은 토큰을 확인하고 새 비밀번호를 입력받아 변경한 뒤 완료 안내를 보여 준다. 두 링크를 같은 완료 화면에만 연결하면, 재설정 메일은 도착해도 사용자가 새 비밀번호를 설정할 수 없다.

이 방식을 사용하면 앱에서 요청한 뒤 다른 기기의 웹 브라우저에서 메일을 열어도 재설정을 마칠 수 있다. 앱 자동 실행은 별도의 App Links 설정에 달려 있으므로, 비밀번호 변경을 완료하는 데 필수 조건으로 두지 않는다.

Cloudflare DNS 화면의 12개 레코드 읽기

개발·운영에 같은 종류의 레코드를 각각 하나씩 두면 총 12개가 된다. Firebase 관련 6개와 Resend 관련 6개로 나눌 수 있다.

화면에 보이는 형태	요구한 서비스	의미
웹 도메인의 A, 값 199.36.158.100	Firebase Hosting	해당 주소의 웹 요청을 Firebase Hosting으로 연결
웹 도메인의 TXT, 값 hosting-site=...	Firebase Hosting	도메인을 어느 Hosting 사이트에 연결할지 증명
_acme-challenge... TXT	Firebase Hosting	HTTPS 인증서 발급 과정에서 도메인 제어 권한 확인
resend._domainkey... TXT, 값 p=...	Resend	수신 측이 DKIM 서명을 검증할 때 쓰는 공개 키
rsend... CNAME	Resend	Resend가 제시한 발송 관련 호스트 연결
send... CNAME	Resend	Return-Path 등 발송 도메인 설정에 필요한 호스트 연결

hosting-site=...와 _acme-challenge...는 웹사이트를 위한 값이다. resend._domainkey..., rsend..., send...는 메일 발송을 위한 값이다. 이름이 비슷해 보여도 서로 대체할 수 없다. resend._domainkey의 p=...는 DNS에 공개하는 DKIM 공개 키이며 API key와 다르다. Firebase 커스텀 도메인 설정, Resend Return-Path 설명

화면의 DNS only는 Cloudflare가 트래픽을 프록시하지 않고 DNS 값만 응답한다는 의미다. TTL은 DNS 응답을 얼마나 캐시할지 정하는 값이다. Auto와 1 hr가 함께 있어도 그 차이 자체가 설정 오류는 아니다. 레코드를 바꾼 뒤 새 값이 보이기까지의 시간에 영향을 준다. Cloudflare 프록시 상태, Cloudflare TTL

화면에 DMARC 레코드가 없더라도 위 12개를 설명하는 데 빠진 행이 있는 것은 아니다. DMARC는 발신 도메인의 메일 인증 정책을 알리는 별도 권장 설정으로 검토할 수 있다. 값은 운영할 메일 정책에 맞춰 정해야 한다. Supabase 발신 도메인 권장사항

무료 사용 범위와 제한

서비스	현재 확인한 범위
Supabase 기본 SMTP	프로젝트 팀 주소로만 발송, 현재 프로젝트당 시간당 2통
Supabase Custom SMTP	활성화 후 기본값 시간당 30통. Auth Rate Limits에서 조정 가능
Resend Free	월 3,000통·일 100통, 검증된 도메인 3개
Cloudflare DNS	도메인 등록·갱신과 구분되는 DNS 관리
도메인 등록	소유 도메인의 구매 및 갱신 비용 발생

Custom SMTP를 연결해도 발송량이 무제한이 되는 것은 아니다. Supabase Auth의 시간당 제한과 Resend 계정의 일·월 한도를 모두 확인해야 한다. 개발·운영 도메인을 한 Resend 계정에 등록하면 도메인 수는 각각 차지하지만 발송량은 계정 한도를 공유한다. Supabase SMTP 제한, Resend 요금제

설정 완료를 확인하는 순서

1. Cloudflare에 각 서비스가 요구한 DNS 레코드가 있는지 확인한다.
2. Resend에서 발신 도메인이 Verified인지 확인한다.
3. Firebase Hosting에서 웹 도메인이 Connected인지 확인하고, HTTPS로 가입 확인·비밀번호 재설정 경로가 열리는지 확인한다.
4. Supabase에서 Custom SMTP의 발신 주소와 템플릿을 확인한다.
5. 실제 회원가입 메일을 받아 언어·발신 주소·가입 확인 화면을 확인한다.
6. 실제 재설정 메일을 받아 새 비밀번호 입력, 변경 완료, 새 비밀번호 로그인까지 확인한다.

DNS 화면에 레코드가 보이는 것만으로 메일 발송과 인증 흐름 전체가 완료된 것은 아니다. 마지막 두 단계가 사용자 관점의 검증이다.

참고 문서

• Supabase — Custom SMTP
• Supabase — Email Templates
• Supabase — Free 템플릿 수정 정책
• Resend — SMTP 설정
• Resend — 요금제
• Firebase — Connect a custom domain
• Cloudflare — DNS 프록시 상태