v2rayN 처음 설치 및 설정 가이드: Windows·macOS 공통 핵심과 자주 겪는 문제

다운로드 전에 운영체제와 프로세서 아키텍처 확인하기

v2rayN 7.x 데스크톱 인터페이스는 Windows와 macOS에서 실행할 수 있지만, 두 플랫폼의 파일 형식이 다르고 프로세서 아키텍처도 맞아야 합니다. Windows의 일반적인 기기는 x64를 사용하고, Qualcomm 프로세서를 탑재한 일부 기기는 arm64를 사용합니다. 오래된 32비트 시스템에는 현재의 64비트 버전을 그대로 적용하기 어렵습니다. macOS에서는 Intel x64와 Apple 실리콘 arm64를 구분해야 합니다.

Windows에서 「설정」→「시스템」→「시스템 정보」를 열고 “시스템 종류”를 확인합니다. “x64 기반 프로세서”라면 x64를, “ARM 기반 프로세서”라면 arm64를 선택합니다. macOS에서는 시스템 정보를 열어 칩 이름이 Apple M 시리즈면 arm64, 프로세서가 Intel이면 x64를 선택합니다. 아키텍처를 잘못 고르면 프로그램 창이 전혀 나타나지 않거나 시스템에서 앱을 실행할 수 없다는 메시지가 표시될 수 있습니다.

Windows 압축 파일은 압축 프로그램의 미리보기 창에서 바로 실행할 수 없습니다. v2rayN은 자체 폴더 또는 사용자 데이터 폴더에서 설정, 로그, 코어 파일을 읽습니다. 압축 파일 안의 실행 파일 하나만 실행하면 코어 누락, 설정 저장 실패, 재시작 후 구독 사라짐 등의 문제가 생기기 쉽습니다. D:\Apps\v2rayN처럼 고정 폴더에 설치하고, 추가 쓰기 권한이 필요한 시스템 폴더는 피하는 것이 좋습니다.

macOS에서 다운로드한 앱을 처음 열면 시스템에서 출처 확인을 요구할 수 있습니다. 먼저 Finder에서 앱을 선택해 “열기”를 사용한 다음 시스템 안내에 따라 확인합니다. 계속 차단되면 「시스템 설정」→「개인정보 보호 및 보안」에서 방금 차단된 기록을 확인할 수 있습니다. 여러 복사본을 반복해서 더블클릭하지 마세요. 현재 실행 중인 버전이 “다운로드” 폴더에 있는지 “응용 프로그램” 폴더에 있는지 구분하기 어려워집니다.

첫 실행 시 정해진 순서로 여섯 가지 점검하기

첫 실행부터 모든 고급 옵션을 조정할 필요는 없습니다. 먼저 클라이언트, 코어, 구독, 로컬 수신 포트가 정상적인 연결 경로를 이루는지 확인한 뒤 라우팅과 시스템 프록시 모드를 결정하세요. 아래 순서대로 진행하면 “클라이언트가 실행되지 않음”과 “노드 자체를 사용할 수 없음”을 구분할 수 있습니다.

1. 압축 해제 또는 이동

   Windows에서는 모든 파일을 고정 폴더에 압축 해제하고, macOS에서는 앱을 “응용 프로그램”으로 이동합니다. 이름이 같은 실행 복사본을 여러 개 두지 마세요.

2. 주 프로그램 실행

   메인 창이 나타나면 제목 표시줄과 트레이 또는 메뉴 막대 아이콘을 먼저 확인합니다. 창을 닫아도 프로그램은 대개 백그라운드에서 계속 실행됩니다.

3. 코어 확인

   「설정」→「매개변수 설정」→「Core 유형」을 열고, 일반적인 VLESS·VMess·Trojan 노드에는 우선 Xray를 선택합니다.

4. 구독 추가

   「구독 그룹」→「구독 그룹 설정」→「추가」로 이동해 메모와 전체 구독 주소를 입력한 뒤 저장합니다.

5. 노드 업데이트

   “모든 구독 업데이트”를 실행하고 메인 목록에 노드가 나타날 때까지 기다립니다. 노드 하나를 선택한 뒤 활성 서버로 지정합니다.

6. 연결 테스트

   먼저 실제 연결 지연 테스트를 실행한 다음 시스템 프록시를 활성화합니다. ICMP ping만으로 프록시 프로토콜의 사용 가능 여부를 판단하지 마세요.

