v2rayN macOS 설치 가이드: 앱을 열 수 없음, 개발자 확인 및 네트워크 권한 해결

1. macOS 설치 파일 선택: ARM64와 x64

Mac에는 v2rayN Desktop용 macOS 설치 파일을 사용해야 합니다. Windows WPF 버전은 사용할 수 없습니다. Desktop은 여러 플랫폼을 지원하는 UI 프레임워크를 사용하지만, 운영체제마다 실행 파일이 다르므로 서로 바꿔 쓸 수 없습니다. 파일명에 WPF 또는 Windows가 있다면 다운로드 페이지로 돌아가 올바른 파일을 선택하세요.

칩 정보는 「Apple 메뉴」→「이 Mac에 관하여」에서 확인할 수 있습니다. Apple M 시리즈 칩이 표시되면 ARM64를, Intel 프로세서가 표시되면 x64를 선택하세요. 필요한 macOS 버전은 해당 설치 파일의 릴리스 정보를 확인해야 합니다. 칩이 맞는다고 해서 구형 시스템에서 실행된다고 단정할 수는 없습니다.

2. DMG 설치 및 첫 실행

앱을 「응용 프로그램」 폴더에 복사한 다음 Mac에 설치된 앱을 실행하세요. DMG가 마운트된 볼륨에서 바로 실행하면 업데이트, 파일 쓰기, 권한 문제를 점검할 때 변수가 늘어납니다. 다시 설치할 때는 「다운로드」 폴더에 있는 이전 버전을 열고 있지 않은지도 확인하세요.

1. 칩 확인

   「Apple 메뉴」→「이 Mac에 관하여」를 열어 칩 종류와 macOS 버전을 확인한 뒤, 이 사이트의 다운로드 센터에서 맞는 macOS 설치 파일을 선택하세요.

2. 앱 복사

   DMG를 더블 클릭하고 설치 창의 안내에 따라 v2rayN 앱을 「응용 프로그램」으로 드래그하세요. 복사가 끝나면 디스크 이미지를 추출하세요. 앱 바로 가기만 데스크톱에 남겨두면 안 됩니다.

3. 첫 실행

   「Finder」→「응용 프로그램」에서 v2rayN을 여세요. 실행이 차단되면 경고 문구를 기록한 다음, 다음 절의 안내에 따라 「개인정보 보호 및 보안」에서 허용하세요. 무작정 반복해서 더블 클릭하지 마세요.

4. 설정 가져오기

   클라이언트에서 「구독 그룹」→「구독 그룹 설정」을 열고 서비스 제공업체가 안내한 구독 주소를 추가해 저장하세요. 그런 다음 「구독 그룹」 메뉴에서 구독을 업데이트합니다. 메뉴 이름은 버전에 따라 다를 수 있으니 현재 화면을 기준으로 진행하세요.

5. 일반 프록시부터 테스트

   서버를 선택하고 먼저 시스템 프록시를 사용해 브라우저 접속을 확인하세요. 코어가 정상적으로 시작한 뒤 TUN을 고려하면 됩니다. 처음 설치할 때 코어, 라우팅, DNS, 트래픽 처리 방식을 한꺼번에 바꾸지 마세요.

구독 주소는 서버 설정을 가져오는 데 쓰이며, 앱 설치 파일이나 계정 비밀번호 입력란이 아닙니다. 가져온 뒤 서버가 표시되지 않으면 구독 응답 내용과 업데이트 로그부터 확인하세요. 앱은 열리지만 목록이 비어 있는 경우 시스템 보안 허용 절차를 다시 진행할 필요는 없습니다.

3. 개발자를 확인할 수 없음: 시스템 안내에 따라 앱 허용

「개발자를 확인할 수 없습니다」는 macOS가 현재 보안 정책에 따라 앱을 확인하지 못했다는 뜻이며, 파일이 손상되었다는 판정은 아닙니다. 먼저 다운로드 출처와 파일 종류를 확인하세요. 출처가 불분명한 파일은 실행하지 말고, 신뢰할 수 있는 곳에서 다시 받으세요.

macOS 13 이후 버전에서는 일반적으로 「Apple 메뉴」→「시스템 설정」→「개인정보 보호 및 보안」으로 이동합니다. 앱 실행을 시도한 뒤 보안 섹션에서 이번 차단 기록과 「그래도 열기」 버튼이 나타났는지 확인하세요. 버튼을 클릭하고 시스템 안내에 따라 인증한 다음 확인 창에서 「열기」를 선택합니다.

구형 시스템에서는 「시스템 환경설정」→「보안 및 개인정보 보호」→「일반」에서 같은 설정을 찾을 수 있습니다. 관리되는 컴퓨터에서는 사용자가 앱을 허용하지 못할 수 있습니다. 이 경우 기기 관리자에게 문의하고 관리 제한을 해제하려고 시도하지 마세요.

