· 플랫폼 가이드 · 약 10분

v2rayN Windows 설치 및 설정 가이드: WPF와 Desktop 버전 선택

Windows용 v2rayN 설치부터 압축 해제, 첫 실행, 구독 가져오기, 시스템 프록시 설정까지 안내합니다. 한글 경로, 권한, 포트 충돌 등 자주 발생하는 문제도 정리했습니다.

이 글의 핵심 내용

v2rayN을 처음 설치한다면 Windows 아키텍처에 맞는 버전과 인터페이스 패키지를 선택한 뒤, 압축 파일을 완전히 풀고 구독 업데이트와 로컬 수신 포트를 확인하세요. 이 글에서는 프로그램 실행 → 노드 가져오기 → 코어 연결 → 앱에서 프록시 사용 순서로 살펴봅니다. 설치는 마쳤지만 웹페이지가 열리지 않는 경우에도 어느 단계에서 문제가 생겼는지 확인할 수 있습니다.

1. WPF와 Desktop 버전, 무엇을 선택할까?

v2rayN은 노드, 구독, 프록시 설정을 관리하는 데스크톱 인터페이스이며 실제 연결은 코어가 처리합니다. WPF와 Desktop은 주로 인터페이스 기술과 실행 환경이 다를 뿐, 프록시 프로토콜이 다른 것은 아닙니다. 어느 버전을 선택해도 연결 속도가 저절로 빨라지는 것은 아닙니다. Desktop은 크로스 플랫폼 인터페이스를 사용하고 WPF는 기존 Windows 인터페이스를 유지합니다. 지원 프로토콜은 패키지에 포함된 코어와 버전에 따라 달라집니다.

Desktop 버전

추천

처음 설치한다면 Desktop 버전부터 사용해 보세요. 다운로드 페이지의 안내에 따라 Windows 아키텍처와 실행 환경 요구 사항을 확인하면 됩니다. 크로스 플랫폼 인터페이스와 WPF는 메뉴 배치가 다를 수 있으므로, 오래된 가이드를 참고할 때는 화면을 그대로 따라 하기보다 설정 항목의 의미를 기준으로 찾아보세요.

추천 대상: 새로 설치하는 사용자, 크로스 플랫폼 인터페이스를 사용해도 괜찮은 Windows 사용자

WPF 버전

기존 Windows 인터페이스가 익숙하다면 WPF를 선택할 수 있습니다. 실행할 때 필요한 프레임워크가 없다는 메시지가 표시되면 해당 배포 패키지가 요구하는 .NET Desktop Runtime과 프로세서 아키텍처를 확인하세요. 이름이 비슷한 일반 런타임을 설치하는 것만으로는 해결되지 않을 수 있습니다.

추천 대상: 기존 인터페이스 사용 방식에 익숙하거나 현재 작업 흐름을 그대로 이어 가려는 사용자

다운로드 전에 Windows의 「설정」→「시스템」→「정보」에서 시스템 종류를 확인하세요. x64와 ARM64는 다운로드 페이지와 패키지 안내에 맞춰 선택해야 합니다. 기기 브랜드만 보고 판단하지 마세요. 다운로드 링크는 클라이언트 다운로드 페이지에서 확인할 수 있습니다. 이 글에서는 특정 버전을 지정하지 않으며, 하나의 런타임 버전이 모든 배포 패키지에 필요하다고 가정하지 않습니다.

2. 압축을 완전히 풀고 처음 실행하기

압축 파일로 배포된 버전은 먼저 모든 파일을 추출한 다음 v2rayN.exe를 실행해야 합니다. 압축 프로그램 안에서 실행하거나 이 파일 하나만 복사하면 종속 파일, 코어 또는 리소스가 빠질 수 있습니다. 현재 계정에서 쓸 수 있는 고정 폴더를 권장합니다. 예를 들어 D:\Tools\v2rayN을 사용할 수 있으며, D 드라이브가 없다면 사용자 폴더 아래에 별도 폴더를 만드세요.

  1. 패키지 종류 확인

    다운로드 페이지에서 Windows용 Desktop 또는 WPF를 선택하고 아키텍처 및 실행 환경 안내를 확인한 다음 다운로드해 압축을 푸세요.

  2. 파일 전체 추출

    파일 탐색기에서 압축 파일을 마우스 오른쪽 버튼으로 클릭하고 「모두 압축 풀기」를 선택하세요. 압축 파일을 연 상태에서 프로그램을 실행하거나 서로 다른 인터페이스 패키지를 같은 폴더에 덮어쓰지 마세요.

  3. 프로그램 실행

    압축을 푼 폴더에서 v2rayN.exe를 실행하세요. 일반적인 시스템 프록시 사용에는 보통 권한으로 실행하면 됩니다. 오류가 발생하면 전체 오류 메시지와 로그를 보관하세요.

  4. 수신 설정 확인

    「설정」→「매개변수 설정」을 열고 로컬 수신 주소와 포트 관련 항목을 찾아 현재 값을 기록하세요. 인터페이스 패키지에 따라 설정 위치가 다를 수 있습니다.

  5. 설정 저장 확인

    설정을 저장한 뒤 정상적으로 종료하고 다시 실행해 설정이 유지되는지 확인하세요. 실행할 때마다 초기값으로 돌아간다면 폴더 쓰기 권한이 있는지, 다른 위치의 프로그램을 실행하고 있지는 않은지 먼저 살펴보세요.

