2026-09-11 · 플랫폼 배포 · 약 9분

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

macOS에서 v2rayN을 처음 열 때 표시되는 ‘개발자를 확인할 수 없음’ 경고와 시스템 프록시 권한, TUN 모드 권한 및 로그인 항목 설정 방법을 시스템 설정 경로에 따라 안내합니다.

이 글 미리보기

‘아키텍처 확인 → 앱 출처 확인 → 첫 실행 문제 해결 → 시스템 프록시 확인 → 필요하면 TUN 활성화 → 로그인 항목 설정’ 순서로 진행하세요. 구독 정보를 확보했지만 macOS 설치나 권한 설정에서 막힌 경우에 적합합니다. 먼저 일반 프록시 연결을 확인한 뒤 TUN과 자동 실행을 추가하면 설정을 한꺼번에 바꿔 문제 원인을 찾기 어려워지는 일을 줄일 수 있습니다.

프로세서 아키텍처와 앱 위치 확인

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple 칩이 표시되면 ARM64 패키지를, Intel 프로세서가 표시되면 x64 패키지를 선택합니다. v2rayN의 macOS 패키지는 Windows 패키지와 함께 사용할 수 없습니다. 앱 화면이 실행되더라도 포함된 코어의 아키텍처가 올바르다는 뜻은 아닙니다. 최소 시스템 버전은 선택한 릴리스 패키지의 안내를 확인하세요.

  1. 아키텍처 확인

    Apple 메뉴 → ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’를 확인하세요. ‘터미널’에서 uname -m을 실행해 확인할 수도 있습니다. 기본 환경에서는 보통 arm64 또는 x86_64가 표시됩니다. Rosetta로 실행 중인 터미널에서는 결과가 달라질 수 있으므로 시스템 정보를 우선 확인하세요.

  2. 설치 패키지 선택

    이 사이트의 다운로드 페이지에서 macOS용 v2rayN 패키지를 선택하세요. 원본 다운로드 파일을 보관하고 압축 파일은 전체 내용을 풀어 사용합니다. 디스크 이미지라면 열어서 앱을 ‘응용 프로그램’으로 복사하세요.

  3. 앱 위치 고정

    처음 실행하기 전에 앱을 변경되지 않을 위치에 두세요. 마운트된 디스크 이미지에서 계속 실행하거나 앱 패키지 내부의 실행 파일만 따로 꺼내 사용하지 마세요.

  4. 한 번 실행해 보기

    Finder의 ‘응용 프로그램’에서 v2rayN을 실행하고 경고창의 문구를 정확히 확인하세요. 개발자 확인 경고, 앱 손상 경고, 코어 실행 오류를 구분한 뒤 다음 단계로 진행합니다.

이 글에서는 ‘시스템 설정’의 메뉴명을 사용합니다. 이전 macOS에서는 ‘시스템 환경설정’으로 표시될 수 있습니다. v2rayN 버전에 따라 설정 메뉴 구성이 달라질 수도 있습니다. 포트와 TUN 설정은 현재 설치한 버전에 표시되는 항목을 기준으로 확인하고 다른 플랫폼의 메뉴 경로를 그대로 따라 하지 마세요.

‘개발자를 확인할 수 없음’ 경고와 첫 실행 차단 해결

