v2rayN을 처음 설치하거나 업데이트 후 실행이 차단되거나 프록시가 작동하지 않는 macOS 사용자를 위한 안내입니다. 먼저 앱 출처와 프로세서 아키텍처를 확인한 뒤, 시스템 안내에 따라 해당 앱만 실행 허용합니다. 앱을 연 다음에는 시스템 프록시, 로컬 네트워크, TUN을 각각 따로 확인하세요. 세 가지 권한을 한꺼번에 점검하지 않는 것이 좋습니다.
Gatekeeper 경고와 설치 파일 아키텍처 확인
코드 서명은 서명자의 신원과 서명 이후 코드가 변경되지 않았는지 확인하는 데 사용됩니다. 공증은 Apple이 제출된 소프트웨어를 자동으로 보안 검사하는 절차입니다. Gatekeeper는 시스템 정책에 따라 다운로드한 앱을 평가합니다. ‘개발자를 확인할 수 없음’ 또는 ‘악성 소프트웨어가 있는지 확인할 수 없음’이라는 경고만으로 설치 파일의 안전 여부를 판단해서는 안 됩니다. 실행되지 않는 모든 문제를 공증 여부 탓으로 돌릴 수도 없습니다.
- 아키텍처: Apple 메뉴 → ‘이 Mac에 관하여’를 엽니다. Apple 칩이라고 표시되면 ARM64, Intel 프로세서라고 표시되면 x64를 선택하세요. 아키텍처 불일치와 서명 검증은 별개의 문제입니다. 보안 설정을 바꿔도 아키텍처가 맞지 않는 프로그램을 네이티브 앱으로 실행할 수는 없습니다.
- 출처: 다운로드 경로, 릴리스 버전, 파일명을 확인하세요. 출처를 알 수 없는 미러 사이트, 메신저 첨부 파일, 재패키징된 파일은 이름과 아이콘이 같다는 이유만으로 실행하지 마세요.
- 경고 유형: 시스템에서 악성 소프트웨어라고 명시하거나 앱이 손상되었다고 알리면 실행을 중단하고 출처를 다시 확인한 뒤 설치 파일을 새로 받으세요. 조직에서 관리하는 Mac의 앱 실행이 제한된 경우 관리자에게 조직 정책을 확인해 달라고 요청하세요.
‘개인정보 보호 및 보안’에서 특정 앱 허용하기
아래 경로는 ‘시스템 설정’을 사용하는 macOS 버전에 해당합니다. 출처가 신뢰할 수 있고 시스템에서 특정 앱만 예외로 허용하는 경우에만 진행하세요. Gatekeeper를 끄거나 시스템 전체의 보안 정책을 변경할 필요는 없습니다.
응용 프로그램 폴더로 이동
설치 파일이 디스크 이미지라면 열고 창의 안내에 따라 v2rayN을 ‘응용 프로그램’으로 드래그하세요. 압축 파일이라면 먼저 압축을 푼 다음 앱을 옮기면 됩니다. 이후 Finder의 ‘응용 프로그램’에서 실행해 다운로드 폴더에 있는 오래된 복사본을 잘못 여는 일을 방지하세요.
실행 검사 시작
방금 설치한 v2rayN을 두 번 클릭합니다. 확인할 수 없다는 경고가 나타나면 먼저 닫고 앱 이름을 확인하세요. 경고 없이 앱이 열리면 이 절의 나머지 단계는 건너뛰어도 됩니다.
보안 경고 찾기
Apple 메뉴 → ‘시스템 설정’ → ‘개인정보 보호 및 보안’을 열고 아래로 내려 ‘보안’ 항목을 찾습니다. 최근 차단된 앱이 v2rayN인지 확인한 다음 ‘그래도 열기’를 클릭하세요. 이 옵션은 보통 앱 실행을 시도한 뒤 약 1시간 동안 표시됩니다.
열기 확인
시스템 대화상자의 안내에 따라 본인 인증을 하고 실행을 확인합니다. 이 예외는 선택한 앱에만 적용되며 네트워크 권한을 부여하는 것은 아닙니다. 앱을 업데이트하거나 교체한 뒤 경고가 다시 나타나면 새 설치 파일의 출처와 버전을 다시 확인하세요.
시스템 프록시와 TUN을 따로 확인
앱이 열렸다는 사실은 앱이 실행되었다는 뜻일 뿐, 코어가 정상적으로 연결을 기다리고 있거나 브라우저 트래픽이 프록시를 통과한다는 뜻은 아닙니다. 처음 테스트할 때는 연결 방식 하나만 사용하세요. 두 방식을 동시에 켜면 브라우저가 다시 연결되어도 어느 설정이 작동했는지 알 수 없습니다.
두 연결 방식별 확인 절차
시스템 프록시: 먼저 브라우저 테스트
- TUN을 끄고 노드를 선택한 뒤 v2rayN의 ‘시스템 프록시’ 메뉴에서 ‘시스템 프록시 자동 구성’을 선택합니다. 이 변경으로 인증 창이 표시되면 요청 내용이 방금 한 작업과 일치하는지 확인하고 안내에 따라 인증하세요.
- ‘시스템 설정’ → ‘네트워크’ → 현재 서비스(예: ‘Wi-Fi’) → ‘세부사항’ → ‘프록시’에서 활성화된 항목을 확인합니다. 주소와 포트가 v2rayN의 로컬 리스너 설정과 일치하는지 살펴보세요. 유선 네트워크로 전환했다면 현재 서비스도 다시 확인해야 합니다.
TUN: 다음으로 가상 네트워크 인터페이스 테스트
- 먼저 시스템 프록시를 해제한 다음 v2rayN의 TUN 모드를 켭니다. 실제 안내에 따라 관리자 인증, VPN 구성 추가, 네트워크 확장 허용을 구분하세요. 각각 별개의 권한이며 모든 구현 방식에서 네트워크 확장을 요청하는 것은 아닙니다.
- macOS 15에서 네트워크 확장이 비활성화되었다는 안내가 명확히 표시되면 ‘시스템 설정’ → ‘일반’ → ‘로그인 항목 및 확장 프로그램’ → ‘네트워크 확장’으로 이동해 세부 정보를 열고 해당 항목을 활성화하세요. VPN 구성을 추가하라는 안내가 표시되면 시스템 확인 창에서 이름을 확인한 다음 ‘시스템 설정’ → ‘VPN’에서 상태를 살펴보세요.
프록시 페이지에 표시된 포트와 클라이언트의 리스너 포트가 같다면 설정이 같은 연결 지점을 가리킨다는 뜻입니다. 노드 연결 여부는 코어 로그와 실제 요청으로 별도로 확인해야 합니다.
시스템 프록시를 변경해도 항상 인증 창이 나타나는 것은 아니며, 모든 버전에 공통으로 적용되는 상시 권한 스위치도 없습니다. 프록시 페이지가 바뀌지 않았다면 먼저 클라이언트에서 ‘시스템 프록시 변경 안 함’을 선택하지 않았는지 확인하고, 클라이언트 로그에 권한 오류가 있는지 살펴보세요. 다른 소프트웨어나 관리 정책이 프록시를 제어하는 경우 기존 설정을 기록하고 함부로 덮어쓰지 마세요.
로컬 네트워크 권한은 접속 대상에 따라 확인
macOS 15의 ‘로컬 네트워크’ 권한은 앱이 로컬 네트워크 기기에 접근하는 것을 제어합니다. 브라우저가 이 컴퓨터의 루프백 주소 127.0.0.1에 연결하는 것과 v2rayN 또는 해당 코어가 다른 로컬 네트워크 호스트에 연결하는 것은 서로 다른 연결입니다. 공용 네트워크 노드를 사용하고 브라우저가 루프백 포트를 가리키는 경우, 웹페이지가 열리지 않는다는 이유만으로 로컬 네트워크 권한을 켜지 마세요.
공용 노드와 루프백 리스너
권장프록시 리스너를 이 컴퓨터에서만 사용하도록 유지하세요. 시스템 프록시를 따르는 브라우저로 연결을 확인합니다. 포트에 예시 값인 10808을 입력했지만 로그에 다른 포트가 표시되면 클라이언트 또는 프록시 설정을 수정하세요.
권장 대상: 첫 설치, 이 컴퓨터의 앱만 프록시 사용
로컬 네트워크 노드에 연결
노드가 주소 192.168.1.20처럼 실제로 같은 로컬 네트워크에 있는 경우 ‘시스템 설정’ → ‘개인정보 보호 및 보안’ → ‘로컬 네트워크’에서 해당 앱의 스위치를 확인하세요. 목록에 앱이 없으면 먼저 실제 접속을 시도하고 시스템에서 권한 요청이 표시되는지 살펴보세요. 시스템에 표시된 요청 앱을 기준으로 판단하고, 알 수 없는 항목을 일괄 허용하지 마세요.
권장 대상: 노드 또는 대상 서비스가 실제로 로컬 네트워크에 있는 경우
권한을 허용해도 연결되지 않을 때 확인할 순서
- 로컬 리스너 확인. 터미널에서
lsof -nP -iTCP:10808 -sTCP:LISTEN을 실행하고, 포트 번호는 클라이언트의 현재 값으로 바꾸세요. 결과가 있으면 프로세스 이름을 확인합니다. 결과가 없으면 v2rayN 로그로 돌아가 코어 실행 여부와 포트 바인딩 실패 여부를 살펴보세요. 리스너가 정상이어도 원격 연결의 핸드셰이크까지 성공했다는 뜻은 아닙니다. - 노드 핸드셰이크 확인. 노드를 하나 선택해 요청을 보내고 해당 시점의 코어 로그를 확인하세요. 연결 시간 초과라면 노드 주소와 포트를 먼저 점검합니다. 핸드셰이크 오류가 발생하면 서버에서 요구하는 전송 방식과 보안 계층 설정을 다시 확인하세요. 노드 이름만 보고 설정을 판단하거나 인증서 검증을 꺼서 오류를 숨기지 마세요.
- 앱과 라우팅 확인. 브라우저는 정상인데 특정 앱만 실패한다면 해당 앱이 시스템 프록시를 사용하는지 먼저 확인하세요. TUN 모드에서만 실패한다면 다른 VPN을 끄고 라우팅과 DNS 충돌 여부를 점검합니다. 로컬 네트워크 서비스만 연결되지 않으면 분할 라우팅 규칙, 로컬 네트워크 권한, 대상 기기의 온라인 상태를 다시 확인하세요.
- 기존 네트워크 설정 복원. 점검이 끝나면 먼저 TUN을 끈 다음 v2rayN에서 시스템 프록시를 해제하세요. 현재 네트워크 서비스의 ‘프록시’ 페이지로 돌아가 설정을 확인합니다. 회사 프록시나 수동 프록시를 사용하는 기기는 모든 항목을 일괄 해제하지 말고 이전에 기록한 설정을 복원하세요.