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

이 글의 핵심 내용

처음 설치할 때는 프로세서 아키텍처에 맞는 파일을 고른 뒤 Gatekeeper 차단을 해결하세요. 메인 창이 열리면 먼저 로컬 프록시로 노드를 확인하고, 시스템 프록시를 설정한 다음 필요한 경우 TUN을 활성화하면 됩니다. 앱 실행 허용, 시스템 프록시 변경 권한, 네트워크 확장 승인을 각각 설명합니다. 설치가 차단되거나 브라우저가 프록시를 사용하지 않거나 TUN이 시작되지 않는 Mac 사용자에게 적합합니다.

설치 파일 선택: Apple Silicon은 arm64, Intel은 x64

v2rayN은 노드, 구독, 라우팅 설정을 관리하는 데스크톱 클라이언트이며, 실제 연결 처리는 클라이언트가 실행하는 프록시 코어가 담당합니다. 설치 파일의 아키텍처는 메인 창이 열리는지뿐 아니라 함께 제공되는 코어가 작동하는지에도 영향을 줍니다. 따라서 화면이 나타났다고 해서 실행 환경 전체가 정상이라고 볼 수는 없습니다.

‘이 Mac에 관하여’에서 프로세서 정보를 확인해 설치 파일을 선택하세요

Apple Silicon Mac

Apple 메뉴 → ‘이 Mac에 관하여’를 열고 ‘칩’ 항목을 확인합니다.
Apple M 시리즈 Mac에는 macOS arm64 패키지를 우선 선택하세요.
Rosetta를 지원한다는 이유만으로 x64 패키지를 우선 사용하지 마세요. 코어와 보조 구성 요소도 아키텍처 호환성이 필요합니다.

Intel Mac

‘이 Mac에 관하여’에 Intel 프로세서 정보가 표시됩니다.
macOS x64 패키지를 선택하세요. x86_64도 같은 계열의 아키텍처 표기입니다.
arm64 패키지는 Intel Mac용 설치 파일을 대체할 수 없습니다.

아키텍처와 최소 시스템 버전은 별개의 조건입니다. 맞는 패키지를 선택한 뒤에도 현재 릴리스에서 요구하는 macOS 버전을 확인하세요.

다운로드 센터에서 macOS 항목으로 이동합니다. 디스크 이미지 파일을 받았다면 앱을 ‘응용 프로그램’으로 드래그하세요. 압축 파일을 받았다면 먼저 전체 압축을 푼 다음 릴리스 안내에 따라 앱을 배치합니다. 압축 파일 미리보기에서 바로 실행하거나 같은 폴더의 의존성 파일을 빠뜨린 채 앱만 복사하지 마세요. 업데이트 전에는 기존 프로세스를 종료하고 구독, 라우팅 및 필요한 설정을 백업해 두세요.

개발자를 확인할 수 없음: 출처를 확인한 앱만 실행 허용

‘개발자를 확인할 수 없음’ 또는 ‘Apple에서 악성 소프트웨어가 포함되어 있는지 확인할 수 없습니다’라는 메시지는 보통 Gatekeeper의 실행 확인 절차에 해당하며, 노드 오류가 아닙니다. 이런 문제를 해결하려고 구독을 반복해서 가져올 필요는 없으며 Mac의 보안 검사를 통째로 끌 필요도 없습니다. 먼저 다운로드 출처와 파일의 압축 해제 여부를 확인하고, 시스템 경고에 표시된 앱 이름을 살펴보세요.

앱 위치 확인

Finder에서 ‘응용 프로그램’을 열고 방금 설치한 v2rayN을 실행하는지 확인하세요. 다운로드 폴더의 오래된 복사본이나 디스크 이미지에 그대로 탑재된 복사본을 열지 않도록 주의합니다.
실행 확인 절차 시작

앱을 이중 클릭하고 차단 메시지를 확인한 뒤 닫습니다. 개발자 확인 실패, 아키텍처 비호환, 파일 손상 중 어떤 문제인지 구분할 수 있도록 메시지의 정확한 문구를 기록해 두세요.
보안 설정 열기

