Windows에서 v2rayN 설치 완벽 가이드: 데스크톱판과 WPF판 선택법, 자주 발생하는 문제 해결

v2rayN은 Windows 데스크톱에서 사용하는 그래픽 클라이언트로, 구독·노드·라우팅 규칙·시스템 프록시와 Xray 같은 핵심 프로그램을 관리합니다. 처음 사용할 때 실제로 자주 문제가 생기는 부분은 서버 정보를 입력하는 과정이 아니라 프로그램 패키지를 잘못 선택하거나, 실행 환경 설치를 빠뜨리거나, 구독을 업데이트하지 않거나, 노드만 선택하고 시스템 프록시를 켜지 않는 경우입니다. 이 글은 v2rayN 7.13.3 중국어 인터페이스를 기준으로 설명하며, Windows 10과 Windows 11에서 같은 순서로 진행할 수 있습니다.

데스크톱판과 WPF판 선택 기준

다운로드 페이지의 ‘데스크톱판’은 일반적으로 Avalonia 인터페이스 기반 버전을, ‘WPF판’은 Windows에 내장된 WPF 데스크톱 기술을 사용하는 버전을 의미합니다. 두 버전 모두 같은 종류의 구독과 프록시 코어를 관리하며 VMess, VLESS, 구독 업데이트, 라우팅 분할, 시스템 프록시 등 주요 기능도 거의 같습니다. 선택할 때는 서로 다른 프로토콜로 보기보다 시스템 환경과 인터페이스 호환성을 먼저 확인해야 합니다.

프로그램 패키지 이름의 x64와 ARM64는 프로세서 아키텍처를 나타냅니다. 대부분의 Intel 또는 AMD 프로세서 컴퓨터는 x64를 선택하고, ARM 프로세서를 사용하는 Windows 기기만 ARM64를 선택합니다. 시스템 화면의 외관만으로 판단하지 말고 「설정」→「시스템」→「시스템 정보」에서 ‘시스템 종류’를 확인하세요. ‘x64 기반 프로세서’로 표시되면 x64 패키지를 사용하면 됩니다.

다운로드, 압축 해제 및 첫 실행

v2rayN은 일반적으로 압축 패키지로 제공됩니다. 먼저 전체 압축 패키지를 고정된 폴더에 압축 해제한 뒤 주 프로그램을 실행해야 합니다. 압축 프로그램의 미리보기 창에서 바로 더블클릭하면 일부 종속 파일이 캐시 폴더에 임시로 풀릴 수 있으며, 종료 후 코어 파일을 찾지 못하거나 설정 저장 및 업데이트에 실패할 수 있습니다. D:\Tools\v2rayN처럼 경로가 짧은 폴더를 사용하고 자주 동기화되는 폴더는 피하는 것이 좋습니다.

1. 프로그램 패키지 다운로드

   이 사이트의 다운로드 페이지에서 Windows 프로세서 아키텍처에 맞는 데스크톱판 또는 WPF판을 선택하세요. 런타임 설치 여부가 확실하지 않다면 해당 자체 포함 패키지를 선택하면 됩니다.

2. 전체 압축 해제

   압축 패키지를 마우스 오른쪽 버튼으로 클릭하고 ‘모두 압축 풀기’를 선택하세요. 대상 폴더는 D:\Tools\v2rayN으로 지정할 수 있습니다. 폴더 안에 주 프로그램뿐 아니라 여러 종속 파일과 하위 폴더가 있는지 확인하세요.

3. 첫 실행

   주 프로그램을 더블클릭하세요. Windows에서 출처 확인 창이 표시되면 파일 이름과 다운로드 출처를 확인한 뒤 계속 진행합니다. 실행에 성공하면 작업 표시줄 알림 영역에 클라이언트 아이콘이 나타납니다.

4. 코어 선택

   「설정」→「매개변수 설정」→「Core 유형」을 열고, 평소 VLESS 또는 VMess를 사용한다면 Xray를 선택한 뒤 저장하고 기본 화면으로 돌아갑니다.