메인 창이 나타나면 하단 상태 정보나 로그 창을 먼저 확인합니다. 정상 상태에는 현재 활성 노드, 로컬 수신 포트, 실행 중인 코어 프로세스가 최소한 표시되어야 합니다. 처음 실행할 때 시스템 방화벽에서 네트워크 액세스 허용 여부를 물을 수 있습니다. 신뢰할 수 있는 현재 네트워크 유형에서 필요한 권한만 허용하세요. 거부해도 클라이언트 화면은 정상적으로 보일 수 있지만, 다른 프로그램이 로컬 프록시 포트에 연결할 때 실패합니다.

메인 창을 닫았다고 반드시 종료된 것은 아닙니다. v2rayN은 기본적으로 Windows 알림 영역이나 macOS 메뉴 막대로 최소화될 수 있습니다. 완전히 종료하려면 트레이 또는 메뉴 막대 메뉴에서 “종료”를 실행한 뒤 작업 관리자나 활성 상태 보기에서 관련 프로세스가 끝났는지 확인하세요. 파일 업데이트, 폴더 이동, 런타임 변경 전에는 반드시 이 단계를 완료해야 합니다.

• 프로그램 창은 보이지만 노드가 전혀 없음: 구독이 저장되었고 “모든 구독 업데이트”를 실행했는지 확인합니다.
• 노드 목록은 있지만 하단에 활성 서버가 없음: 대상 노드를 마우스 오른쪽 버튼으로 클릭해 활성 서버로 지정합니다.
• 코어가 시작 직후 종료됨: 로그를 열고 포트 사용 여부, 노드 필드, Core 유형을 우선 확인합니다.
• 브라우저가 여전히 일반 네트워크를 사용함: 시스템 프록시가 활성화되었는지 확인하고 브라우저의 독립 프록시 설정도 점검합니다.

Core 유형, 수신 포트, 시스템 프록시 설정 방법

Core 유형은 노드 설정을 어떤 코어가 해석할지 결정합니다. Xray는 VLESS, REALITY, XTLS Vision 및 일반적인 VMess 설정의 지원 범위가 더 넓어 v2rayN의 일상적인 기본값으로 적합합니다. V2Fly 코어는 기존 VMess, WebSocket 등의 설정 호환성을 확인할 때 더 알맞습니다. 코어 선택은 노드 필드와 일치해야 하며, 이름을 바꾼다고 서버 측에 없는 매개변수가 생기지는 않습니다.

로컬 수신 포트는 브라우저나 다른 앱이 v2rayN에 연결하는 진입점입니다. v2rayN에서 자주 사용하는 기본 포트는 10808이지만, 실제 값은 「설정」→「매개변수 설정」의 로컬 수신 설정과 실행 로그를 기준으로 확인해야 합니다. 포트는 변경할 수 있지만 다른 프록시 프로그램이나 로컬 서비스와 중복되면 안 됩니다. 로그에 “address already in use” 또는 “포트가 사용 중입니다”가 표시되면 다른 프록시 프로그램을 먼저 종료하거나 포트를 10818로 변경한 뒤 코어를 다시 시작하세요.

시스템 프록시는 시스템 프록시 설정을 따르는 트래픽을 로컬 포트로 전달할 뿐, 모든 프로세스가 자동으로 연결된다는 뜻은 아닙니다. 일부 명령줄 도구, 게임, 자체 네트워크 스택을 관리하는 소프트웨어는 시스템 프록시를 무시합니다. 처음 확인할 때는 일반 브라우저로 웹페이지를 테스트한 뒤 SOCKS 또는 HTTP 주소를 별도로 입력해야 하는 앱을 처리하세요.

구독을 가져온 뒤 노드 필드 먼저 확인하기

구독 링크를 성공적으로 저장해도 노드가 즉시 나타나는 것은 아닙니다. 클라이언트가 원격 내용을 읽어 현재 그룹에 기록하려면 “모든 구독 업데이트”를 실행해야 합니다. 업데이트 결과가 0이면 구독 주소가 완전한지, 복사 과정에서 공백이 섞이지 않았는지 먼저 확인한 뒤 로그의 HTTP 상태와 파싱 메시지를 살펴보세요. 같은 그룹을 여러 개 연속으로 만들지 마세요. 중복 노드가 생기고 업데이트 결과를 구분하기 어려워집니다.

구독 가져오기의 장점은 제공자가 프로토콜 필드를 일관되게 전달한다는 것입니다. VLESS + REALITY를 예로 들면 서버 주소, 포트, 사용자 식별자, Server Name, 공개 키, Short ID, 지문, Flow가 서로 일치해야 합니다. 어느 하나라도 만료되거나 누락되면 클라이언트는 시작되더라도 프로토콜 핸드셰이크를 완료하지 못할 수 있습니다. VMess + WebSocket + TLS는 Host, 경로, TLS, 서버 측 전송 설정도 함께 일치해야 합니다.

