v2rayN Windows 설치 및 설정 가이드: 데스크톱 버전과 WPF 버전 비교, 자주 하는 실수

이 글 미리 보기

Windows 설정 순서: 시스템 아키텍처에 맞춰 데스크톱 버전 또는 WPF 버전을 선택하고, 압축 해제와 구독 업데이트, 활성 서버 선택을 마친 뒤 로컬 프록시와 시스템 프록시, 라우팅을 확인합니다. 처음 설치하거나 설정을 이전하는 사용자를 위한 안내입니다. 포트는 구체적인 예시로 설명하며, 예시 값을 모든 버전의 기본값으로 간주하지 않습니다. 기본 연결을 확인하지 않은 채 TUN을 켜는 것도 권장하지 않습니다.

버전 선택: 데스크톱 버전과 WPF 버전 비교

인터페이스 선택: v2rayN 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 Windows 전용으로 기존 데스크톱 방식의 조작 환경을 유지합니다. 두 버전의 주된 차이는 인터페이스와 실행 환경이며, 특정 인터페이스를 선택한다고 노드 속도가 자동으로 빨라지는 것은 아닙니다. 실제 연결 상태는 노드 설정, 선택한 코어, 네트워크 및 서버 상태에 따라 달라집니다.

데스크톱 버전

WPF 버전

기존 작업 방식 유지: 클래식 Windows 인터페이스에 익숙하고 기존 조작 방식을 계속 사용하고 싶다면 선택하세요. 설치 전에는 패키지에 필요한 실행 환경이 포함되어 있는지 확인해야 합니다. WPF라는 이름만 보고 종속 환경을 별도로 설치해야 하는지 판단하지 마세요.

추천 대상: 클래식 인터페이스에 익숙하고 Windows의 기존 작업 흐름에 맞춰 설정을 관리하는 사용자

아키텍처 확인: Windows에서 「설정」→「시스템」→「정보」를 열어 ‘시스템 종류’를 확인하세요. 일반적인 Intel 또는 AMD 64비트 기기는 x64를, ARM 기기는 다운로드 페이지에 안내된 ARM64 패키지를 우선 선택합니다. ‘64비트’를 x64와 같은 의미로 간주하지 말고, 인터페이스가 실행된다는 이유로 코어 실행 파일의 아키텍처 요구 사항을 무시하지 마세요.

다운로드 및 실행: 쓰기 가능한 프로그램 폴더 만들기

파일 준비: 이 사이트의 설치 파일 페이지에서 Windows용 패키지를 선택하세요. 압축 파일은 완전히 풀고, 설치 프로그램은 안내에 따라 설치해야 합니다. 압축 프로그램의 미리 보기에서 실행 파일을 바로 더블 클릭하면 코어, 데이터 파일, 상대 경로를 정상적으로 불러오지 못할 수 있습니다.

아키텍처 확인

시스템 정보: 「설정」→「시스템」→「정보」를 열어 시스템 종류를 확인한 다음, 이에 맞는 데스크톱 버전 또는 WPF 버전 설치 패키지를 선택하세요.
압축 파일 완전히 풀기

폴더 권한: 압축 파일은 사용자가 쓸 수 있는 별도 폴더(예: D:\Tools\v2rayN)에 푸세요. 실행 파일만 따로 복사하거나 이전 버전의 코어 파일을 함께 넣지 마세요.
처음 실행

프로그램 실행: 압축을 푼 폴더에서 v2rayN.exe를 실행하세요. 실행 환경이 없다는 오류가 뜨거나 파일을 불러올 수 없다면, 먼저 실행 오류를 해결한 뒤 구독을 설정하세요.
로그 보관

문제 해결을 위한 확인: 메인 화면이 표시되는지 확인하고 로그를 살펴보세요. 첫 연결을 확인할 때는 TUN을 켜지 말고 v2rayN을 여러 개 실행하지 마세요. 포트 충돌이나 프록시 설정 덮어쓰기가 발생할 수 있습니다.

권한 안내: 일반적인 시스템 프록시 사용에는 항상 관리자 권한으로 실행할 필요가 없습니다. TUN은 가상 네트워크 어댑터나 관련 서비스를 사용하므로 현재 버전의 안내에 따라 권한을 설정하세요. 오류를 피하려고 시스템 보호 기능을 계속 꺼 두지 마세요. 조직에서 관리하는 기기의 권한이 제한되어 있다면 먼저 관리 정책을 확인하세요.

구독 가져오기: 업데이트 주소와 연결 노드 구분하기

