Apple TV용 UniFi WireGuard 서버

이 설정이 적합한 경우

Apple TV를 휴가용 숙소 같은 집 밖의 장소에서 사용하면서 UniFi 게이트웨이를 통해 집으로 다시 연결해 미디어 서버 같은 서비스에 주소로 접속하려는 경우 이 설정을 사용하세요.

이 가이드는 집에서 Apple TV 트래픽을 게이트웨이의 VPN 클라이언트를 통해 보내는 방법은 다루지 않습니다. 그런 설정에는 WaveSocket이 필요하지 않습니다.

다음이 필요합니다:

WireGuard 구성으로 연결하며 VPN 서비스는 포함하지 않는 WaveSocket 앱이 설치된 Apple TV
UniFi Network 애플리케이션을 실행하는 UniFi Gateway 또는 UniFi Cloud Gateway
게이트웨이의 공용 IP 주소, 또는 게이트웨이와 인터넷 사이에 있는 다른 라우터가 게이트웨이로 포워딩하는 포트
Apple TV와 같은 네트워크에 있는, 전송에 사용할 휴대폰이나 컴퓨터

UniFi Teleport는 다른 기능입니다. WireGuard 구성 파일이 아니라 Ubiquiti의 WiFiman 앱을 통한 초대를 사용합니다.

WireGuard 서버 설정

이 단계는 Ubiquiti의 WireGuard VPN 서버 문서를 따릅니다.

UniFi Network에서 Settings → VPN을 열고 WireGuard VPN 서버를 만드세요. 기본 포트는 UDP 51820입니다.
게이트웨이와 인터넷 사이에 다른 라우터가 있으면 그 라우터에서 UDP 포트 51820을 게이트웨이의 WAN 주소로 포워딩하세요. Ubiquiti는 공용 IP에 직접 연결되는 게이트웨이를 권장합니다.
공용 주소가 바뀌는 경우 먼저 Cloudflare나 No-IP처럼 UniFi가 지원하는 Dynamic DNS 제공업체에서 호스트 이름을 받으세요. 그런 다음 클라이언트가 이 호스트 이름을 사용할 수 있도록 Settings → Internet에서 Dynamic DNS 항목을 만드세요. Ubiquiti의 Dynamic DNS를 사용하려면 게이트웨이에 공용 IP가 있어야 합니다. 다른 라우터 뒤에 있는 경우 그 라우터의 DDNS를 사용하거나, 게이트웨이가 공용 IP를 받도록 그 라우터를 브리지 모드로 설정하세요.

Apple TV 클라이언트 만들기

WireGuard 서버에서 Clients → Add Client를 열고 Apple TV 같은 이름을 입력하세요.
Download Configuration File을 선택하고 파일을 비공개로 보관하세요.
Add를 선택한 다음 Apply Changes를 선택하세요.

기기마다 별도의 클라이언트를 만드세요. Ubiquiti는 Endpoint, AllowedIPs, DNS의 고정 기본값을 문서화하지 않으므로 파일에서 직접 확인하세요. Endpoint에 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 또는 100.64.0.0/10에 속한 주소 같은 사설 주소가 표시되거나, Dynamic DNS를 사용하는데 공용 IP 주소가 표시된다면, 파일을 보내기 전에 이를 공용 주소 또는 DDNS 호스트 이름으로 바꾸고 포트는 그대로 두세요. 가져온 후에는 연결이 해제된 상태에서 프로필 편집의 서버를 변경할 수도 있습니다. AllowedIPs에 대해서는 경로 및 홈 네트워크를 참조하세요.

Apple TV에서 가져오기

Apple TV에서 WaveSocket을 열고 프로필 → VPN 프로필 추가 → 브라우저에서 업로드를 선택한 다음 업로드 세션 시작을 선택하세요. VPN이 연결되어 있다면 먼저 연결을 해제하세요.
Apple TV와 같은 네트워크에 있는 휴대폰이나 컴퓨터에서 TV의 QR 코드를 스캔하거나 표시된 주소를 여세요. TV에 표시된 코드를 4자리 코드 필드에 입력하세요.
파일 선택을 눌러 .conf 파일을 고른 다음 Apple TV로 전송을 누르세요.
Apple TV의 검토 화면에 서버와 허용된 IP가 표시되니 확인하세요. 이름 변경을 선택해 프로필에 집 VPN처럼 알아보기 쉬운 이름을 붙인 다음 프로필 저장을 선택하세요.

전송에는 신뢰할 수 있는 네트워크를 사용하세요. Apple TV를 휴가용 숙소의 Wi-Fi 같은 공유 네트워크에서 사용한다면, Apple TV를 그곳으로 옮기기 전에 집에서 프로필을 가져오세요. 신뢰할 수 있는 네트워크가 필요한 이유는 가져오기 가이드에서 설명합니다.

연결 및 확인

Apple TV가 집 밖의 네트워크에 있을 때 연결하세요. Ubiquiti에 따르면 다른 라우터 뒤에 있는 경우 홈 네트워크 안에서 공용 주소로 접속하면 실패할 수 있습니다.

WaveSocket이 저장된 프로필을 선택하고 연결 화면을 엽니다. 연결을 선택하세요. 처음 연결할 때는 Apple TV가 VPN 구성을 추가하도록 허용하세요. 서버 확인됨이 표시되고 가장 오래된 피어 핸드셰이크 경과 시간 옆에 최근 시간이 나타나는지 확인한 다음, 알고 있는 홈 서비스를 주소로 열어 보세요.

엔드포인트로 DDNS 호스트 이름을 사용하면 WaveSocket은 연결하기 전에 이 호스트 이름의 주소를 조회하고, 연결된 동안에도 다시 확인합니다. DNS 및 서버 주소를 참조하세요.

WaveSocket의 모든 기능은 연결당 3분 동안 무료이므로, 시간 제한을 없애 주는 WaveSocket 평생 이용권을 선택하기 전에 이 설정을 사용해 볼 수 있습니다.

연결되지 않는 경우

공용 주소 없음. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 또는 100.64.0.0/10에 속한 WAN 주소는 공용 주소가 아닙니다. Ubiquiti는 인터넷 서비스 제공업체에 공용 IP를 요청하거나, 제공업체 라우터의 브리지 모드를 사용해 이중 NAT를 없애도록 제안합니다.
집에서 테스트한 경우. 홈 네트워크 밖에서 테스트하세요. Ubiquiti의 포트 포워딩 문서를 참조하세요.
주소 범위가 같은 경우. 집과 Apple TV를 사용하는 네트워크에서 같은 사설 주소 범위를 사용하지 마세요.

이 단계는 WaveSocket이 UniFi로 직접 테스트한 결과가 아니라, 2026년 10월 16일에 확인한 Ubiquiti의 공개 문서를 바탕으로 합니다. Ubiquiti의 WireGuard VPN 서버 문서를 따르며, 클라이언트 레이블은 UniFi Mobile Router용 사이트 간 WireGuard 문서를 따릅니다. UniFi Network의 레이블은 바뀔 수 있으니, 바뀐 경우 Ubiquiti의 최신 도움말 문서를 따르세요. UniFi는 Ubiquiti Inc.의 등록 상표입니다. WaveSocket은 독립적인 앱으로, Ubiquiti Inc.와 제휴 관계가 없으며 Ubiquiti Inc.의 승인을 받지 않았습니다.