v2rayN macOS 설치 방법과 권한 설정: ‘개발자를 확인할 수 없음’ 해결 및 네트워크 권한 안내

이 글의 핵심

Mac에 v2rayN을 처음 설치하거나 앱이 열리지 않거나 시스템 프록시가 작동하지 않는 경우에 유용한 안내입니다. 프로세서에 맞는 패키지를 선택해 ‘응용 프로그램’에 옮긴 다음, macOS에서 제공하는 앱별 허용 절차를 거쳐 실행하세요. 이후 로컬 리스너, 시스템 프록시, 필요한 경우에만 표시되는 네트워크 권한을 각각 확인합니다. Gatekeeper 허용은 프록시 연결 성공을 뜻하지 않으며, 관리자 승인이 macOS 보안 기능을 꺼야 한다는 의미도 아닙니다.

설치 파일 선택: 칩 종류와 macOS 요구 사항 확인

화면 왼쪽 위의 Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩 Apple M…’이라고 표시되면 Apple Silicon, 즉 ARM64용을 선택하고, ‘프로세서 Intel…’이라고 표시되면 Intel, 즉 x64용을 선택합니다. 외관이나 구입 연도로 판단하지 마세요. 같은 제품명에도 프로세서가 다른 모델이 있을 수 있습니다.

Apple Silicon 네이티브 버전

권장

Apple 칩 탑재 기기용이며 다운로드 파일에는 보통 arm64가 표시됩니다. 권장한다는 것은 Apple 칩 기기에서 해당 아키텍처의 네이티브 버전을 우선 사용하라는 뜻이지, 모든 Mac에서 이 패키지를 선택하라는 의미가 아닙니다.

대상: ‘이 Mac에 관하여’에 Apple 칩이라고 표시되는 Mac

Intel 네이티브 버전

Intel 기기용이며 다운로드 파일에는 보통 x64가 표시됩니다. Intel Mac에서는 ARM64 패키지를 실행할 수 없습니다. Apple Silicon에서 일부 Intel 앱을 실행하려면 Rosetta가 필요할 수 있지만, 처음 설치할 때부터 변환 실행을 기본 경로로 삼지는 마세요.

대상: ‘이 Mac에 관하여’에 Intel 프로세서라고 표시되는 Mac

클라이언트 다운로드 페이지에서 macOS용을 선택하고 해당 릴리스에 명시된 최소 시스템 요구 사항을 확인하세요. macOS용 데스크톱 앱 패키지를 선택하고 Windows WPF 패키지는 사용하지 마세요. Apple 칩 기기에서 Rosetta가 필요하다는 안내가 나오면 먼저 다운로드한 파일의 아키텍처가 맞는지 확인하세요. 앱과 함께 제공되는 코어도 기기 아키텍처에 맞춰야 하며, 이전 폴더의 다른 아키텍처 실행 파일이 섞이지 않도록 주의하세요.

압축 파일은 완전히 압축 해제한 뒤 앱을 ‘응용 프로그램’으로 옮기세요. 디스크 이미지 파일은 먼저 연 다음 안에 있는 앱을 ‘응용 프로그램’으로 드래그하세요.
기존 버전을 종료한 뒤 앱을 교체하세요. 처음 실행할 때 압축 파일 미리 보기나 디스크 이미지 안의 임시 복사본을 바로 실행하지 마세요.
업데이트 전에 클라이언트의 백업 또는 내보내기 기능으로 설정을 저장하세요. 구독 주소가 포함된 백업을 공개된 곳에 업로드하지 마세요.

Gatekeeper 차단: ‘그래도 열기’로 앱별 허용

