v2rayN macOS 설치 방법: 확인되지 않은 개발자 경고와 네트워크 권한 설정

설치 파일 선택과 앱 위치

화면 왼쪽 위의 Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’에 Apple 칩 모델이 표시되면 macOS ARM64를, ‘프로세서’에 Intel 모델이 표시되면 macOS x64를 선택합니다. 설치 파일 크기로 아키텍처를 판단하거나 Windows 설치 파일을 macOS 앱처럼 실행하지 마세요.

설치 전에 ‘이 Mac에 관하여’에서 macOS 버전을 확인하고 선택한 릴리스의 최소 시스템 요구 사항과 비교하세요. 시스템 버전이 낮은 문제와 Gatekeeper 차단은 서로 다릅니다. ‘이 앱은 이 Mac에서 사용할 수 없습니다’라는 메시지가 반드시 보안 설정을 허용해야 한다는 뜻은 아닙니다. 먼저 아키텍처와 시스템 요구 사항을 확인한 뒤 경고 문구 전체를 살펴보세요.

1. 아키텍처 확인

   Apple 메뉴 → ‘이 Mac에 관하여’에서 칩 정보를 확인하고 ARM64 또는 x64를 선택하세요. 다운로드는 사이트의 다운로드 페이지에서 할 수 있습니다.

2. 디스크 이미지 열기

   다운로드한 DMG 파일을 두 번 클릭하고 열린 디스크 창에서 v2rayN 앱을 찾으세요. 이미지가 마운트되지 않으면 먼저 다시 다운로드하세요. 시스템 보안 설정을 바로 변경하지 마세요.

3. 응용 프로그램으로 이동

   v2rayN을 Finder의 ‘응용 프로그램’ 폴더로 드래그하세요. 복사가 끝나면 디스크 이미지를 추출하고 ‘응용 프로그램’에서 실행합니다.

4. 정보 기록

   앱의 ‘정보’ 화면에 표시된 버전, macOS 버전, 설치 파일 아키텍처를 기록해 두세요. 나중에 오류를 문의할 때 ‘실행되지 않음’이라고만 설명하는 것보다 문제를 파악하기 쉽습니다.

디스크 이미지나 다운로드 폴더에서 앱을 계속 실행하지 마세요. 설치 위치를 고정하면 업데이트, 권한 인식, 로그인 항목 관리가 수월합니다. 업데이트 전에는 이전 프로세스를 종료하세요. 이전 버전에서 TUN을 사용했다면 먼저 TUN을 끄고 시스템 프록시를 해제한 다음 앱을 교체합니다.

‘개발자를 확인할 수 없음’ 경고 허용하기

Gatekeeper는 앱을 실행하는 단계에서 검사합니다. ‘개발자를 확인할 수 없음’ 또는 ‘악성 소프트웨어가 포함되어 있는지 확인할 수 없음’이라는 경고가 표시되면 보통 핵심 프로그램이 아직 포트를 열지 않은 상태입니다. 이때 노드, 구독, DNS를 바꿔도 실행 차단은 해결되지 않습니다.

1. 앱 실행 시도

   ‘응용 프로그램’에서 v2rayN을 두 번 클릭한 뒤 차단 경고를 읽고 닫으세요. 출처를 확인한 앱에 대해서만 다음 단계를 진행합니다.

2. 보안 설정 열기

   Apple 메뉴 → ‘시스템 설정’ → ‘개인정보 보호 및 보안’으로 이동한 뒤 아래쪽 ‘보안’ 영역에서 방금 차단된 앱 기록을 확인하세요.

3. 이번 실행만 허용

   기록에 표시된 앱 이름이 맞는지 확인하고 ‘그래도 열기’를 클릭하세요. 시스템 안내에 따라 관리자 인증을 완료한 다음 확인 창에서 ‘열기’를 선택합니다.

4. 다시 실행

   ‘응용 프로그램’으로 돌아가 앱을 다시 실행하세요. 해당 기록이 보이지 않으면 차단을 한 번 더 발생시킨 뒤 확인합니다. 조직에서 관리하는 기기는 관리자에게 문의하세요.

macOS 버전에 따라 Finder에서 마우스 오른쪽 버튼을 눌러 ‘열기’를 선택하는 방식이 항상 통하지는 않습니다. ‘개인정보 보호 및 보안’에 표시된 허용 기록을 우선 확인하세요. 조직에서 관리하는 기기는 ‘그래도 열기’가 정책상 비활성화될 수 있으며, 관리자 암호를 반복 입력해도 관리 정책을 우회할 수 없습니다.

시스템 프록시와 TUN: 트래픽 처리 방식 선택

v2rayN 창이 열렸다고 해서 모든 앱의 트래픽이 프록시를 거치는 것은 아닙니다. 시스템 프록시는 현재 네트워크 서비스에 사용할 프록시 주소를 설정하지만, 각 앱이 이를 따르는지는 앱의 구현 방식에 달려 있습니다. TUN은 가상 네트워크 인터페이스로 트래픽을 처리하며 라우팅, DNS, 권한도 관련됩니다. 처음 문제를 확인할 때는 두 방식을 분리해 테스트하세요.

클라이언트가 네트워크 설정 변경을 요청하면 방금 관련 기능을 실행했으며 인증 창에 해당 앱 또는 알려진 구성 요소가 명시된 경우에만 허용하세요. 일반적인 시스템 프록시 설정은 네트워크 확장 설치와 다르며, 인터넷 연결을 위해 ‘전체 디스크 접근 권한’이나 ‘손쉬운 사용’을 허용할 필요도 없습니다.

