v2rayN Windows 설치 가이드: WPF 버전과 크로스 플랫폼 데스크톱 버전 비교 및 설치 문제 해결

Windows용 v2rayN 두 가지 패키지의 차이와 선택 기준을 안내합니다. 압축 해제 위치, 런타임 누락, 백신 오탐, 시작 프로그램 설정 등 설치 중 자주 겪는 문제도 다룹니다.

이 글 핵심 내용

Windows에서만 사용하고 클래식 인터페이스를 계속 쓰고 싶다면 WPF 버전을 선택하세요. 여러 데스크톱 운영체제에서 비슷한 사용 방식을 유지하려면 크로스 플랫폼 데스크톱 버전의 Windows 패키지를 선택하면 됩니다. 처음 설치하거나 패키지를 바꿔 업그레이드할 때는 세 가지를 확인하세요. 메인 화면이 열리는지, 코어가 로컬 포트를 수신 대기하는지, 다시 로그인했을 때 필요한 프로그램 하나만 실행되는지 확인하면 됩니다.

WPF 버전과 크로스 플랫폼 데스크톱 버전, 무엇을 선택할까?

WPF 버전과 크로스 플랫폼 데스크톱 버전은 인터페이스 프레임워크, 배포 패키지, 실행 종속성이 다릅니다. 프록시 프로토콜의 차이가 아닙니다. VMess, VLESS 등의 설정을 사용할 수 있는지는 선택한 코어와 버전, 설정 내용에 따라 달라집니다. 프로토콜 오류가 발생하면 화면에 표시된 버전만 보고 판단하지 말고 먼저 코어 로그를 확인하세요.

WPF 버전

추천

Windows 전용 WPF 인터페이스를 사용합니다. 클래식 버전의 레이아웃에 익숙하다면 시스템 아키텍처에 맞는 WPF 패키지를 우선 선택하세요. 별도로 런타임을 설치해야 하는지는 해당 패키지의 안내와 실제 실행 시 표시되는 메시지를 확인하면 됩니다.

추천 대상: Windows에서만 사용하거나 기존 클래식 인터페이스에서 옮겨 오는 경우

크로스 플랫폼 데스크톱 버전

여러 데스크톱 운영체제에서 비슷한 화면 구성을 제공하지만, 다운로드할 때는 Windows용 패키지를 선택해야 합니다. 크로스 플랫폼이라고 해서 같은 파일을 모든 운영체제에서 실행할 수 있는 것은 아니며, 이전 버전의 설정 폴더를 그대로 함께 사용할 수 있다는 뜻도 아닙니다.

추천 대상: 데스크톱 운영체제를 자주 바꿔 사용하거나 새 레이아웃에 익숙한 경우

Windows에서 「설정」→「시스템」→「정보」로 이동해 「시스템 종류」를 확인하세요. x64 기반 프로세서와 64비트 운영체제가 표시되면 x64를 선택합니다. ARM 기기는 해당 기기용 ARM64 패키지가 있는지 먼저 확인하세요. x64와 ARM64를 같은 종류의 ‘64비트’로 보면 안 됩니다.

설치 및 압축 해제: 먼저 프로그램 폴더를 정하세요

다운로드한 파일이 설치 프로그램이면 설치 화면의 안내를 따르세요. 압축 파일이라면 파일 탐색기에서 전체 압축을 해제해야 합니다. 압축 파일 미리 보기에서 메인 프로그램을 바로 실행하거나 v2rayN.exe만 바탕 화면으로 옮기지 마세요. 메인 프로그램과 코어가 실행될 때 필요한 파일은 서로 다를 수 있습니다. 파일을 빠뜨리면 화면은 열리지만 노드를 선택해도 연결되지 않을 수 있습니다.

  1. 설치 위치 정하기

    파일 탐색기 주소 표시줄에 %LOCALAPPDATA%를 입력한 다음, 아래 예시처럼 별도의 프로그램 폴더에 휴대용 패키지 전체를 압축 해제하세요. 예: %LOCALAPPDATA%\Programs\v2rayN-WPF. 설정 파일을 저장해야 하는 휴대용 패키지는 보호된 시스템 폴더나 동기화 폴더에 두지 마세요. 바탕 화면에는 바로 가기만 두면 됩니다.

  2. 기존 프로세스 확인

    컴퓨터에 v2rayN이 이미 설치되어 있다면 이전 버전의 트레이 메뉴에서 이전 버전이 설정한 시스템 프록시를 해제한 뒤 프로그램을 종료하세요. 창을 닫아도 트레이로 최소화되었을 수 있습니다. 필요한 경우 「작업 관리자」→「세부 정보」에서 기존 v2rayN.exe 프로세스가 종료되었는지 확인하세요.

  3. 메인 프로그램 실행

    새 폴더에서 v2rayN.exe를 실행하거나 설치 프로그램이 만든 바로 가기를 이용하세요. 먼저 프로그램 화면이 정상적으로 열리는지 확인한 뒤 설정을 가져오세요. 런타임 오류가 표시되면 프레임워크 이름, 버전, 아키텍처를 빠짐없이 기록하고 다음 절차에 따라 해결하세요.

  4. 로컬 포트 확인

    메인 화면에서 「설정」→「매개변수 설정」으로 이동해 로컬 수신 대기 포트를 확인하세요. 버전에 따라 이 항목이 「Core: 기본 설정」에 있을 수 있습니다. 기존 설정 중 사용 가능한 항목을 선택한 다음 코어 로그에 포트 충돌이 표시되는지 확인하고, 실제로 포트가 수신 대기 중인지 점검하세요.