‘개발자를 확인할 수 없음’ 또는 ‘Apple에서 악성 소프트웨어가 포함되어 있는지 확인할 수 없습니다’라는 메시지는 앱 신뢰 확인 안내이며, 노드·DNS·구독 오류가 아닙니다. 파일이 예상한 배포 경로에서 제공되었는지 확인한 뒤 macOS가 해당 앱에 제공하는 예외 허용 절차를 이용하세요. 아래 경로는 ‘시스템 설정’ 인터페이스를 사용하는 macOS 기준입니다. 버전에 따라 안내 문구가 조금 다를 수 있습니다.

처음 열기

‘Finder’에서 ‘응용 프로그램’을 열고 v2rayN을 두 번 클릭하세요. 보안 확인으로 차단되면 안내 내용을 확인하고 대화상자를 닫으세요. 이때 처음 실행한 기록은 남겨 둡니다.
보안 설정 열기

Apple 메뉴에서 ‘시스템 설정’ → ‘개인정보 보호 및 보안’을 열고 아래의 ‘보안’ 영역으로 이동하세요. 차단된 앱 이름이 방금 실행한 v2rayN인지 확인합니다.
앱별로 허용

해당 기록 옆의 ‘그래도 열기’를 클릭하세요. 요청이 표시되면 Touch ID 또는 관리자 계정으로 승인한 다음 이어지는 확인 창에서 ‘열기’를 선택합니다.
메인 화면 확인

앱이 실행되면 먼저 메인 화면과 로그를 확인해 코어 시작 오류가 없는지 살펴보세요. 창이 열렸다는 것은 앱 실행이 허용되었다는 뜻일 뿐입니다. 프록시 리스너와 네트워크 설정도 이어서 확인해야 합니다.

일부 구형 macOS에서는 Finder에서 앱을 Control 키를 누른 채 클릭하고 ‘열기’를 선택해 예외 확인을 띄울 수 있지만, 최신 시스템에서는 이 경로를 사용할 수 없는 경우가 있습니다. ‘개인정보 보호 및 보안’의 허용 기능을 우선 이용하세요. Gatekeeper 전체를 끄거나 시스템 무결성 보호를 비활성화할 필요는 없습니다.

처음 연결하기: 로컬 포트와 시스템 프록시 구분

v2rayN 메인 화면에서 본인의 구독을 가져와 업데이트한 다음 유효한 노드를 활성 서버로 선택하세요. 먼저 ‘설정’ → ‘매개변수 설정’에서 로컬 리스너 포트를 확인합니다. 그런 다음 메인 화면이나 메뉴 막대 아이콘의 ‘시스템 프록시’ 메뉴에서 ‘시스템 프록시 자동 구성’을 선택하세요. 데스크톱 릴리스에 따라 메뉴 위치가 다를 수 있으므로 현재 화면에 표시된 같은 이름의 설정을 기준으로 진행하세요.

아래 예시의 127.0.0.1:10808은 HTTP 프록시를 지원하는 로컬 리스너의 예시입니다. 모든 릴리스의 기본 포트가 이 값이라는 뜻은 아닙니다. 클라이언트에 다른 포트가 표시되거나 HTTP와 SOCKS가 별도 포트에서 수신 대기한다면, 시스템 웹 프록시에는 실제 HTTP 주소를 지정해야 합니다. 예시를 그대로 복사하지 마세요.

127.0.0.1

원격 노드가 아닌 로컬 루프백 주소

10808

예시에 사용된 로컬 HTTP 리스너 포트

2개 항목

웹 프록시와 보안 웹 프록시 직접 확인

프록시를 활성화한 뒤 ‘시스템 설정’ → ‘네트워크’ → 현재 사용 중인 Wi-Fi 또는 이더넷 서비스 → ‘세부사항’ → ‘프록시’를 여세요. 수동 HTTP 시스템 프록시를 사용한다면 ‘웹 프록시(HTTP)’와 ‘보안 웹 프록시(HTTPS)’가 해당 로컬 주소와 포트를 가리키는지 확인합니다. HTTPS 프록시 설정은 HTTPS 요청이 해당 HTTP 프록시를 통해 터널링된다는 뜻이며, 로컬 리스너 자체에 TLS를 활성화해야 한다는 의미는 아닙니다.