구독 메뉴: 메인 화면에서 「구독 그룹」→「구독 그룹 설정」으로 이동해 그룹을 추가하고 알아보기 쉬운 이름을 입력하세요. 구독 주소 입력란에 전체 링크를 붙여 넣고 저장한 다음 메인 화면으로 돌아옵니다. 구독 주소에는 대개 액세스 토큰이 포함되므로 스크린샷, 공개 문의 게시물, 채팅방에 공유하지 마세요.

업데이트 순서: 「구독 그룹」 메뉴에서 먼저 ‘프록시 사용 안 함’으로 구독을 업데이트하세요. 구독 서버에 프록시를 통해서만 접속할 수 있다면, 먼저 사용 가능한 노드를 확인한 뒤 ‘프록시 사용’을 선택해야 합니다. 구독 주소만 있고 연결 가능한 노드가 없는 상태에서 프록시 업데이트를 선택해도 연결이 자동으로 설정되지는 않습니다.

목록이 비어 있음: 업데이트 로그에서 요청 실패인지 형식 파싱 실패인지 확인하세요. 로그인 페이지로 돌아가거나 구독이 만료된 경우, 복사할 때 공백이 포함된 경우에도 노드 목록이 생성되지 않을 수 있습니다.
단일 링크: vmess:// 또는 vless:// 형식의 노드 공유 링크를 받았다면 「서버」→「클립보드에서 URL 일괄 가져오기」 등 해당 가져오기 메뉴를 사용하세요. 구독 업데이트 주소로 입력하면 안 됩니다.
활성 서버: 가져온 뒤 노드를 선택하고 마우스 오른쪽 버튼을 눌러 활성 서버로 지정하세요. 메인 화면의 활성 항목이 바뀌었는지도 확인해야 합니다. 목록에 노드가 표시되는 것만으로 해당 노드로 전환된 것은 아닙니다.
자동 업데이트: 「구독 그룹 설정」에서 현재 버전의 자동 업데이트 항목과 단위를 확인하세요. 자주 업데이트한다고 연결 속도가 빨라지지는 않습니다. 업데이트에 실패하면 링크와 업데이트에 사용된 네트워크 경로부터 확인하세요.

설정 보존: 직접 추가한 노드와 구독 노드는 가급적 따로 관리하세요. 구독을 업데이트하면 해당 그룹의 항목이 다시 구성될 수 있습니다. 구독으로 생성된 노드의 설정을 직접 바꾸면 다음 업데이트 때 덮어써질 수 있으므로, 임시로 시험할 때는 별도 그룹에 복사하고 기존 값을 기록해 두세요.

코어와 노드: 항목을 확인한 뒤 연결 시작하기

코어 확인: v2rayN은 관리 인터페이스이며 실제 프로토콜은 코어가 처리합니다. 「설정」→「매개변수 설정」에서 Core 유형 관련 설정을 확인하고, 시작 로그에 표시된 실제 코어를 기준으로 삼으세요. VLESS와 REALITY 설정에는 해당 기능을 지원하는 Xray 코어가 필요합니다. 클라이언트 이름, 프로토콜 이름, 코어 이름을 혼동하지 마세요.

VLESS + REALITY 확인 항목

코어: 해당 설정을 지원하는 Xray
서버 포트: 서버에서 안내한 값 입력
serverName: 서버에서 안내한 이름 입력
공개 키 및 shortId: 서버 요구 사항에 맞게 설정
flow: 서버에서 요구하는 경우에만 xtls-rprx-vision 사용

항목 일치 여부: 구독에서 가져온 전송 방식, 보안 계층, 지문 설정을 임의로 바꾸지 마세요. 프로토콜 이름이 같아도 노드마다 설정값은 다를 수 있습니다.

VMess + WebSocket + TLS 확인 항목

사용자 ID: 서버 설정과 일치
전송 방식: WebSocket
경로: 서버 경로에 맞게 입력하고 대소문자 구분
Host: 리버스 프록시 또는 서버 요구 사항에 맞게 입력
TLS 이름: 인증서 및 서버 요구 사항에 맞게 설정

이름 구분: 연결 주소, WebSocket Host, TLS serverName은 서로 다를 수 있지만 각각 서버 구성에 맞아야 합니다. 모두 같은 값으로 일괄 입력하지 마세요.

시간 동기화: Windows에서 「설정」→「시간 및 언어」→「날짜 및 시간」으로 이동해 시스템 시간이 정확한지 확인하고 동기화하세요. 시간 오차는 인증서 유효 기간 확인이나 일부 프로토콜 인증에 영향을 줄 수 있습니다. TLS 오류가 발생하면 인증서 검증을 건너뛰기 전에 시간, 이름, 인증서 체인부터 확인하세요.

시스템 프록시: 지정한 포트로 로컬 연결 확인하기