한글 경로라고 해서 무조건 문제 원인으로 볼 필요는 없습니다. 일부 외부 구성 요소에서 경로를 처리하는 데 영향을 줄 수 있지만, 먼저 로그에 경로 오류나 파일 읽기 오류가 있는지 확인하세요. 검증이 필요하면 프로그램을 종료하고 전체 폴더를 영문으로 된 짧은 경로에 복사해 실행해 보세요. 구독과 설정을 복구할 수 있도록 원래 폴더는 보관하세요. 네트워크 공유 폴더, 동기화 폴더, 시스템 보호 폴더는 쓰기 권한이나 파일 잠금 문제를 일으킬 가능성이 더 큽니다.

3. 구독 가져오기와 노드 선택

구독 주소는 노드 목록을 가져오는 주소이며, 개별 노드 공유 링크와는 다릅니다. 먼저 전체 구독 URL을 받았는지 확인한 다음 「구독 그룹」→「구독 그룹 설정」으로 이동해 그룹을 추가하고 별칭과 주소를 입력한 뒤 저장하세요. 현재 인터페이스에서 추가 버튼이 “+”로 표시되더라도, 서버 설정이 아니라 구독 그룹을 추가하는 기능입니다.

V2Ray 프로토콜은 제공업체가 전달한 노드 매개변수와 현재 코어의 지원 여부를 기준으로 선택해야 합니다. VLESS, VMess, TLS, 전송 방식 등의 항목을 보더라도 ‘최적화’를 이유로 서버 주소, 포트, 사용자 ID 또는 서버 이름을 임의로 바꾸지 마세요. 서버 설정과 일치해야 합니다. 구독을 다시 업데이트하면 직접 수정한 노드 설정이 덮어써질 수도 있습니다.

4. 시스템 프록시와 로컬 포트 확인

활성 노드를 확인한 뒤 v2rayN의 「시스템 프록시」 메뉴에서 「시스템 프록시 자동 설정」을 선택하고, 시스템 프록시 설정을 따르는 브라우저로 테스트하세요. 이 설정은 Windows 프록시 설정을 변경하지만 모든 프로그램이 이를 사용하는 것은 아닙니다. 터미널 도구, 게임 또는 프록시 설정을 별도로 관리하는 앱은 각각 설정해야 할 수 있습니다.

10808
아래의 로컬 포트는 예시입니다. 실제 설정값을 확인하세요.
443
HTTPS 기본 포트이며 노드 공통 포트가 아닙니다
1–65535
사용 가능한 포트 번호 범위

로컬 수신 포트와 원격 서버 포트는 서로 다릅니다. 아래에서는 127.0.0.1:10808을 예시로 사용하지만 배포 버전이나 기존 설정에 따라 포트가 다를 수 있으며 HTTP, SOCKS, 혼합 수신 포트를 따로 사용할 수도 있습니다. 아래 명령을 사용하기 전에 해당 포트가 HTTP 프록시 요청을 받는지 확인하세요. SOCKS 전용 포트를 HTTP 프록시로 지정하면 안 됩니다.

curl.exe --proxy http://127.0.0.1:10808 --head --max-time 15 https://example.com/

이 명령은 프록시를 명시적으로 지정하므로 터미널이 Windows 시스템 프록시를 읽는지에 영향을 받지 않습니다. 브라우저에서는 실패하지만 명령은 성공한다면 브라우저 확장 프로그램, 사용자 지정 프록시, 우회 규칙을 확인하세요. 브라우저에서는 성공하지만 터미널에서는 실패한다면 도구 자체의 프록시 옵션이나 환경 변수를 살펴보세요. 프록시를 사용하지 않을 때는 클라이언트에서 먼저 「시스템 프록시 지우기」를 선택한 뒤 프로그램을 종료하세요. Windows에 이미 중지된 주소가 남는 것을 방지할 수 있습니다.

5. V2Ray 노드 속도 측정과 연결 확인

