· 플랫폼별 가이드 · 약 8분

v2rayN Windows 설치 및 설정 가이드: WPF와 Desktop 버전 비교, 자주 발생하는 문제 해결

Windows에서 v2rayN 압축 해제부터 첫 실행, 구독 가져오기, 시스템 프록시 설정까지 안내합니다. WPF와 Desktop 버전의 차이, 런타임 누락과 포트 충돌 해결법도 확인하세요.

이 글 미리보기

Windows에서 처음 v2rayN을 설정한다면 시스템 아키텍처에 맞는 패키지를 선택해 압축을 완전히 푼 뒤 구독을 가져오고 노드를 선택한 다음 시스템 프록시를 켜세요. 문제가 생기면 ‘화면 표시 → 코어 수신 대기 → 노드 연결 → 앱 프록시 사용’ 순서로 점검하면 런타임, 포트 충돌, 구독 문제를 구분해 해결할 수 있습니다.

WPF와 Desktop 버전, 어떤 것을 선택할까요?

여기서 WPF와 Desktop은 클라이언트 인터페이스 종류를 가리키며, 노드 프로토콜을 뜻하지 않습니다. WPF 버전은 Windows의 WPF UI 프레임워크를 사용하고, Desktop 버전은 크로스 플랫폼 UI 프레임워크를 사용합니다. 같은 버전이라면 특정 노드의 사용 가능 여부는 실제로 호출되는 코어와 버전, 노드 설정값, 네트워크 환경에 따라 달라집니다. 패키지 이름에 Desktop이 있다고 해서 코어나 런타임이 포함된다고 단정하지 마세요.

WPF 버전

추천

익숙한 Windows 스타일의 인터페이스입니다. WPF 버전을 사용해 본 적이 있거나 WPF 가이드에서 트레이 메뉴와 설정 메뉴를 찾고 있다면 이 버전을 먼저 선택하세요. 프레임워크 의존 패키지에서 런타임 누락 메시지가 뜨면 안내에 따라 Windows Desktop Runtime의 버전과 아키텍처를 확인하세요.

추천 대상: Windows에서만 사용하며 클래식한 인터페이스와 익숙한 조작 방식을 선호하는 경우

Desktop 버전

크로스 플랫폼 인터페이스를 사용하므로 설정 메뉴 위치와 창 구성은 WPF 버전과 조금 다를 수 있습니다. 다운로드할 때 Windows용 패키지를 선택하세요. 런타임이 포함되어 있는지, 필요한 코어가 함께 제공되는지는 해당 패키지 설명을 확인해야 합니다.

추천 대상: Desktop 인터페이스를 선호하거나 데스크톱 운영체제 간 조작 방식을 비슷하게 유지하고 싶은 경우

다운로드하기 전에 Windows의 ‘설정’ → ‘시스템’ → ‘정보’에서 ‘시스템 종류’를 확인하고, 다운로드 페이지의 안내에 따라 x64 또는 arm64 패키지를 선택하세요. 버전을 바꿔 문제를 해결할 때는 기존 프로세스를 종료한 뒤 새 패키지를 별도 폴더에 압축 해제하세요. 두 버전의 파일을 한 폴더에 덮어쓰거나 클라이언트 두 개를 동시에 실행하면 같은 로컬 포트를 두고 충돌할 수 있습니다.

압축 해제, 구독 가져오기, 시스템 프록시 설정