Gatekeeper는 앱 배포 출처의 신뢰 여부를 확인합니다. ‘개발자를 확인할 수 없음’ 경고는 서버 연결 실패를 뜻하지 않으며 구독 정보를 수정해도 해결되지 않습니다. 다운로드 출처와 파일이 일치하는지 확인한 경우에만 해당 앱을 개별적으로 허용하세요.

  1. 경고 내용 확인

    처음 실행이 차단되면 먼저 경고창을 닫으세요. 해당 창이 방금 다운로드한 v2rayN을 가리키는지 확인합니다. 이름만 같은 이전 버전이나 출처를 알 수 없는 보조 프로그램은 허용하지 마세요.

  2. 보안 설정 열기

    Apple 메뉴 → ‘시스템 설정’ → ‘개인정보 보호 및 보안’을 열고 아래쪽의 ‘보안’ 항목을 찾으세요. 방금 차단된 앱에 관한 안내가 여기에 표시되는 경우가 많습니다.

  3. 앱만 허용

    시스템에서 허용하고 앱 출처도 확인했다면 해당 앱 옆의 ‘그래도 열기’를 클릭하세요. 시스템 안내에 따라 관리자 인증을 마친 뒤 다시 열기를 확인합니다. 버튼 이름은 macOS 버전에 따라 조금 다를 수 있습니다.

  4. 다시 실행

    ‘응용 프로그램’으로 돌아가 같은 앱을 실행하세요. 허용 버튼이 보이지 않으면 앱을 다시 열어 차단을 한 번 더 유발한 뒤 확인합니다. 관리되는 기기라면 조직의 보안 정책에서 예외 허용을 막고 있는지도 확인하세요.

클라이언트 하나를 설치하려고 Mac 전체에서 Gatekeeper를 끄거나 ‘다운로드’ 폴더 전체의 격리 속성을 일괄 삭제하지 마세요. 허용을 반복해도 실행되지 않으면 앱을 종료하고 문제가 있는 사본을 삭제한 뒤, 아키텍처에 맞는 전체 릴리스 패키지를 다시 다운로드하세요. 출처를 알 수 없는 터미널 명령을 추가로 실행하는 것보다 문제를 찾기 쉽습니다.

먼저 시스템 프록시를 확인하고 TUN은 필요할 때 활성화

v2rayN 인터페이스, 프록시 코어, 시스템 네트워크 설정은 서로 다른 계층입니다. 인터페이스가 열리는 것은 앱을 실행할 수 있다는 뜻일 뿐입니다. 코어가 로컬 포트에서 정상적으로 대기해야 앱에서 사용할 프록시가 준비되고, 시스템 프록시가 올바르게 설정되어야 해당 설정을 따르는 프로그램이 그 프록시를 사용합니다.

앱에 맞는 연결 방식 선택

먼저 시스템 프록시 사용
  • 브라우저와 시스템 프록시를 따르는 앱에 적합합니다.
  • 서버, 코어, 로컬 포트가 모두 정상인지 먼저 확인하세요.
  • 일반적인 웹 이용에는 TUN을 함께 켤 필요가 없습니다.
필요할 때 TUN 사용
  • 시스템 프록시를 따르지 않는 앱의 트래픽에 적합합니다.
  • 가상 인터페이스, 라우팅, DNS를 확인해야 합니다.
  • 추가 권한을 처리한 다음 트래픽이 전달되는지 확인하세요.

시스템 프록시는 애플리케이션 계층의 연결 방식이고, TUN은 네트워크 계층에서 트래픽을 전달하는 방식입니다. 어느 쪽도 올바른 서버 설정과 라우팅 규칙을 대신하지 못합니다.

구독을 가져오고 서버를 선택한 뒤, TUN은 끈 상태로 두고 v2rayN의 ‘시스템 프록시’ 메뉴에서 ‘시스템 프록시 자동 설정’을 선택하세요. ‘자동 설정’이 반드시 PAC를 사용한다는 뜻은 아닙니다. 실제 적용 결과는 시스템에 설정된 HTTP, HTTPS 또는 SOCKS 프록시 항목으로 확인하세요.

포트와 명령으로 권한 문제 구분

아래에서는 로컬 HTTP 프록시 포트로 10808을 예시로 사용합니다. 모든 버전의 기본 포트라는 뜻은 아닙니다. 먼저 v2rayN의 ‘설정’ → ‘매개변수 설정’에서 로컬 대기 포트와 프로토콜을 확인하세요. 현재 버전에서 메뉴 경로가 다르면 해당 버전의 로컬 인바운드 설정을 확인합니다.