로컬 연결 지점: 「설정」→「매개변수 설정」에서 기본 설정의 로컬 수신 포트와 LAN 연결 허용 옵션 등을 확인하세요. 아래에서는 설정된 로컬 혼합 인바운드의 예시로 127.0.0.1:10808을 사용합니다. 해당 인바운드가 HTTP와 SOCKS를 모두 지원하는지 확인한 뒤에만 각 방식의 테스트에 사용하세요. 실제 값은 현재 설정과 시작 로그를 기준으로 확인해야 합니다.

127.0.0.1

로컬 루프백 주소이며 원격 노드 주소가 아님

10808

이 문서에서 사용하는 로컬 혼합 인바운드 포트 예시

443

원격 TLS 포트 예시이며 로컬 포트를 대신할 수 없음

프록시 켜기: 코어가 정상적으로 시작되었는지 확인한 다음 메인 화면 하단이나 시스템 트레이 메뉴의 「시스템 프록시」에서 「시스템 프록시 자동 설정」을 선택하세요. 이 설정은 Windows 프록시 설정을 변경하며, 주로 해당 설정을 따르는 앱에 적용됩니다. 명령줄 도구, 게임, 별도의 네트워크 구성 요소는 따로 설정해야 할 수 있으며 모든 트래픽이 자동으로 프록시를 통과하는 것은 아닙니다.

# PowerShell: 예시 로컬 포트에서 수신 중인지 확인
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808

# 시스템에 curl.exe가 있고 해당 포트가 HTTP 프록시를 지원하는 경우 테스트
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 --head https://v2raymark.com/

결과 해석: TcpTestSucceeded가 True이면 해당 포트에 TCP 연결을 설정할 수 있다는 뜻일 뿐, 노드가 정상 작동한다는 의미는 아닙니다. 다른 프로세스가 포트를 사용 중일 수도 있습니다. 위 요청에서 HTTP 상태가 반환되면 응답을 받은 것이지만, 원격 노드를 거쳤는지는 라우팅 규칙과 로그를 함께 확인해야 합니다. 규칙에 따라 직접 연결된 경우에도 요청이 성공할 수 있습니다.

포트 연결 거부: 코어가 종료되었는지, 설정 파일 생성에 실패했는지, 수신 포트가 예시와 다른지 먼저 확인하세요.
명시적 프록시 연결 성공: 명령은 성공하지만 브라우저에서 연결되지 않는다면 브라우저 자체의 프록시 설정, 확장 프로그램, Windows 시스템 프록시 설정이 서로 충돌하는지 확인하세요.
네트워크 노출: 로컬 기기에서만 사용할 경우 문제 해결을 위해 ‘LAN 연결 허용’을 함부로 켜지 말고, 프록시 수신 포트를 인터넷에 직접 노출하지 마세요.

라우팅과 TUN: 기본 연결을 확인한 뒤 범위 확장하기

라우팅 선택: 메인 화면의 「라우팅」 메뉴에서 용도에 맞는 규칙을 선택한 다음 「설정」→「라우팅 설정」에서 세부 내용을 확인하세요. 규칙은 대개 순서대로 적용되므로 앞선 규칙이 먼저 일치하면 뒤의 규칙은 적용되지 않을 수 있습니다. ‘LAN 우회’, ‘직접 연결’, ‘프록시’는 트래픽이 향하는 경로를 설명하는 것이지 노드 품질을 나타내는 등급이 아닙니다.

설정 계층	결정하는 항목	첫 번째 확인 사항
시스템 프록시	시스템 설정을 따르는 앱이 요청을 로컬 프록시로 전달하는지 여부	브라우저와 Windows 프록시 설정이 일치하는지
라우팅 규칙	코어에 전달된 트래픽을 직접 연결, 프록시 또는 차단 중 어디로 보낼지	규칙 적용 순서, 대상 도메인, 최종 아웃바운드
DNS	도메인 확인 방식과 규칙에서 사용할 수 있는 도메인 정보	이름 확인 경로가 예상한 아웃바운드와 함께 작동하는지
TUN	가상 네트워크 어댑터로 설정에 맞는 네트워크 트래픽을 가로채기	권한, 네트워크 어댑터, 라우팅, DNS 가로채기 상태

TUN 사용 시점: 시스템 프록시를 따르지 않는 앱의 트래픽을 가로채야 할 때만 켜세요. 먼저 TUN을 끈 상태에서 활성 노드 하나를 명시적 프록시로 연결해 정상 접속을 확인하세요. 그다음 TUN을 켜고 대상 앱을 테스트하면 노드 문제와 가상 네트워크 어댑터, DNS, 시스템 라우팅 문제를 구분하기 쉽습니다.

