v2rayN Windows 설치 및 설정 총정리: 데스크톱판과 WPF판 선택법, 자주 발생하는 문제

데스크톱판과 WPF판, 어떻게 선택할까

두 버전의 핵심 기능은 같습니다. VMess, VLESS 등의 서버 설정을 관리하고 Xray Core로 로컬 프록시를 만든 뒤 Windows 앱의 트래픽을 로컬 포트로 전달합니다. 차이는 UI 구현 방식, 런타임 의존성, 시스템 호환성에 있으며 노드 프로토콜이나 회선 품질의 차이를 뜻하지 않습니다. 같은 구독을 두 버전에 가져오면 서버 주소, 포트, 전송 방식과 TLS 매개변수는 동일해야 합니다.

Windows 11 또는 아직 지원 기간인 Windows 10에서는 다운로드 페이지에 표시된 데스크톱판을 먼저 사용해 보세요. 고해상도와 화면 배율 설정에 맞는 UI를 제공하며, 일상적인 구독 관리·속도 측정·라우팅 작업도 한곳에서 처리하기 편합니다. 전통적인 데스크톱 환경을 사용하거나 데스크톱판에서 창 렌더링 및 런타임 로딩 문제가 발생하면 WPF판으로 전환해 UI 호환성 문제인지 확인할 수 있습니다.

압축 해제, 실행 및 Xray Core 준비

다운로드가 끝났다고 압축 파일 미리보기 창에서 바로 메인 프로그램을 실행하지 마세요. 모든 파일을 D:\Tools\v2rayN\처럼 장기간 보관할 위치에 압축 해제해야 합니다. 메인 프로그램만 꺼내면 Core, 리소스 파일과 설정 폴더가 누락될 수 있으며, 흔히 UI는 열리지만 노드 실행 시 로그에 Core를 찾을 수 없다는 메시지가 표시됩니다.

프로그램을 시스템 임시 폴더, 브라우저 다운로드 캐시 또는 자주 권한을 요구하는 폴더에 장기간 두는 것은 권장하지 않습니다. 경로에 한글을 사용할 수 있지만 문제를 확인할 때는 짧은 영문 경로가 더 직관적입니다. 처음 실행할 때 Windows 보안 경고가 나타나면 파일 출처와 앱 이름을 확인한 뒤 현재 보안 정책에 따라 실행 여부를 결정하세요.

1. 다운로드 및 압축 해제

   사이트의 설치 패키지 페이지에서 Windows용 버전을 선택한 뒤 전체 압축 파일을 D:\Tools\v2rayN\에 압축 해제하세요. 압축 파일 내부에서 바로 더블클릭해 실행하지 마세요.

2. 메인 프로그램 실행

   v2rayN 메인 프로그램을 실행하세요. 창이 나타나지 않으면 작업 표시줄 알림 영역을 확인합니다. v2rayN은 메인 창을 닫아도 트레이 프로세스가 남아 있는 경우가 많습니다.

3. Core 확인

   「설정」→「매개변수 설정」→「Core 유형」으로 이동해 VLESS, VMess 등의 설정을 Xray에 맡기도록 지정하세요. 마이너 버전에 따라 이 메뉴가 「Core」 또는 「Core 설정」으로 표시될 수 있습니다.

4. 로그 확인

   아무 설정이나 선택해 실행한 뒤 메인 창의 로그를 확인하세요. 정상 상태라면 로컬 리스닝 포트가 표시됩니다. Core 파일이 없다는 메시지가 나오면 전체 패키지를 다시 압축 해제하거나 클라이언트의 Core 관리 메뉴에서 파일을 보충하세요.

5. 고정 폴더

   실행이 정상인지 확인한 뒤 바탕 화면 바로 가기를 만드세요. 이후 업데이트할 때는 먼저 트레이 프로세스를 종료하고 설정을 백업해 오래된 프로세스가 파일을 계속 점유하지 않도록 하세요.

더블클릭 후 창과 트레이 아이콘이 모두 나타나지 않으면 먼저 작업 관리자를 열어 프로세스가 즉시 종료되는지 확인한 다음 Windows 이벤트 뷰어의 애플리케이션 오류를 살펴보세요. .NET 구성 요소가 없다는 메시지가 나오면 패키지 안내에 맞는 x64 Desktop Runtime을 설치하세요. 의존성 문제를 프로그램 폴더를 반복해서 옮기는 방식으로 해결하려 하지 마세요.