4. 앱이 손상되었다는 경고: 다시 다운로드한 뒤 격리 속성 확인

「앱이 손상되어 열 수 없습니다」라는 경고는 다운로드 중단, 앱 패키지 변경, 서명 문제 또는 다운로드 파일에 대한 시스템 격리 처리와 관련이 있을 수 있습니다. 이 메시지만으로 디스크의 파일이 실제로 손상되었다고 단정할 수 없으며, 격리 속성을 바로 삭제해도 된다는 뜻도 아닙니다.

• 디스크 이미지 확인: DMG가 마운트되지 않거나 복사 중 오류가 발생하면 이번에 받은 파일을 삭제하고 설치 파일을 다시 완전히 다운로드하세요.
• 앱 위치 확인: 클라이언트를 종료한 뒤 「응용 프로그램」에서 새로 복사한 앱을 실행하세요. 마운트된 이전 볼륨의 앱을 계속 실행하지 않도록 확인합니다.
• 시스템 요구 사항 확인: 시스템 버전이 너무 오래되었거나 아키텍처가 맞지 않으면 지원되는 설치 파일을 선택하거나 시스템을 업그레이드하세요. 권한 설정으로 실행 조건을 충족할 수는 없습니다.
• 오류 문구 그대로 확인: 서명 무효, 개발자 확인 실패, 악성 소프트웨어 경고는 각각 다르게 처리해야 합니다. 모두 「권한 부족」으로 뭉뚱그리지 마세요.

출처를 확인했고 다시 다운로드해도 격리 관련 차단이 발생하며 그 영향을 이해한 경우에만 앱의 확장 속성 확인을 고려하세요. 아래 명령은 앱이 /Applications/v2rayN.app에 설치되어 있다고 가정합니다. 앱 이름이나 위치가 다르면 실제 경로로 바꿔야 합니다. Finder에서 앱을 터미널 창으로 드래그해 경로를 확인할 수도 있습니다.

# 읽기 전용 확인: 앱에 다운로드 격리 속성이 있는지 확인
xattr -p com.apple.quarantine "/Applications/v2rayN.app"

# 선택 작업: 신뢰할 수 있다고 확인한 앱 패키지에 한해 격리 속성 제거
xattr -r -d com.apple.quarantine "/Applications/v2rayN.app"

5. 시스템 프록시 권한 및 로컬 포트 확인

시스템 프록시는 macOS 프록시 설정을 따르는 앱의 요청을 로컬 클라이언트로 전달합니다. 원격 서버의 포트 설정과는 다릅니다. v2rayN 화면이 열려도 프록시 코어가 정상적으로 포트를 열고 대기 중이라는 뜻은 아니며, 모든 앱이 시스템 프록시를 사용한다는 뜻도 아닙니다.

아래 예시에서는 127.0.0.1:10808을 사용하지만 모든 버전에서 같은 포트를 사용한다는 뜻은 아닙니다. 먼저 v2rayN의 「설정」→「매개변수 설정」에서 실제 로컬 수신 설정을 확인하세요. 일부 구형 설정에서는 HTTP와 SOCKS 포트를 따로 지정하므로 SOCKS 전용 포트를 HTTP 프록시 입력란에 넣으면 안 됩니다.

허용했는데도 프록시 설정이 저장되지 않으면 현재 Wi-Fi 또는 이더넷 중 어떤 네트워크를 사용하는지, 기기가 관리 정책의 적용을 받는지 먼저 확인하세요. 「전체 디스크 접근 권한」을 켜지는 마세요. 이 권한은 네트워크 프록시 설정을 정상적으로 쓰는 데 필요한 권한과 다릅니다.

# 시스템 프록시 상태 확인, 설정은 변경하지 않음
scutil --proxy

# 예시 포트를 사용 중인 프로세스가 있는지 확인; 실제 포트에 맞게 수정
lsof -nP -iTCP:10808 -sTCP:LISTEN

# 해당 포트에서 HTTP 프록시를 지원하는 경우에만 테스트
curl -I --connect-timeout 10 --proxy http://127.0.0.1:10808 https://example.com/

HTTP 응답이 오면 이번 요청이 해당 프록시를 통해 연결된 것입니다. 시간 초과가 발생해도 권한 문제가 원인이라고 단정할 수는 없습니다. 서버, DNS 또는 원격 연결 실패일 수도 있습니다. 포트에서 SOCKS를 지원한다면 curl -I --connect-timeout 10 --proxy socks5h://127.0.0.1:10808 https://example.com/으로 추가 테스트할 수 있습니다. 여기서 socks5h는 대상 도메인 이름 해석을 프록시에 맡깁니다.

6. TUN, 네트워크 확장 및 로컬 네트워크 권한

