Windows용 v2rayN 설치 및 설정 가이드: 데스크톱 버전과 WPF 버전 비교

Windows용 v2rayN 데스크톱·WPF 버전 비교부터 다운로드, 압축 해제, 구독 가져오기, 시스템 프록시·TUN 설정까지 안내합니다. 백신 차단 등 자주 묻는 문제도 다룹니다.

핵심 내용

Windows에서 v2rayN을 처음 설정한다면 시스템 아키텍처에 맞는 패키지를 고른 뒤 데스크톱 버전과 클래식 WPF 버전 중 하나를 선택하세요. 구독을 가져온 다음에는 로컬 프록시를 직접 테스트하고 시스템 프록시를 켭니다. 대상 앱이 프록시 설정을 따르지 않고 트래픽을 직접 처리해야 할 때만 TUN을 별도로 시험하세요. 이 순서는 버전을 바꾼 뒤 실행 실패, 포트 충돌, 브라우저의 프록시 미적용 문제를 점검할 때도 유용합니다.

Windows용 v2rayN 다운로드: 데스크톱 버전과 WPF 버전 비교

다운로드 페이지의 ‘데스크톱 버전’과 ‘WPF 버전’은 주로 UI 구현 방식과 배포 패키지를 구분하며, 서로 다른 프록시 프로토콜을 뜻하지 않습니다. WPF는 Windows UI 프레임워크를 사용합니다. 연결 여부는 주로 사용 중인 코어, 노드 프로토콜, 전송 설정의 호환성에 달려 있습니다. 노드 연결 실패를 해결하려고 UI 버전을 계속 바꾸지 마세요. WPF 버전이 구형 Windows와의 호환성을 보장하는 것도 아닙니다.

UI 버전 선택 기준

데스크톱 버전: 처음 설치한다면
  • 기존 UI를 계속 써야 할 이유가 없다면 현재 시스템 아키텍처에 맞는 데스크톱 버전 패키지를 선택하세요.
  • 가이드를 따라 설정할 예정이라면 먼저 해당 가이드가 어느 배포 계열을 기준으로 하는지 확인하세요. 버튼 위치가 클래식 UI와 다를 수 있습니다.
WPF 버전: 클래식 Windows UI 유지
  • 클래식 메뉴와 트레이 조작에 익숙하거나 기존 안내 스크린샷을 참고해야 한다면 해당 WPF 배포 패키지를 선택할 수 있습니다.
  • 다른 UI 버전에서 옮기는 경우 기존 프로세스를 종료하고 프로그램과 설정을 각각 별도 위치에 보관하세요. 구독과 라우팅이 정상인지 확인한 뒤 이전 폴더를 정리합니다.

먼저 Windows ‘설정’ → ‘시스템’ → ‘정보’에서 ‘시스템 종류’를 확인한 다음 x64 또는 ARM64 패키지를 고르세요. 해당 아키텍처용 UI 버전이 있는지는 다운로드 페이지에 실제로 표시된 파일을 기준으로 판단합니다.

‘64비트 운영 체제’만으로 패키지를 고르면 안 됩니다. 프로세서 유형도 확인해야 합니다. 경량 패키지와 코어가 함께 제공되는 패키지가 있다면 처음 설정할 때는 코어 포함 패키지를 우선 고려하세요. 경량 패키지를 선택하기 전에는 해당 릴리스 안내를 읽고 별도로 준비해야 할 런타임이나 코어 파일이 있는지 확인합니다.

압축 해제부터 구독 가져오기까지: 순서대로 진행하는 5단계