구독 가져오기 및 프로토콜 매개변수 확인

구독 링크는 서버 설정 목록을 업데이트하는 주소이며 특정 노드 하나를 뜻하지 않습니다. 처음 가져올 때는 https://로 시작하는 구독 주소 전체를 복사하고, 메신저의 줄바꿈이나 끝부분 누락이 없는지 확인하세요. 「구독 그룹」 관리 창에서 그룹을 만든 뒤 주소를 붙여 넣고 「모든 구독 업데이트(프록시 사용 안 함)」를 실행합니다.

업데이트가 완료되면 메인 목록에 보통 노드 별칭, 주소, 포트와 프로토콜 유형이 표시됩니다. 이때 이름만 보고 품질을 판단하지 말고 설정 하나를 임의로 열어 VLESS 또는 VMess, 전송 방식, TLS, SNI, 경로 등이 자동으로 채워졌는지 확인하세요. 구독 서비스가 제공한 매개변수를 기준으로 삼아야 하며, 필드 하나를 임의로 바꾸면 핸드셰이크가 실패할 수 있습니다.

목록이 나타나면 먼저 실제 지연 시간 테스트를 한 번 실행하고 지연 시간이 정상인 노드를 선택하세요. 지연 시간은 테스트 시점에 대상에 연결할 수 있는지만 보여 주며 지속적인 다운로드 속도를 의미하지 않습니다. 모든 노드가 시간 초과로 표시되면 프로토콜 필드를 하나씩 수정하기보다 시스템 시간, 구독 유효 기간과 로컬 네트워크를 먼저 확인하세요.

시스템 프록시 활성화 및 라우팅 모드 설정

노드 실행 성공은 Xray가 로컬 리스닝을 시작했다는 뜻일 뿐, 브라우저 트래픽이 v2rayN으로 전달된다는 의미는 아닙니다. Windows 일반 프로그램은 보통 시스템 프록시를 사용하므로 트레이 메뉴나 메인 창에서 「시스템 프록시」→「시스템 프록시 자동 구성」을 선택해야 합니다. 활성화한 뒤 Windows 「설정」→「네트워크 및 인터넷」→「프록시」에서 상태를 확인할 수 있습니다.

v2rayN의 일반적인 로컬 SOCKS 포트는 10808, HTTP 포트는 10809이지만 실제 값은 현재 클라이언트 상태 표시줄과 「설정」→「매개변수 설정」→「기본 설정」을 기준으로 확인해야 합니다. 포트를 변경한 적이 있다면 브라우저 확장 프로그램이나 다른 소프트웨어가 이전 포트를 계속 사용해 클라이언트는 실행 중으로 보이지만 앱 연결은 실패할 수 있습니다.

• 시스템 프록시 자동 구성: 브라우저와 Windows 시스템 프록시를 따르는 소프트웨어에 적합합니다. 처음 사용할 때는 연결 상태를 확인하기 위해 이 항목을 먼저 선택하는 것이 좋습니다.
• 시스템 프록시 변경 안 함: 지정한 소프트웨어만 127.0.0.1:10808 또는 127.0.0.1:10809에 수동으로 연결할 때 적합합니다.
• 시스템 프록시 지우기: 사용을 마치기 전에 Windows 프록시 상태를 원래대로 돌려 다음 부팅 때 시스템이 중지된 로컬 포트를 계속 가리키지 않도록 하세요.
• 라우팅 분할: 「설정」→「라우팅 설정」에서 규칙 집합을 선택해 도메인 또는 IP 조건에 따라 직접 연결, 프록시와 차단 규칙을 적용합니다.

처음 확인할 때는 LAN 주소는 직접 연결하고 나머지는 규칙에 따라 처리하는 간단한 라우팅 모드를 권장합니다. 웹페이지와 자주 사용하는 소프트웨어가 정상 작동하는지 확인한 뒤 도메인, IP 또는 프로세스 규칙을 추가하세요. 라우팅 규칙은 위에서 아래로 적용되므로 범위가 지나치게 넓은 규칙을 앞에 두면 뒤의 트래픽을 먼저 가로챌 수 있습니다.

로컬 SOCKS: 127.0.0.1:10808
로컬 HTTP: 127.0.0.1:10809
LAN 리스닝: 기본적으로 꺼짐
시스템 프록시: 시스템 프록시 자동 구성
라우팅 확인: LAN 직접 연결 → 사용자 지정 규칙 → 기본 규칙

