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

v2rayN 데스크톱 버전과 WPF 버전의 차이를 비교하고, 압축 해제부터 첫 실행, 구독 가져오기, 시스템 프록시 설정까지 안내합니다. 백신 오탐과 포트 충돌 해결법도 확인하세요.

핵심 내용

Windows에서 v2rayN을 처음 설정한다면 시스템 아키텍처와 런타임에 맞는 패키지를 고른 뒤, 클라이언트 실행 여부, 구독 업데이트, 노드 선택, 앱의 시스템 프록시 사용 여부를 차례로 확인하세요. 기존 버전에서 옮길 때도 같은 순서로 점검하면 됩니다. 한 번에 한 항목씩 변경하면 문제가 발생한 단계를 찾기 쉽습니다.

데스크톱 버전과 WPF 버전, 무엇을 선택할까요?

여기서 데스크톱 버전은 크로스 플랫폼 UI 프레임워크를 사용하는 배포판이며, WPF 버전은 Windows 전용 WPF UI를 사용합니다. 메뉴 배치와 창, 트레이 아이콘 조작 방식이 다를 수 있습니다. UI 선택은 프로토콜 선택과 별개입니다. 노드 사용 가능 여부는 실제로 실행되는 코어와 설정에 따라 달라지므로 패키지 이름만으로 판단할 수 없습니다.

데스크톱 버전

추천

처음 설치한다면 시스템 아키텍처에 맞는 데스크톱 버전을 먼저 선택해 보세요. 릴리스 안내에 자체 포함 패키지가 있다면 해당 패키지는 보통 별도로 .NET 런타임을 설치하지 않아도 됩니다. 단, 해당 릴리스의 시스템 요구 사항은 충족해야 합니다.

추천 대상: Windows 클라이언트를 새로 설치하며 기존 UI 사용 방식에 익숙하지 않은 경우

WPF 버전

익숙한 Windows UI를 계속 사용하려면 적합합니다. 프레임워크 종속 패키지를 선택했다면 실행 안내와 릴리스 정보를 확인해 호환되는 .NET Desktop Runtime을 설치하세요. 주 버전과 아키텍처도 확인해야 합니다. 일반 .NET Runtime만 설치해서는 WPF 앱의 요구 사항을 충족하지 못할 수 있습니다.

추천 대상: WPF 사용에 익숙하거나 해당 버전의 사용 설명서를 계속 참고하려는 경우

Windows 11에서 「설정」→「시스템」→「시스템 정보」를 열고 「시스템 종류」를 확인하세요. x64 기반 프로세서에는 x64 패키지를, ARM 기반 장치에는 릴리스 페이지에서 제공하는 ARM64 패키지를 우선 선택합니다. 「64비트 운영 체제」라고 해서 반드시 x64인 것은 아닙니다. 자체 포함은 런타임이 패키지에 포함되는지를, 코어 포함은 프록시 코어가 들어 있는지를 뜻하므로 다운로드할 때 각각 확인하세요.

다운로드, 실행 및 구독 가져오기

  1. 알맞은 패키지 다운로드

    다운로드 페이지에서 Windows 클라이언트 항목으로 이동한 다음, 아키텍처와 UI에 맞는 패키지를 선택하세요. 압축 파일은 현재 계정에서 쓸 수 있는 별도 폴더에 완전히 풀어야 합니다. 압축 파일 미리 보기에서 실행하거나 본 프로그램만 바탕 화면으로 옮기지 마세요. 설치 파일은 설치 마법사의 안내에 따르면 됩니다. 압축 해제한 버전을 바탕 화면에서 실행하려면 바로 가기를 만드세요.

  2. 첫 실행

    압축을 푼 폴더에서 v2rayN.exe를 실행하고 기본 창과 트레이 아이콘이 정상적으로 표시되는지 확인하세요. 일반적인 시스템 프록시 테스트는 일반 권한으로 실행하면 되며, 실행을 위해 권한을 높일 필요는 없습니다. 런타임이 없다는 안내가 나오면 오류 내용에 따라 처리하세요. 기본 창은 열리지만 로그에 코어를 찾을 수 없다고 나오면 다운로드한 패키지에 필요한 코어가 포함되어 있는지 먼저 확인하세요. 코어 누락 문제를 UI 런타임 문제와 혼동하지 마세요.

  3. 구독 링크 저장

    기본 창에서 「구독 그룹」→「구독 그룹 설정」을 열고 「추가」 또는 화면의 「+」를 눌러 그룹을 만드세요. 알아보기 쉬운 이름을 입력하고 구독 링크 전체를 주소 입력란에 붙여 넣은 뒤 저장합니다. 빌드에 따라 버튼 위치가 다를 수 있습니다. 구독 주소에는 계정 토큰이 포함되는 경우가 많으므로 스크린샷, 공개 로그, 채팅방에 올리지 마세요.

  4. 현재 구독 업데이트

    방금 만든 그룹을 선택하고 「구독 그룹」 메뉴에서 현재 구독 업데이트를 실행하세요. 주소를 저장하면 그룹만 만들어질 뿐, 노드 목록이 반드시 나타나는 것은 아닙니다. 새로고침한 뒤 로그와 해당 그룹의 목록을 확인하세요. 목록이 비어 있다면 먼저 검색 필터를 지운 다음 로그에서 요청 실패, 빈 응답, 파싱 실패 중 어떤 문제인지 확인합니다.

  5. 노드 선택

    목록에서 사용할 노드를 마우스 오른쪽 버튼으로 클릭하고 「활성 서버로 설정」 또는 이에 해당하는 활성 항목 설정을 선택하세요. 화면에 방금 선택한 노드가 표시되는지 확인합니다. 구독 업데이트 성공은 클라이언트가 설정을 가져왔다는 뜻일 뿐, 모든 노드에 연결할 수 있다는 뜻은 아닙니다. 노드를 바꾼 뒤 코어 실행 오류가 발생하면 먼저 로그를 확인하고, 그다음 시스템 프록시를 켜세요.

