v2rayN Windows 설치 및 설정 가이드: Desktop·WPF 버전 선택과 자주 발생하는 문제

1. Desktop과 WPF 버전: UI를 선택한 다음 아키텍처 확인

먼저 Windows에서 ‘설정’ → ‘시스템’ → ‘정보’를 열고 ‘시스템 종류’를 확인하세요. x64 프로세서라면 보통 Windows x64 패키지를 선택합니다. ARM64 기기는 해당 UI 버전에서 지원하는 경우 ARM64 패키지를 우선 선택하세요. 파일명에 Windows가 들어 있다는 이유만으로 내려받지 말고, 시스템 아키텍처와 노드 프로토콜을 혼동하지 마세요.

Desktop과 WPF는 UI 구현 방식의 차이이고, Xray와 V2Ray는 프록시 코어의 차이이며, VMess와 VLESS는 노드에서 사용하는 프로토콜입니다. 서로 다른 계층의 개념입니다. UI를 바꿔도 잘못된 서버 주소가 수정되지는 않으며, 코어를 바꿔도 본 프로그램에 필요한 런타임 설치를 대신할 수 없습니다.

2. 파일을 완전히 압축 해제한 뒤 첫 실행: 압축 파일 안에서 실행하지 마세요

1. 설치 파일 확인

   다운로드 센터에서 Windows용 UI와 아키텍처를 선택하세요. 패키지 설명을 먼저 읽고 압축 파일인지, 설치 파일인지, 런타임이 포함된 배포 패키지인지 확인합니다.

2. 파일 압축 해제

   압축 파일은 C:\Tools\v2rayN처럼 쓰기 권한이 있는 고정 폴더에 풀 수 있습니다. v2rayN.exe만 따로 꺼내지 말고, 압축 프로그램의 미리 보기 창에서 바로 실행하지 마세요.

3. 필요한 런타임 설치

   실행 시 .NET이 없다는 안내가 나오면 창에 표시된 런타임 이름, 주 버전, 아키텍처를 확인한 뒤 해당 구성 요소를 설치하세요. WPF 패키지에서 Windows Desktop Runtime을 요구하는 경우 일반 .NET Runtime만 설치해서는 부족할 수 있습니다.

4. 실행 확인

   주 프로그램을 실행해 기본 창과 로그 영역이 정상적으로 열리는지 확인하세요. 첫 확인 단계에서는 일반 사용자 권한을 유지하세요. 이후 TUN처럼 권한이 필요한 기능을 사용할 때만 UI 안내에 따라 권한을 부여하면 됩니다.

설치 파일을 사용한다면 설치 마법사를 따라 진행하면 되며, 압축 해제 단계는 필요하지 않습니다. 실행 직후 종료되는 경우 오류 문구와 패키지 종류를 먼저 기록하세요. 프로그램을 여러 폴더로 옮겨 가며 실행하거나 호환되지 않는 런타임을 여러 개 설치하면 이후 문제 해결이 더 어려워집니다.

3. 구독 가져오기: 먼저 노드 목록을 만든 뒤 연결하세요

구독 링크는 노드 설정을 가져오는 주소이지 브라우저의 프록시 주소가 아닙니다. 보통 액세스 정보가 포함되므로 비밀번호처럼 취급하고, 전체 링크를 공개 스크린샷이나 로그에 노출하지 마세요. 구독이 만료되었거나 사용량을 소진했거나 로그인 페이지가 반환되는 경우에도 업데이트에 실패할 수 있습니다.

1. 그룹 추가

   메인 화면에서 ‘구독 그룹’ → ‘구독 그룹 설정’으로 이동해 그룹을 추가하세요. 현재 UI에 ‘+’ 버튼이 있으면 해당 버튼으로 추가해도 됩니다. 알아보기 쉬운 별칭을 입력하고 전체 구독 링크를 주소 입력란에 붙여 넣으세요.

2. 구독 업데이트

   저장한 뒤 ‘구독 그룹’ 메뉴에서 ‘전체 구독 업데이트(프록시 미사용)’를 실행하세요. 사용할 수 있는 프록시가 아직 없다면 우선 직접 연결로 업데이트를 시도합니다. 배포 버전에 따라 괄호 안 문구가 조금 다를 수 있으므로 실제 메뉴를 기준으로 하세요.

3. 목록 확인

   노드 이름, 주소, 포트, 프로토콜이 표시되는지 확인하세요. 목록이 비어 있다면 시스템 프록시를 켜기 전에 업데이트 로그부터 확인하세요. 구독 내용 대신 웹페이지가 반환된다면 서비스 제공자에게 해당 링크의 용도를 문의하세요.

4. 활성 노드로 지정

   노드를 선택하고 마우스 오른쪽 버튼 메뉴에서 활성 서버로 지정하세요. ‘서버 실제 연결 지연 시간 테스트’와 같은 항목을 실행해 결과가 나오는지 확인한 뒤 브라우저 프록시를 설정하세요.

현재 사용할 수 있는 노드가 있고 구독 주소에 프록시 연결이 꼭 필요한 경우에만 프록시를 통해 구독 업데이트를 시도하세요. 실제 연결 지연 시간은 테스트 대상과 현재 회선의 영향을 받습니다. 예를 들어 180 ms가 표시되면 해당 요청이 성공했고 그때 걸린 시간이 180 ms라는 뜻일 뿐, 지속적인 다운로드 속도를 나타내거나 모든 사이트 접속을 보장하지는 않습니다.