TUN과 시스템 프록시는 서로 다른 트래픽 처리 방식입니다. TUN은 보통 가상 네트워크 인터페이스, 라우팅, DNS 설정을 통해 트래픽을 처리하며 높은 권한이 필요할 수 있습니다. 다만 구체적인 동작은 클라이언트 버전과 선택한 코어에 따라 다르므로 모든 TUN 실행을 macOS 네트워크 확장 설치와 동일하게 볼 수는 없습니다.

• 일반 시스템 프록시: 먼저 브라우저로 서버와 코어가 정상 작동하는지 확인하세요. 일부 앱이 시스템 프록시를 무시하더라도 클라이언트 설치 실패를 뜻하지는 않습니다.
• TUN 권한 요청: TUN을 직접 활성화했고 실행 중인 클라이언트에서 요청한 것이 확실할 때만 허용하세요. 실패하면 로그에서 권한, 가상 인터페이스 또는 라우팅 오류를 확인하세요.
• 네트워크 확장 허용: 현재 버전에서 실제로 네트워크 확장을 사용하고 시스템 안내가 표시되는 경우에만 처리하세요. 최신 시스템에서는 「시스템 설정」→「일반」→「로그인 항목 및 확장 프로그램」→「네트워크 확장」에서 확인할 수 있습니다. 그 외 버전은 안내에 따라 「개인정보 보호 및 보안」을 확인하세요.
• 로컬 네트워크 권한: 이 설정을 제공하는 시스템에서는 「시스템 설정」→「개인정보 보호 및 보안」→「로컬 네트워크」로 이동해 앱의 로컬 네트워크 접근을 확인하세요. 이 권한은 모든 인터넷 연결을 허용하는 권한이 아니며 TUN 권한을 대신하지도 않습니다.

TUN 문제를 진단할 때는 네트워크 트래픽을 처리 중인 다른 도구를 먼저 종료하고, 한 번에 한 가지 처리 방식만 켜서 비교하세요. 시스템 프록시는 되지만 TUN이 안 된다면 권한, 인터페이스, 라우팅, DNS부터 확인하세요. 곧바로 클라이언트를 다시 설치하거나 모든 서버를 바꿀 필요는 없습니다. FakeDNS도 설치 필수 항목이 아니므로 앱이 열리지 않는 문제를 해결하려고 무심코 활성화하지 마세요.

7. 설치 후 확인 및 종료 시 복원

설치가 끝나면 재현 가능한 점검 절차로 결과를 확인하세요. 「연결됨」 표시만 보는 것보다 정확합니다. 클라이언트 관리 화면, 프록시 코어, 시스템 연결 방식, 원격 서버는 각각 역할이 다르므로 단계별로 점검해야 합니다.

1. 앱 단계: 「응용 프로그램」에서 실행해 보안 차단이 없는지 확인하세요. 종료 후 다시 열어 같은 앱을 사용 중인지 확인합니다.
2. 설정 단계: 구독에서 서버 항목이 생성되었는지, 선택한 VMess 또는 VLESS 설정이 서비스 제공업체의 안내와 일치하는지 확인하세요. 프로토콜, 전송 방식, TLS 매개변수를 경험만으로 임의 변경하지 마세요.
3. 코어 단계: 시작 로그에서 반복적인 충돌이나 수신 실패가 없는지 확인하고, 로컬 포트를 사용하는 프로세스가 있는지 확인하세요. 클라이언트를 여러 개 실행해 포트를 서로 차지하게 하지 마세요.
4. 연결 단계: 먼저 시스템 프록시를 확인한 뒤 TUN을 별도로 확인하세요. 한 번에 설정 하나만 바꾸고 변경 전후 결과를 기록합니다.
5. 복원 단계: 종료 전에 TUN을 끈 다음 시스템 프록시를 「시스템 프록시 지우기」로 전환하세요. 비정상 종료 후에는 macOS의 현재 네트워크 서비스에서 「프록시」 페이지를 열어 남은 설정을 확인합니다.

클라이언트를 끈 뒤 모든 웹 페이지가 열리지 않는다면 시스템 프록시가 더 이상 수신하지 않는 로컬 포트를 가리키고 있을 가능성이 큽니다. 남아 있는 프록시 설정을 지운 뒤 직접 연결을 확인하세요. 네트워크 서비스 전체를 먼저 삭제하지 마세요. 재설치하기 전에 필요한 설정을 백업하고, 로그를 다른 사람에게 전달할 때는 구독 주소, 서버 인증 정보, 계정 정보를 가리세요.

문제 해결 순서는 설치 파일 선택, 로컬에 앱 복사, 앱별 보안 허용, 코어 수신 확인, 시스템 프록시 확인, 마지막으로 TUN 권한 확인입니다. 이 순서대로 점검하면 앱 실행 문제를 찾기 쉽고, 설치 문제와 서버 연결 문제를 혼동하지 않을 수 있습니다.