pfSense 소프트웨어에서 Apple TV용 WireGuard

이 설정이 적합한 경우

Apple TV를 휴가용 숙소 같은 집 밖의 장소에서 사용하면서 pfSense 소프트웨어를 실행하는 방화벽으로 다시 연결하려는 경우 이 설정을 사용하세요.

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

다음이 필요합니다:

WireGuard 구성으로 연결하며 VPN 서비스는 포함하지 않는 WaveSocket 앱이 설치된 Apple TV
방화벽 관리자 권한과 Apple TV가 접속할 수 있는 WAN 주소
WireGuard 패키지(Netgate® 문서에서는 설치하기 전에 최신 pfSense Plus 또는 pfSense CE 소프트웨어로 업그레이드하도록 권장함)
Apple TV와 같은 네트워크에 있는, 전송에 사용할 휴대폰이나 컴퓨터

Netgate 예시에서는 터널 및 피어 설정을 바탕으로 Apple TV 구성을 직접 작성한 다음 WaveSocket에 붙여넣습니다.

WireGuard 서버 설정

이 단계는 Netgate 문서의 WireGuard 원격 접속 예시를 따릅니다.

System → Packages 아래의 Available Packages 탭에서 WireGuard 패키지를 설치하세요.
VPN → WireGuard → Tunnels에서 터널을 추가하세요. 터널을 활성화하고, 수신 포트(예시에서는 51820)를 설정하고, 인터페이스 키를 생성하고, 10.6.210.1/24 같은 주소를 지정한 다음 Save Tunnel을 선택하세요.
Firewall → Rules의 WAN 탭에서 WAN 주소의 수신 포트로 들어오는 UDP에 대해 Pass 규칙을 추가하세요. WireGuard 탭에서는 터널 트래픽을 허용하는 규칙을 추가하세요. 각 규칙을 저장하고 Apply Changes를 선택하세요.

WAN 주소가 바뀌는 경우 Services → Dynamic DNS를 설정하고 그 호스트 이름을 엔드포인트로 사용하세요.

Apple TV 클라이언트 만들기

Apple TV용 키 쌍을 만드세요. 예를 들어 방화벽의 콘솔이나 SSH 셸에서 wg genkey | tee /dev/stderr | wg pubkey를 실행하면 됩니다. 이 명령은 파일을 저장하지 않고 개인 키와 공개 키를 차례로 출력합니다. Netgate 예시에서는 클라이언트 간에 키를 재사용할 수 없다고 설명합니다.
VPN → WireGuard → Peers에서 터널에 피어를 추가하세요. Dynamic Endpoint를 활성화하고, Apple TV 공개 키를 붙여넣고, Allowed IPs를 10.6.210.2/32 같은 Apple TV의 터널 주소로 설정하세요.
피어를 저장하고 변경 사항을 적용하세요.

클라이언트 구성 작성

자리 표시자를 자신의 값으로 바꾸세요:

APPLE_TV_PRIVATE_KEY: 이전 섹션에서 만든 Apple TV 개인 키
FIREWALL_TUNNEL_PUBLIC_KEY: VPN → WireGuard → Tunnels에 있는 터널의 공개 키
vpn.example.com: WAN 주소 또는 DDNS 호스트 이름
10.6.0.0/24: 홈 네트워크

Address에는 피어의 Allowed IPs와 같은 IP 주소(10.6.210.2)를 사용하되, 아래 예시처럼 터널의 마스크(/24)를 붙입니다.

[Interface]
PrivateKey = APPLE_TV_PRIVATE_KEY
Address = 10.6.210.2/24

[Peer]
PublicKey = FIREWALL_TUNNEL_PUBLIC_KEY
AllowedIPs = 10.6.210.1/32, 10.6.0.0/24
Endpoint = vpn.example.com:51820

이 예시는 터널과 하나의 홈 네트워크만 VPN으로 보냅니다. 모든 IPv4 트래픽을 보내려면 AllowedIPs = 0.0.0.0/0으로 설정하고 [Interface] 섹션에 DNS = 10.6.210.1을 추가하세요. IPv6에는 별도의 터널 주소와 ::/0이 필요합니다. 경로 및 홈 네트워크를 참조하세요.

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 구성을 추가하도록 허용하세요. 서버 확인됨이 표시되고 가장 오래된 피어 핸드셰이크 경과 시간 옆에 최근 시간이 나타나는지 확인한 다음, 알고 있는 홈 서비스를 주소로 열어 보세요.

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

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

연결되지 않는 경우

터널 없음. VPN → WireGuard → Settings에서 Enable 옵션이 켜져 있는지 확인하세요.
핸드셰이크 없음. 피어의 공개 키가 Apple TV 개인 키와 짝을 이루는지, 클라이언트의 PublicKey가 터널의 공개 키인지 확인하세요. WAN 규칙을 확인하고, 엔드포인트가 현재 WAN 주소로 조회되는지도 확인하세요.
전체 터널에서 인터넷 안 됨. Firewall → NAT → Outbound가 터널 네트워크(10.6.210.0/24)를 WAN 주소로 변환하는지 확인하세요. 이름 조회가 실패하면 Services → DNS Resolver → Access Lists를 확인하세요.
유휴 상태에서 연결 끊김. Apple TV와 인터넷 사이에 다른 방화벽이 있다면 [Peer] 섹션에 PersistentKeepalive = 25를 추가하세요. 이미 저장한 프로필은 연결을 해제한 다음 프로필 편집에서 PersistentKeepalive를 설정하세요.

이 단계는 WaveSocket이 pfSense 소프트웨어로 직접 테스트한 결과가 아니라, 2026년 10월 16일에 확인한 Netgate의 공개 문서를 바탕으로 합니다. 메뉴 레이블은 버전에 따라 바뀔 수 있으니, 바뀐 경우 최신 문서를 따르세요. pfSense®는 Electric Sheep Fencing LLC(“ESF”)가 소유한 등록 상표이며, ESF의 명시적인 사전 서면 허가 없이 사용할 수 없습니다. Netgate®는 Rubicon Communications LLC가 소유한 등록 상표이며, Rubicon Communications LLC의 명시적인 사전 서면 허가 없이 사용할 수 없습니다. WaveSocket은 독립적인 앱입니다. 이 사이트와 앱 모두 ESF 또는 Rubicon Communications LLC와 제휴 관계가 없으며 이들의 승인을 받지 않았습니다.