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

1. 설치 파일 아키텍처와 응용 프로그램 폴더

Apple 메뉴에서 ‘이 Mac에 관하여’를 엽니다. Apple 칩이 표시되면 Apple Silicon용 패키지를, Intel 프로세서가 표시되면 Intel용 패키지를 선택하세요. 아키텍처가 맞지 않으면 앱이 실행되지 않거나 별도의 호환 실행 환경을 요구할 수 있습니다. 창은 열리더라도 포함된 코어가 실행되지 않을 수도 있습니다. 모든 실행 문제를 개발자 확인 절차 탓으로 돌리지는 마세요.

1. 칩 확인

   Apple 메뉴에서 ‘이 Mac에 관하여’를 열어 칩 종류를 확인한 뒤 클라이언트 다운로드 페이지의 macOS 섹션에서 알맞은 아키텍처를 선택하세요.

2. 설치 파일 압축 해제

   압축 파일은 먼저 압축을 푼 다음 앱을 찾으세요. 디스크 이미지는 연 뒤 안에 있는 앱을 복사하면 됩니다. 압축 파일 자체를 옮기거나 임시 미리보기 폴더에서 계속 실행하지 마세요.

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

   Finder에서 ‘이동’ → ‘응용 프로그램’을 선택하고 v2rayN 앱을 이 폴더로 드래그하세요. 업데이트할 때는 기존 프로세스를 종료한 다음 앱을 교체하고, 기존 설정은 미리 백업해 두세요.

4. 처음 실행

   ‘응용 프로그램’에서 앱을 실행하세요. 시스템이 실행을 차단하면 안내 문구를 끝까지 읽고 다음 절의 ‘개인정보 보호 및 보안’에서 설정을 변경하세요. 압축을 반복해서 풀어 여러 사본을 만든 뒤 계속 실행을 시도하지 마세요.

5. 코어 실행 확인

   앱을 연 뒤 설정을 가져오고 노드를 선택한 다음 실행 로그를 확인하세요. 앱 화면이 정상이라고 프록시 코어까지 실행된 것은 아닙니다. 포트 충돌이나 설정 파싱 오류가 없는지 먼저 확인하세요.

이 글에서는 앱 이름을 v2rayN.app으로 표기합니다. 실제 파일 이름, 메뉴 문구, 기능 위치는 클라이언트 빌드에 따라 달라질 수 있습니다. 명령어에 입력하는 앱 경로는 Finder에 표시된 이름과 일치해야 합니다. 시스템 경로는 ‘시스템 설정’ 앱을 사용하는 macOS 13 이상을 기준으로 설명하며, 클라이언트의 최소 시스템 요구 사항을 뜻하지는 않습니다.

2. 개발자를 확인할 수 없음: Gatekeeper 차단 해제

‘개발자를 확인할 수 없음’ 또는 ‘Apple에서 악성 소프트웨어가 있는지 확인할 수 없습니다’라는 경고는 앱 실행 전 보안 검사에서 표시됩니다. 구독 주소나 VMess, VLESS 설정과는 관련이 없습니다. 차단을 해제하기 전에 설치 파일의 출처가 예상한 곳과 일치하는지, 방금 실행하려 한 앱이 ‘응용 프로그램’ 폴더에 넣은 사본인지 확인하세요.

1. 앱을 한 번 실행해 경고 내용을 확인한 뒤 경고 창을 닫으세요.
2. Apple 메뉴에서 ‘시스템 설정’ → ‘개인정보 보호 및 보안’으로 이동한 다음 아래로 스크롤해 ‘보안’ 섹션을 찾으세요.
3. 해당 앱에 대한 차단 기록이 표시되면 앱 이름을 확인하고 ‘그래도 열기’를 클릭하세요. 이 버튼은 일반적으로 마지막 차단 직후 일정 시간 동안만 표시됩니다.
4. 시스템 안내에 따라 암호 또는 Touch ID로 인증하세요. 다시 확인 창이 표시되면 내용을 확인한 뒤 ‘열기’를 선택하세요.

일부 macOS 버전에서는 Finder에서 Control 키를 누른 채 앱을 클릭하고 ‘열기’를 선택할 수 있습니다. 최신 버전에서는 ‘개인정보 보호 및 보안’에서 다시 승인해야 할 수도 있습니다. 조직에서 관리하는 Mac은 관리 정책에 따라 ‘그래도 열기’가 제한될 수 있습니다. 이 경우 시스템 정책을 바꾸지 말고 관리자에게 문의하세요.

검사 정보를 기록해야 한다면 ‘응용 프로그램’ → ‘유틸리티’ → ‘터미널’에서 다음 읽기 전용 명령을 실행할 수 있습니다. com.apple.quarantine 속성은 파일에 다운로드 격리 표시가 있다는 뜻일 뿐, 파일이 안전하거나 유해하다는 사실을 입증하지 않습니다. 검사 결과도 프로그램 동작을 완전히 감사한 결과와는 다릅니다.

xattr -l "/Applications/v2rayN.app"
spctl --assess --type execute --verbose "/Applications/v2rayN.app"

3. 시스템 프록시와 TUN: 먼저 트래픽 처리 방식 선택

v2rayN을 실행한 뒤에는 시스템 프록시로 기본 연결부터 확인하세요. 시스템 프록시는 현재 네트워크 서비스의 프록시 설정을 로컬 수신 대기 포트로 연결해 시스템 프록시를 따르는 앱에서 사용하도록 합니다. 모든 프로세스를 자동으로 처리하거나 모든 UDP 트래픽을 지원하는 것은 아닙니다. TUN은 가상 네트워크 인터페이스와 라우팅을 사용하므로 권한과 문제 범위가 다릅니다.