• 시스템 프록시 확인: ‘시스템 설정’ → ‘네트워크’ → 현재 연결된 Wi-Fi 또는 이더넷 → ‘세부사항’ → ‘프록시’로 이동하세요. HTTP, HTTPS 또는 SOCKS에 설정된 주소와 포트를 기록합니다.
• 로컬 주소 확인: 이 기기의 프록시는 보통 127.0.0.1을 사용합니다. 포트는 v2rayN이 실제로 수신 대기하는 값과 일치해야 합니다. 안내서에 특정 숫자가 있다고 그대로 입력하지 마세요.
• 종료 전에 복원: v2rayN에서 ‘시스템 프록시 해제’를 선택한 다음 클라이언트를 종료하세요. 앱이 비정상 종료되었다면 위의 시스템 설정 화면에서 남아 있는 로컬 프록시 설정을 지웁니다.

네트워크 확장 및 네트워크 권한 확인

‘네트워크 확장’, ‘VPN 구성’, ‘로컬 네트워크’, 관리자 인증은 서로 다른 권한입니다. 먼저 시스템 메시지에 어떤 항목이 표시됐는지 확인한 뒤 해당 설정을 찾아야 합니다. v2rayN은 릴리스 버전과 실행 방식에 따라 트래픽 처리 방법이 다를 수 있습니다. 시스템 프록시만 사용하는 경우 네트워크 확장 알림이 없는 것이 정상일 수 있습니다.

시스템에 ‘VPN 구성 추가’라는 메시지가 표시되면 앱 이름을 확인한 뒤 허용 여부를 결정하세요. 이후 시스템 설정에서 ‘VPN’을 검색해 관련 항목을 확인할 수 있습니다. 일반 프록시 연결 문제를 해결하려고 실행 보안 정책을 낮추지 마세요. TUN을 켠 뒤 네트워크가 끊기면 먼저 TUN을 끄고 시스템 프록시를 해제해 일반 네트워크 연결이 복구되는지 확인하세요. 그다음 클라이언트 로그에서 권한, 라우팅, DNS 오류를 확인합니다.

• 승인 창이 나타나지 않음: 앱 창만 실행한 것이 아니라 추가 권한이 필요한 기능을 실제로 활성화했는지 먼저 확인하세요.
• 승인 후에도 실패함: 앱을 종료하고 다시 실행한 뒤 핵심 로그를 확인하세요. 로그에 표시되는 ‘권한 부족’과 ‘주소가 이미 사용 중’은 해결 방법이 다릅니다.
• 시스템에서 재시작을 요구함: 작업을 저장한 뒤 안내에 따라 재시작하세요. 클라이언트만 다시 열어서는 시스템 구성 요소 승인 절차가 완료되지 않을 수 있습니다.

첫 실행 후 연결 확인

권한 설정이 끝나면 먼저 정상 작동이 확인된 구성을 가져오세요. v2rayN에서 ‘구독 그룹’ → ‘구독 그룹 설정’을 열고 이름과 구독 주소를 입력한 뒤 저장합니다. 그런 다음 ‘구독 그룹’ 메뉴에서 업데이트를 실행하세요. 메뉴 문구는 버전에 따라 조금 다를 수 있습니다. 먼저 그룹을 저장한 다음 구독 내용을 가져와야 합니다. 주소만 저장했다고 노드가 가져와진 것은 아닙니다.

VMess와 VLESS는 구성에 사용하는 프로토콜 이름이지 macOS 권한 종류가 아닙니다. 구독 주소는 구성 목록을 가져오는 데 사용하고, 개별 공유 링크는 하나의 구성을 설명하므로 각각 알맞은 가져오기 기능을 사용해야 합니다. 구독에 포함된 TLS, SNI, 전송 방식, 경로는 원래 값으로 유지하세요. 설치 문제를 확인하려고 임의로 변경하지 마세요.

1. 먼저 목록 확인: 업데이트 후 구성 항목이 표시되어야 합니다. 목록이 비어 있으면 구독 응답, 그룹 필터, 업데이트 로그를 확인하세요. 네트워크 확장부터 승인하지 마세요.
2. 그다음 핵심 확인: 구성을 선택해 활성 서버로 지정하고 로그에서 핵심 프로그램 실행 실패, 파일 누락, 포트 충돌이 있는지 확인하세요. 화면의 실행 상태만으로 판단하지 말고 로그를 확인해야 합니다.
3. 수신 포트 확인: ‘설정’ → ‘매개변수 설정’에서 로컬 수신 포트 관련 항목을 확인한 뒤 시스템 네트워크 프록시 화면과 비교하세요. 아래 명령어의 10808은 확인용 예시일 뿐이므로 실행 전에 실제 값으로 바꾸세요.
4. 접속 테스트: 먼저 시스템 프록시를 사용해 평소 접속할 수 있는 HTTPS 사이트를 열고 해당 연결 로그가 생성되는지 확인하세요. 지연 시간 테스트에 성공해도 모든 앱이 프록시를 사용한다는 뜻은 아닙니다.

lsof -nP -iTCP:10808 -sTCP:LISTEN
scutil --proxy

첫 번째 명령어는 해당 TCP 포트를 프로세스가 수신 중인지 확인합니다. 출력에 나타나는 프로세스 이름과 PID로 포트를 사용하는 대상을 찾을 수 있습니다. 출력이 없으면 먼저 포트 값을 확인한 뒤 핵심 프로그램이 실행 중인지 살펴보세요. 두 번째 명령어는 현재 시스템 프록시 설정을 읽습니다. 실제로 표시되는 HTTPEnable, HTTPSProxy, HTTPSPort 등의 필드를 확인하세요. 특정 스위치가 1인지 여부만 보지 말고 주소와 포트가 올바르게 짝을 이루는지도 확인해야 합니다.

설치 및 권한 관련 자주 묻는 질문