4. 로컬 포트와 시스템 프록시: 트래픽이 들어오는 경로 확인

‘설정’ → ‘매개변수 설정’에서 기본 설정 또는 로컬 수신 관련 페이지의 포트 값을 확인하세요. 버전에 따라 ‘로컬 혼합 수신 포트’ 등으로 표시될 수 있습니다. 아래에서는 혼합 포트 10808을 예로 듭니다. 실제 설정이 다르면 명령과 시스템 설정의 포트도 함께 바꾸세요.

• 먼저 노드를 활성화하고 코어 시작 실패가 로그에 없는지 확인하세요. 그런 다음 메인 화면 하단이나 트레이 메뉴의 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택합니다.
• Windows에서 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’를 열고 클라이언트가 설정한 주소와 포트가 현재 수신 설정과 일치하는지 확인하세요.
• 처음 테스트할 때는 Windows 프록시, 브라우저 확장 프로그램, 클라이언트 포트를 동시에 수동으로 바꾸지 마세요. 먼저 브라우저가 시스템 프록시를 사용하도록 설정한 뒤 하나씩 확인하세요.
• 이 PC에서만 사용할 경우 루프백 수신과 기본 액세스 제한을 유지하세요. 테스트 편의를 위해 함부로 LAN 연결 허용을 켜지 마세요.

이전 안내서에서는 SOCKS 포트 10808과 HTTP 포트 10809를 따로 입력하는 경우가 있습니다. 현재 설치에서 포트를 분리해 수신하는지는 실제 매개변수 설정을 확인해야 하며, 이전 설정을 그대로 복사하면 안 됩니다. HTTP 프록시 요청은 HTTP를 지원하는 포트로 보내야 합니다. 혼합 수신 포트는 하나의 포트에서 해당 유형의 프록시 요청을 받을 수 있습니다.

5. 시스템 프록시와 TUN: 한 가지 모드로 먼저 확인

라우팅 분기와 시스템 프록시도 서로 다른 기능입니다. 시스템 프록시는 앱이 요청을 클라이언트에 전달할지 결정하고, 라우팅 규칙은 클라이언트가 받은 요청을 프록시로 보낼지, 직접 연결할지, 차단할지 결정합니다. 처음에는 UI에서 제공하는 일반 분기 모드를 선택하고, 특정 도메인에 문제가 생기면 해당 요청에 실제로 어떤 규칙이 적용됐는지 확인하세요.

‘전역’을 모든 Windows 프로그램에 자동으로 적용된다는 뜻으로 이해하지 마세요. 시스템 프록시 모드에서 앱이 시스템 프록시를 읽지 않는다면 클라이언트의 라우팅 모드를 바꿔도 자동으로 연결되지 않습니다. 먼저 프록시를 지원하는 것이 명확한 도구로 테스트한 뒤 TUN이 필요한지 판단하세요.

6. 명령줄로 연결 확인: 로컬 문제와 원격 문제 구분

PowerShell에서 아래 명령을 차례로 실행하세요. 첫 번째 명령은 이 PC에서 예시 포트를 수신 대기 중인 프로세스가 있는지 확인합니다. 두 번째 명령은 HTTP 프록시를 명시적으로 지정해 브라우저 캐시, 확장 프로그램, 시스템 프록시 인식 차이가 결과에 섞이지 않도록 합니다. 테스트 대상은 접속할 수 있다고 확인한 HTTPS 사이트로 바꿔도 됩니다.

Get-NetTCPConnection -State Listen -LocalPort 10808

curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

200 Connection established만 표시된다면 프록시 터널 연결 단계가 성공했다는 뜻입니다. 대상 사이트의 응답이나 이후 오류도 계속 확인해야 합니다. 최종적으로 403이 반환되더라도 ‘사이트가 접근을 거부함’과 ‘로컬 프록시가 실행되지 않음’을 구분하세요. 두 경우의 해결 방법은 다릅니다.

7. 자주 발생하는 설치 문제: 증상에 맞게 해결하고 반복 재설치는 피하세요

8. 설치 완료 후 확인 목록

• 실행: 주 프로그램과 코어가 정상 작동하며 로그에 시작 오류가 반복해서 표시되지 않습니다.
• 구독: 노드 목록이 비어 있지 않고 활성 서버가 선택되어 있으며, 구독 주소가 공개되지 않았습니다.
• 포트: 실제 수신 포트가 시스템 프록시 설정과 일치하고, 프록시를 명시한 명령으로 대상 응답을 받을 수 있습니다.
• 브라우저: 시스템 프록시를 통해 테스트 사이트에 접속할 수 있으며 라우팅 결과가 예상과 일치합니다.
• 종료: 시스템 프록시를 지운 뒤 일반 직접 연결이 복구되며, 클라이언트를 다시 시작해도 같은 확인 절차를 완료할 수 있습니다.

이 항목을 모두 확인해야 설치 과정이 마무리됩니다. 이후 특정 노드만 시간 초과되거나 특정 사이트에만 문제가 생긴다면 Desktop과 WPF UI를 먼저 바꾸기보다 노드, 대상 사이트, 라우팅 규칙부터 확인하세요. 패키지 종류, 시스템 아키텍처, 개인정보를 가린 오류 로그를 보관하면 문제를 반복해서 확인하는 일을 줄일 수 있습니다.