시스템 프록시: 브라우저로 먼저 확인하고 TUN은 필요할 때만 사용

트레이 아이콘을 마우스 오른쪽 버튼으로 클릭한 뒤 「시스템 프록시」에서 「시스템 프록시 자동 설정」을 선택하세요. 일부 빌드에서는 이 명령이 트레이 메뉴에 바로 표시됩니다. 그런 다음 Windows의 「설정」→「네트워크 및 인터넷」→「프록시」를 열어 수동 프록시 주소와 포트가 클라이언트의 수신 대기 주소를 가리키는지 확인하세요. 회사나 기관에서 프록시 설정을 관리하는 PC라면 기존 값을 기록하고 관리 지침에 따라 처리하세요. 조직 설정을 덮어쓰지 마세요.

127.0.0.1
원격 노드 주소가 아닌 로컬 루프백 주소
10808
로컬 SOCKS 또는 혼합 수신 포트로 흔히 사용
10809
구형 분리형 설정에서 흔히 사용하는 HTTP 수신 포트

이 포트는 설정을 식별하기 위한 예시이며, 반드시 입력해야 하는 고정값이 아닙니다. v2rayN의 「설정」→「매개변수 설정」에서 로컬 수신 포트를 확인하고, 시작 로그를 함께 살펴 혼합 수신인지 분리 수신인지 판단하세요. Windows 수동 프록시는 SOCKS만 지원하는 수신 포트를 지정할 수 없습니다. 이전 가이드에 10809가 나와 있지만 현재 버전에서 HTTP를 지원하는 혼합 포트를 사용한다면 현재 설정을 따르세요.

실행 실패, 구독 시간 초과 및 포트 충돌

보안 프로그램이 파일을 격리했습니다. 오탐일까요?

먼저 「Windows 보안」→「바이러스 및 위협 방지」→「보호 기록」을 열어 탐지 이름, 발생 시각, 격리된 파일 경로를 확인하세요. 기본 프로그램과 패키지에 포함된 코어는 별도 파일이므로 어떤 파일이 차단됐는지 파악해야 합니다. 프로그램이 실행된다는 이유만으로 오탐이라고 단정하지 말고, 보호 기능을 끄거나 폴더 전체를 제외 항목에 추가하지 마세요. 출처를 확인할 수 없거나 경고가 계속되면 실행을 중단하고 재검토를 요청하세요.

로그에 포트 사용 중이라고 나옵니다. 무엇을 바꿔야 하나요?

먼저 오류에 표시된 로컬 수신 포트를 기록하세요. 예를 들어 10808을 사용 중인 프로세스는 PowerShell에서 확인할 수 있습니다. 출력의 OwningProcess 값은 작업 관리자의 「세부 정보」 탭에 있는 PID와 대조하면 됩니다. 이전 v2rayN 인스턴스가 사용 중이라면 트레이 메뉴에서 정상적으로 종료하세요. 다른 프로그램이 사용 중인 포트라면 「설정」→「매개변수 설정」에서 v2rayN의 충돌 포트를 바꾸고 코어를 다시 시작합니다. 그런 다음 시스템 프록시를 다시 적용하세요. 프록시 포트를 별도로 입력한 앱도 함께 수정해야 합니다.

Get-NetTCPConnection -State Listen -LocalPort 10808 |
  Select-Object LocalAddress, LocalPort, OwningProcess

구독 업데이트 시간 초과, 재설치가 도움이 될까요?

먼저 구독 주소의 누락이나 불필요한 공백을 확인한 뒤 「구독 그룹」에서 현재 구독 업데이트를 다시 시도하세요. 사용 가능한 노드가 있다면 해당 메뉴의 프록시를 통한 업데이트 옵션도 테스트할 수 있습니다. 사용 가능한 노드가 하나도 없다면 프록시를 통한 업데이트를 선택해도 최초 연결은 성립하지 않습니다. 로그에 HTTP 401 또는 403이 표시되면 계정과 구독 권한부터 확인하세요. 로컬 포트를 계속 바꿀 필요는 없습니다.

WPF 버전으로 바꾼 뒤 기존 그룹이 보이지 않는 이유는 무엇인가요?

새 폴더에 압축을 풀어 별도로 실행하면 새 인스턴스가 이전 인스턴스의 설정을 읽지 않을 수 있습니다. 먼저 기존 클라이언트를 종료하고 설정 폴더를 백업한 다음, 새 인스턴스에서 구독을 다시 추가하세요. 수동으로 추가한 노드는 별도로 옮겨야 합니다. 버전 차이가 큰 경우 프로그램 폴더 전체를 그대로 덮어쓰지 마세요. 이전 코어와 설정이 새 버전에 섞일 수 있습니다. 새 인스턴스에서 구독 업데이트와 코어 실행이 독립적으로 되는 것을 확인한 뒤 기존 폴더를 삭제하세요.

v2rayN 다운로드