Apple 메뉴 → ‘시스템 설정’ → ‘개인정보 보호 및 보안’을 열고 아래로 스크롤해 ‘보안’ 섹션에서 방금 차단된 앱과 ‘그래도 열기’ 버튼이 있는지 확인합니다.
이번 앱만 실행 허용

앱 이름을 확인한 다음 ‘그래도 열기’를 클릭하고, 시스템 안내에 따라 관리자 인증을 완료한 뒤 확인 창에서 열기를 선택합니다. 앱으로 돌아가 메인 창과 로그를 확인하세요.

macOS 15 및 이후 버전에서는 서명되지 않았거나 공증되지 않은 소프트웨어의 실행 절차가 더 엄격해졌습니다. Finder에서 마우스 오른쪽 버튼을 클릭해 ‘열기’를 선택하는 것만으로 허용될 거라고 가정하지 마세요. 여기서는 ‘개인정보 보호 및 보안’의 검토 항목을 기준으로 안내합니다. 이전 macOS에서는 메뉴 이름이 다를 수 있습니다. 조직에서 관리하는 Mac은 이 작업이 비활성화되어 있을 수 있으므로 관리 정책을 우회하지 말고 기기 관리자에게 문의하세요.

먼저 로컬 포트를 확인하고 브라우저에서 시스템 프록시 사용

v2rayN이 정상적으로 열리면 신뢰할 수 있는 구독을 가져오고 서버 목록을 업데이트한 뒤 노드를 선택하세요. 로그에서 코어가 시작되었는지도 확인합니다. 메인 창의 ‘설정’ → ‘매개변수 설정’에서 로컬 수신 설정을 확인하세요. 항목 이름은 버전에 따라 다를 수 있습니다. 수신 주소와 포트를 확인해야 시스템 프록시 문제를 구체적으로 점검할 수 있습니다.

10808

아래 명령에 사용하는 HTTP 프록시 포트 예시

10809

포트 충돌 시 대안으로 고려할 수 있는 포트 예시

이 숫자는 문제 해결을 위한 예시일 뿐, 모든 릴리스의 기본값을 뜻하지 않습니다. 명령을 실행하기 전에 매개변수 설정에서 실제로 활성화한 HTTP 또는 혼합 수신 포트로 바꾸세요. SOCKS 수신만 활성화되어 있다면 아래의 HTTP 프록시 명령을 그대로 사용할 수 없습니다. 로컬에서 사용할 때는 수신 주소를 가급적 127.0.0.1로 유지하세요. 권한 문제를 해결하려고 모든 네트워크 인터페이스에 함부로 개방하지 마세요.

# 예시 포트에서 TCP 연결을 수신 중인지 확인
lsof -nP -iTCP:10808 -sTCP:LISTEN

# macOS 시스템 프록시 설정에 의존하지 않고 HTTP 프록시를 명시적으로 지정
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com

example.com은 연결 테스트용 대상일 뿐이며, 이 결과만으로 모든 웹사이트나 라우팅 규칙이 정상이라고 판단할 수는 없습니다. 연결이 거부되면 먼저 로컬 수신 상태를 확인하세요. 프록시 핸드셰이크 오류가 발생하면 포트 유형을 확인하고, 로컬 프록시에는 연결되지만 시간 초과가 발생하면 코어 로그, 노드 매개변수, 실제 아웃바운드 연결을 살펴보세요. 브라우저가 계속 로딩된다는 이유만으로 시스템 권한 문제라고 단정하지 마세요.

프록시를 명시한 명령은 성공하지만 브라우저는 실패하는 경우: 시스템 프록시가 현재 네트워크 서비스에 적용되어 있는지, 브라우저가 별도 프록시 설정을 사용하는지 먼저 확인하세요.
프록시를 명시한 명령도 실패하는 경우: TUN을 추가로 활성화하지 말고 먼저 코어, 노드, 라우팅을 확인하세요.
다른 프로세스가 포트를 사용 중인 경우: 먼저 해당 프로세스를 확인하고 충돌 프로그램을 종료할지 수신 포트를 변경할지 결정하세요. 설정을 변경했다면 시스템 프록시도 함께 업데이트해야 합니다.

시스템 프록시와 TUN: 사용 목적에 맞춰 트래픽 처리 방식 선택