아래 내용은 v2rayN 7.x의 일반적인 중국어 UI를 기준으로 작성했습니다. 빌드에 따라 메뉴 이름은 다를 수 있습니다. 예를 들어 업데이트 메뉴에서 ‘프록시 사용’이 괄호 안에 표시될 수 있으니, 현재 그룹만 업데이트하는지 전체 그룹을 업데이트하는지, 직접 연결하는지 프록시를 거치는지 확인하세요.

  1. 압축 파일 완전히 풀기

    시스템 아키텍처에 맞는 패키지를 선택하세요. 압축 파일을 받았다면 ‘모두 압축 풀기’를 사용해 현재 사용자에게 쓰기 권한이 있는 별도 폴더에 압축을 푸세요. 압축 파일 미리보기 창에서 프로그램을 실행하거나 실행 파일만 바탕 화면으로 옮기지 마세요. 처음 문제를 점검하는 동안에는 같은 폴더의 파일을 그대로 두고, 시작 프로그램 등록은 나중에 하세요.

  2. 클라이언트 실행

    압축을 푼 폴더에서 v2rayN.exe를 실행하고 기본 창이 표시되는지 확인하세요. 창을 닫았는데 작업 표시줄 알림 영역에 아이콘이 남아 있다면 트레이에서 기존 창을 다시 여세요. 화면이 표시되는 것은 클라이언트가 실행됐다는 뜻일 뿐입니다. 노드 실행에 필요한 코어가 있는지는 노드를 선택한 뒤 로그에서 확인하세요.

  3. 구독 그룹 추가

    ‘구독 그룹’ → ‘구독 그룹 설정’을 열고 새 항목을 추가한 다음 이름과 전체 구독 URL을 입력하고 저장하세요. vmess:// 또는 vless:// 링크 하나만 있는 경우에는 링크를 복사한 뒤 메인 화면의 ‘클립보드에서 가져오기’를 사용하세요. 단일 링크를 구독 URL 입력란에 넣으면 안 됩니다.

  4. 구독 업데이트 및 노드 선택

    새로 만든 그룹으로 전환한 다음 ‘구독 그룹’에서 ‘현재 구독 업데이트(프록시 사용 안 함)’를 실행하세요. 첫 업데이트가 아직 설정되지 않은 프록시에 의존하지 않도록 하기 위한 방법입니다. 목록에 항목이 표시되면 하나를 마우스 오른쪽 버튼으로 클릭해 ‘활성 서버로 설정’을 선택하세요. 활성 항목이 바뀌었는지 확인한 뒤 코어 시작 또는 수신 대기 오류가 로그에 있는지 살펴보세요.

  5. 시스템 프록시 켜기

    트레이 아이콘을 마우스 오른쪽 버튼으로 클릭하고 ‘시스템 프록시’ 관련 메뉴에서 ‘시스템 프록시 자동 설정’을 선택하세요. Windows의 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 설정을 확인한 다음, 시스템 프록시를 사용하는 브라우저로 평소 안정적으로 열리는 웹페이지에 접속해 보세요. 처음 확인할 때는 설정이 섞이지 않도록 TUN을 켜지 마세요.

로컬 포트와 Windows 시스템 프록시 비교

시스템 프록시에 입력하는 값은 이 컴퓨터의 프록시 진입점이지 노드 서버 주소나 포트가 아닙니다. 혼합 인바운드를 사용하는 7.x 빌드에서는 초기 수신 대기 포트로 10808을 쓰는 경우가 많습니다. 기존 설정, 다른 버전 또는 인바운드 설정에 따라 값은 달라질 수 있습니다. 먼저 ‘설정’ → ‘매개변수 설정’의 로컬 수신 대기 설정과 시작 로그를 확인한 뒤 Windows 프록시와 앱에 표시된 포트 번호를 비교하세요.

127.0.0.1
이 컴퓨터에서만 사용하는 루프백 주소
10808
혼합 인바운드의 일반적인 예시 포트
10818
포트 충돌 시 확인할 대체 포트

v2rayN 로컬 진입점

수신 대기 주소
127.0.0.1(이 컴퓨터에서 사용)
수신 대기 포트
10808(예시이며 현재 설정 기준)
진입점 유형
혼합 인바운드는 HTTP 프록시와 SOCKS 요청을 모두 받을 수 있습니다. 인바운드를 별도로 구성했다면 각각의 포트를 구분해서 확인하세요.

이 컴퓨터에서만 사용할 경우 ‘LAN 연결 허용’을 켤 필요가 없습니다.

Windows 프록시 설정

주소
127.0.0.1
포트
현재 HTTP 프록시를 지원하는 진입점 사용
적용 범위
Windows 시스템 프록시 설정을 사용하는 앱

앱에서 프록시를 별도로 설정했다면 해당 주소와 포트, 프록시 유형도 확인하세요.

같은 컴퓨터에서 브라우저는 정상인데 특정 앱만 프록시를 사용하지 않는다고 해서 노드에 문제가 있다는 뜻은 아닙니다. 먼저 해당 앱이 시스템 프록시를 따르는지, HTTP 또는 SOCKS 설정을 따로 제공하는지 확인하세요. v2rayN을 종료하기 전에 트레이 메뉴에서 ‘시스템 프록시 해제’를 선택한 다음 종료할 수 있습니다. 기존에 회사나 학교 프록시를 사용했다면 종료 후 원래 설정으로 복구하고, 더 이상 수신 대기하지 않는 포트를 계속 가리키지 않도록 주의하세요.

PowerShell로 포트 사용 여부 확인

로그에 address already in use 또는 이와 비슷한 바인딩 실패 메시지가 나타나면 현재 포트를 어떤 프로세스가 사용 중인지 확인하세요. 아래 예시는 10808을 사용합니다. 포트를 바꿨다면 명령의 숫자를 실제 값으로 바꾸세요. 첫 번째 명령은 수신 대기 주소와 프로세스 ID를 확인하고, 두 번째 명령은 이 컴퓨터에서 TCP 연결을 맺을 수 있는지만 검사합니다.

