Windows에서 v2rayN을 처음 사용하거나 새 PC에서 다시 설정하는 분을 위한 안내입니다. ‘시스템 아키텍처 확인 → 인터페이스 버전 선택 → 압축 파일 전체 해제 → 런타임 설치 → 구독 가져오기 → 시스템 프록시 설정’ 순서로 진행하세요. 시작되지 않으면 프로그램과 런타임을 먼저 확인하고, 화면은 정상인데 연결되지 않으면 코어, 수신 포트, 노드를 점검하세요. 처음부터 TUN을 켤 필요는 없습니다.
1. Windows 버전과 프로세서 아키텍처에 맞는 설치 파일 선택
먼저 Windows에서 설정 → 시스템 → 정보 → 시스템 종류를 엽니다. 일반적인 Windows 10·11 PC에서는 Intel 또는 AMD 64비트 프로세서라면 보통 x64 패키지를 선택합니다. ARM 프로세서 PC는 다운로드 페이지에서 해당하는 ARM64 패키지를 제공하는지 확인하세요. PC 브랜드만 보고 아키텍처를 판단하거나 운영체제의 비트 수와 클라이언트 인터페이스 버전을 혼동하지 마세요.
v2rayN은 서버, 구독, 라우팅을 관리하고 프록시 코어를 실행하는 그래픽 클라이언트입니다. 데스크톱 버전은 Avalonia 인터페이스 프레임워크를 사용하고, WPF 버전은 Windows 전용 인터페이스 프레임워크를 사용합니다. 둘 다 노드 프로토콜 이름이 아니며, WPF를 선택했다고 특정 프로토콜만 사용할 수 있는 것도 아닙니다. 실제로 사용할 수 있는 기능은 클라이언트 버전, 함께 제공되는 코어, 노드 설정에 따라 달라집니다.
| 항목 | 확인 기준 | 선택 방법 |
|---|---|---|
| 데스크톱 버전 | Avalonia 기반 크로스 플랫폼 인터페이스 | Windows용 패키지 중 시스템 종류와 아키텍처가 일치하는 것을 선택하세요. |
| WPF 버전 | Windows 전용 인터페이스 | 기존 Windows 인터페이스가 익숙하다면 선택하세요. 릴리스 안내에서 필요한 런타임도 확인해야 합니다. |
| x64 / ARM64 | 시스템 종류에 표시된 프로세서 아키텍처 | 가능하면 네이티브 아키텍처 패키지를 선택하고, 함께 제공되는 코어도 실행 가능한지 확인하세요. |
| 자체 포함 / 런타임 필요 | 설치 파일에 실행 환경이 포함되어 있는지 확인 | 자체 포함 패키지는 용량이 큰 편입니다. 런타임이 필요한 패키지는 지정된 실행 환경을 별도로 설치해야 합니다. |
선택 요약: 아키텍처를 먼저 맞추고 런타임을 확인하세요
다운로드 페이지에서 Windows 패키지를 선택하고 버전과 아키텍처를 기록해 두세요. 프레임워크 누락 안내가 명확하게 표시될 때만 안내에 따라 해당 런타임을 추가로 설치하세요. 인터페이스 버전을 바꿔 가며 문제를 해결하려고 하지는 마세요.
2. 쓰기 가능한 폴더에 압축 파일 전체 해제
압축 파일에 포함된 실행 프로그램, 종속 파일, 코어 폴더는 기존 상대 경로를 유지해야 합니다. 압축 프로그램에서 v2rayN.exe를 바로 더블 클릭하면 일부 파일만 임시로 풀릴 수 있어 화면은 열려도 서비스가 실행되지 않을 수 있습니다. 현재 계정으로 쓸 수 있고 위치가 안정적인 폴더를 사용하세요. 예를 들면 C:\Users\Public\Tools\v2rayN이 있습니다. 조직 정책으로 해당 폴더를 사용할 수 없다면 개인 사용자 폴더 안의 도구 디렉터리를 이용하세요.
- 클라이언트 다운로드 페이지에서 원하는 Windows 패키지를 받은 다음, 다운로드가 완료되면 ‘모두 압축 풀기’를 실행하세요.
- 압축을 푼 폴더를 열어
v2rayN.exe와 나머지 파일이 있는지 확인하세요. 실행 파일만 바탕 화면으로 옮기지 마세요. - 처음 실행하기 전에는 압축 파일 내부, 임시 폴더 또는 추가 쓰기 권한이 필요한 위치에 프로그램을 두지 마세요.
- 실제 프로그램 폴더에서
v2rayN.exe를 더블 클릭하세요. 바탕 화면에 바로가기가 필요하면 파일을 복사하지 말고 바로가기를 만드세요.
Windows 보안 경고가 표시되면 먼저 다운로드 출처와 파일 정보를 확인하세요. 회사 PC의 차단은 조직 정책 때문일 수 있으니 관리자에게 확인해야 합니다. 시스템 보호를 끄거나 다운로드 폴더 전체를 예외로 등록하는 방법을 일반적인 설치 절차로 삼지 마세요.
3. 첫 실행과 .NET 런타임 확인
처음 실행할 때는 먼저 ‘인터페이스가 열리는지’를 확인하고, 그다음 ‘프록시 코어가 실행되는지’를 점검하세요. 두 단계는 따로 확인해야 합니다. 메인 화면이 열리지 않으면 아키텍처, 종속성, 압축 파일 전체 해제 여부를 먼저 살펴보세요. 화면은 정상인데 로그에 코어 파일이 없다고 나오면 설치 파일 구성, 코어 경로, 보안 소프트웨어 기록을 확인하세요.
- .NET 설치 안내가 표시되는 경우: 오류 세부 정보를 펼쳐 필요한 프레임워크 이름, 주 버전, 아키텍처를 확인하세요. v2rayN 릴리스에 따라 요구 사항이 달라질 수 있으니 예전 가이드의 런타임 버전 번호를 그대로 따르지 마세요.
- WPF 버전에서 Windows Desktop 프레임워크 누락 안내가 표시되는 경우: 해당 버전의 .NET Desktop Runtime을 설치하세요. 일반 .NET Runtime만 설치하면 데스크톱 프레임워크 종속성을 충족하지 못할 수 있습니다.
- 런타임을 설치했는데도 누락 안내가 표시되는 경우: x64와 ARM64 아키텍처가 일치하는지, 주 버전이 요구 사항을 충족하는지 확인하세요. 더 높은 주 버전을 설치했더라도 프로그램이 요구하는 이전 주 버전을 반드시 대체할 수 있는 것은 아닙니다.
- 자체 포함 패키지를 사용하는 경우: 일반적으로 패키지에 포함된 .NET 환경을 따로 설치할 필요는 없습니다. 다만 패키지의 시스템 요구 사항을 충족해야 하며 함께 제공된 파일을 그대로 유지해야 합니다.
일반 시스템 프록시 모드에서는 항상 관리자 권한으로 실행할 필요가 없습니다. 처음 문제를 확인할 때는 일반 계정으로 실행하세요. 추가 권한이 필요한 기능을 명확히 사용할 때만 클라이언트 안내에 따라 권한을 부여하면 됩니다. 모든 문제에 ‘관리자 권한으로 실행’을 적용하면 폴더 권한이나 파일 누락 같은 실제 원인을 놓칠 수 있습니다.
4. 구독 가져오기, 노드 선택, 시스템 프록시 설정
클라이언트를 열었다고 바로 사용할 수 있는 서버가 생기는 것은 아닙니다. 구독은 서버 설정을 제공하는 주소이고, VMess·VLESS 등은 노드에서 사용하는 프로토콜입니다. 서로 다른 개념입니다. 서비스 제공업체가 안내한 클라이언트 호환 구독 주소를 사용하고, 계정 관리 페이지 주소를 입력하지 마세요.
구독 그룹 → 구독 그룹 설정을 열고 그룹을 추가하세요. 알아보기 쉬운 이름과 전체 구독 주소를 입력한 다음 저장합니다.구독 그룹메뉴에서모든 구독 업데이트를 실행하세요. 현재 인터페이스에서 직접 연결과 프록시 연결을 구분한다면 구독 주소에 실제로 접속할 수 있는 경로를 선택하세요. 사용할 노드가 아직 없는 첫 설정 단계에서는 작동하지 않는 프록시로 구독을 업데이트하려고 하지 마세요.- 서버 목록에 노드가 표시되는지 확인한 뒤 노드를 선택하고 활성 서버로 지정하세요. 버전에 따라 마우스 오른쪽 버튼 메뉴나 해당하는 활성 서버 설정 메뉴를 이용할 수 있습니다.
- 하단 로그를 확인해 서비스가 시작되었고 수신 실패나 설정 로드 오류가 없는지 살펴보세요.
- 메인 화면 하단 바 또는 트레이의
시스템 프록시메뉴에서시스템 프록시 자동 설정을 선택한 다음 브라우저에서 연결을 확인하세요. 메뉴 위치는 인터페이스 버전에 따라 조금씩 다릅니다. - 필요에 따라
라우팅 설정에서중국 본토 우회(Whitelist)등의 규칙을 선택하세요. 시스템 프록시는 앱의 요청을 클라이언트로 보낼지 결정하고, 라우팅 규칙은 클라이언트에 들어온 요청이 어디로 향할지 결정합니다.
5. 로컬 포트와 Windows 프록시 상태 확인
아래 숫자는 로컬 연결 관계를 설명하기 위한 예시이며, 모든 v2rayN 버전의 기본값이 같다는 뜻은 아닙니다. 실제 포트는 설정 → 매개변수 설정에서 로컬 수신 관련 항목을 확인하세요. 일부 버전에서는 해당 항목이 Core 기본 설정에 있습니다. 최신 설정은 하나의 통합 포트를 사용할 수 있고, 이전 설정은 SOCKS와 HTTP 수신 포트를 각각 지정할 수 있습니다.
앱에서 HTTP 프록시를 별도로 입력해야 한다면 클라이언트에서 실제로 제공하는 HTTP 또는 통합 수신 포트를 사용하세요. SOCKS 전용 포트를 HTTP 포트로 입력하면 안 됩니다. 원격 노드의 서버 포트도 Windows 로컬 프록시 설정에 입력하지 마세요.
포트 충돌이 발생하면 명령 프롬프트에서 아래의 읽기 전용 조회를 실행하세요. 로컬 주소 열에 해당 포트가 있는지, 상태가 LISTENING인지, 행 끝에 표시된 PID가 무엇인지 확인하세요. 원격 주소에 같은 숫자가 있다고 해서 로컬 포트가 사용 중이라는 뜻은 아닙니다.
netstat -ano | findstr ":10808"그다음 작업 관리자의 ‘세부 정보’ 탭에서 PID로 프로세스를 찾으세요. 다른 v2rayN 인스턴스라면 트레이 메뉴에서 종료합니다. 계속 실행해야 하는 프로그램이라면 사용되지 않는 로컬 수신 포트로 변경하세요. 예를 들어 10818이 비어 있는지 확인한 뒤 사용할 수 있습니다. 저장하고 서비스를 다시 시작하세요. 시스템 프록시를 다시 적용하고 브라우저 확장 프로그램이나 다른 앱에 직접 입력한 이전 포트도 바꾸세요. 알 수 없는 시스템 프로세스를 무작정 종료하지 마세요.
6. 첫 실행 오류와 해결 순서
아래 오류 원문은 팝업, 클라이언트 로그 또는 코어 로그에 표시될 수 있으며 주변 문구는 버전에 따라 달라집니다. 먼저 오류 전체 내용과 발생 시간을 기록한 다음 해당 단계부터 확인하세요. ‘웹페이지가 열리지 않는다’는 이유만으로 설치 파일 문제라고 단정하지 마세요.
오류: You must install or update .NET to run this application.
원인 및 해결: 프로그램이 요구하는 .NET 프레임워크 또는 아키텍처를 충족하지 못한 상태입니다. 팝업의 Framework와 Architecture 항목을 확인하고 해당 실행 환경을 설치한 뒤 다시 시작하세요. Windows Desktop 프레임워크가 필요하다면 해당 버전의 Desktop Runtime을 선택하세요.
오류: This app can't run on your PC
원인 및 해결: 시스템 아키텍처가 맞지 않거나, 시스템 버전이 요구 사항을 충족하지 않거나, 프로그램 파일이 손상되었을 수 있습니다. ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인하고 현재 시스템을 지원하는 설치 파일을 다시 선택해 전체 압축을 해제하세요.
오류: Only one usage of each socket address (protocol/network address/port) is normally permitted.
원인 및 해결: 대개 다른 프로세스가 해당 수신 주소와 포트를 이미 사용 중일 때 발생합니다. 오류에 표시된 포트의 PID를 조회해 중복 실행을 종료하거나 로컬 수신 포트를 바꾸고 프록시 설정도 함께 변경하세요.
오류: An attempt was made to access a socket in a way forbidden by its access permissions.
원인 및 해결: 권한, 포트 예약 범위 또는 보안 정책 때문에 포트를 바인딩하지 못한 경우입니다. 먼저 중복 수신이 없는지 확인하고 netsh interface ipv4 show excludedportrange protocol=tcp로 TCP 제외 범위를 조회하세요. 사용할 수 있고 비어 있는 포트를 선택하세요. 시스템 예약 항목을 직접 삭제하지 마세요.
오류: connectex: No connection could be made because the target machine actively refused it.
원인 및 해결: 대상이 연결을 거부한 상태입니다. 오류에 표시된 대상 주소부터 확인하세요. 127.0.0.1이라면 로컬 코어가 수신 중인지, 프록시 포트가 일치하는지 점검하세요. 원격 서버 주소라면 노드 주소, 서버 포트, 서버 상태를 확인하세요.
클라이언트에서 코어 파일을 찾을 수 없다고 나오면 먼저 프로그램을 종료하세요. 실행 파일만 따로 떼어 완전한 설치 폴더처럼 사용했거나 코어를 별도로 준비해야 하는 패키지를 다운로드했는지 확인합니다. 그런 다음 Windows 보안 센터의 보호 기록에서 파일이 격리되었는지 확인하세요. 출처와 해당 파일을 확인한 후에만 조치하고, 차단된 항목을 모두 무작정 복원하지 마세요.
7. 설치 후 자주 묻는 질문
설치했는데 바탕 화면 아이콘이 없습니다. 설치에 실패한 건가요?
압축 파일로 배포되는 버전은 Windows에 설치 기록을 남기거나 바탕 화면 바로가기를 만들지 않을 수 있습니다. 전체 압축을 푼 폴더에서 v2rayN.exe를 실행해 정상적으로 열리는지 확인한 뒤 바로가기를 만드세요. 아이콘이 없다는 이유로 여러 번 압축을 풀어 동시에 실행하지 마세요.
화면은 열리지만 구독을 업데이트해도 노드가 보이지 않으면 어떻게 하나요?
‘구독 그룹 → 구독 그룹 설정’에서 주소가 전체 입력되었는지 확인한 다음 업데이트 로그에서 시간 초과, 인증 실패, 파싱 실패 중 어떤 오류가 발생했는지 확인하세요. 구독 결과로 로그인 페이지가 표시된다면 서비스 제공업체가 안내한 구독 주소로 바꿔야 합니다. 시간 초과라면 먼저 업데이트에 사용하는 네트워크 경로에 접속할 수 있는지 확인하세요.
노드 테스트 결과가 있는데 브라우저에서는 왜 연결되지 않나요?
먼저 해당 노드가 활성 서버로 지정되어 있는지 확인한 다음 ‘시스템 프록시 → 시스템 프록시 자동 설정’을 선택하세요. Windows의 ‘설정 → 네트워크 및 인터넷 → 프록시’에서 프록시가 현재 로컬 수신 포트를 가리키는지 확인하고, 브라우저가 별도의 프록시 설정을 사용하지 않는지도 살펴보세요. 한 번의 지연 시간 테스트만으로 모든 웹사이트에 접속할 수 있는 것은 아닙니다.
v2rayN을 종료한 뒤 오히려 인터넷에 연결되지 않습니다. 어떻게 해야 하나요?
Windows가 이미 중지된 로컬 프록시를 계속 가리키고 있을 수 있습니다. 클라이언트를 다시 시작한 뒤 ‘시스템 프록시 → 시스템 프록시 지우기’를 실행하고 종료하세요. Windows 프록시 설정에서 수동 프록시를 확인할 수도 있습니다. 조직에서 제공한 프록시를 사용 중이었다면 설정을 기록하고 복원한 뒤 진행하세요. 무작정 프록시 설정을 지우지 마세요.
처음부터 시작 프로그램과 TUN을 켜야 하나요?
먼저 일반 모드로 실행해 구독 업데이트, 노드 연결, 종료 후 인터넷 복구까지 확인하세요. 기본 연결이 정상인지 확인한 뒤 시작 프로그램이나 TUN을 하나씩 켜세요. 한 번에 하나의 설정만 변경하면 문제가 생겼을 때 정상 상태로 되돌리기 쉽습니다.
추가로 문제를 확인할 때는 Windows 시스템 종류, v2rayN 버전, 선택한 인터페이스 버전, 오류 원문, 로컬 수신 포트를 기록해 두면 충분합니다. 로그를 공유하기 전에 구독 주소, 사용자 식별 정보, 인증 매개변수는 가리세요. ‘프로그램 시작 → 코어 실행 → 로컬 수신 → 앱 프록시 → 원격 노드’ 순서로 점검하면 설치 파일, 포트, 라우팅을 한꺼번에 바꾸는 것보다 원인을 찾기 쉽습니다.