아래 내용은 흔히 사용하는 v2rayN 7.x 중국어 UI를 기준으로 설명합니다. 세부 버전에 따라 추가 버튼이 그룹 표시줄에 있거나 메뉴 안에 있을 수 있습니다. 스크린샷에서 같은 위치를 찾기보다 먼저 메뉴와 작업 이름을 확인하세요.

  1. 압축 해제 또는 설치

    다운로드 센터에서 Windows 배포 패키지를 선택하세요. 압축 파일은 현재 계정에서 쓸 수 있는 별도 폴더(예: 사용자 폴더 아래 Apps\v2rayN)에 완전히 압축을 푸세요. 압축 프로그램의 미리보기 창에서 실행 파일을 더블 클릭하지 마세요. 설치 파일을 받았다면 설치 마법사를 따르고 압축 파일처럼 다루지 않습니다.

  2. 실행 후 로그 확인

    v2rayN을 실행하고 기본 창의 메시지 영역에서 코어 실행 실패, 파일 누락, 포트 바인딩 실패가 있는지 확인하세요. Windows에서 데스크톱 런타임이 없다고 명확히 안내하면 해당 버전 설명에 따라 아키텍처에 맞는 런타임을 설치합니다. 관리자 권한으로 반복 실행해도 누락된 종속성은 해결되지 않습니다.

  3. 구독 그룹 추가

    ‘구독 그룹’ → ‘구독 그룹 설정’에서 ‘추가’를 선택하거나 그룹 표시줄의 더하기 버튼을 누르세요. 출처를 알아볼 수 있는 이름을 입력하고 구독 주소를 URL 입력란에 붙여넣은 뒤 저장합니다. 구독 주소는 보통 한 번 업데이트해 여러 설정을 가져옵니다. 단일 공유 링크만 있다면 복사한 뒤 ‘서버’ 메뉴에서 ‘클립보드에서 URL 일괄 가져오기’를 선택하세요. 구독 주소 입력란에 넣으면 안 됩니다.

  4. 현재 구독 업데이트

    방금 만든 그룹을 선택하고 ‘구독 그룹’ 메뉴에서 ‘현재 구독 업데이트(프록시 사용 안 함)’를 선택하세요. 메시지 영역의 결과를 확인한 다음 해당 그룹에 노드가 실제로 나타났는지 확인합니다. 검증된 프록시가 이미 있는 경우에만 ‘현재 구독 업데이트(프록시 사용)’로 다시 시도하는 것이 좋습니다.

  5. 노드 선택 및 테스트

    그룹 목록에서 사용할 서버를 선택한 뒤 마우스 오른쪽 버튼을 눌러 ‘활성 서버로 설정’을 선택하세요. 목록에 속도 측정 결과가 있더라도 지연 시간만으로 모든 앱의 인터넷 연결이 보장되는 것은 아닙니다. 다음 단계에서 클라이언트가 실제로 수신 대기하는 포트로 요청을 보내 코어, 노드, 라우팅이 해당 요청을 처리하는지 확인하세요.

시스템 프록시와 TUN: 로컬 포트를 먼저 확인한 뒤 트래픽 처리 방식 전환

‘설정’ → ‘매개변수 설정’을 열고 Core 기본 설정에서 로컬 수신 포트를 확인하세요. 아래 값은 설정을 읽을 때 흔히 볼 수 있는 예시이며, 수동으로 이 값에 맞추라는 뜻은 아닙니다. 혼합 포트는 HTTP와 SOCKS 요청을 모두 받을 수 있습니다. 인바운드가 각각 표시된다면 테스트 도구에서 사용하는 프로토콜에 맞는 포트를 선택하세요.

127.0.0.1
같은 컴퓨터에서 테스트할 때 사용하는 루프백 주소
10808
7.x에서 흔히 사용하는 로컬 혼합 인바운드 포트
10809
일부 구형 이중 인바운드 설정의 HTTP 포트

현재 클라이언트에 혼합 포트가 10808로 표시된다고 가정하고, TUN은 끈 상태로 PowerShell에서 다음 명령을 실행하세요. 실제 포트가 다르면 UI에 표시된 값으로 바꿉니다. 이 테스트는 로컬 SOCKS 인바운드를 직접 지정하므로 Windows 시스템 프록시가 켜져 있는지와 관계없이 동작합니다.

curl.exe --proxy socks5h://127.0.0.1:10808 --max-time 15 -I https://example.com