노드가 나타나면 먼저 하나만 선택해 실제 연결 지연을 테스트합니다. 이 테스트는 로컬 코어를 거쳐 실제 연결을 시도하므로 단순 ping보다 프록시 핸드셰이크 결과에 가깝습니다. 한 번의 결과는 당시 네트워크 상태만 반영하므로 10초 간격으로 3회 테스트하는 것이 좋습니다. 예를 들어 같은 노드가 168ms, 175ms, 171ms로 나오면 변동이 작습니다. 140ms, 890ms, 시간 초과처럼 나오면 회선 변동, 패킷 손실 또는 불안정한 핸드셰이크일 가능성이 큽니다.

지연 시간이 낮다고 다운로드 속도가 빠른 것은 아닙니다. 지연 테스트는 연결 설정에 걸리는 시간을 주로 반영하며, 처리량은 서버 대역폭, 중간 회선 혼잡, 전송 방식, 대상 사이트의 제한에도 영향을 받습니다. 첫 설치 단계에서는 연결 설정, 웹페이지 로딩, 정상적인 DNS 해석만 확인하면 됩니다. 속도 최적화는 기본 연결이 안정된 뒤 별도로 진행하세요.

Windows에서 자주 발생하는 실행 실패와 트레이 문제

Windows에서 실행이 실패하는 가장 흔한 원인은 압축 파일이 완전히 해제되지 않았거나, .NET 런타임이 맞지 않거나, 프로그램 폴더에 쓰기 권한이 없는 경우입니다. 더블클릭 후 화면이 전혀 나타나지 않으면 먼저 작업 관리자에서 프로세스가 잠시라도 나타났는지 확인하세요. 그런 다음 프로그램 폴더의 로그 파일과 시스템 이벤트 기록을 점검합니다. 오류가 .NET 8을 명확히 가리키면 v2rayN과 동일한 아키텍처의 Desktop Runtime을 설치해야 하며, SDK만 설치하거나 다른 아키텍처의 런타임을 설치해서는 안 됩니다.

메인 창을 닫은 뒤 프로그램이 보이지 않는다고 프로세스가 종료된 것은 아닙니다. Windows에서는 아이콘이 알림 영역의 숨겨진 목록으로 접힐 수 있습니다. 작업 표시줄 오른쪽의 위쪽 화살표를 클릭해 v2rayN 아이콘을 확인하고, 「설정」→「개인 설정」→「작업 표시줄」의 트레이 아이콘 설정에서 표시를 허용하세요. 주 프로그램을 다시 실행해도 기존 프로세스를 깨우기만 할 뿐 두 번째 창이 만들어지지 않을 수 있습니다.

v2rayN은 실행되지만 재시작할 때마다 설정이 기본값으로 돌아간다면 폴더 쓰기 권한과 실제 설정 파일 위치를 먼저 확인해야 합니다. 프로그램을 임시 압축 해제 폴더에 장기간 두지 말고 정리 도구가 데이터 폴더를 주기적으로 삭제하지 않도록 하세요. 프로그램을 옮기기 전 클라이언트를 종료하고 설정을 백업해 두세요. 이동 후에는 구독과 Core 유형을 다시 확인합니다.

• 주 프로그램과 나머지 압축 해제 파일이 같은 폴더 단계에 있는지 먼저 확인합니다.
• 그다음 런타임 아키텍처와 프로그램 아키텍처가 일치하는지 확인합니다.
• 이후 10808 등 로컬 포트가 다른 프로세스에서 사용 중인지 점검합니다.
• 마지막으로 시스템 프록시가 현재 수신 중인 포트를 가리키는지 확인합니다.

macOS 권한, 백그라운드 아이콘, 프록시 잔류 문제 처리

macOS에서 처음 실행할 때 핵심은 앱 위치와 시스템 권한입니다. 앱은 “응용 프로그램” 폴더에서 실행하고, 최초 확인이 끝난 뒤에는 경로를 되도록 바꾸지 마세요. 매번 다운로드 폴더의 서로 다른 복사본을 열면 시스템이 각각을 다른 앱으로 인식해 권한을 반복해서 묻고 설정 파일 위치도 혼동될 수 있습니다.