클라이언트 리스너 예시

리스너 주소: 127.0.0.1
리스너 포트: 10808
지원 프로토콜: HTTP 프록시 지원
활성 서버: 선택된 유효 노드

먼저 로그에서 코어가 정상적으로 시작되었는지 확인하세요. 예시 값은 실제 기기의 설정에 맞게 바꿔야 합니다.

시스템 프록시 설정 확인 예시

웹 프록시: 127.0.0.1:10808
보안 웹 프록시: 127.0.0.1:10808
프록시 인증: 로컬 리스너 설정에 맞춰 입력
적용 대상 서비스: 현재 인터넷에 연결된 네트워크 서비스

클라이언트가 PAC를 사용한다면 자동 프록시 구성 주소를 확인하고, 출처를 알 수 없는 수동 프록시를 추가로 설정하지 마세요.

시스템 프록시는 이 설정을 따르는 앱에만 영향을 줍니다. 브라우저에서는 접속되지만 명령줄 도구가 계속 직접 연결된다고 해서 권한 문제가 발생한 것은 아닙니다. 해당 도구에는 별도로 프록시 매개변수를 지정해야 할 수 있습니다. 반대로 시스템 설정에서 프록시가 켜져 있다고 해서 코어가 실제로 수신 대기 중이라는 뜻도 아닙니다. 두 항목을 따로 확인해야 합니다.

네트워크 권한: 관리자 승인, 로컬 네트워크, TUN 구분

macOS에는 ‘모든 프록시 트래픽 허용’과 같은 필수 통합 스위치가 없습니다. 권한 요청이 표시되면 어떤 프로그램이 무엇을 변경하려는지 먼저 확인하세요. 일반 시스템 프록시, 로컬 네트워크 검색, 가상 네트워크 인터페이스를 통한 트래픽 처리의 목적은 서로 다릅니다. 웹 페이지가 열리지 않는다는 이유만으로 모든 권한을 켜지 마세요.

요청 또는 설정 위치	사용 목적	대응 방법
관리자 계정 확인	보호된 네트워크 설정을 변경하거나 필요한 보조 구성 요소를 설치	요청한 프로세스와 작업을 확인하고 방금 실행한 클라이언트 작업이 맞을 때 승인하세요. 비밀번호를 구독 또는 노드 입력란에 입력하지 마세요.
개인정보 보호 및 보안 → 로컬 네트워크	앱이 로컬 네트워크 기기 등 로컬 네트워크 리소스에 접근하는 것을 제어	macOS 15 및 이후 버전에서는 관련 요청이 표시될 수 있습니다. 로컬 네트워크 기능이 실제로 필요할 때만 허용하세요. 이 설정은 인터넷 접속을 통제하는 전체 스위치가 아닙니다.
TUN 관련 권한 상승	가상 네트워크 인터페이스 생성, 경로 또는 DNS 변경	현재 릴리스에서 이 기능을 제공하고 시스템 프록시를 따르지 않는 앱까지 처리해야 할 때만 활성화하세요. 클라이언트 안내에 따라 권한을 설정합니다.
네트워크 → 방화벽	수신 연결 관리	로컬 프록시의 송신 연결 오류는 보통 방화벽을 끈다고 해결되지 않습니다. 다른 기기에서 접속해야 하는 경우에만 해당 수신 규칙을 확인하세요.

‘로컬 네트워크’ 목록에 v2rayN이 없다고 설치가 잘못된 것은 아닙니다. 보통 앱이 관련 접근을 요청한 뒤에야 목록에 표시됩니다. 루프백 주소로 로컬 프록시를 사용하는 경우에는 이 항목만으로 추가 권한이 반드시 필요하다고 판단할 수 없습니다. 관리되는 업무용 컴퓨터에서는 조직 정책이 네트워크 확장 또는 프록시 설정을 제어할 수 있습니다. 이 경우 관리자에게 문의하고 관리 설정을 임의로 제거하지 마세요.