5. 포트 확인

   「설정」→「매개변수 설정」에서 로컬 수신 포트를 확인하세요. 일반적인 SOCKS 포트는 10808, HTTP 포트는 10809입니다. 이미 다른 프로그램이 사용 중이면 사용하지 않는 다른 포트로 변경하세요.

6. 설정 저장

   설정을 확인한 뒤 매개변수 창을 닫습니다. 아직 프록시를 바로 켜지 말고 구독 가져오기와 노드 테스트를 먼저 완료하세요. 확인되지 않은 설정으로 시스템 트래픽이 전환되는 것을 방지할 수 있습니다.

프로그램을 실행한 뒤 기본 창이 나타나지 않아도 반드시 실행에 실패한 것은 아닙니다. 먼저 작업 표시줄 오른쪽 알림 영역을 확인하고, 필요하면 위쪽 화살표를 클릭해 숨겨진 아이콘을 펼친 다음 v2rayN 아이콘을 더블클릭하세요. 작업 관리자에 이미 v2rayN 프로세스가 있다면 계속 더블클릭해도 기존 인스턴스가 활성화될 뿐, 기본 창이 여러 개 생성되지는 않습니다.

런타임 누락 확인 방법

• 명확한 .NET Desktop Runtime 안내가 표시되는 경우: 프로그램 아키텍처와 일치하는 런타임을 설치하거나 같은 버전의 자체 포함 패키지로 바꾸세요.
• 더블클릭 후 프로세스가 즉시 종료되는 경우: 프로그램 폴더의 로그를 확인하고 보안 정책이 주 프로그램 또는 코어 하위 프로세스를 차단하지 않았는지 점검하세요.
• 기본 화면은 열리지만 노드 실행에 실패하는 경우: 코어 파일이 완전한지 확인한 다음 「설정」→「매개변수 설정」→「Core 유형」에서 코어를 다시 지정하세요.
• 압축 해제 후 파일 수가 눈에 띄게 적은 경우: 주 프로그램 파일만 복사하지 말고 전체 압축 해제를 다시 진행하세요.

구독을 가져와 첫 연결 완료

구독 링크는 일반 웹페이지 주소가 아니라 서비스 제공자가 생성한 설정 진입점입니다. v2rayN이 구독을 읽으면 그 안의 VMess, VLESS 등 노드를 현재 구독 그룹에 기록합니다. 링크를 가져오는 것은 ‘구독 등록’만 완료하는 단계이므로, 노드가 기본 목록에 표시되려면 반드시 한 번 업데이트해야 합니다.

1. 구독 링크 전체를 복사하되 앞뒤 공백, 줄바꿈 또는 메신저가 덧붙인 설명 문구가 포함되지 않도록 주의하세요.
2. 기본 화면에서 「구독 그룹」→「구독 그룹 설정」을 열고 추가 버튼을 클릭하세요.
3. 알아보기 쉬운 별칭을 입력하고 구독 주소 입력란에 링크를 붙여 넣은 뒤 설정을 저장하세요.
4. 「구독 그룹」→「모든 구독 업데이트(프록시 사용 안 함)」를 여세요. 현재 네트워크에서 직접 업데이트할 수 없다면 프록시를 통한 업데이트를 선택하세요.
5. 노드가 표시되면 먼저 지연 시간 테스트 또는 실제 연결 테스트를 실행한 뒤 응답하는 노드를 활성 서버로 선택하세요.
6. 대상 노드를 마우스 오른쪽 버튼으로 클릭해 활성 서버로 지정하고, 상태 표시줄에 해당 노드 이름이 표시되는지 확인하세요.