메인 창을 닫은 뒤 화면 상단 메뉴 막대의 v2rayN 아이콘을 확인합니다. 메뉴 막대 공간이 부족하면 일부 아이콘이 숨겨질 수 있습니다. 메뉴 막대 공간을 차지하는 앱을 먼저 종료한 뒤 활성 상태 보기에서 v2rayN이 계속 실행 중인지 확인하세요. 클라이언트를 재시작할 때는 먼저 메뉴에서 종료해 이전 코어가 로컬 포트를 계속 점유하지 않도록 합니다.

1. Finder에서 현재 실행 중인 복사본이 “응용 프로그램”에 있는지 확인합니다.
2. “활성 상태 보기”를 열고 v2rayN과 현재 코어 프로세스를 검색합니다.
3. 종료를 확인한 뒤 앱을 다시 열고 활성 노드를 선택합니다.
4. 시스템 프록시를 활성화해 브라우저를 테스트하고, 종료하기 전 시스템 프록시를 먼저 지웁니다.

클라이언트를 종료한 뒤에도 네트워크 요청이 계속 실패하면 v2rayN을 다시 열어 시스템 프록시 지우기를 실행하세요. 그런 다음 「시스템 설정」→「네트워크」에서 현재 네트워크 서비스의 세부 설정을 열고 프록시 항목이 여전히 127.0.0.1과 이전 포트를 가리키는지 확인합니다. 시스템 프록시 잔류의 전형적인 증상은 일반 웹페이지는 모두 실패하지만 LAN 기기와의 직접 연결은 정상인 경우입니다.

앱은 열리고 구독도 업데이트되지만 노드 시작만 실패한다면 문제는 대개 시스템 권한 단계가 아닙니다. 이때는 로그로 돌아가 Core 유형, 노드 필드, 포트 사용 여부를 확인하세요. 지문, Server Name, Flow, 전송 경로를 연속해서 바꾸지 마세요. 먼저 구독을 다시 업데이트하고 다른 노드와 비교하면 단일 노드 장애인지 로컬 환경 문제인지 더 빠르게 판단할 수 있습니다.

설치 완료 후 기본 유지 관리 체크리스트

첫 연결이 확인된 뒤에는 원인을 설명할 수 있는 변경만 소수 유지하는 것이 좋습니다. 라우팅 규칙, Mux, 동시성 테스트, 사용자 지정 DNS는 점검 변수를 늘리므로 기본 연결이 안정되기 전에 한꺼번에 활성화하지 마세요. 일정 기간 먼저 사용하면서 구독 업데이트, 노드 전환, 시스템 프록시, 종료 과정이 모두 정상인지 확인한 뒤 실제 필요에 따라 조정합니다.

구독 주소는 설정으로 들어가는 입구와 같으므로 관리되는 위치에 보관하고 공개 로그, 스크린샷, 공유 문서에 붙여 넣지 마세요. 다른 사람에게 문제 정보를 전달할 때는 프로토콜 유형, 포트, 전송 방식, 오류 문구를 남겨도 되지만 구독 주소, 사용자 식별자, 공개 키 관련 정보, 서버 자격 증명은 가려야 합니다.

• 클라이언트를 업데이트할 때마다 「설정」→「매개변수 설정」→「Core 유형」을 다시 확인합니다.
• 구독 업데이트에 실패하면 먼저 로그를 확인하고 원래 그룹을 바로 삭제하지 마세요.
• 새 노드 문제와 로컬 문제를 구분할 수 있도록 검증된 노드 하나를 남겨 둡니다.
• 로컬 포트를 변경하면 브라우저, 명령줄 도구 및 기타 수동 프록시 설정도 함께 업데이트합니다.
• 프로그램 폴더를 업그레이드하거나 이동하기 전 정상적으로 종료하고 현재 설정을 백업합니다.
• 문제 해결이 끝나면 로그 수준을 warning으로 되돌려 디버그 기록이 장기간 과도하게 쌓이지 않게 합니다.

재현 가능한 기본 상태는 다음과 같아야 합니다. v2rayN의 메인 창과 백그라운드 아이콘이 정상적으로 표시되고, Xray 코어가 계속 실행되며, 구독 업데이트 후 노드 수가 합리적으로 표시되어야 합니다. 활성 노드의 실제 연결 지연 테스트가 결과를 반환하고, 시스템 프록시를 활성화하면 브라우저가 네트워크에 접속할 수 있어야 합니다. 시스템 프록시를 지우고 종료한 뒤에는 직접 연결도 정상으로 돌아와야 합니다. 여섯 가지가 모두 충족되면 첫 설치 단계가 완료된 것으로 볼 수 있습니다.