두 번 클릭해도 열리지 않을 때: 런타임 누락과 보안 차단 구분하기

오류 창에 .NET을 설치하거나 업데이트해야 한다고 표시되면 Framework, Version, Architecture 항목을 먼저 확인하세요. 메인 프로그램은 열리지만 설정을 활성화한 뒤 특정 코어 파일을 찾을 수 없다는 오류가 발생한다면 전체 압축을 해제했는지, 다운로드 패키지에 필요한 코어가 포함되어 있는지, 해당 파일이 격리되었는지 확인하세요. 두 문제는 해결 절차가 서로 다릅니다.

.NET 런타임 누락

프레임워크 예시
Microsoft.WindowsDesktop.App은 .NET Desktop Runtime에 해당합니다
버전 예시
오류 메시지에 8.0.0이 표시되면 지원되는 해당 8.0 유지 관리 버전을 선택하세요. 더 높은 주 버전이 대체할 수 있다고 단정하지 마세요.
아키텍처 확인
오류 창의 Architecture 항목을 기준으로 선택하세요. 예를 들어 x64를 선택하며 운영체제의 비트 수만 확인해서는 안 됩니다.

Microsoft 공식 경로에서 해당 런타임을 다운로드하세요. 설치한 뒤 프로그램을 다시 실행하고, 오류가 계속되면 메시지를 다시 확인해 어떤 프레임워크가 필요한지 파악하세요.

다운로드 후 위협 경고가 표시될 때

확인 경로
「Windows 보안」→「바이러스 및 위협 방지」→「보호 기록」
확인할 항목
기록을 펼쳐 탐지 이름, 영향을 받은 파일 경로, 처리 상태를 확인하세요
처리 순서
격리 상태를 유지한 채 다운로드 출처와 해당 배포 패키지를 확인하세요. 출처가 불분명하거나 경고가 계속되면 해당 파일의 사용을 중단하세요

오탐으로 의심되면 보안 소프트웨어 제공업체에 판정을 요청할 수 있습니다. 실시간 보호를 끄거나 프로그램 폴더 전체를 검사 제외 목록에 추가하지 마세요.

Microsoft.NETCore.App이 표시되면 .NET Runtime에 해당합니다. Microsoft.WindowsDesktop.App이 표시된 경우 같은 버전의 기본 .NET Runtime만 설치해서는 해결되지 않습니다. 오류 창도 격리 기록도 없다면 「이벤트 뷰어」→「Windows 로그」→「응용 프로그램」을 열고 방금 프로그램을 실행한 시간대의 .NET Runtime 또는 Application Error 기록을 확인하세요. 예외 모듈과 오류 코드를 기록한 뒤 종속성을 설치할지 배포 패키지를 다시 받을지 결정하세요.

화면은 열리지만 웹사이트에 연결되지 않을 때: 포트를 단계별로 확인

먼저 코어가 실행 중인지 확인한 뒤 애플리케이션의 요청이 프록시로 전달되는지 확인하세요. 아래 예시에서는 127.0.0.1:10808을 사용합니다. 실제 포트는 현재 버전의 설정과 로그를 기준으로 확인하세요. 화면에 HTTP와 SOCKS 포트가 각각 표시되면 애플리케이션의 수동 프록시 설정에서 프로토콜과 포트를 모두 일치시켜야 합니다. 연결되는 숫자만 골라 입력해서는 안 됩니다.