지연 시간 테스트는 대상 주소가 정해진 시간 안에 응답하는지만 보여 주며, 웹페이지 접속이 반드시 정상이라는 뜻은 아닙니다. 일부 서버는 탐색 요청을 제한할 수 있지만 실제 프록시 연결은 정상일 수 있고, 지연 시간이 낮아도 실제 다운로드 속도가 불안정할 수 있습니다. 따라서 노드를 선택할 때는 지연 시간, 연결 로그와 실제 웹페이지 로딩 결과를 함께 확인해야 합니다.

시스템 프록시를 켜고 트래픽 확인

노드를 선택하는 것과 시스템 프록시를 켜는 것은 별개의 작업입니다. 전자는 v2rayN이 사용할 아웃바운드 연결을 지정하고, 후자는 Windows 시스템 프록시 설정을 따르는 애플리케이션의 트래픽을 로컬 수신 포트로 보냅니다. ‘노드에는 지연 시간이 표시되지만 브라우저가 열리지 않는’ 가장 흔한 원인은 활성 서버만 지정하고 시스템 프록시 모드를 전환하지 않았기 때문입니다.

• 시스템 프록시 해제: Windows의 프록시 설정을 원래대로 되돌립니다. 종료 전이나 네트워크 문제를 점검할 때 적합합니다.
• 시스템 프록시 자동 설정: v2rayN이 로컬 프록시 주소를 입력합니다. 일반 브라우저와 시스템 설정을 따르는 데스크톱 프로그램에 적합합니다.
• 시스템 프록시 변경 안 함: 로컬 수신만 실행합니다. 애플리케이션을 127.0.0.1:10808 또는 127.0.0.1:10809로 직접 지정하는 경우에 적합합니다.
• 라우팅 모드: 연결이 코어에 들어온 뒤 프록시 아웃바운드, 직접 연결 아웃바운드 또는 차단 아웃바운드 중 어느 경로로 나갈지 결정합니다. Windows 시스템 프록시 스위치와는 다릅니다.

먼저 알림 영역 아이콘을 마우스 오른쪽 버튼으로 클릭해 ‘시스템 프록시 자동 설정’을 선택한 다음 새 브라우저 창을 열어 테스트하세요. 이미 실행 중인 애플리케이션은 이전 프록시 상태를 캐시할 수 있으므로, 반복해서 새로 고침하기보다 완전히 종료한 뒤 다시 여는 편이 확실합니다. 회사 네트워크에서 프록시를 강제하는 경우에는 기존 주소와 포트를 먼저 기록하고, 테스트가 끝난 뒤 원래 값으로 복원하세요.

포트 상태로 문제 원인 찾기

netstat -ano | findstr :10808
netstat -ano | findstr :10809
tasklist /fi "PID eq 프로세스 번호"

첫 번째와 두 번째 명령은 로컬 포트가 수신 상태인지 확인하는 데 사용합니다. 결과에 LISTENING이 나타나면 끝에 표시된 PID를 기록한 뒤 세 번째 명령으로 프로세스 이름을 조회하세요. PID가 v2rayN이 실행한 코어 프로세스에 해당하면 로컬 진입점이 만들어진 것입니다. 다른 프로그램에 해당한다면 해당 프로그램을 종료하거나 「설정」→「매개변수 설정」에서 로컬 포트를 10810, 10811 등 사용하지 않는 값으로 변경하세요.

자주 발생하는 문제별 해결

문제 해결은 ‘프로그램 프로세스—로컬 수신—코어 로그—구독 노드—시스템 프록시—애플리케이션 캐시’ 순서로 진행해야 합니다. 이 순서를 따르면 클라이언트가 실행되지 않은 문제, 포트가 열리지 않은 문제, 원격 핸드셰이크 실패와 브라우저가 시스템 설정을 읽지 않는 문제를 빠르게 구분할 수 있으며, 처음부터 모든 설정을 삭제할 필요가 없습니다.

시스템 프록시가 계속 자동으로 꺼지는 경우

