Apple TV용 OPNsense WireGuard 서버

이 설정이 적합한 경우

Apple TV를 휴가용 숙소 같은 집 밖의 장소에서 사용하면서 OPNsense®를 실행하는 방화벽을 통해 집으로 다시 연결하려는 경우 이 설정을 사용하세요. OPNsense에서는 이를 Road Warrior 설정이라고 부릅니다.

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

다음이 필요합니다:

WireGuard 구성으로 연결하며 VPN 서비스는 포함하지 않는 WaveSocket 앱이 설치된 Apple TV
관리자 권한과 Apple TV가 접속할 수 있는 WAN 주소
OPNsense 24.1.6 이상: WireGuard는 24.1부터 기본 제공되며, 피어 생성기에는 24.1.6부터 DNS 필드가 있습니다
Apple TV와 같은 네트워크에 있는, 전송에 사용할 휴대폰이나 컴퓨터

아래에 나오는 Save 버튼과 Store private key on this firewall 옵션을 사용하려면 OPNsense 26.7.3 이상이 필요합니다. 이전 버전에서는 Store and generate next 옆의 체크 표시 버튼을 사용하세요. 이 경우 개인 키는 전혀 저장되지 않습니다.

WireGuard 서버 설정

이 단계는 OPNsense WireGuard Road Warrior 가이드를 따릅니다.

VPN → WireGuard → Instances에서 인스턴스를 추가하세요. 톱니바퀴 아이콘으로 키를 생성하고, 51820 같은 수신 포트와 10.10.10.1/24 같은 터널 주소를 설정한 다음 인스턴스를 저장하세요.
Instances 및 Peers 목록 아래에 표시되는 Enable WireGuard를 켜고 Apply를 선택하세요.
Firewall → Rules → WAN에서 WAN 주소의 수신 포트로 들어오는 UDP에 대해 Pass 규칙을 추가하세요.
Interfaces → Assignments에서 WireGuard 장치(예: wg1)를 할당하세요. 새 인터페이스를 열어 활성화하고 저장한 다음 Apply changes를 선택하세요. 그런 다음 WireGuard를 다시 시작하세요. Enable WireGuard를 껐다가 다시 켜고, 그때마다 Apply를 선택하면 됩니다.
직접 선택한 네트워크나 기기에 Apple TV가 접속할 수 있도록 허용하는 방화벽 규칙을 그 인터페이스에 추가하세요. 아웃바운드 Source NAT와 Unbound DNS 다시 로드가 언제 필요한지는 OPNsense 가이드에서 설명합니다.

WAN 주소가 바뀌는 경우 System → Firmware → Plugins에서 os-ddclient 플러그인을 설치하고 Services → Dynamic DNS에서 설정하세요.

Apple TV 클라이언트 만들기

VPN → WireGuard → Peer generator를 열고 인스턴스를 선택하세요.
Endpoint에 vpn.example.com:51820처럼 공용 주소 또는 DNS 이름을 포트와 함께 입력하세요.
피어에 Apple TV 같은 이름을 지정하고 제안된 Address를 확인하세요. 인스턴스에 자체 값이 저장되어 있지 않은 한(26.7.3 이상), Allowed IPs는 모든 트래픽(0.0.0.0/0,::/0)을 제안합니다. 홈 네트워크에만 접속하려면 10.10.10.0/24, 192.168.1.0/24처럼 터널 네트워크와 홈 네트워크를 입력하세요. 설정하는 DNS 서버는 모두 이 네트워크 안에 있어야 합니다.
이름 조회에 OPNsense를 사용하려면 DNS Servers를 10.10.10.1 같은 터널 주소로 설정하세요. 연결된 동안 WaveSocket은 이 주소를 터널 DNS로 사용하므로, OPNsense의 Unbound가 터널 네트워크에서 오는 쿼리에 응답해야 합니다.
Config 필드의 전체 텍스트를 복사하세요. 그런 다음 Save를 선택하고 이어서 Apply를 선택하세요.

저장하기 전에 텍스트를 복사하세요. Store private key on this firewall을 켜지 않으면 OPNsense는 공개 키만 보관하므로 나중에 구성을 다시 만들 수 없습니다. 구성을 잃어버렸다면 새 피어를 생성하세요.

Apple TV에서 가져오기

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

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

연결 및 확인

Apple TV가 집 밖의 네트워크에 있을 때 연결하세요. 홈 네트워크 안에서 테스트해서는 원격 접속이 작동하는지 알 수 없을 수도 있습니다.

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

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

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

연결되지 않는 경우

핸드셰이크 없음. WAN 규칙을 확인하고, 엔드포인트가 현재 공용 주소를 가리키는지 확인하세요.
일부 앱이 로드되지 않음. 핸드셰이크는 되지만 일부 앱이 멈추거나 일부만 로드된다면 OPNsense 가이드에서 MTU와 Normalization(MSS 클램핑) 규칙을 검토하세요. WaveSocket에서는 연결을 해제하고 프로필 편집에서 MTU를 조정하세요. 구성에 MTU 줄이 없으면 WaveSocket은 1280을 사용합니다.
통신업체급 NAT 또는 다른 라우터 뒤에 있는 경우. 둘 다 들어오는 연결을 차단할 수 있습니다. 인터넷 서비스 제공업체에 공용 IP 주소를 요청하거나, OPNsense와 인터넷 사이에 있는 라우터에서 포트를 포워딩하세요. OPNsense 문서는 이 경우를 다루지 않습니다.

경로와 네트워크 중복에 대해서는 경로 및 홈 네트워크를 참조하세요.

이 단계는 WaveSocket이 OPNsense로 직접 테스트한 결과가 아니라, 2026년 10월 16일에 확인한 OPNsense의 공개 문서를 바탕으로 합니다. 메뉴 레이블은 버전에 따라 바뀔 수 있으니, 바뀐 경우 최신 문서를 따르세요. OPNsense®는 해당 소유자의 등록 상표입니다. WaveSocket은 독립적인 앱으로, OPNsense 프로젝트 또는 Deciso B.V.와 제휴 관계가 없으며 이들의 승인을 받지 않았습니다.