시스템 프록시는 가상 네트워크 인터페이스가 아니며, 해당 설정을 따르는 앱에만 영향을 줍니다. TUN은 가상 네트워크 인터페이스와 라우팅을 통해 트래픽을 처리하며, 보통 더 높은 권한이 필요하고 다른 네트워크 도구와 충돌할 가능성도 큽니다. 처음 설정한다면 확인하기 쉬운 시스템 프록시부터 연결한 뒤 TUN이 필요한지 판단하세요.

시스템 프록시부터 시작

권장

v2rayN 메인 창의 ‘시스템 프록시’ 메뉴에서 시스템 프록시 설정을 선택하세요. 일부 버전에서는 메뉴 막대 아이콘에서도 설정할 수 있습니다. 네트워크 설정을 처음 변경할 때 관리자 인증을 요구할 수 있으며, 인증 후에도 시스템에 실제로 적용된 프록시 주소와 포트를 확인해야 합니다.

적합한 경우: 브라우저 사용, 첫 설치 확인, 문제 원인을 좁혀 가고 싶은 데스크톱 환경

필요한 경우 TUN 활성화

노드가 정상임을 확인한 뒤 클라이언트에서 제공하는 TUN 스위치를 사용하고, 현재 버전 안내에 따라 권한 상승 또는 보조 서비스 설정을 완료하세요. TUN이 트래픽을 처리하더라도 라우팅 규칙은 계속 적용되므로 모든 연결이 프록시 아웃바운드를 사용하는 것은 아닙니다.

적합한 경우: 시스템 프록시를 따르지 않는 앱이 있거나 가상 네트워크 인터페이스로 더 많은 트래픽을 처리해야 하는 환경

시스템 프록시 확인 경로는 ‘시스템 설정’ → ‘네트워크’ → 현재 사용 중인 Wi-Fi 또는 이더넷 → ‘세부사항’ → ‘프록시’입니다. 웹 프록시, 보안 웹 프록시, SOCKS 프록시가 각각 활성화되어 있는지, 주소와 포트가 클라이언트 설정과 일치하는지 확인하세요. 직접 수정하기 전에는 기존 값을 기록해 두세요. 특히 회사나 기관 네트워크에 필요한 자동 프록시 설정을 실수로 삭제하지 않도록 주의합니다.

# 현재 시스템 프록시 상태 확인
scutil --proxy

# 네트워크 서비스 이름을 확인하고 실제 이름으로 이후 조회
networksetup -listallnetworkservices

# 아래는 Wi-Fi라는 이름의 서비스를 예로 사용
networksetup -getwebproxy "Wi-Fi"
networksetup -getsecurewebproxy "Wi-Fi"
networksetup -getsocksfirewallproxy "Wi-Fi"

이 조회 명령은 설정을 변경하지 않습니다. Wi-Fi 전환, 도킹 스테이션의 이더넷 연결 또는 네트워크 위치 변경 후에는 현재 사용 중인 네트워크 서비스가 달라질 수 있으므로 프록시 상태를 다시 확인하세요. 터미널 명령줄 도구가 macOS 시스템 프록시를 자동으로 읽는다고 보장할 수도 없습니다. 따라서 앞서 프록시를 명시하는 명령으로 확인해 도구의 동작을 클라이언트 오류로 오해하지 않도록 했습니다.

네트워크 권한: 확장 승인과 TUN 권한 상승은 별개

‘네트워크 허용’이라는 설정 하나로 모든 문제가 해결되는 것은 아닙니다. 시스템 프록시 변경, TUN 인터페이스 생성, 로컬 네트워크 접근, 수신 연결 허용, 네트워크 확장 로드는 각각 별도의 방식으로 관리됩니다. v2rayN의 구현은 릴리스와 코어 조합에 따라 달라지므로 TUN이라는 문구만 보고 네트워크 확장을 반드시 설치해야 한다고 판단하지 마세요.