V2Ray 노드 속도는 지연 시간 숫자 하나만 보고 판단할 수 없습니다. TCP 연결 테스트, 실제 요청 테스트, 다운로드 속도 테스트는 각각 측정 대상이 다릅니다. TCP 연결에 성공해도 인증이 성공한 것은 아니며, 지연 시간이 낮다고 지속 전송 속도가 빠른 것도 아닙니다. 처음 설정할 때는 서버 목록의 오른쪽 클릭 메뉴에서 ‘실제 연결’ 또는 ‘지연 시간’이 포함된 테스트 항목을 선택한 다음, 브라우저로 접속 가능한 페이지를 열어 보세요.

테스트 결과확인할 수 있는 내용다음 단계
TCP 테스트 성공, 실제 요청 실패서버 포트에는 연결될 수 있지만 인증과 전송은 확인되지 않음사용자 매개변수, TLS 서버 이름, 코어 로그 확인
실제 요청 성공, 브라우저 접속 실패노드는 사용할 수 있지만 앱의 프록시 경로가 일치하지 않을 수 있음시스템 프록시, 브라우저 확장 프로그램, 우회 목록 확인
일부 도메인은 접속되지만 다른 도메인은 접속되지 않음라우팅, DNS 또는 대상 사이트 제한이 원인일 수 있음규칙 적용 여부와 대상 도메인의 DNS 조회 결과 확인
모든 노드에서 로컬 수신 실패 표시원격 노드보다 공통 로컬 환경을 먼저 확인할 필요가 있음포트 점유, 프로세스 상태, 파일 권한 확인

노드를 비교할 때는 동일한 테스트 대상, 라우팅 모드, 네트워크 환경을 유지하세요. 먼저 소수의 후보만 테스트해 대량 동시 요청으로 인한 제한을 피하세요. 다운로드 속도 측정은 데이터 사용량이 크게 늘 수 있으므로 구독 용량이 제한되어 있다면 제공업체의 요금 안내를 먼저 확인하세요. 간헐적인 변동은 반복 측정할 수 있지만, 한 번의 결과를 노드의 고정 성능으로 간주하지 마세요.

6. 시스템 프록시와 v2rayN TUN 모드

v2rayN TUN 모드는 가상 네트워크 인터페이스로 규칙에 맞는 트래픽을 처리하며, 시스템 프록시와 적용 범위가 다릅니다. 처음 설치할 때는 먼저 시스템 프록시가 작동하는지 확인하세요. 시스템 프록시를 따르지 않는 앱이 있거나 더 많은 트래픽을 처리해야 할 때 TUN을 고려하면 됩니다. 이렇게 하면 노드 문제와 가상 인터페이스, 라우팅, DNS 문제를 구분하기 쉽습니다.

앱의 시스템 프록시 지원 여부에 따라 선택

시스템 프록시
  • 「시스템 프록시」→「시스템 프록시 자동 설정」부터 시작하세요.
  • 시스템 프록시를 따르는 브라우저와 앱에 적합합니다.
  • 보통 프로그램을 관리자 권한으로 실행할 필요가 없습니다.
  • 터미널에서는 프록시를 명시하는 매개변수로 별도 테스트할 수 있습니다.
TUN 모드
  • 현재 배포 패키지에서 TUN을 지원하는지, 필요한 구성 요소는 무엇인지 확인하세요.
  • 관리자 권한, 서비스 또는 가상 인터페이스가 필요할 수 있습니다.
  • 활성화한 뒤 DNS, 라우팅, 로컬 네트워크 연결을 확인하세요.
  • 문제가 발생하면 먼저 TUN을 끄고 시스템 프록시로 테스트한 결과와 비교하세요.

선택 기준은 트래픽 처리 범위이지 어느 모드가 ‘더 빠른가’가 아닙니다. 모드를 바꿀 때는 기존 설정을 보관하고 한 번에 하나의 조건만 변경하세요.

다른 VPN이나 가상 네트워크 어댑터를 사용 중이라면 TUN이 기본 경로, DNS 또는 인터페이스 우선순위의 영향을 받을 수 있습니다. 여러 트래픽 처리 도구를 동시에 켠 상태에서 라우팅 설정을 모두 바꾸지 마세요. 원격 데스크톱 환경에서는 특히 주의해야 합니다. 라우팅 변경으로 현재 연결이 끊길 수 있으므로 로컬에서 복구할 방법을 준비하고 TUN을 끄는 방법을 미리 확인하세요.

7. 강제 종료, 권한, 포트 충돌 문제 해결