연결 문제 해결: 리스너부터 현재 네트워크 서비스까지 확인

‘시스템 프록시는 켜져 있는데 웹 페이지가 열리지 않는’ 경우 로컬 리스너, 시스템 설정, 원격 연결 순서로 점검하세요. 시스템 프록시 설정을 변경하는 다른 도구가 있다면 먼저 종료해 여러 프로그램이 설정을 덮어쓰지 않게 하세요. 아래 명령은 상태만 확인하며 시스템 설정을 변경하지 않습니다. ‘응용 프로그램’ → ‘유틸리티’ → ‘터미널’에서 실행하세요.

# 예시 포트에서 TCP 리스너가 실행 중인지 확인
lsof -nP -iTCP:10808 -sTCP:LISTEN

# 네트워크 서비스를 나열해 실제 사용 중인 서비스 이름 확인
networksetup -listallnetworkservices

# 아래 예시는 Wi-Fi라는 서비스 이름을 사용합니다
networksetup -getwebproxy "Wi-Fi"
networksetup -getsecurewebproxy "Wi-Fi"
networksetup -getautoproxyurl "Wi-Fi"

리스너 출력이 없음: v2rayN 로그로 돌아가 코어가 종료되었는지, 포트가 다른지 확인하세요. 포트가 이미 사용 중이면 해당 프로세스를 확인하거나 클라이언트에서 포트를 변경한 다음 시스템 프록시를 다시 설정하세요.
시스템 프록시가 이전 포트를 가리킴: 클라이언트에서 시스템 프록시를 해제한 다음 자동 구성을 다시 실행하세요. 수동으로 변경하는 경우 현재 연결된 네트워크 서비스의 두 웹 프록시 항목을 모두 업데이트해야 합니다.
서비스 이름 조회 오류: 명령의 Wi-Fi를 목록에 표시된 실제 네트워크 서비스 이름으로 바꾸세요. 이름에 공백이 있으면 영문 큰따옴표를 유지합니다.
리스너와 시스템 설정이 올바름: 로그에서 원격 연결, TLS 또는 도메인 이름 확인 오류를 살펴보세요. 시간 초과는 서버에 연결할 수 없는 문제일 수 있습니다. 인증서 오류가 발생하면 시스템 시간과 노드의 TLS 설정을 확인하세요. 인증서 검증을 건너뛰는 방식으로 문제를 덮지 마세요.

아래 요청으로 로컬 HTTP 프록시만 따로 테스트할 수도 있습니다. 프록시를 명시적으로 지정하므로 시스템 프록시 스위치에 의존하지 않습니다. 예시 포트를 실제 포트로 바꾸세요. 대상은 이 사이트의 홈이며, 결과는 현재 네트워크와 노드, 대상 사이트의 상태에 따라 달라집니다. 한 번의 요청 결과만으로 모든 앱의 상태를 판단하지 마세요.

curl --proxy http://127.0.0.1:10808 --head --max-time 15 https://v2raydns.com/

127.0.0.1에 연결할 수 없다는 메시지가 나오면 먼저 로컬 리스너를 확인하세요. 로컬 연결은 되었지만 원격 요청이 실패하면 활성 노드와 로그를 확인합니다. 프록시를 명시한 요청은 성공하지만 브라우저에서 실패한다면 브라우저의 별도 프록시 설정, 이전 PAC 또는 설정을 덮어쓰는 확장 프로그램을 점검하세요. 로컬 리스너가 작동하기 전에 DNS를 반복해서 변경하지 마세요.

자주 묻는 질문: 앱 실행을 허용한 뒤 확인할 항목

‘그래도 열기’ 버튼이 표시되지 않는 이유는 무엇인가요?