메시지 또는 증상	확인 경로	확인할 사항
프록시를 변경할 때 인증 요청	클라이언트에서 작업한 뒤 표시되는 시스템 인증 창	현재 앱에서 요청한 것인지 확인하세요. 인증 후 프록시 설정이 실제로 적용되었는지 살펴봅니다.
TUN 생성 실패 또는 권한 부족	v2rayN 로그 및 현재 버전의 보조 서비스 설정	permission denied, operation not permitted 등의 메시지를 확인하고 릴리스 안내에 따라 권한을 설정하세요.
네트워크 확장 승인 요청이 실제로 표시됨	macOS 15의 ‘시스템 설정’ → ‘일반’ → ‘로그인 항목 및 확장 프로그램’ → ‘네트워크 확장’	방금 설치한 구성 요소에 해당하는 항목만 검토하세요. 다른 macOS 버전에서는 ‘개인정보 보호 및 보안’에 승인 항목이 표시될 수 있습니다.
로컬 네트워크 기기에 접근할 수 없음	해당 옵션을 제공하는 macOS의 ‘개인정보 보호 및 보안’ → ‘로컬 네트워크’	이 권한은 로컬 네트워크 접근을 위한 것입니다. 인터넷 프록시 사용 권한이나 TUN 권한 상승을 대신하지 않습니다.
수신 연결을 허용할지 묻는 메시지	‘시스템 설정’ → ‘네트워크’ → ‘방화벽’ → ‘옵션’	수신 연결 허용은 일반적인 아웃바운드 프록시와 다릅니다. 이 Mac에서만 사용할 경우 이 설정을 이유로 수신 범위를 넓히지 마세요.

TUN을 활성화하기 전에는 기본 라우트, DNS 또는 가상 네트워크 인터페이스를 변경하는 다른 네트워크 도구를 잠시 종료하고 한 번에 하나의 트래픽 처리 경로만 사용하세요. 시스템 인증을 마친 뒤에도 실패한다면 비밀번호를 반복해서 입력하지 말고 최초 시작 시점의 전체 오류 내용을 저장하세요. 기기가 조직 정책으로 제한되어 있다면 관리자 승인 없이 앱 설정만으로 정책을 대신할 수 없습니다.

종료 및 업그레이드: 남은 프록시 설정과 구성 이전 확인

앱을 종료한 뒤 인터넷이 끊기는 문제는 시스템 프록시가 이미 중지된 로컬 포트를 계속 가리키는 경우가 많습니다. 정상 종료 전 클라이언트에서 시스템 프록시를 해제하고 TUN을 끈 다음 앱을 종료하세요. 앱이 비정상 종료되었다면 시스템 설정에서 현재 네트워크 서비스의 프록시 항목을 확인하고 활성화 전 기록해 둔 값으로 복구합니다. 자동 프록시를 사용하는 네트워크에서는 자동 프록시 설정이 변경되었는지도 확인하세요.

메인 창이 열리지 않음: 시스템 차단 메시지의 원문을 기록하고 아키텍처, 최소 시스템 버전, Gatekeeper 허용 상태를 다시 확인하세요.
메인 창은 정상인데 코어가 종료됨: 코어 아키텍처, 실행 권한, 구성 오류, 포트 충돌을 확인하세요. 로그를 먼저 보관한 뒤 설치 파일을 다시 풀지 결정합니다.
프록시 명령은 성공하지만 앱은 실패함: 앱이 시스템 프록시를 따르는지, 자체 프록시 설정이 있는지 확인한 뒤 TUN으로 전환할지 결정하세요.
TUN 사용 후 도메인 연결 실패: DNS 및 라우팅 로그를 함께 살펴보고 도메인 조회 경로를 확인하세요. 모든 조회 실패를 권한 부족 탓으로 돌리지 마세요.
업그레이드 후 동작이 달라짐: 업그레이드 전후의 수신 포트, 선택한 코어, 라우팅 설정을 비교하세요. 확인 없이 기존 파일로 새 구성 전체를 덮어쓰지 마세요.

문제 해결 기록에는 macOS 버전, 프로세서 아키텍처, v2rayN 버전, 선택한 코어, 현재 프록시 모드, 오류 발생 시각을 포함하세요. 로그를 제출하기 전 구독 주소, 노드 비밀번호, 사용자 식별 정보 및 기타 민감한 매개변수를 삭제해야 합니다. 이렇게 하면 설치 차단, 코어 시작 실패, 라우팅 문제를 구분해 처리할 수 있으며 설정을 여러 개 한꺼번에 바꿔 비교 기준을 잃는 일을 방지합니다.