10808
HTTP 프록시 포트 예시
15초
연결 시간 초과 예시
30초
요청 전체 시간 제한 예시
scutil --proxy
lsof -nP -iTCP:10808 -sTCP:LISTEN
curl -I --connect-timeout 15 --max-time 30 --proxy http://127.0.0.1:10808 https://example.com/

scutil --proxy로 현재 프록시 설정을 확인하고, lsof로 로컬 TCP 대기 상태를 확인할 수 있습니다. 대기 중인 포트가 보이지 않으면 코어 로그에서 시작 실패, 아키텍처 비호환 또는 주소 충돌 여부를 먼저 확인하세요. 시스템 프록시 권한을 계속 다시 시도할 필요는 없습니다. 포트가 대기 중이어도 HTTP 요청을 받는다는 보장은 없으므로 인바운드 프로토콜도 함께 확인해야 합니다.

프록시를 지정한 요청 성공

명령 결과
대상 사이트의 HTTP 응답 헤더 수신
브라우저에서 오류 발생
시스템 프록시와 브라우저 자체 설정을 먼저 확인하세요.
시스템 설정 확인
scutil --proxy에서 주소와 포트를 확인하세요.

응답을 받았다는 것은 이번 요청에 연결할 수 있었다는 뜻일 뿐, 모든 도메인이나 라우팅이 정상이라는 뜻은 아닙니다.

프록시를 지정한 요청 실패

연결 거부
포트, 대기 상태, 인바운드 프로토콜 확인
핸드셰이크 시간 초과
서버 주소, 네트워크, 아웃바운드 로그 확인
인증서 오류
시간, 서버 도메인, TLS 설정 확인

프록시를 명시한 curl 요청은 시스템 프록시 설정에 의존하지 않으므로 애플리케이션 계층의 설정 문제를 분리해 확인하는 데 유용합니다.

로컬 포트가 SOCKS만 제공한다면 테스트할 때 --proxy socks5h://127.0.0.1:10808을 사용하고 실제 SOCKS 포트로 바꾸세요. 여기서 socks5h는 대상 도메인 이름을 프록시 서버에서 확인한다는 뜻입니다. Mac에서 직접 조회한 결과와 혼동하지 마세요.

필요한 경우 TUN 및 네트워크 접근 권한 부여

일반 프록시 테스트가 성공한 뒤 클라이언트에서 ‘TUN 활성화’를 시도하세요. 가상 네트워크 인터페이스를 만들거나 라우팅을 변경하거나 관련 보조 서비스를 활성화하려면 관리자 권한이 필요할 수 있습니다. 구체적인 동작은 v2rayN 버전과 사용 중인 TUN 구성 요소에 따라 다르므로 매번 같은 시스템 경고가 표시된다고 가정하지 마세요.

로그인 항목을 설정하고 종료 후 복구 여부 확인

로그인 시 자동 실행, 백그라운드 실행, TUN 권한은 각각 별개의 설정입니다. v2rayN을 로그인 항목에 추가해도 사용자가 로그인한 뒤 앱을 실행하도록 시도할 뿐, 서버 선택이나 시스템 프록시 설정, TUN 연결까지 자동으로 된다는 뜻은 아닙니다. 이런 동작은 클라이언트의 시작 옵션과 시스템 권한에 따라서도 달라집니다.

  1. 로그인 항목 추가

    ‘시스템 설정’ → ‘일반’ → ‘로그인 항목’을 여세요. 일부 버전에서는 ‘로그인 항목 및 확장 프로그램’으로 표시됩니다. ‘로그인 시 열기’에 ‘응용 프로그램’ 폴더의 v2rayN을 추가하세요.

  2. 중복 실행 방지

    클라이언트에 자동 실행 옵션이 이미 있다면 먼저 시스템 목록에 등록되어 있는지 확인하세요. 명확한 시작 방법 하나만 사용하고 이전 경로와 새 경로가 함께 남지 않도록 합니다.

  3. 백그라운드 항목 확인

    현재 버전에 관련 보조 항목이 실제로 설치된 경우에만 ‘백그라운드에서 허용’ 목록에서 이름과 출처를 확인하세요. 해당 항목이 없다고 앱 설치가 잘못된 것은 아닙니다.

  4. 종료 테스트

    창만 닫지 말고 메뉴에서 앱을 종료하세요. 시스템 프록시가 원래 설정으로 복원되었는지 확인합니다. 웹 페이지 연결이 끊기면 ‘네트워크’ → 현재 네트워크 서비스 → ‘세부사항’ → ‘프록시’로 돌아가 남아 있는 로컬 프록시 설정을 삭제하세요.

