Mac에 v2rayN을 처음 설치한다면 먼저 칩에 맞는 설치 파일을 선택하고, 시스템 안내에 따라 필요한 경우 앱 실행을 별도로 허용하세요. 메인 창이 열리면 시스템 프록시를 확인한 뒤 필요에 따라 TUN을 테스트합니다. 이렇게 하면 앱 실행, 프록시 코어, 시스템 네트워크 설정 중 어느 단계에서 문제가 생겼는지 구분할 수 있습니다.
Apple Silicon과 Intel: 아키텍처에 맞는 설치 파일 선택
Apple 메뉴 ‘’ → ‘이 Mac에 관하여’를 엽니다. ‘칩’ 항목에 Apple M 시리즈가 표시되면 ARM64를, ‘프로세서’ 항목에 Intel이 표시되면 x64를 선택하세요. 두 아키텍처 모두 현재 배포 파일에 적힌 최소 macOS 버전을 확인해야 합니다. 칩 아키텍처가 맞더라도 macOS 버전이 요구 사항을 충족하지 않을 수 있습니다.
ARM64 네이티브 버전
권장Apple Silicon Mac에서는 ARM64 또는 arm64로 표시된 macOS 버전을 우선 사용하세요. 처음 실행할 때 Rosetta 설치 안내가 예상치 않게 나타나면 다운로드한 파일과 사용 중인 코어의 아키텍처를 먼저 확인하세요.
권장 대상: Apple Silicon Mac
x64 네이티브 버전
Intel Mac에서는 x64 또는 x86_64 버전을 선택하세요. ARM64 버전은 Intel Mac에서 실행되지 않으며, 개인정보 보호 권한을 변경해도 아키텍처 불일치 문제는 해결되지 않습니다.
권장 대상: Intel 프로세서 Mac
디스크 이미지 파일을 받았다면 이미지를 열고 v2rayN 앱을 ‘응용 프로그램’으로 드래그하세요. 이미지를 추출한 다음 ‘응용 프로그램’에서 앱을 실행하면 됩니다. 압축 파일을 받았다면 먼저 압축을 완전히 풀고 해당 배포 파일의 안내에 따라 앱을 옮기세요. 압축 미리보기에서 바로 실행하거나 패키지 안의 코어 파일만 따로 옮기지 마세요.
Gatekeeper 경고: ‘그래도 열기’는 어디에서 누르나요?
‘개발자를 확인할 수 없음’은 앱을 실행할 때 나타나는 시스템 검사로, 구독·노드·네트워크 권한과는 무관합니다. 출처를 신뢰할 수 있고 파일이 의도한 배포 버전이며 기기 관리 정책에서 허용하는 경우에만 해당 앱을 별도로 허용하세요. 앱이 컴퓨터를 손상시키거나 악성 소프트웨어가 감지됐다는 경고가 표시되면 실행을 중단하고 출처를 다시 확인하세요. 이를 일반적인 개발자 확인 경고로 취급해서는 안 됩니다.
응용 프로그램에서 실행
Finder에서 ‘응용 프로그램’을 열고 v2rayN을 두 번 클릭하세요. 경고창에 표시된 앱 이름과 안내 문구를 확인한 뒤 창을 닫습니다. 이름을 먼저 확인해 같은 시기에 차단된 다른 앱을 실수로 허용하지 않도록 하세요.
보안 설정 열기
macOS 13 이후 버전에서는 ‘’ → ‘시스템 설정’ → ‘개인정보 보호 및 보안’을 열고 아래로 스크롤해 ‘보안’ 섹션을 찾으세요. 앱이 차단된 직후 확인하는 것이 좋습니다. 이 항목은 최근 실행 시도에 대한 안내이므로 항상 표시되는 것은 아닙니다.
앱 실행을 개별적으로 허용
보안 섹션에 표시된 앱이 v2rayN인지 확인한 뒤 ‘그래도 열기’를 누르세요. 시스템 안내에 따라 인증하고 확인 창에서 열기를 선택합니다. 관리형 기기에서 해당 옵션이 보이지 않으면 관리자에게 문의하세요. 시스템 전체의 보안 정책은 변경하지 마세요.
실행 결과 확인
메인 창이 열린 뒤 구독과 프록시를 설정하세요. 메인 창은 열리지만 로그에 코어 실행 실패가 표시된다면 앱 실행 단계의 문제가 아닙니다. 오류 메시지를 바탕으로 코어 아키텍처, 파일 누락 여부, 포트 사용 중 여부를 확인하세요.
시스템 프록시: 로컬 수신 주소부터 네트워크 서비스까지 확인
먼저 TUN을 끄고 정상 작동이 확인된 노드를 선택하세요. v2rayN의 ‘설정’ → ‘매개변수 설정’에서 로컬 수신 설정을 확인한 다음, 메인 화면의 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택합니다. 버전에 따라 버튼 위치는 다를 수 있습니다. 아래 숫자는 주소와 포트를 확인하는 예시이며 모든 버전의 기본값을 의미하지 않습니다.
- 현재 연결 확인. ‘시스템 설정’ → ‘네트워크’에서 사용 중인 연결을 선택하세요. Wi-Fi를 사용한다면 ‘Wi-Fi’ → 연결된 네트워크 옆의 ‘세부사항’ → ‘프록시’로 이동합니다. 유선 연결은 해당 이더넷 서비스에서 확인하세요. 연결을 바꾸면 이전 서비스의 프록시 설정이 새 서비스에도 적용된다고 볼 수 없습니다.
- 프록시 유형 확인. 활성화된 웹 프록시 또는 SOCKS 프록시에 입력된 주소와 포트를 확인하고, 실제 수신 프로토콜과 일치하는지 살펴보세요. SOCKS 전용 포트를 HTTP 프록시에 입력하면 안 됩니다. 혼합 수신을 사용하는 버전이라면 해당 수신 설정에서 지원하는 프로토콜을 기준으로 확인하세요.
- 브라우저 요청 확인. 시스템 프록시 설정을 따르는 브라우저에서 접속 가능한 웹페이지를 열고, v2rayN 로그에 새 요청이 기록되는지 확인하세요. 요청은 들어오지만 연결에 실패하면 노드와 라우팅을 먼저 점검하세요. 요청 자체가 없다면 브라우저에서 별도 프록시를 설정했는지, 현재 네트워크 서비스에 프록시가 적용됐는지 확인하세요.
시스템 프록시를 켜기 전에 기존 수동 프록시 설정이나 자동 구성 주소를 기록해 두세요. 테스트가 끝나면 먼저 v2rayN에서 클라이언트가 설정한 시스템 프록시를 해제한 다음 프로그램을 종료하고, 기존 설정이 복원됐는지 확인하세요. 복원하지 않으면 브라우저가 더 이상 수신하지 않는 로컬 포트에 계속 연결을 시도할 수 있습니다.
TUN과 네트워크 확장: 현재 기능에 필요한 항목만 허용
시스템 프록시는 프록시 설정을 따르는 앱에 적용됩니다. TUN은 가상 인터페이스와 라우팅으로 트래픽을 처리하므로 시스템 프록시 설정을 읽지 않는 프로그램을 테스트할 때 적합합니다. TUN이 곧 네트워크 확장인 것은 아닙니다. 버전에 따라 관리자 권한이 필요하거나 권한 도우미 프로그램을 사용하거나, 시스템의 VPN 구성 및 네트워크 확장 허용 안내가 표시될 수 있습니다. 확장 안내가 나타나지 않는다고 해서 설치 단계가 누락된 것은 아닙니다.
- 먼저 시스템 프록시 모드에서 노드가 정상 작동하는지 확인하세요. TUN을 테스트할 때는 이번에 설정한 시스템 프록시를 해제하고 필요한 네트워크 관리 설정은 유지한 채 TUN만 별도로 켜세요. 그래야 트래픽이 어떤 경로를 통과하는지 혼동하지 않습니다.
- 시스템에서 VPN 구성을 추가하거나 네트워크 확장을 허용하라고 하면 안내에 표시된 앱 이름과 직접 실행한 작업이 일치하는지 먼저 확인하세요. macOS 15에서는 ‘시스템 설정’ → ‘일반’ → ‘로그인 항목 및 확장 프로그램’의 ‘네트워크 확장’에서 관련 항목을 확인할 수 있습니다. 현재 버전에서 실제로 해당 확장을 사용하고 안내와 항목이 일치하는 경우에만 활성화하세요. 관리자 승인이 필요하다는 안내가 표시되면 권한이 있는 계정으로 시스템 대화상자에서 승인하세요.
- 기능을 켠 뒤 웹페이지와 로컬 네트워크 리소스를 테스트하고, 로그에서 인터페이스 생성, DNS 또는 라우팅 오류를 확인하세요. 업무용 네트워크에 연결할 수 없다면 먼저 TUN을 끄고 기존 연결이 복구됐는지 확인한 다음, 사용 중인 VPN이나 대역 라우팅, 기업 정책과 충돌하는지 점검하세요. 한 번에 하나씩 변경해야 라우팅 수정과 노드 교체를 같은 테스트로 혼동하지 않습니다.
첫 실행 및 네트워크 연결 문제 해결
‘그래도 열기’가 보이지 않는 이유는 무엇인가요?
‘응용 프로그램’에서 v2rayN을 다시 실행하고 차단 경고를 닫은 뒤 곧바로 ‘개인정보 보호 및 보안’ 화면 아래쪽을 확인하세요. 아키텍처가 호환되지 않거나 macOS 버전이 너무 낮다는 안내가 표시되면 설치 파일 요구 사항에 맞는 버전을 다시 선택하세요. 기기 관리 정책으로 제한된 경우에는 관리자에게 문의하세요.
구독 업데이트는 성공했는데 웹페이지가 열리지 않는 이유는 무엇인가요?
구독이 업데이트됐다는 것은 구독 주소에 접속해 설정을 가져왔다는 뜻일 뿐, 선택한 노드가 작동한다는 의미는 아닙니다. 사용할 노드를 선택하고 코어 로그에서 수신 상태를 확인한 뒤 현재 네트워크 서비스의 ‘프록시’ 화면에서 포트를 대조하세요. 로그에 요청은 있지만 핸드셰이크에 실패한다면 노드 설정을 확인하세요. 앱 권한을 다시 허용할 필요는 없습니다.
v2rayN을 종료한 뒤 브라우저에서 인터넷에 연결되지 않는 이유는 무엇인가요?
현재 네트워크 서비스가 웹 요청을 여전히 루프백 주소로 보내는지 확인하세요. 이번 테스트에서 설정한 프록시가 남아 있다면 v2rayN을 다시 실행해 시스템 프록시를 해제한 뒤 종료하거나, 네트워크 설정에서 미리 기록해 둔 값으로 복원하세요. TUN을 사용했다면 TUN도 꺼져 있는지 확인하세요.