먼저 TUN을 끄고 한 가지 트래픽 처리 방식만 사용하세요. 시스템 프록시 연결이 확인된 뒤 필요에 따라 TUN을 테스트하면 됩니다. 두 방식을 동시에 켜면 라우팅, DNS, 로컬 루프백 문제를 해결하기가 더 복잡해집니다. 문제가 발생했을 때 연결이 어느 경로를 거치는지도 파악하기 어려워집니다.

4. 로컬 수신 대기와 macOS 프록시 항목 비교

아래에서는 프록시 인바운드 예시 포트로 10808, 대체 포트로 10809를 사용합니다. 모든 버전의 기본값이라는 뜻은 아닙니다. v2rayN에서 ‘설정’ → ‘매개변수 설정’을 열어 로컬 수신 대기 항목을 확인하세요. 저장된 설정과 현재 실행 로그를 최종 기준으로 삼아야 합니다. 포트를 변경했다면 시스템 프록시 포트도 함께 바꾸세요.

‘시스템 설정’ → ‘네트워크’ → 현재 사용 중인 Wi-Fi 또는 이더넷 → ‘세부사항’ → ‘프록시’로 이동하세요. 웹 프록시, 보안 웹 프록시, SOCKS는 서로 다른 옵션입니다. 입력하기 전에 코어 인바운드가 어떤 프로토콜을 지원하는지 확인하세요. HTTP와 SOCKS를 모두 지원하는 혼합 인바운드가 명확히 설정된 경우에만 두 요청을 같은 포트로 연결할 수 있습니다.

터미널에서 수신 대기 상태와 현재 시스템 프록시를 읽기 전용으로 확인할 수 있습니다. 첫 번째 명령에 출력이 없으면 코어가 실행 중인지, 포트가 변경되었는지 먼저 확인하세요. 수신 대기가 표시되어도 프로세스가 포트를 사용 중이라는 뜻일 뿐, 원격 노드가 작동한다는 뜻은 아닙니다. 두 번째 명령에 표시된 프록시 주소는 클라이언트의 로컬 인바운드 설정과 일치해야 합니다.

lsof -nP -iTCP:10808 -sTCP:LISTEN
scutil --proxy

5. 네트워크 권한: 필요한 항목만 승인

시스템 프록시, 네트워크 확장, 로컬 네트워크, 인바운드 방화벽은 서로 다른 계층입니다. 시스템 프록시를 켠다고 네트워크 확장 승인이 반드시 필요한 것은 아닙니다. 로컬 네트워크 알림이 표시되더라도 공용 인터넷 프록시에 LAN 접근이 필수라는 뜻은 아닙니다. 현재 사용하는 방식에 필요한 권한만 승인하고, 요청한 앱이나 구성 요소의 이름을 확인하세요.

시스템에 네트워크 확장 승인 항목이 없고 클라이언트 로그에 다른 TUN 구현 방식이 표시된다면, 존재하지 않는 스위치를 찾으려고 앱을 반복해서 재설치하지 마세요. 먼저 로그에서 인터페이스 생성, 권한 요청, 라우팅 설정, DNS 요청 중 어느 단계에서 실패했는지 확인하세요. 시스템 프록시가 정상 작동한다면 사용 가능한 모드를 유지하고 TUN 문제는 별도로 해결하세요.

6. 업데이트 후 권한 문제와 프록시 설정 잔류

앱을 교체하면 실행 파일, 서명 상태 또는 보조 구성 요소가 달라져 시스템에서 권한을 다시 요청할 수 있습니다. 하지만 업데이트 후 인터넷이 끊겼다고 해서 반드시 권한이 사라진 것은 아닙니다. 기존 프로세스의 포트 점유, 새 코어의 설정 읽기 실패, 네트워크 서비스 변경, 종료 후 남은 시스템 프록시도 비슷한 증상을 일으킬 수 있습니다.

• 교체 전: 설정을 백업하고 클라이언트에서 시스템 프록시를 해제한 뒤 TUN을 끄고 앱을 종료하세요. 필요하면 ‘활성 상태 보기’에서 기존 프로세스가 종료되었는지 확인합니다.
• 교체 후: ‘응용 프로그램’ 폴더에 있는 새 사본만 실행하세요. 개발자 확인 경고가 다시 표시되면 앞에서 설명한 절차에 따라 다시 승인하고, 다운로드 폴더의 이전 사본을 동시에 실행하지 마세요.
• 권한 확인: 시스템에서 재승인을 명시적으로 요청할 때만 관련 확장 또는 보조 구성 요소를 확인하세요. 모든 권한을 한꺼번에 껐다가 켜는 것을 고정된 업데이트 절차로 삼지 마세요.
• 포트 재확인: 로그에 표시된 수신 대기 주소를 확인하고 scutil --proxy 출력과 비교하세요. 포트가 일치하지 않으면 클라이언트에서 시스템 프록시를 다시 설정하세요.
• 직접 연결로 복구: 앱을 당장 실행할 수 없다면 현재 네트워크 서비스의 ‘프록시’ 설정을 열어 로컬 프록시에 사용했던 옵션을 끄고 적용하세요. 관리되는 프록시 설정은 먼저 관리자에게 문의해야 합니다.

7. 설치 및 차단 해제 FAQ