먼저 v2rayN이 비정상적으로 종료되지 않았는지 확인하세요. 코어 연결 실패가 시스템 프록시를 직접 삭제하는 경우는 드물지만, 주 프로그램 종료, 해제 모드로 전환 또는 다른 네트워크 도구가 Windows 프록시 설정을 다시 쓰면 프록시 상태가 바뀔 수 있습니다. 「설정」→「네트워크 및 인터넷」→「프록시」를 열고 v2rayN 모드 전환에 따라 ‘프록시 서버 사용’ 설정이 함께 바뀌는지 확인하세요.

Windows 설정 페이지에 프록시 주소가 올바르게 표시되는데 특정 애플리케이션이 계속 직접 연결된다면 해당 애플리케이션에 별도 프록시 옵션이 있는지 확인하세요. 일부 프로그램은 시작할 때의 시스템 설정을 읽으므로 프로세스를 완전히 종료한 뒤 다시 시작해야 합니다. 또 일부 명령줄 프로그램은 기본적으로 Windows 시스템 프록시를 읽지 않으므로 HTTP 또는 SOCKS 주소를 별도로 지정해야 합니다.

업데이트, 백업 및 일상적인 사용 순서

첫 설정을 완료한 뒤 겉보기 속도를 높이기 위해 여러 매개변수를 자주 바꾸는 것은 권장하지 않습니다. 안정적인 사용은 명확한 업데이트 순서에 더 크게 좌우됩니다. 먼저 설정을 백업하고, 클라이언트 또는 코어를 업데이트한 다음 구독을 업데이트하고, 마지막으로 라우팅 규칙과 실제 연결을 확인하세요. 한 번에 한 항목만 변경해야 문제가 생겼을 때 정확히 되돌릴 수 있습니다.

• 클라이언트 업데이트 전: v2rayN을 종료하고 현재 프로그램 폴더의 설정 데이터를 별도의 백업 폴더에 복사한 뒤 현재 로컬 포트를 기록하세요.
• 프로그램 업데이트 시: 새 패키지와 기존 패키지의 아키텍처가 일치하는지 확인하세요. WPF판과 데스크톱판 파일을 같은 폴더에 직접 섞어 덮어쓰지 마세요.
• 구독 업데이트 후: 활성 서버가 여전히 존재하는지 확인하세요. 서비스 제공자가 기존 노드를 삭제하면 원래 활성 항목을 사용할 수 없게 될 수 있습니다.
• 라우팅 변경 후: 프록시가 필요한 도메인과 직접 연결이 필요한 도메인을 각각 테스트해 규칙이 예상한 아웃바운드 태그에 적용되는지 확인하세요.
• 클라이언트 종료 전: 일반 네트워크로 돌아가려면 먼저 시스템 프록시를 해제한 뒤 주 프로그램을 종료하세요. 이미 작동하지 않는 로컬 프록시 주소가 시스템에 남는 것을 방지할 수 있습니다.

v2rayN은 설정과 제어를 위한 진입점일 뿐이며 실제 연결은 선택한 코어가 처리합니다. VMess, VLESS 등의 프로토콜 매개변수는 노드 또는 구독에서 제공되고, routing 규칙은 트래픽을 프록시 아웃바운드로 보낼지 직접 연결 아웃바운드로 보낼지 결정합니다. 로컬 10808과 10809는 애플리케이션이 보낸 연결을 받습니다. 이 세 계층을 나누어 이해하면 로그의 ‘로컬 수신 실패’, ‘원격 핸드셰이크 실패’, ‘라우팅 규칙이 직접 연결에 적용됨’을 하나의 문제로 혼동하지 않게 됩니다.

첫 설정을 완료한 뒤 버전 번호, 인터페이스 유형, 코어 유형, 로컬 포트와 구독 그룹 이름을 포함한 간단한 기록을 저장해 두세요. 이후 폴더를 변경하거나 프로그램을 업그레이드할 때 이 항목을 하나씩 대조하면 모든 노드를 다시 가져오는 것보다 빠르고, 브라우저 포트와 클라이언트 포트가 달라지는 문제도 방지할 수 있습니다.