ReachTest Relay path
Host에서 실제 TURN 할당을 시도합니다. 중계 서비스까지 닿는지 확인하지만, iPad까지의 전체 연결 성공을 뜻하지는 않습니다.
REACH / CLOUDFLARE SETUP
Cloudflare, 필요한 만큼만.
중계 연결을 준비하거나, 이미 쓰는 중계의 사용량을 확인하세요. 목적에 맞는 토큰을 실제 발급 화면과 함께 안내합니다.
확인: 2026년 9월 22일 · Cloudflare와 Reach Host의 화면 이름은 버전에 따라 다를 수 있습니다.
목차 열기
먼저 목적 선택
필요한 작업을 고르면 아래 권한과 입력 위치가 바뀝니다. 토큰은 Mac의 Reach Host에만 입력하세요.
준비할 것: Account ID + 계정 API 토큰 하나.
토큰에
Calls: Edit와
Account Analytics: Read를 추가합니다.
준비할 것:
기존 TURN 키와 같은 계정의 Account ID + 읽기 전용
토큰.
Account Analytics: Read만 필요합니다. 기존
TURN 키는 그대로 둡니다.
1. 계정과 토큰
Cloudflare에 로그인하고 사용할 계정을 선택하세요. Account ID를 복사해 둡니다. 계정 이메일, Zone ID, TURN 키 ID와 다른 값입니다.
대시보드 검색(⌘K)에서 Copy account ID를 찾아 복사하고 Host의 Account ID 입력란에 먼저 붙여 두세요. 이후 Manage Account → Account API Tokens → Create Token을 엽니다.
이름은 Reach Host Relay처럼 알아보기 쉽게 정하고
Start from scratch(처음부터 시작)를
선택하세요.
이름은 Reach Host Usage로 정하고
Start from scratch(처음부터 시작)를
선택하세요.
2. 권한 선택
두 권한을 선택합니다.
Media → Calls → Edit는 Host의 TURN 키 생성에,
Analytics & Logs → Account Analytics → Read는
사용량 조회에 쓰입니다.
읽기 전용 권한 하나만 선택하세요:
Analytics & Logs → Account Analytics → Read.
사용량만 조회한다면 Calls: Edit는 필요
없습니다.
토큰의 대상은 Reach에서 사용할 Cloudflare 계정으로 제한하세요.
Global API Key나 필요 없는 전체 권한을 추가하지 않습니다.
3. 검토와 보관
이름, 계정 범위, 권한, 만료를 확인한 뒤 토큰을 만드세요. 만료일은 운영 방식에 맞게 선택하세요. 예시의 90일을 그대로 사용할 필요는 없습니다. Reach는 계정 API 토큰을 자동 갱신하지 않으므로 만료 전에 새 토큰으로 교체하세요.
비밀 토큰 값은 생성 직후 한 번만 표시됩니다. 비밀번호 관리자
등에 안전하게 보관하고, 채팅·공개 이슈·스크린샷에 붙이지 마세요.
Account ID를 먼저 복사해 두면 비밀 토큰을 복사한 뒤 클립보드를
덮어쓸 일이 줄어듭니다.
IP 필터도 설정해야 하나요?
필수는 아닙니다. Host가 사용하는 인터넷 출구 IP를 확실히 아는 경우에만 제한하세요. 회사망·핫스팟 전환 등으로 IP가 바뀌면 토큰 호출이 거부될 수 있습니다.
4. Host에 입력
Reach Host 상태 화면 → Cloudflare 릴레이 → 설정…을 엽니다. Cloudflare 관리 → Cloudflare 계정 API 토큰에서 값을 입력하세요.
Cloudflare → Reach HostAccount ID → Account ID
선택한 Cloudflare 계정 식별자
Cloudflare → Reach HostToken → API token
방금 발급한 비밀 토큰 값
계정 토큰 저장(Save account token)을 누르고 TURN 키 생성 완료 메시지를 확인하세요. Host가 키를 자동으로 만듭니다. 임시 TURN 사용자 이름·암호나 수동 TURN 키를 따로 만들 필요는 없습니다.
Reach Host 상태 화면 → Cloudflare 릴레이 → 관리… → Cloudflare 관리 → 사용량 설정을 엽니다. 분석 계정 및 읽기 전용 토큰에서 아래 값을 입력하세요.
Cloudflare → Reach HostAccount ID → Analytics Account ID
현재 TURN 키가 속한 계정
Cloudflare → Reach HostToken → New analytics read token
Account Analytics: Read 토큰
분석 자격 증명 저장(Save analytics credentials)을 누릅니다. 기존 TURN 키 ID·키는 변경하지 않습니다.
자격 증명은 Mac의 Keychain에 저장됩니다. Viewer에는 계정 API 토큰이나 TURN 키를 입력하지 않습니다.
5. 연결·사용량 확인
Refresh usage
읽기 전용 사용량 조회 활성화를 켜고 기간·범위를 선택한 뒤 사용량 새로고침(Refresh usage)을 누릅니다. 저장하거나 기간을 바꾸는 것만으로 조회하지 않습니다.
기간은 최근 30일 / 이번 달 / 사용자 지정으로 고릅니다. 월·사용자 지정 날짜 경계는 UTC 기준입니다. 사용량 막대는 Cloudflare의 송신·수신 트래픽 비교이며, 무료 할당량 잔액이나 청구서가 아닙니다.
수치는 제공자의 집계 지연이나 선택한 계정·키 범위에 따라 달라질 수 있습니다. 요금과 실제 청구액은 Cloudflare 대시보드에서 확인하세요.
문제 해결
401 / 403 — 조회나 저장이 거부됩니다.
계정 ID와 토큰이 같은 계정인지, 토큰이 만료·폐기되지 않았는지 확인하세요. 처음 중계 설정에는 Calls: Edit, 사용량에는 Account Analytics: Read가 필요합니다. IP 필터가 Host의 현재 인터넷 IP를 차단하지 않는지도 확인하세요.
사용량은 보이는데 연결되지 않습니다.
조회 권한과 중계 경로는 별개입니다. Test Relay path 결과, 두 기기의 Reach 로그인 상태, 네트워크 제한을 확인하세요. 사용량 조회 성공은 영상·입력 연결 성공을 보장하지 않습니다.
회사망이면 TLS 443으로 무조건 연결되나요?
아닙니다. Host는 TLS 443 경로도 시도하지만 Viewer 쪽에는 UDP 통신이 필요합니다. HTTP 전용 프록시나 회사·학교의 방화벽 정책에 따라 연결이 제한될 수 있습니다.
메뉴가 없거나 토큰을 만들 수 없습니다.
Cloudflare 계정 소유 토큰을 만들거나 수정하려면 해당 계정의 Super Administrator 역할이 필요합니다. 관리자에게 필요한 권한만 포함한 토큰을 요청하세요. 토큰에 전체 관리자 권한을 주라는 의미가 아닙니다.
토큰을 바꾸거나 지우려면?
관리… → 계정 토큰 변경에서 새 토큰을 저장하세요. 사용량 전용 토큰은 사용량 설정 → 분석 계정 및 읽기 전용 토큰에서 교체합니다. 계정 토큰이 만료되어도 이미 만들어진 TURN 키가 함께 폐기되지는 않습니다.
Host의 계정 토큰 삭제는 저장된 토큰과 Reach가 자동 생성한 로컬 TURN 키를 제거합니다. 수동으로 입력한 TURN 키는 그대로 둡니다. Cloudflare 측 API 토큰과 TURN 키의 폐기는 Cloudflare에서 별도로 진행하세요.
429 또는 ‘보고된 기록 없음’이 표시됩니다.
429는 조회 제한입니다. Host에 표시된 재시도 시각 이후 새로고침하세요. 기록이 없으면 조회 기간과 계정·TURN 키 범위를 확인하세요. 기록 없음은 사용량이나 청구액이 0이라는 뜻이 아닙니다.