‘응용 프로그램’에서 다시 실행한 직후 ‘시스템 설정’ → ‘개인정보 보호 및 보안’ 아래의 보안 영역을 확인하세요. 개발자 확인 안내인지, 악성 소프트웨어 차단 또는 조직 정책인지 구분해야 합니다. 허용 메뉴가 계속 나타나지 않으면 macOS 버전과 전체 안내 문구를 기록하세요. 시스템 전체 보안 확인을 끄는 방식으로 해결하지 마세요.

앱 실행을 허용했는데도 로그에 권한 부족이 표시되는 이유는 무엇인가요?

Gatekeeper는 앱을 신뢰하고 실행할 수 있는지 확인할 뿐입니다. 오류가 코어 실행, 설정 디렉터리 쓰기, TUN 권한 상승 중 어디에 해당하는지 확인하세요. 앱이 ‘응용 프로그램’으로 완전히 이동되었고 현재 계정이 클라이언트에서 실제 사용하는 설정 디렉터리에 쓸 수 있는지도 점검합니다. 디렉터리 권한 문제를 감추려고 데스크톱 앱 전체를 관리자 권한으로 실행하지 마세요.

Wi-Fi를 바꾼 뒤 프록시가 작동하지 않는데 권한을 다시 승인해야 하나요?

먼저 현재 네트워크 서비스의 ‘세부사항’ → ‘프록시’를 확인하세요. Wi-Fi에서 유선 네트워크로 바꾸면 다른 서비스로 전환될 수 있으며, 서비스마다 프록시 설정이 다를 수 있습니다. v2rayN에서 시스템 프록시 자동 구성을 다시 실행한 다음 주소와 포트를 확인하세요. 네트워크 서비스의 차이를 Gatekeeper가 다시 차단한 것으로 오해하지 마세요.

클라이언트를 종료한 뒤 브라우저 전체가 인터넷에 연결되지 않으면 어떻게 하나요?

v2rayN을 실행하고 ‘시스템 프록시’에서 ‘시스템 프록시 해제’를 선택한 다음 종료하세요. 앱을 실행할 수 없다면 현재 네트워크 서비스의 ‘프록시’ 화면에서 로컬의 이전 포트를 가리키는 웹 프록시를 끄거나 이전 PAC를 비활성화하세요. 해당 클라이언트의 설정만 정리하고, 회사 네트워크에서 요구하는 프록시는 먼저 관리자에게 문의하세요.

설치 마무리: 네트워크 설정을 되돌릴 수 있게 유지

설정이 끝나면 ‘클라이언트 실행 → 시스템 프록시 켜기 → 정상 접속 확인 → 시스템 프록시 해제 → 클라이언트 종료’의 전체 과정을 한 번 이상 테스트하세요. 실제 리스너와 올바른 설정으로 연결되는지 확인할 수 있어 브라우저 캐시나 다른 프록시의 잔여 설정에 속지 않습니다. 앱 업데이트, 노드 변경, TUN 활성화는 한 번에 한 종류씩 적용하세요. 문제가 생겨도 원인을 찾기 쉽습니다.

나중에 비교할 수 있도록 실제 로컬 리스너 포트와 현재 네트워크 서비스 이름을 기록해 두세요. 구독 주소가 보이는 문제 해결 스크린샷을 공개하지 마세요.
로그를 공유하기 전에 서버 주소, 사용자 식별 정보, 구독 토큰 등 민감한 정보를 가리고 오류 유형과 필요한 맥락만 남기세요.
앱을 제거하기 전에 TUN이 활성화되어 있다면 끄고 시스템 프록시를 해제하세요. 앱을 삭제해도 네트워크 설정까지 자동으로 복원되는 것은 아닙니다.
구독 가져오기와 DNS 설정을 더 알아보려면 입문 가이드를 따라 항목별로 설정하세요. 코어, 라우팅, DNS 확인 정책을 한꺼번에 변경하지 마세요.