다른 기기가 컴퓨터의 프록시에 연결해야 할 때만 「LAN 연결 허용」을 고려하세요. 활성화하면 리스닝 범위가 로컬 루프백 주소에서 LAN 네트워크 어댑터까지 확장될 수 있으며 Windows 방화벽 인바운드 규칙도 설정해야 합니다. 이 컴퓨터에서만 사용할 때는 LAN 공유를 끄고 포트도 계속 127.0.0.1에 바인딩하세요.

권한, 방화벽 및 포트 점유 확인 방법

v2rayN의 일반적인 시스템 프록시 모드는 계속 관리자 권한으로 실행할 필요가 없습니다. 보호된 폴더를 수정하거나 특정 방화벽 규칙을 만들거나 시스템 수준의 네트워크 구성 요소가 필요한 기능을 활성화할 때만 권한 요청이 나타날 수 있습니다. 일반적인 프록시 작업을 항상 관리자 권한으로 실행하면 설정 파일 소유권과 시작 동작이 오히려 달라질 수 있습니다.

Windows 방화벽에서 처음 네트워크 액세스 범위를 물으면 LAN 공유가 필요한지 먼저 판단하세요. 로컬 프록시가 루프백 주소만 처리한다면 연결을 위해 모든 네트워크 유형을 허용할 필요가 없습니다. LAN 연결을 활성화할 경우 전용 네트워크로 제한하고 실제 사용하는 프로그램과 포트만 허용하세요.

Windows 기본 명령으로 포트 문제를 확인할 수 있습니다. 터미널을 열고 netstat -ano | findstr :10808을 실행하면 마지막 열의 숫자가 포트를 사용 중인 프로세스 ID입니다. 그런 다음 작업 관리자의 「세부 정보」 탭에서 PID로 해당 프로그램을 찾으세요. 오래된 Xray 프로세스가 포트를 사용 중이라면 기존 클라이언트를 정상 종료한 뒤 다시 시작합니다.

첫 설정 후 확인 목록

설치가 완료되었는지 트레이 아이콘 색상만으로 판단해서는 안 됩니다. 전체 확인에는 클라이언트의 안정적인 실행, Core 로그의 지속적인 오류 여부, 구독 업데이트, 노드 연결, 시스템 프록시 포트 일치, 예상대로 작동하는 라우팅 규칙이 포함되어야 합니다. 한 항목씩 완료한 뒤 다음으로 넘어가면 문제가 어느 단계에서 발생했는지 쉽게 확인할 수 있습니다.

1. v2rayN을 닫았다가 다시 열어 설정과 구독 그룹이 그대로 있는지 확인하세요.
2. 노드 하나를 선택하고 최소 60초 동안 로그를 살펴 반복 재시작이나 포트 바인딩 오류가 없는지 확인하세요.
3. 지연 시간 테스트를 한 번 실행한 뒤 자주 사용하는 웹페이지를 열어 DNS, TLS와 실제 요청 경로를 확인하세요.
4. 「설정」→「매개변수 설정」의 로컬 포트를 확인하고 시스템 프록시 또는 수동 프록시 소프트웨어와 일치하는지 확인하세요.
5. 라우팅 모드를 한 번 전환해 직접 연결 사이트와 프록시 대상이 규칙에 따라 작동하는지 확인하세요.
6. 트레이 메뉴에서 정상적으로 종료한 뒤 Windows 시스템 프록시가 삭제되었거나 예상대로 유지되는지 확인하세요.
7. 클라이언트를 다시 시작하고 모든 구독을 업데이트한 뒤 노드 목록에 중복 그룹이 없는지 확인하세요.

기본 시스템 프록시가 안정적으로 작동한 뒤에야 시작 시 자동 실행, LAN 공유 또는 더 세밀한 프로세스 분할을 고려하세요. 한 번에 옵션 하나만 변경하고 변경 전 포트와 라우팅 설정을 기록해 두세요. 새 규칙으로 문제가 생겨도 마지막으로 작동한 설정으로 빠르게 되돌릴 수 있습니다.

데스크톱판과 WPF판을 전환할 때도 핵심은 구독, Core, 포트와 라우팅의 네 가지입니다. UI 버전은 작업 메뉴와 실행 환경만 결정하며 구독 만료, 매개변수 오류 또는 연결 불가 문제를 자동으로 해결하지 않습니다. 이 글의 순서대로 각 계층을 확인하면 첫 설치 중 발생하는 문제를 대개 명확한 한 단계로 좁힐 수 있습니다.