Mac에서 Happ 설정하기: 설치부터 트래픽 라우팅까지

macOS에 Happ 설치하기

Happ는 Xray 코어 기반 클라이언트로, Mac에서는 시스템 프록시를 사용하는 일반 앱으로도, 완전한 네트워크 터널로도 동작합니다. macOS용 버전을 내려받아 앱을 '응용 프로그램' 폴더로 옮기고 실행하세요. 처음 실행할 때 macOS가 인터넷에서 다운로드한 프로그램이라는 Gatekeeper 경고를 표시할 수 있는데, '시스템 설정 → 개인 정보 보호 및 보안'을 열고 '확인 없이 열기' 버튼으로 실행을 허용하면 됩니다.

안정적인 동작을 위해서는 macOS 12 Monterey 이상을 권장합니다. 그보다 낮은 버전에서는 Happ가 TUN 모드에 사용하는 일부 네트워크 API를 이용할 수 없습니다. 클라이언트는 Apple Silicon 프로세서(M1~M4)를 탑재한 Mac과 Intel 칩 모델 모두에서 동일하게 정상 작동하며, 아키텍처별로 별도 빌드를 찾을 필요 없이 universal 버전이 알아서 필요한 코드를 선택합니다.

설치 후에는 로그인 시 Happ 자동 실행과 메뉴 막대 아이콘 표시를 바로 허용해 두는 것이 좋습니다. 이렇게 하면 연결, 서버 전환, 모드 변경을 손쉽게 할 수 있고, 매번 앱 창을 열 필요가 없어 편리합니다.

키와 구독: 연결 방법

서버 접근 권한은 서비스의 Telegram 봇이 발급합니다. 봇에서 체험용, 공식 또는 유료 키를 발급받으면, 응답으로 구독 문자열(happ:// 또는 https:// 형식의 링크)이나 개별 서버 설정을 받게 됩니다. Mac에서 긴 설정을 손으로 복사할 필요는 없습니다. 구독이 최신 서버 목록을 스스로 불러오고 서비스 측 변경이 있을 때마다 갱신해 줍니다.

키를 추가하는 가장 빠른 방법은 구독 링크를 복사한 뒤 Happ에서 '클립보드에서 추가'를 누르는 것입니다. 앱이 클립보드 내용을 인식해 프로필을 자동으로 가져옵니다. macOS에서 happ:// 링크를 직접 열면 시스템이 deep-link로 Happ에 전달할지 물어보고, 프로필이 한 번의 클릭으로 추가됩니다.

가져오기가 끝나면 서버 목록이 메인 창에 나타납니다. 핑이 가장 낮은 노드를 선택하고 '연결'을 누른 뒤 표시등이 활성화될 때까지 기다리세요. 구독은 한 번만 추가하면 충분합니다. 봇에서 키를 갱신할 때 다시 설치할 필요가 없으며, 클라이언트가 알아서 업데이트를 불러옵니다.

프록시 모드와 TUN 모드: 무엇을 고를까

macOS에서 Happ는 트래픽을 통과시키는 근본적으로 다른 두 가지 방식을 제공합니다. 프록시 모드는 로컬 SOCKS/HTTP 프록시를 띄우고 이를 시스템 네트워크 설정에 등록합니다. 이 프록시를 통해서는 시스템 프록시를 따르는 앱들의 요청, 특히 브라우저의 요청이 지나갑니다. 가벼운 모드로, 관리자 권한이 필요 없고 프록시를 우회하는 프로그램의 트래픽에는 영향을 주지 않습니다.

TUN 모드(시스템 터널 모드라고도 함)는 가상 네트워크 인터페이스 utun을 생성해 시스템 전체 수준에서 트래픽을 가로챕니다. 이 경우 브라우저뿐 아니라 메신저, 데스크톱 클라이언트, 터미널, 백그라운드 서비스까지 터널을 통해 지나갑니다. TUN을 활성화하려면 Happ가 한 번 권한이 있는 helper를 설치하고 관리자 암호로 동작을 확인해 달라고 요청하는데, 이는 네트워크 스택을 제어하는 앱에 대한 macOS의 정상적인 동작입니다.

실용적인 규칙: 앱 전체가 '전부 통하게' 해야 한다면 TUN을 켜세요. 브라우저에서만 접근을 열고 나머지 시스템은 건드리지 않는 것처럼 목적이 한정적이라면 프록시 모드로 충분합니다. 구독을 지우거나 선택한 서버를 바꾸지 않고도 실시간으로 모드를 전환할 수 있습니다.

라우팅과 split tunneling

Happ 내부의 Xray 코어는 유연한 라우팅을 지원합니다. 어떤 트래픽이 서버를 통해 가고 어떤 트래픽이 직접 나갈지 규칙을 정할 수 있습니다. Mac에서는 이를 주로 분할 터널링(split tunneling)에 사용합니다. 예를 들어 은행 및 로컬 사이트는 터널을 우회시키고 나머지는 모두 선택한 서버를 통해 보내는 식입니다. 규칙은 도메인, IP 서브넷, 지역 구역을 기준으로 구성됩니다.

미리 준비된 라우팅 목록(routing lists)을 쓰면 수백 개의 도메인을 일일이 나열하지 않아도 됩니다. 이런 목록을 연결하면 '로컬 리소스는 직접 연결' 또는 '광고 및 추적 도메인은 차단' 같은 미리 설정된 규칙 세트를 얻게 됩니다. 목록은 갱신되므로 별도 조작 없이도 규칙이 최신 상태로 유지됩니다.

macOS에서는 로컬 네트워크 트래픽 우회 옵션이 특히 유용합니다. 프린터, NAS, 홈 네트워크의 다른 기기에 대한 접근은 직접 나가야 하며, 그렇지 않으면 해당 기기를 찾지 못하게 됩니다. 라우팅 설정에서 사설 대역(10.0.0.0/8, 192.168.0.0/16 등)은 터널 밖에 두세요. 이는 표준적이고 안전한 관행입니다.

최적화와 Mac에서의 흔한 문제

TUN을 켠 뒤 모든 앱에서 인터넷이 끊겼다면, 우선 권한이 있는 helper가 설치되었는지, 그리고 Happ가 '개인 정보 보호 및 보안'에서 네트워크 구성을 변경할 권한을 가지고 있는지 확인하세요. 이 권한이 회수된 것이 터널은 올라오지만 트래픽이 통과하지 않는 가장 흔한 원인입니다. 보통 앱 설정에서 helper를 다시 설치하면 문제가 해결됩니다.

속도가 느릴 때는 지리적으로 더 가까운 서버로 바꿔 보고 연결 전송 방식에 주목하세요. Xray 코어의 최신 위장 프로토콜을 쓰는 노드는 대개 불안정한 회선에서도 안정적인 결과를 주는 반면, 과부하된 공용 노드는 혼잡 시간대에 속도가 떨어집니다. 서버의 핑과 부하는 목록에서 바로 확인할 수 있습니다.

프록시 모드에서 브라우저가 연결을 무시한다면, 브라우저에 자체 프록시나 네트워크를 가로채는 확장 프로그램이 설정되어 있지 않은지 확인하세요. 그것이 시스템 설정을 덮어씁니다. 그리고 Mac이 절전 모드로 들어갈 때 Happ가 끊기지 않게 하려면 시작 시 자동 연결과 터널 유지를 켜세요. 그러면 노트북이 깨어난 뒤 연결이 스스로 복구됩니다.