먼저 ‘앱이 열리지 않는 문제’와 ‘앱은 열리지만 인터넷에 연결되지 않는 문제’를 구분하세요. 전자는 설치 파일의 아키텍처와 macOS 보안 알림부터 확인하고, 후자는 코어, 로컬 포트, 시스템 프록시, 서버 연결을 차례로 점검합니다. 일반적인 웹 브라우징에는 우선 시스템 프록시를 사용하고, 더 많은 앱의 트래픽을 처리해야 할 때만 TUN에 필요한 관리자 승인을 진행하세요. 모든 권한을 한꺼번에 켤 필요는 없습니다.
먼저 구분하기: 실행 차단은 네트워크 오류가 아닙니다
‘개발자를 확인할 수 없음’은 보통 macOS의 앱 보안 검사와 관련된 메시지입니다. 메인 창이 표시되기 전에 나타나며 구독 유효 여부나 서버 상태와는 별개의 문제입니다. 이때 구독을 반복해서 업데이트하거나 서버 포트를 바꿔도 실행 차단은 해제되지 않습니다.
먼저 Apple 메뉴에서 ‘이 Mac에 관하여’를 확인하세요. Apple 칩 기기는 arm64 설치 파일을, Intel 프로세서 기기는 x64 설치 파일을 선택하는 것이 좋습니다. Apple 칩 기기에서 일부 x64 앱을 실행하려면 Rosetta가 필요할 수 있지만, 문제를 확인할 때는 해당 기기에 맞는 아키텍처를 우선 사용해 변수를 줄이세요.
| 표시되는 증상 | 관련 단계 | 먼저 할 일 |
|---|---|---|
| 개발자를 확인할 수 없거나 악성 소프트웨어인지 확인할 수 없음 | 앱 실행 보안 검사 | 출처를 확인한 뒤 ‘개인정보 보호 및 보안’에서 차단 기록을 확인합니다. |
| 앱이 손상되어 열 수 없음 | 다운로드 무결성, 서명 또는 앱 패키지 상태 | 기기에 맞는 설치 파일을 다시 받으세요. 일반적인 허용 절차를 그대로 적용하지 마세요. |
| 컴퓨터가 손상되었거나 악성 소프트웨어가 감지됨 | 명확한 보안 위험 알림 | 실행을 중단하고 출처를 확인하세요. 보안 경고를 억지로 우회하지 마세요. |
| 창은 정상적으로 열리지만 웹 페이지가 열리지 않음 | 코어, 프록시 진입점 또는 원격 연결 | 로그를 확인한 다음 로컬 수신 대기와 시스템 프록시를 점검합니다. |
‘개인정보 보호 및 보안’에서 앱 열기 허용하기
아래 절차는 ‘시스템 설정’ 인터페이스를 사용하는 macOS 13 및 이후 버전에 해당합니다. 시스템 버전에 따라 확인 버튼의 문구는 조금 다를 수 있지만, 설정 위치는 모두 ‘개인정보 보호 및 보안’의 보안 섹션입니다. 허용 설정은 출처를 확인한 해당 앱에만 적용되며, Mac 전체의 보안 검사를 끄는 것은 아닙니다.
-
응용 프로그램으로 옮기기
다운로드한 DMG를 열고 v2rayN을 ‘응용 프로그램’으로 드래그하세요. 설치 디스크 이미지를 꺼낸 뒤 ‘Finder’ → ‘응용 프로그램’에서 실행하면 디스크 이미지 안의 복사본을 계속 실행하는 일을 피할 수 있습니다.
-
실행 알림 표시하기
v2rayN을 두 번 클릭하고 시스템 알림을 읽은 다음 알림 창을 닫으세요. 안내 문구를 기록하고, 이것이 개발자 확인 알림인지 명확한 악성 소프트웨어 경고인지 구분하세요.
-
차단 기록 찾기
Apple 메뉴 → ‘시스템 설정’ → ‘개인정보 보호 및 보안’을 열고 아래로 내려가 ‘보안’ 섹션을 찾으세요. 최근 v2rayN 실행을 차단한 기록을 확인합니다.
-
이번 실행 허용하기
‘그래도 열기’를 클릭하고 시스템 안내에 따라 Touch ID 또는 관리자 인증 정보로 승인하세요. 이후 확인 창이 다시 나타나면 앱 이름을 확인한 뒤 ‘열기’를 클릭합니다.
-
다시 실행해 확인하기
메인 창이 열리는지 확인한 다음 앱을 종료하고 ‘응용 프로그램’에서 다시 실행하세요. 같은 방식으로 계속 차단되면 먼저 다운로드 폴더에 있는 다른 복사본을 실행하고 있지 않은지 확인합니다.
macOS 15 및 이후 버전에서는 서명이 올바르지 않거나 공증되지 않은 일부 앱의 실행 절차가 더 엄격합니다. 이전 가이드에 나온 마우스 오른쪽 버튼 클릭 후 ‘열기’가 항상 통하는 지름길이라고 생각하지 마세요. 격리 속성을 삭제하거나 Gatekeeper를 비활성화하는 명령, 앱 디렉터리 전체의 권한을 변경하는 명령도 직접 실행하지 마세요. 원인을 가리고 문제 범위를 키울 수 있습니다.
시스템 프록시와 TUN: 필요한 기능만 선택하기
v2rayN은 설정과 관리를 위한 인터페이스이며, 실제 연결을 중계하는 것은 코어입니다. 인터페이스가 실행된다고 코어까지 실행 중인 것은 아니며, 코어가 서버에 연결되더라도 브라우저가 프록시를 사용한다는 뜻은 아닙니다. 시스템 프록시는 시스템 설정을 따르는 앱에 연결을 전달할 로컬 진입점을 알려주고, TUN은 가상 네트워크 인터페이스를 통해 규칙에 맞는 트래픽을 처리합니다.
시스템 프록시부터 사용하기
권장먼저 TUN을 끈 상태에서 유효한 서버를 선택한 다음, v2rayN의 ‘시스템 프록시’ → ‘시스템 프록시 자동 구성’을 선택해 활성화하세요. 메뉴 위치는 데스크톱 버전에 따라 다를 수 있으며, 보통 메인 창 하단이나 트레이 메뉴에 있습니다.
적합한 용도: 브라우저 사용, 초기 설정, 로컬 진입점과 원격 연결 문제 구분
필요할 때만 TUN 활성화
일반 프록시가 작동하는 것을 확인한 뒤 TUN을 시도하세요. 가상 인터페이스 생성, 라우팅 변경 및 관련 보조 작업에는 보통 관리자 승인이 필요하며, 구체적인 안내는 클라이언트 버전과 사용하는 코어에 따라 다릅니다.
적합한 용도: 시스템 프록시를 따르지 않는 앱, 트래픽을 일괄 처리해야 하는 경우
시스템 프록시를 활성화한 뒤 ‘시스템 설정’ → ‘네트워크’ → 현재 연결된 Wi-Fi 또는 이더넷 → ‘세부사항’ → ‘프록시’에서 설정을 확인할 수 있습니다. 웹 프록시, 보안 웹 프록시 또는 SOCKS 프록시 설정이 클라이언트에서 실제로 제공하는 인바운드 유형과 일치해야 합니다. 옵션이 선택되어 있다는 사실만으로 설정이 올바르다고 판단할 수는 없습니다.
- 주소: 로컬 프록시 주소는 보통
127.0.0.1입니다. 구독 서버 주소를 로컬 프록시 입력란에 넣지 마세요. - 포트: v2rayN의 ‘설정’ → ‘매개변수 설정’에 표시된 로컬 수신 대기 값을 기준으로 하세요. 버전에 따라 탭과 필드 이름이 다를 수 있습니다.
- 인증: 로컬 인바운드에 사용자 이름과 암호가 명시적으로 설정된 경우에만 시스템 프록시에 인증 정보를 입력하세요.
- 종료: 클라이언트를 닫기 전에 ‘시스템 프록시’ → ‘시스템 프록시 지우기’를 선택하세요. 앱을 종료한 뒤에도 시스템이 더 이상 수신하지 않는 포트를 가리키는 상황을 방지할 수 있습니다.
네트워크 권한: 안내에 따라 필요한 권한만 허용하기
macOS에는 모든 데스크톱 앱에 공통으로 적용되는 ‘모든 네트워크 연결 허용’ 스위치가 없습니다. 보안 설정에서 앱을 허용하는 것, 로컬 네트워크 접근, 시스템 프록시 설정 변경, TUN 관리자 권한은 서로 다른 단계입니다. 한 종류의 승인 창이 떴다고 다른 단계까지 완료된 것으로 생각하지 마세요.
| 권한 또는 설정 | 실제 용도 | 적용 범위 |
|---|---|---|
| 로컬 네트워크 | macOS 15 및 이후 버전에서 해당 기능으로 관리되는 로컬 네트워크 접근을 제어합니다. | 라우터나 로컬 네트워크 기기에 접근하거나 로컬 네트워크에서 서비스를 제공해야 한다면 ‘개인정보 보호 및 보안’ → ‘로컬 네트워크’를 확인하세요. |
| 네트워크 프록시 설정 | 현재 네트워크 서비스에서 사용할 프록시 주소와 포트를 변경합니다. | 시스템에서 인증을 요구하면 작업을 요청한 앱을 확인한 뒤 승인하세요. 실패하면 현재 네트워크 서비스와 관리 정책을 확인합니다. |
| TUN 관리자 승인 | 가상 인터페이스 생성, 라우팅 변경 등 제한된 작업을 허용합니다. | 클라이언트에 실제로 표시되는 승인 절차에 따르세요. 일반 GUI 앱을 계속 관리자 권한으로 실행하지 마세요. |
| 방화벽의 수신 연결 | 다른 기기가 이 Mac의 서비스에 연결할 수 있는지 제어합니다. | Mac에서 루프백 주소로 프록시에 접근하는 경우, 보통 외부 수신 연결을 허용할 필요는 없습니다. |
‘로컬 네트워크’ 목록에 v2rayN이 없다고 해서 설치가 잘못된 것은 아닙니다. 관련 권한은 보통 앱이 해당 기능으로 제어되는 접근을 시도한 뒤에야 표시됩니다. 공용 인터넷이나 Mac 자체의 루프백 주소에 접근하는 문제를 모두 로컬 네트워크 권한 부족으로 볼 수는 없습니다. 웹 페이지 시간 초과를 해결하려고 방화벽 전체를 끄지 마세요.
로컬 포트로 연결 경로 확인하기
점검 순서는 ‘코어 실행 → 로컬 수신 대기 → 명시적 프록시 요청 → 시스템 프록시 → TUN’입니다. 아래의 10808은 예시 포트일 뿐이며 모든 버전의 기본값이라는 뜻은 아닙니다. 사용 중인 클라이언트가 실제로 해당 포트에서 HTTP 또는 혼합 프록시 인바운드를 제공할 때만 예시 명령을 사용하세요.
‘Finder’ → ‘응용 프로그램’ → ‘유틸리티’ → ‘터미널’을 열고 아래의 읽기 전용 명령 두 개를 실행하세요. 첫 번째 명령은 예시 포트가 TCP 연결을 수신 대기하는지 확인하고, 두 번째 명령은 현재 시스템 프록시 상태를 읽습니다. 시스템 설정은 변경되지 않습니다.
lsof -nP -iTCP:10808 -sTCP:LISTEN
scutil --proxy- 수신 대기 검사 결과가 비어 있음: 먼저 실제 포트와 코어 로그를 확인하세요. 출력이 없다는 사실만으로 앱 설치 실패를 판단할 수는 없습니다.
- 예상한 코어가 아닌 프로세스가 수신 대기 중: 포트 충돌일 수 있습니다. 프로세스 이름을 기록하고 클라이언트에서 사용 가능한 포트로 변경한 뒤 코어를 다시 시작하세요.
- 시스템 프록시 주소 또는 포트가 일치하지 않음: 시스템 프록시를 다시 적용하고 현재 사용하는 Wi-Fi 또는 이더넷 서비스를 확인하세요.
해당 진입점이 HTTP 프록시를 지원하는지 확인한 다음 명시적 프록시 요청을 한 번 보내세요. 이 테스트는 브라우저가 시스템 프록시를 사용하는지와 무관하므로 ‘로컬 중계가 작동하는지’와 ‘시스템 설정이 적용되는지’를 나눠 확인하는 데 유용합니다.
curl --connect-timeout 10 --max-time 20 -I \
--proxy http://127.0.0.1:10808 https://v2raybit.com/로컬 진입점이 SOCKS만 지원한다면 프록시 매개변수를 --proxy socks5h://127.0.0.1:10808로 바꾸세요. 포트는 해당 SOCKS 수신 대기 값으로 설정해야 합니다. 여기서는 응답 내용을 미리 정하지 않습니다. 연결이 거부되면 먼저 로컬 수신 대기를 확인하고, 시간 초과가 발생하면 코어 로그를 바탕으로 원격 연결, DNS 또는 규칙 문제인지 판단하세요.
자주 묻는 질문과 종료 후 설정 복구
실행할 때마다 ‘그래도 열기’를 눌러야 하나요?
한 번 허용한 동일 앱은 보통 다시 승인할 필요가 없습니다. 실행 중인 복사본을 모두 종료하고 ‘응용 프로그램’에서 다시 실행하세요. 업데이트로 앱 패키지가 바뀌면 시스템이 다시 검사할 수 있습니다. 차단이 계속 반복되면 알림 문구를 기록하고 이전 복사본을 실행하고 있거나 관리 정책에 제한된 것은 아닌지 확인하세요.
앱 실행을 허용했는데도 구독 업데이트가 실패하는 이유는 무엇인가요?
앱 실행 허용은 시작 단계의 보안 검사만 해결합니다. 구독 주소가 완전한지, 만료되지는 않았는지, 업데이트에 프록시 연결이 필요한지 확인하세요. 사용할 수 있는 프록시 경로가 이미 있을 때만 ‘프록시를 통해 업데이트’ 옵션이 구독에 접근하는 데 도움이 될 수 있습니다. 이 옵션만으로 연결이 새로 만들어지지는 않습니다. 로그를 공유할 때는 구독 주소 전체와 인증 정보를 숨기세요.
TUN을 켜자마자 인터넷 연결이 끊기면 어떤 권한을 추가해야 하나요?
먼저 TUN을 끄고 작동을 확인한 시스템 프록시 경로로 돌아가세요. 그런 다음 TUN만 따로 활성화하고 처음 실패한 시점의 로그와 시스템 승인 알림을 기록하세요. 일반 프록시는 되는데 TUN만 실패한다면 가상 인터페이스, 라우팅 충돌, DNS를 중점적으로 확인하세요. 노드, 프로토콜, 권한을 한꺼번에 바꾸지 마세요.
v2rayN을 종료한 뒤 컴퓨터 전체에서 인터넷이 안 되면 어떻게 하나요?
‘시스템 설정’ → ‘네트워크’ → 현재 연결 → ‘세부사항’ → ‘프록시’에서 로컬 포트를 가리키는 설정이 남아 있는지 확인하세요. 클라이언트가 이번에 설정한 프록시 항목만 취소하고, 기존 업무 네트워크 설정은 유지하세요. TUN을 사용했다면 정상적으로 TUN을 끈 뒤 종료하고, 필요하면 현재 네트워크에 다시 연결하세요.
계속 문제를 확인하려면 macOS 버전과 칩 유형, 실제 사용 중인 v2rayN 버전, 오류 발생 시점의 첫 번째 관련 로그만 기록해 두면 됩니다. 먼저 문제가 발생한 단계를 파악한 뒤 해당 설정을 조정하세요. 무작정 재설치하거나 권한을 더 넓히는 것보다 원인을 분명히 찾기 쉽습니다.