Get-NetTCPConnection -LocalPort 10808 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
  • 수신 대기 중이지만 어떤 프로세스인지 불분명한 경우: 작업 관리자의 ‘세부 정보’ 탭에서 PID를 OwningProcess와 대조하세요. 코어는 클라이언트가 실행한 별도 프로세스일 수 있으므로 프로세스 이름이 v2rayN.exe가 아니라는 이유만으로 종료하지 마세요. 먼저 기존 클라이언트를 종료하고 해당 포트의 수신 대기가 사라지는지 확인하세요.
  • 다른 프로그램이 포트를 사용 중인 경우: 정체를 모르는 프로세스는 그대로 두고, 대체 포트가 이미 수신 대기 중인지 확인한 다음 ‘설정’ → ‘매개변수 설정’에서 로컬 프록시 포트를 바꾸세요. 저장하고 코어를 다시 시작한 뒤 ‘시스템 프록시 자동 설정’을 다시 선택해 Windows가 더 이상 이전 포트를 가리키지 않는지 확인하세요.
  • 수신 대기 중인 포트가 없는 경우: 클라이언트로 돌아가 활성 노드와 코어 로그를 확인하고, 코어 누락이나 설정 로드 실패, 바인딩 실패부터 해결하세요. TcpTestSucceeded : True는 해당 포트에서 프로그램이 연결을 받고 있다는 뜻일 뿐, 노드에 연결되거나 웹 트래픽이 프록시를 통과한다는 의미는 아닙니다.

처음 설정할 때 자주 묻는 질문

프로그램을 실행하자마자 .NET 설치를 요구합니다. 무엇을 설치해야 하나요?

먼저 대화상자에서 요구하는 프레임워크 이름과 주 버전, 아키텍처를 확인하세요. WPF 버전에서 Microsoft.WindowsDesktop.App 누락을 안내한다면 기본 .NET Runtime만 설치하지 말고 안내에 맞는 Windows Desktop Runtime을 설치해야 합니다. 설치 후 원래 압축을 푼 폴더에서 다시 실행하세요. 패키지 설명에 런타임 포함이라고 적혀 있다면 이전 폴더를 가리키는 바로 가기가 아니라 해당 패키지의 프로그램을 실행했는지 확인하세요.

구독 그룹을 만들었는데 노드가 하나도 표시되지 않습니다. 어떻게 해야 하나요?

그룹을 저장해도 URL만 기록될 뿐 구독이 자동으로 업데이트되지는 않습니다. 해당 그룹으로 전환한 뒤 ‘현재 구독 업데이트(프록시 사용 안 함)’를 실행하고, 로그에서 시간 초과, HTTP 오류, 콘텐츠 파싱 실패 중 무엇이 발생했는지 확인하세요. 이미 작동을 확인한 노드가 있을 때만 ‘프록시 사용’ 업데이트 옵션을 비교용으로 사용하세요. 로그인 페이지가 반환되거나 URL이 만료됐다는 메시지가 나오면 제공자에게 구독 URL과 유효 기간을 확인하세요.

목록에 노드는 있는데 시스템 프록시를 켜면 웹페이지가 열리지 않습니다. 왜 그런가요?

먼저 노드를 ‘활성 서버로 설정’했는지 확인한 다음 코어 로그, 로컬 수신 대기 상태, Windows 프록시 포트를 점검하세요. 로컬 진입점은 정상이지만 로그에 원격 연결 시간 초과가 있다면 같은 네트워크에서 사용 가능한 것으로 확인된 다른 노드와 비교해 보세요. 인증서나 시간 관련 오류가 발생하면 Windows의 날짜, 시간, 시간대를 확인한 뒤 노드 설정을 점검하세요. 안내를 없애려고 인증서 검증을 끄지는 마세요.

창을 닫았는데 다음에 실행해도 포트 충돌이 계속 뜹니다. 왜 그런가요?

창을 닫으면 프로그램이 종료되지 않고 알림 영역으로 최소화될 수 있습니다. 트레이를 펼쳐 기존 v2rayN을 찾고, ‘시스템 프록시 해제’를 선택한 다음 ‘종료’를 눌러 완전히 종료하세요. 종료 후에도 포트가 수신 대기 중이라면 위의 PID 확인 방법으로 어떤 프로세스인지 살펴보세요. 특히 다른 폴더에 압축을 푼 v2rayN이 Windows 시작 시 실행되도록 설정되어 있는지 확인하세요.

v2rayN 다운로드