127.0.0.1
이 컴퓨터에서 테스트할 때 사용하는 루프백 주소
10808
로컬 수신 대기 포트 예시. 테스트 전에 설정을 확인하세요
8.0
런타임 주 버전 예시이며 모든 배포 패키지의 요구 사항을 뜻하지 않습니다
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
Get-NetTCPConnection -LocalPort 10808 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess
  • TcpTestSucceeded : False: 이번 TCP 테스트에서 해당 주소와 포트에 연결되지 않았습니다. 포트 번호를 확인하고 코어 로그에서 설정 로드 또는 수신 대기 실패가 있는지 점검하세요. 아직 구독을 바꿀 필요는 없습니다.
  • TcpTestSucceeded : True: 해당 주소와 포트로 로컬 TCP 연결을 설정할 수 있다는 뜻이며, 원격 서버에 연결되었다는 의미는 아닙니다. 이전 인스턴스가 포트를 사용 중인 것 같다면 OwningProcess의 값을 「작업 관리자」→「세부 정보」에서 PID와 대조해 어떤 프로세스가 수신 대기 중인지 확인하세요.
  • 예상한 코어가 포트를 수신 대기 중인지 확인한 뒤 트레이 메뉴의 「시스템 프록시」 설정을 살펴보세요. 시스템 프록시를 사용하는 브라우저와 별도 프록시를 설정한 애플리케이션은 서로 다른 경로를 사용할 수 있습니다. 프로그램을 종료한 뒤 평소 직접 연결되던 사이트에도 접속할 수 없다면 Windows의 「설정」→「네트워크 및 인터넷」→「프록시」가 중지된 로컬 포트를 가리키고 있는지 확인하세요. 회사나 기관에서 관리하는 프록시 설정은 먼저 관리자에게 문의하세요.

로컬 포트와 시스템 프록시가 모두 정상인데 특정 사이트에만 접속할 수 없다면 연결 불가 문제 진단으로 이동해 코어 로그와 접속 증상을 바탕으로 계속 확인하세요.

시작 프로그램, 트레이와 업그레이드 관련 자주 묻는 질문

시작 프로그램으로 설정했는데 재부팅 후 창이 열리지 않는 이유는 무엇인가요?

먼저 작업 표시줄의 숨겨진 아이콘 영역에서 v2rayN을 찾은 다음 「작업 관리자」→「세부 정보」에서 프로세스를 확인하세요. 로그인 후 트레이 아이콘은 표시되지만 메인 창이 보이지 않는다면 최소화 상태로 시작했을 가능성이 큽니다. 프로세스도 실행되지 않았다면 v2rayN의 「설정」→「매개변수 설정」에서 「Windows 시작 시 자동 실행」을 껐다가 다시 켜고 저장한 뒤 로그아웃 후 다시 로그인해 테스트하세요. 여기서 확인하는 것은 현재 사용자 로그인 후 실행되는 방식이며, 로그인 전부터 시스템 서비스로 실행되는 방식이 아닙니다.

폴더를 바꿨는데 로그인할 때 이전 버전이 계속 실행되는 이유는 무엇인가요?

먼저 이전 버전에서 자동 실행을 끈 다음 종료하고, 새 버전에서 자동 실행을 켜세요. 이전에 시작 프로그램 바로 가기를 직접 만들었다면 Win + R을 누르고 shell:startup을 입력하세요. 바로 가기 속성의 「대상」을 확인해 이전 폴더를 가리키는 것이 확실한 항목만 삭제하세요. 다시 로그인한 뒤 작업 관리자에서 프로세스를 마우스 오른쪽 버튼으로 클릭하고 「파일 위치 열기」를 선택해 실제 경로를 확인하세요.

업데이트할 때마다 관리자 권한으로 실행해야 하나요?

휴대용 패키지는 평소 일반 사용자 권한으로 실행하세요. 파일을 쓸 수 없다는 메시지가 나오면 먼저 프로그램 폴더와 설정 폴더에 쓰기 권한이 있는지 확인하고, 필요하면 휴대용 패키지를 현재 사용자 폴더로 옮기세요. 런타임이나 설치 프로그램이 권한 상승을 요청하는 경우에는 출처가 확인된 설치 프로그램의 안내를 따르세요. 폴더 권한 문제를 피하려고 메인 프로그램을 항상 관리자 권한으로 실행하도록 설정하지 마세요.

업그레이드 후 목록이 비었는데 구독이 만료된 건가요?

먼저 어떤 프로그램이 실행 중인지 확인하세요. 새 폴더의 화면에 목록이 없다면 다른 설정을 읽고 있는 것일 수 있습니다. 새 버전을 종료하고 이전 버전에서 목록과 구독 그룹이 그대로 있는지 확인하세요. 내보내기나 백업 기능이 있다면 해당 기능으로 먼저 옮기고, 그렇지 않으면 신뢰할 수 있는 출처에서 다시 가져오세요. 이전 후에는 그룹, 현재 선택한 설정, 로컬 포트를 확인한 다음 이전 폴더를 정리하세요.

클라이언트 다운로드