마지막으로 로그아웃한 뒤 다시 로그인해 앱이 지정한 위치에서 실행되는지, 코어가 포트에서 대기하는지, 시스템 프록시나 TUN이 예상대로 작동하는지 확인하세요. 잠자기 후 깨어난 뒤 연결이 끊기면 대기 상태, 프록시 설정, DNS 순서로 다시 확인합니다. 컴퓨터 재시동만을 유일한 해결책으로 삼지 마세요.

자주 표시되는 경고와 대응 범위

‘그래도 열기’ 버튼이 보이지 않으면 어떻게 하나요?

먼저 ‘응용 프로그램’에서 앱을 다시 열어 차단을 유발한 뒤 ‘개인정보 보호 및 보안’에서 해당 기록을 확인하세요. 회사나 기관에서 관리하는 Mac이라면 기기 정책이 예외 허용을 차단하는지 확인합니다. 악성 소프트웨어 경고가 표시되면 일반적인 개발자 확인 절차로 계속 진행하지 마세요.

앱은 열리는데 코어 오류가 계속 표시되는 이유는 무엇인가요?

다운로드한 패키지의 아키텍처와 전체 파일을 먼저 확인한 뒤, 로그에서 코어 이름과 실행 경로, 첫 번째 오류를 확인하세요. 메인 앱을 허용해도 별도의 코어 실행 파일까지 허용되는 것은 아닙니다. 하위 프로그램이 다시 차단되면 같은 릴리스 패키지에 포함된 프로그램인지 확인하고, 출처를 모르는 프로그램은 무턱대고 허용하지 마세요.

브라우저에서는 접속되는데 터미널 명령은 연결에 실패하나요?

많은 명령줄 도구는 macOS 시스템 프록시 설정을 자동으로 사용하지 않습니다. 먼저 이 글의 curl 프록시 지정 명령으로 테스트한 다음 도구 설명서에 따라 프록시 환경 변수를 설정하세요. 터미널 요청이 실패했다는 이유만으로 시스템 네트워크 권한을 반복해서 요청하지 마세요.

업데이트 후 다시 확인 경고가 표시되는데 이전 로그인 항목을 계속 사용할 수 있나요?

새 버전에서는 보안 확인이 다시 실행될 수 있습니다. 출처를 재확인하고 앱별 허용 절차를 따르세요. 앱 폴더나 이름을 변경했다면 ‘로그인 항목’에서 이전 경로를 삭제하고 새 위치를 추가한 뒤 포트와 시작 옵션을 다시 확인합니다. 앱 사본 두 개를 동시에 실행하지 마세요.

문제 해결 기록에는 macOS 버전, v2rayN 버전, 프로세서 아키텍처, 오류 발생 시각, 민감 정보를 가린 오류 로그만 남기면 됩니다. 로그를 공유하기 전에 구독 주소, 서버 인증 정보, 네트워크를 식별할 수 있는 정보를 삭제하세요. 구독 가져오기나 라우팅 개념은 이 사이트의 빠른 시작 및 고급 가이드에서 확인할 수 있습니다.

v2rayN 다운로드플랫폼에 맞는 클라이언트 선택