문제를 해결할 때는 로그에서 처음 발생한 유효 오류부터 확인하세요. 인터페이스가 열리지 않는 문제, 코어 실행 실패, 구독 요청 실패, 웹페이지 접속 실패는 서로 다른 문제입니다. 프로그램을 다시 다운로드하는 것만으로는 원인을 모두 설명할 수 없습니다. 오류가 발생한 단계, 선택한 인터페이스 패키지, 시스템 아키텍처, 오류 문구를 기록한 뒤 아래의 해당 항목을 확인하세요.

더블클릭해도 창이 뜨지 않는데, 런타임이 없는 걸까요?

먼저 작업 관리자에 프로세스가 있는지 확인하고, 창이 트레이에 숨겨져 있는지도 살펴보세요. 프레임워크가 없다는 메시지가 명확히 표시되면 배포 패키지 요구 사항에 맞는 아키텍처의 런타임을 설치하세요. WPF 패키지에서 Desktop Runtime을 요구한다면 일반 .NET Runtime으로 대체할 수 없습니다. 별도 메시지가 없다면 Windows의 「이벤트 뷰어」→「Windows 로그」→「응용 프로그램」에서 해당 시간대의 오류를 확인하세요.

로그에 포트 점유라고 나오는데 어떻게 확인하나요?

PowerShell에서 아래의 수신 포트 조회 명령을 실행하고, 예시의 10808을 실제 포트로 바꾸세요. PID를 기준으로 작업 관리자의 「세부 정보」에서 프로세스를 찾습니다. 중복 실행된 v2rayN이라면 불필요한 인스턴스를 정상 종료하세요. 정체를 모르는 시스템 프로세스를 강제 종료하지 마세요.

영문 폴더로 옮기니 해결됐어요. 원래 폴더는 사용할 수 없나요?

두 번의 실행 환경이 달랐다는 점만 확인된 것이며 한글 문자에 문제가 있었다고 단정할 수는 없습니다. 폴더 권한, 파일이 완전한지, 동기화 폴더에 있는지, 보안 소프트웨어의 처리 기록을 계속 비교하세요. 판단할 때는 로그에 기록된 구체적인 경로 오류를 기준으로 삼으세요.

항상 관리자 권한으로 실행해야 안정적인가요?

일반적인 시스템 프록시 사용에는 관리자 권한이 필요하지 않습니다. 로그에 설정을 저장할 수 없다고 나오면 먼저 쓰기 가능한 폴더로 옮기세요. TUN을 활성화할 때 권한 상승이 필요하다면 현재 배포 안내를 따르세요. 권한을 높여도 만료된 구독, 원격 시간 초과, 잘못된 인증 매개변수는 해결되지 않습니다.

프로그램은 정상적으로 실행되는데 코어 파일을 찾을 수 없어요.

압축 파일을 완전히 풀었는지 확인하고 Windows의 「보안 센터」→「바이러스 및 위협 방지」→「보호 기록」을 살펴보세요. 차단 기록이 있다면 파일 출처와 위험 안내를 먼저 확인하세요. 보안 기능 전체를 바로 끄지 마세요. 선택한 패키지에서 코어 구성 요소를 별도로 준비해야 하는지도 확인하세요.

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

조회 결과가 없다면 해당 시점에 TCP 수신 포트가 열려 있지 않았을 가능성이 큽니다. 결과가 있더라도 포트 번호만 보지 말고 수신 주소와 프로세스를 확인하세요. 로컬 포트를 바꾼 뒤 설정을 저장하고 코어를 다시 불러온 다음 시스템 프록시를 재설정하세요. 브라우저나 터미널에 직접 입력한 프록시 주소도 함께 변경해야 합니다.

8. 업데이트 전 백업과 최종 점검

업데이트 전에 v2rayN을 정상 종료하고 관련 코어 프로세스가 모두 멈췄는지 확인한 다음 기존 작업 폴더를 백업하세요. Desktop과 WPF 간 설정 이전은 해당 릴리스 안내를 기준으로 확인해야 하며, 아무 폴더나 서로 덮어써도 된다고 가정하지 마세요. 백업에 구독 주소와 노드 자격 증명이 포함될 수 있으므로 개인적으로 보관하고 공개 클라우드에는 올리지 마세요.

Windows에서 V2Ray 클라이언트 설정을 마쳤다면 이제 중요한 것은 ‘어떤 인터페이스를 설치했는가’가 아니라 노드, 코어, 라우팅, 앱 설정이 서로 맞는지입니다. 같은 서비스를 Android 기기에서도 사용하려면 다운로드 페이지에서 v2rayNG 또는 v2flyNG를 확인하세요. v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용하므로 프로토콜 지원 여부를 각각 확인해야 합니다. v2rayNG의 구독도 별도로 업데이트해야 하며, 데스크톱에서 노드를 변경해도 다른 기기에 자동으로 동기화되지 않습니다.

클라이언트 다운로드4개 플랫폼 다운로드 보기