로컬 테스트가 통과하면 트레이 메뉴에서 ‘시스템 프록시’ → ‘시스템 프록시 자동 설정’을 선택하세요. Windows ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 입력된 주소와 포트를 확인한 뒤 프록시 확장 프로그램이 트래픽을 가로채지 않는 브라우저 창에서 테스트합니다. 시스템 프록시는 설정을 읽는 앱에 프록시 진입점을 알려줄 뿐입니다. 앱의 요청이 코어에 들어온 뒤 직접 연결할지 프록시를 통해 나갈지는 여전히 라우팅 규칙에 따라 결정됩니다.

특정 앱만 프록시를 사용하지 않는다면 먼저 해당 앱에서 HTTP 또는 SOCKS 프록시를 직접 설정할 수 있는지 확인하세요. 가상 네트워크 어댑터로 트래픽을 처리해야 한다면 먼저 ‘시스템 프록시 지우기’를 선택한 다음 기본 창에서 ‘TUN 사용’을 켜고 안내에 따라 권한을 허용한 뒤 대상 앱을 테스트합니다. TUN이 특정 트래픽을 처리하는지는 시스템 라우팅, 제외 항목, 다른 가상 네트워크 어댑터의 영향을 받습니다. 테스트 중 LAN이나 업무 네트워크에 계속 접속할 수 있는지도 확인하세요. 문제가 생기면 TUN을 먼저 끄고 이전 상태로 되돌린 뒤 라우팅을 점검합니다. 두 가지 트래픽 처리 방식을 동시에 바꾸지 마세요.

자주 발생하는 문제: 구독 실패, 백신 차단, 종료 후 인터넷 연결 끊김

업데이트를 눌렀는데 그룹이 비어 있는 이유는 무엇인가요?

먼저 방금 선택한 그룹을 보고 있는지 확인한 다음 업데이트 로그를 읽으세요. 401 또는 403 오류가 표시되면 구독이 만료됐는지, 주소를 빠짐없이 붙여넣었는지 확인하고 필요하면 제공자에게 새 주소를 요청합니다. 시간 초과라면 현재 네트워크에서 구독 서비스에 접속할 수 있는지 확인하거나 검증된 프록시를 통해 업데이트하세요. 한 번 실패했다고 기존 그룹을 삭제하지 마세요. 기존 그룹에 아직 사용할 수 있는 노드가 남아 있을 수 있습니다.

압축을 푼 뒤 실행했더니 코어 파일이 사라졌나요?

먼저 ‘Windows 보안’ → ‘바이러스 및 위협 방지’ → ‘보호 기록’을 열고 차단 시간, 대상 경로, 탐지 이름이 이번 실행과 관련 있는지 확인하세요. 탐지 이유가 명확하지 않다면 격리 상태를 유지하고 다운로드 센터에서 해당 버전을 다시 받으세요. 계속 차단된다면 배포 버전, 파일명, 탐지 이름을 기록해 문의합니다. 실행을 위해 실시간 보호를 끄거나 다운로드 폴더 전체를 제외 항목으로 추가하지 마세요.

브라우저는 되는데 터미널은 왜 연결되지 않나요?

먼저 앞 절의 프록시 명령을 직접 지정하는 방법으로 터미널이 시스템 프록시를 읽지 않는 문제인지 확인하세요. 명령으로는 연결되지만 같은 요청을 직접 실행하면 실패한다면 해당 도구의 프록시 설정을 확인합니다. 도구가 지원하는 프로토콜로 실제 인바운드 포트에 연결하세요. 전체 시스템 환경을 바꾸기보다 현재 터미널 세션이나 해당 도구만 설정하는 것이 좋습니다.

v2rayN을 종료한 뒤 브라우저에서 인터넷이 끊기는 이유는 무엇인가요?

먼저 Windows 프록시 설정이 더 이상 수신 대기하지 않는 로컬 포트를 가리키는지 확인하세요. 정상적으로 종료하기 전에 트레이에서 ‘시스템 프록시 지우기’를 선택하고 TUN을 사용했다면 TUN도 끕니다. 앱이 종료된 뒤에도 시스템에 로컬 프록시 설정이 남아 있다면 Windows 설정에서 실행 전 값으로 복원하세요. 회사 기기에 조직에서 설정한 프록시가 있다면 해당 프록시를 임의로 끄지 마세요.

v2rayN 다운로드