← Reach
User Guide

Reach Remote 시작하기.

Reach Host 설치부터 권한 허용, 페어링, 디스플레이 선택, 문제 해결까지 한 번에 정리한 사용자 가이드입니다.

시작하기

Reach는 두 앱으로 동작합니다. viewer에는 Reach Remote를 설치하고, host에는 Reach Host를 설치합니다.

  • Mac: macOS 14 이상
  • iPad: iPadOS 17 이상
  • 첫 연결은 같은 Wi-Fi 또는 같은 로컬 네트워크 권장
  • 4K, 60fps, HEVC 성능은 M-series iPad 권장
일반 사용자는 notarized DMG로 배포되는 Reach Host를 사용하세요. 개발용 빌드나 CLI는 권한 동작이 다를 수 있습니다.

Mac 권한 허용

화면 기록

선택한 디스플레이를 viewer로 스트리밍하기 위해 필요합니다.

System Settings → Privacy & Security → Screen Recording에서 Reach Host를 켜고, 필요하면 앱을 다시 여세요.

손쉬운 사용

viewer에서 보낸 터치, 마우스, 키보드 입력을 host에 전달하기 위해 필요합니다.

Privacy & Security → Accessibility에서 Reach Host를 허용하세요.

로컬 네트워크

같은 네트워크의 host를 Nearby에서 찾기 위해 필요합니다.

iPadOS 또는 macOS가 묻는 Local Network 권한을 허용하세요.

시스템 오디오

macOS 14+에서는 시스템 오디오 캡처가 Microphone 권한에 묶일 수 있습니다.

마이크 소리를 녹음하는 것이 아니라 시스템 오디오 권한 게이트로 사용됩니다.

Host 연결하기

Nearby

  1. Reach Host를 실행합니다.
  2. Reach Remote를 엽니다.
  3. Nearby 목록에서 host를 선택합니다.
  4. 요청되면 Reach Host에 표시된 pairing code를 입력합니다.
  5. 디스플레이를 고르고 Start Streaming을 누릅니다.

QR 또는 pairing code

Host가 Nearby에 보이지 않거나 나중에 원격으로 접속할 프로필을 저장하려면 Add에서 pairing code를 입력하세요.

Pairing code는 setup용 자격 증명입니다. 저장된 Connection Profile은 code 자체가 아니라 연결할 host를 나타내야 합니다.

디스플레이 선택

Physical Displays

Host의 실제 모니터 중 하나를 보여줍니다. 이미 보고 있는 화면을 그대로 제어할 때 적합합니다.

Virtual Display 만들기

태블릿 크기에 맞는 가상 디스플레이를 만들어 추가 화면처럼 사용할 수 있습니다.

사용 중 기능

  • 터치, 드래그, 키보드 입력으로 host를 제어합니다.
  • Cursor 핸들 — Direct Touch 모드에서 호스트 cursor 옆에 작은 동그란 핸들이 나타납니다. 핸들을 끌면 호스트 cursor를 정밀하게 움직일 수 있어요. 호스트 쪽 토글로 끌 수 있습니다.
  • 스크롤 방향 반전 — 두 손가락 스크롤(터치)과 트랙패드 스크롤을 각각 따로 반전시킬 수 있습니다. Reach Remote 설정 → Scroll direction.
  • 시스템 오디오가 켜져 있으면 세션 오디오를 들을 수 있습니다.
  • 1.0은 포그라운드 스트리밍에 집중합니다. 세션 화면을 열어둔 상태에서 사용하세요.
  • 네트워크가 약하면 해상도나 FPS를 낮추고, HEVC가 불안정하면 H.264를 사용하세요.

원격으로 연결하기

같은 Wi-Fi가 아닌 곳에서 Mac에 연결할 때 Reach가 시도하는 경로는 세 가지입니다.

Direct (주소 입력)

호스트 쪽에서 UDP 포트(기본 8443)를 열어두고, Reach Remote에 그 IP와 포트를 저장합니다. 가장 빠르지만 라우터 설정이 필요합니다.

Discover (자동 탐색)

라우터 설정이 어렵거나 주소를 모를 때, Reach가 공개 탐색 서버에 자기 주소를 물어보고 자동으로 직접 연결을 시도합니다. 데이터는 여전히 두 기기 사이로 직통하며, 탐색 서버는 주소 조회에만 쓰입니다.

Relay (우회 경로)

회사망·학교망·통신사 CGNAT 환경에서 직접 연결이 막힐 때, 본인 Cloudflare 계정으로 우회 서버를 직접 운영해서 사용할 수 있습니다. 우회 중에도 영상·음성·입력은 끝에서 끝까지 암호화돼서 흘러갑니다. Cloudflare는 패킷을 전달할 뿐 내용은 못 봅니다.

Discover와 Relay 모두 기본은 사용자가 선택할 때만 동작합니다. 토글이나 자격증명은 Reach Host 또는 Reach Remote 설정에서 관리하세요.

보안과 프라이버시

모든 연결 경로(LAN, Direct, Discover, Relay)는 QUIC 위의 TLS와 인증서 핀닝을 사용합니다. 화면, 입력, 오디오는 Reach 서버를 거치지 않습니다.

Discover 경로는 탐색 서버에 일시적으로 주소만 노출되며, 세션 데이터는 두 기기 직통입니다. Relay 경로는 본인이 운영하는 Cloudflare 우회 서버를 거치지만 내용은 암호화되어 Cloudflare도 못 읽습니다.

Reach 계정은 필요 없고, 추적 SDK나 광고용 분석을 사용하지 않습니다.

문제 해결

Host가 Nearby에 보이지 않음

  • Reach Host가 메뉴바에서 실행 중인지 확인합니다.
  • 두 기기가 같은 네트워크에 있는지 확인합니다.
  • Local Network 권한과 VPN/게스트 네트워크 격리를 확인합니다.

연결됐지만 화면이 안 나옴

  • Host의 Screen Recording 권한을 허용합니다.
  • Reach Host를 완전히 종료한 뒤 다시 엽니다.
  • 디스플레이를 다시 선택하거나 H.264로 시도합니다.

입력이 안 됨

  • Host의 Accessibility 권한을 허용합니다.
  • Reach Remote에서 세션을 끊고 다시 연결합니다.

연결 timeout 또는 원격 접속 실패

  • 첫 페어링은 같은 네트워크에서 시도합니다.
  • Direct가 막히면 Discover(자동 탐색)를 시도해 보세요. 라우터 설정 없이도 직접 연결을 시도합니다.
  • CGNAT나 회사·학교망에서 Direct/Discover 모두 막히면, 본인 Cloudflare 계정으로 Relay(우회 경로)를 설정하세요.