v2rayN macOS 설치 시 ‘개발자를 확인할 수 없음’ 해결 및 네트워크 권한 설정

macOS에서 v2rayN을 응용 프로그램 폴더로 옮기는 방법부터 Gatekeeper 차단 해제, 시스템 프록시와 네트워크 권한 설정까지 안내합니다.

이 글의 핵심

v2rayN을 처음 설치하거나 Mac을 교체한 뒤 다시 설정하는 사용자를 위한 안내입니다. 설치 파일의 아키텍처, Gatekeeper 경고, 로컬 리스너, 시스템 프록시와 네트워크 권한 순서로 확인하세요. 문제가 발생한 지점을 먼저 파악한 다음 재설치, 프록시 조정 또는 권한 변경 여부를 결정하면 됩니다.

v2rayN 설치 및 첫 실행 경고 해결

  1. 프로세서 확인

    Apple 메뉴 → ‘이 Mac에 관하여’를 엽니다. Apple 칩이 표시되는 Mac은 arm64 패키지를, Intel 프로세서가 표시되는 Mac은 x64 패키지를 선택하세요. 다운로드 페이지의 시스템 요구 사항도 확인합니다. 아키텍처가 맞지 않아 발생한 실행 오류는 네트워크 권한을 바꿔도 해결되지 않습니다.

  2. 응용 프로그램 폴더로 이동

    압축 파일은 먼저 풀고, 디스크 이미지는 연 다음 v2rayN 앱을 Finder의 ‘응용 프로그램’ 폴더로 드래그하세요. 복사가 끝나면 해당 폴더에서 앱을 실행합니다. 다운로드 폴더나 디스크 이미지에 있는 복사본은 실행하지 마세요. 업그레이드 전에 실행 중인 이전 버전을 종료하고 필요한 설정을 백업해 두세요.

  3. 차단 경고 문구 확인

    ‘개발자를 확인할 수 없음’은 시스템이 해당 앱의 신뢰 여부를 확인하지 못했다는 뜻이며, 노드 테스트 결과와는 관계가 없습니다. 경고 창에 표시된 앱 이름이 ‘응용 프로그램’ 폴더로 옮긴 앱과 같은지 확인하세요. 출처를 알 수 없거나 앱이 컴퓨터를 손상시킬 수 있다는 경고가 표시되면 실행을 중단하고 출처가 명확한 배포 파일을 사용하세요.

  4. 앱별 허용 옵션 확인

    macOS 13 이상에서는 Apple 메뉴 → ‘시스템 설정’ → ‘개인정보 보호 및 보안’을 열고 아래로 스크롤해 ‘보안’ 항목을 확인하세요. 앱 실행이 차단된 뒤 해당 앱에 ‘그래도 열기’가 표시될 수 있습니다. 배포 출처와 앱을 확인했고 기기 정책에서 허용하는 경우에만 이 옵션을 선택한 다음, 인증 절차를 거쳐 앱을 여세요. 이 예외는 해당 앱에만 적용되며 Mac 전체의 보안 정책을 바꿀 필요는 없습니다.

macOS 15부터는 Finder에서 Control 키를 누른 채 앱을 클릭하고 ‘열기’를 선택하는 방법으로 서명 또는 공증 차단을 우회할 수 없습니다. ‘그래도 열기’가 표시되지 않으면 가장 최근에 차단된 앱이 현재 설치한 복사본인지 먼저 확인하세요. 조직에서 관리하는 Mac은 이 옵션이 제한될 수 있으므로 전체 설정을 변경하지 말고 관리자에게 정책을 확인하세요.

Gatekeeper, 프록시, 네트워크 권한 구분하기

경고와 증상으로 문제 지점 파악

권장

메인 창이 나타나지 않으면 먼저 시스템 경고를 확인하세요. 메인 창은 열렸지만 코어가 종료되면 v2rayN 로그를 살펴보세요. 코어가 리스닝 중인데 브라우저가 연결되지 않으면 프록시 주소와 포트를 확인합니다. 한 번에 하나씩 변경하고 변경 전 값을 기록해 두세요.

대상: 첫 설치, 업그레이드 후 오류, Mac 교체 후 이전

기존 시스템 프록시 유지

회사 네트워크에서 프록시나 자동 프록시 설정을 사용 중이라면 우선 기존 값을 유지하세요. 프록시를 별도로 설정할 수 있는 테스트 앱에 v2rayN의 실제 리스닝 주소를 입력하면 시스템 프록시 설정 충돌과 코어 문제를 구분할 수 있습니다.

대상: 기존 프록시를 바꾸지 않고 특정 앱 하나만 테스트하려는 경우

시스템 프록시는 앱이 참조할 수 있는 프록시 설정일 뿐, 모든 트래픽을 가로채지는 않습니다. 자체 프록시 설정을 사용하거나 직접 연결하는 앱은 시스템 프록시를 바꿔도 연결 경로가 달라지지 않을 수 있습니다. v2rayN의 라우팅 규칙은 코어에 전달된 요청에 적용되므로, 라우팅을 조정해도 원래 직접 연결하던 앱이 자동으로 로컬 리스너를 사용하게 되지는 않습니다.

리스닝 포트와 macOS 시스템 프록시 확인

127.0.0.1
로컬 IPv4 루프백 주소
10808
로컬 포트 점검 예시: 실제 설정에 맞게 확인
10809
다른 포트 예시이며 별도의 리스너가 반드시 있다는 뜻은 아닙니다