우회 설정 확인: 일반 웹페이지가 열린다고 해서 모든 도메인이 동일한 아웃바운드로 연결되는 것은 아닙니다. 일부 사이트만 열리지 않는다면 대상 도메인에 어떤 규칙이 적용됐는지 확인한 다음 DNS와 원격 연결 로그를 살펴보세요. DNS, 라우팅, 코어, 노드를 동시에 바꾸면 어떤 변경이 영향을 줬는지 판단하기 어렵습니다.

LAN 접속: 프린터, 공유 폴더, 로컬 서비스에 접속해야 한다면 사설 네트워크 대역이 예상대로 프록시를 우회하는지 확인하세요.
도메인별 라우팅: IP 규칙과 도메인 규칙은 서로 다른 정보를 사용합니다. 규칙 이름만 보고 실제로 일치하는 항목을 단정하지 마세요.
세부 설정: DNS나 규칙 순서를 조정하려면 고급 사용법을 참고하세요. 먼저 규칙 항목의 의미를 파악한 뒤 수정하는 것이 좋습니다.

자주 발생하는 문제: 증상별로 확인하고 복구 방법 유지하기

문제 해결 순서: 프로그램과 코어가 정상적으로 실행되는지 확인한 다음 로컬 포트, 구독 내용, 활성 서버, 시스템 프록시, 라우팅 순으로 점검하세요. 로그에 표시되는 ‘연결 거부’, ‘시간 초과’, ‘TLS 핸드셰이크 실패’는 각기 다른 단계의 오류이므로 모두 클라이언트 재설치로 해결하려고 해서는 안 됩니다.

프로그램을 더블 클릭해도 창이 뜨지 않으면 계속 다시 실행해야 하나요?

프로세스 확인: 시스템 트레이와 작업 관리자를 먼저 확인하세요. 프로그램이 이미 실행 중이거나 최소화되어 있을 수 있습니다. 실제로 실행에 실패했다면 압축 파일을 완전히 풀었는지, 패키지 아키텍처가 맞는지, 실행 환경 안내를 처리했는지, 보안 소프트웨어가 필요한 파일을 격리했는지 확인하세요. 계속 실행하면 중복 실행이나 포트 점유가 발생할 수 있습니다.

구독 업데이트는 성공했는데 모든 웹페이지가 열리지 않으면 어떻게 해야 하나요?

단계별 확인: 구독 업데이트 성공은 구독 내용을 가져와 파싱했다는 뜻일 뿐입니다. 활성 서버가 지정되어 있는지, 해당 코어가 정상적으로 시작되었는지, 로컬 포트에서 수신 중인지 확인한 다음 명시적 프록시 요청을 테스트하세요. 로그에 원격 연결 시간 초과가 표시되면 서버 주소와 포트, 현재 네트워크에서의 접속 가능성을 추가로 확인하세요.

v2rayN을 종료한 뒤 브라우저에서 인터넷에 연결되지 않으면 어떻게 해야 하나요?

프록시 복구: 시스템 트레이의 「시스템 프록시」에서 「시스템 프록시 지우기」를 실행한 다음 종료하세요. 프로그램이 비정상 종료되었다면 Windows 「설정」→「네트워크 및 인터넷」→「프록시」를 열어 로컬 포트를 가리키는 수동 프록시가 남아 있는지 확인하세요. 이번 설정으로 남은 항목만 되돌리고, 조직에서 일괄 적용한 프록시 정책은 관리자에게 확인해야 합니다.

업그레이드할 때 실행 중인 폴더에 새 파일을 바로 덮어써도 되나요?

업그레이드 및 이전: 먼저 시스템 프록시를 지우고 프로그램을 완전히 종료한 뒤 설정과 구독 정보를 백업하세요. 이후 새 패키지의 안내에 따라 업그레이드합니다. 인터페이스나 주요 버전이 바뀌는 경우 프로그램에서 제공하는 백업, 복원, 가져오기 기능을 우선 사용하세요. 이전 버전과 새 버전의 데이터베이스 및 코어 폴더를 섞지 마세요. 복구 가능한 백업을 보관하고 이전 후 로컬 포트와 활성 서버를 다시 확인하세요.

설정 완료 기준: 클라이언트가 실행되고, 구독이 파싱되며, 활성 서버가 지정되고, 로컬 인바운드에 연결할 수 있으며, 대상 요청이 예상한 경로로 나가야 설치와 설정이 완료된 것입니다. 이후에는 인터페이스 유형, 시스템 아키텍처, 사용 코어, 변경한 항목을 기록해 두면 됩니다. 문의할 때는 구독 주소, 사용자 ID 등 민감한 설정을 가리세요.