문제 해결

1. 연결이 안 될 때

위에서부터 순서대로 확인하면 대부분 여기서 해결됩니다.

① 같은 Wi-Fi인지 확인

• Mac과 Android가 같은 공유기에 연결되어 있어야 합니다.
• 이름이 비슷한 '게스트(Guest)' Wi-Fi는 남는 네트워크가 아니라 격리된 별도 네트워크인 경우가 많습니다. 게스트 SSID가 아닌 본래 SSID에 연결해 주세요.
• 폰이 Wi-Fi가 아닌 모바일 데이터(LTE/5G)로 연결되어 있으면 발견되지 않습니다.

② 공유기의 'AP 격리' 설정 끄기

• 공유기 설정에 'AP 격리', '클라이언트 격리', '무선 격리' 같은 항목이 켜져 있으면 같은 Wi-Fi여도 기기끼리 통신할 수 없습니다.
• 공유기 관리 페이지에서 해당 설정을 끄면 바로 연결됩니다. 공유기를 바꿀 수 없는 환경이라면 2번(Tailscale)으로 넘어가세요.

③ Mac 방화벽에서 BeamLink 허용

• macOS 방화벽이 켜져 있으면 연결 요청이 차단될 수 있습니다.
• 시스템 설정 → 네트워크 → 방화벽에서 BeamLink를 허용해 주세요. BeamLink는 UDP 49200 포트로 통신합니다.

④ 그래도 안 되면 수동으로 연결

• 일부 네트워크는 기기 자동 검색(mDNS) 자체를 막습니다. Android 앱의 '직접 입력'에서 Mac의 IP 주소를 입력하면 검색 없이 바로 연결할 수 있습니다.
• Mac의 IP는 시스템 설정 → Wi-Fi → 연결된 네트워크 → 세부 정보에서 확인할 수 있습니다.

2. 회사 · 학교 · 공용 네트워크, 또는 집 밖에서 연결할 때

회사·학교·카페의 Wi-Fi는 보안상 기기 간 통신과 자동 검색을 막는 경우가 많고, 테더링·통신사망(CGNAT)에서는 기기끼리 직접 연결할 경로가 없습니다. 이런 환경에서는 Tailscale이 해결책입니다.

1. Mac과 Android에 각각 Tailscale 앱을 설치하고 같은 계정으로 로그인합니다.
2. 양쪽에서 Tailscale을 켜면, BeamLink는 저장된 기기의 Tailscale 주소로 자동 연결을 시도합니다.
3. 이후에는 집 밖에서도, 막힌 네트워크에서도 같은 방식으로 그대로 연결됩니다.

Tailscale을 거치더라도 화면 데이터는 BeamLink 서버가 아닌 두 기기 사이의 암호화된 경로로만 이동합니다.

3. 화면이 느리거나 끊길 때

• 성능 모드를 'Fast'로 변경: Android 앱 설정에서 성능 모드를 Fast(720p60 · 낮은 지연)로 바꾸면 가장 가볍게 동작합니다. Balanced는 대부분의 환경에 권장되는 기본값, Quality(1080p60)는 망이 충분히 빠를 때만 켜세요.
• 5GHz Wi-Fi 사용: 2.4GHz보다 혼잡이 적어 지연이 안정적입니다. 공유기와 두 기기가 가까울수록 좋습니다.
• 화면 위 숫자 확인: 연결 중 화면에 표시되는 지연 시간(ms)이 튀는 구간이 보이면 네트워크 품질 문제입니다. 숫자가 안정적인데 느리다면 Mac 측 부하를 의심해 보세요.
• 적응형 화질: 네트워크가 흔들리면 BeamLink가 화질을 스스로 낮췄다가 회복합니다. 일시적인 화질 저하는 정상 동작입니다.

4. 연결은 됐는데 검은 화면만 보일 때

Mac의 '화면 녹화' 권한이 없으면 화면을 캡처할 수 없어 검은 화면이 표시됩니다.

1. Mac에서 시스템 설정 → 개인정보 보호 및 보안 → 화면 및 시스템 오디오 녹화(또는 '화면 기록')로 이동합니다.
2. BeamLink를 켜고, 권한 변경 후 안내에 따라 Mac 앱을 재시작합니다.

5. 화면은 보이는데 터치 · 키보드가 동작하지 않을 때

입력 전달에는 '손쉬운 사용' 권한이 필요합니다.

1. Mac에서 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용으로 이동합니다.
2. BeamLink를 켭니다. 목록에 없으면 BeamLink 앱을 한 번 실행한 뒤 다시 확인해 보세요.

6. 연결이 자주 끊길 때

• Mac 절전 확인: Mac이 잠자기에 들어가면 호스트가 멈추며 연결이 끊깁니다. 사용 중에는 시스템 설정 → 배터리(또는 전원)에서 자동 잠자기를 늦추거나, 전원 어댑터 연결 상태를 유지해 주세요.
• Wi-Fi 신호 확인: 공유기에서 멀어지면 세션이 끊길 수 있습니다. 끊기면 앱이 자동으로 다시 연결을 시도하고, 저장된 기기는 주소가 바뀌어도 다시 찾아 연결합니다.
• 네트워크 전환 직후: Wi-Fi를 바꾸거나 VPN을 켜고 끈 직후에는 한 번 수동으로 재연결해 주세요.