먼저 v2rayN의 ‘설정’ → ‘매개변수 설정’에서 로컬 리스너 구성을 확인하고, 코어 시작 로그와 실제 리스닝 상태를 기준으로 판단하세요. 버전에 따라 항목 이름, 리스닝 방식, 포트가 다를 수 있습니다. 오래된 안내에서 SOCKS와 HTTP에 포트를 각각 지정했다고 해서 시스템에 그대로 입력하지 마세요. 해당 버전에서 혼합 인바운드를 사용한다면 실제 구성에 따라 같은 포트가 두 프로토콜을 모두 받는지 확인하세요.

로컬 리스너 확인

서버
이 컴퓨터에서만 테스트할 때 127.0.0.1
포트
현재 설정과 시작 로그 확인
프로토콜
HTTP, SOCKS, 혼합 인바운드 구분
상태
코어 프로세스가 계속 실행 중인지 확인

포트가 리스닝 중이라는 사실만으로 원격 노드의 연결 가능 여부까지 확인되지는 않습니다.

시스템 프록시 확인

설정 경로
‘시스템 설정’ → ‘네트워크’
서비스
현재 사용 중인 Wi-Fi 또는 이더넷 → ‘세부사항’ → ‘프록시’
프록시 유형
로컬 인바운드 프로토콜과 일치하는 유형
서버 및 포트
로컬 리스너를 입력하고 원격 구독 노드는 입력하지 마세요

변경하기 전에 기존 수동 프록시, 자동 프록시 설정과 예외 항목을 기록해 두면 복원할 때 편리합니다.

v2rayN에서 ‘시스템 프록시 설정’을 선택한 뒤 현재 연결 중인 네트워크 서비스로 돌아가 실제 적용된 값을 확인하세요. 다른 네트워크 인터페이스로 전환한 후 앱이 갑자기 프록시를 사용하지 않는다면 새 서비스의 설정부터 확인합니다. 코어 로그에 address already in use가 표시되면 아래 예시처럼 터미널에서 해당 포트를 사용 중인 프로세스를 확인하세요. 예시 포트는 로그에 표시된 오류 포트로 바꿉니다.

lsof -nP -iTCP:10808 -sTCP:LISTEN

포트를 사용하는 프로세스를 확인한 뒤 이전 인스턴스를 종료할지 현재 인스턴스의 포트를 변경할지 결정하세요. 포트를 바꾸면 기존 포트를 참조하는 시스템 프록시나 앱별 프록시 설정도 함께 업데이트해야 합니다. v2rayN을 종료한 뒤 웹페이지가 열리지 않으면 시스템이 더 이상 리스닝하지 않는 루프백 포트를 가리키고 있는지 먼저 확인하세요. 기존에 회사 프록시를 사용했다면 무조건 초기화하지 말고 기록해 둔 설정을 복원하세요.

macOS 네트워크 권한 관련 자주 묻는 질문

‘로컬 네트워크’를 거부하면 구독을 업데이트할 수 없나요?

반드시 그런 것은 아닙니다. macOS 15의 로컬 네트워크 권한은 로컬 네트워크 기기에 접근하는 등의 상황에 적용되며, 일반 인터넷 연결을 제어하는 스위치는 아닙니다. 공용 인터넷에서 구독 업데이트가 실패하면 먼저 로그에서 DNS 조회 실패, 연결 시간 초과, 서버 오류 중 어떤 문제가 발생했는지 확인하세요. 로컬 네트워크 리소스에 실제로 접근해야 하는 경우에만 ‘시스템 설정’ → ‘개인정보 보호 및 보안’ → ‘로컬 네트워크’에서 해당 앱의 권한 상태를 확인하세요.

방화벽에서 들어오는 연결을 허용하라고 합니다. 허용해야 하나요?

이 Mac에서 시스템 프록시만 사용하는 경우, 외부 연결 시간 초과를 해결하려고 로컬 네트워크의 인바운드 연결을 허용하지 마세요. ‘시스템 설정’ → ‘네트워크’ → ‘방화벽’ → ‘옵션’에서 해당 앱의 규칙을 확인하고, 리스너가 루프백 주소에만 바인딩되어 있는지도 살펴보세요. 방화벽의 인바운드 규칙과 코어의 원격 서버 연결 여부는 서로 다른 문제입니다.

브라우저는 되는데 다른 앱은 왜 직접 연결되나요?

해당 앱에 자체 프록시 설정이 있는지 확인하세요. 수동 설정을 지원한다면 로컬 리스너와 같은 프로토콜을 선택하고 루프백 주소와 실제 포트를 입력한 뒤 같은 요청을 다시 시도합니다. 직접 연결만 지원하는 앱이라면 시스템 프록시가 설정되었다고 해서 그 앱도 프록시를 사용한다고 볼 수 없습니다.

시스템에서 네트워크 구성을 추가하라고 합니다. 일반 프록시에도 필요한가요?

먼저 TUN이나 다른 가상 네트워크 기능을 직접 활성화했는지 확인하세요. 일반 시스템 프록시를 테스트할 때는 해당 모드를 종료하고 로컬 리스너와 현재 네트워크 서비스의 프록시 설정만 확인할 수 있습니다. 추가 권한을 요청하면 팝업에 표시된 요청 대상과 용도를 확인하세요. 조직에서 관리하는 기기라면 기능을 활성화해도 되는지 관리자에게 확인합니다.

v2rayN 다운로드