Windows에서 v2rayN을 처음 사용하거나 WPF 버전에서 데스크톱 버전으로 바꾸려는 사용자에게 적합합니다. 먼저 시스템 아키텍처와 패키지 종류를 확인한 뒤 압축 해제, 런타임 점검, 구독 가져오기, 시스템 프록시 설정을 진행하세요. 문제를 해결할 때는 ‘프로그램 실행’, ‘코어 작동’, ‘앱의 프록시 경유’를 각각 확인해야 합니다. 웹페이지가 열리지 않는다고 설치 실패로 단정하지 마세요.
데스크톱 버전과 WPF 버전 비교
v2rayN은 서버 설정, 구독, 라우팅 규칙을 관리하는 클라이언트 인터페이스이며, 실제 연결은 호출된 프록시 코어가 처리합니다. 데스크톱 버전과 WPF 버전의 차이는 주로 인터페이스 기술과 사용 방식에 있습니다. 서버 프로토콜이나 구독 서비스가 서로 다른 것은 아닙니다. 같은 서버에 연결할 수 있는지는 사용하는 코어, 노드 설정, 네트워크 환경에 따라 달라집니다.
데스크톱 버전
추천크로스 플랫폼 인터페이스를 사용합니다. 처음 설치한다면 다운로드 페이지에서 Windows 데스크톱 버전을 선택한 뒤, 해당 패키지의 안내에 따라 아키텍처와 런타임을 확인하세요. 초보자가 선택하기 쉬운 경로라는 의미이며, WPF 버전보다 연결 속도가 반드시 빠르다는 뜻은 아닙니다.
추천 대상: 처음 설정하거나 크로스 플랫폼 인터페이스를 익히려는 사용자
WPF 버전
기존 Windows 스타일의 인터페이스를 사용해 메뉴 배치에 익숙한 사용자에게 적합합니다. 필요한 종속성은 패키지의 릴리스 안내와 실행 시 표시되는 메시지를 확인하세요. 인터페이스가 비슷해 보여도 이전 폴더의 프로그램과 새 패키지 파일을 섞어 사용하면 안 됩니다.
추천 대상: 기존 Windows 인터페이스와 익숙한 작업 흐름을 선호하는 사용자
인터페이스 버전을 바꿀 때는 별도 폴더에서 먼저 실행해 보세요. 클라이언트를 두 개 동시에 실행하면 시스템 프록시 설정이 반복해서 바뀌거나 로컬 포트가 충돌할 수 있습니다. 새 버전에서 설정을 가져오고 연결까지 확인한 뒤 이전 폴더를 정리하세요. 개인 구독 주소와 설정 백업은 본인만 접근할 수 있는 곳에 보관해야 합니다.
다운로드 전 확인: 시스템 아키텍처와 패키지
Windows에서 ‘설정’ → ‘시스템’ → ‘정보’를 열고 ‘시스템 종류’를 확인하세요. x64와 ARM64는 인터페이스 유형이 아니라 프로세서 아키텍처입니다. 다운로드 페이지에 실제로 표시된 패키지를 기준으로 선택하세요. 해당 아키텍처의 항목이 없다면 파일명만 보고 호환성을 추측하지 마세요. 구형 Windows도 같은 패키지를 반복해서 다시 설치하기보다 현재 버전의 시스템 요구 사항을 먼저 확인해야 합니다.
| 확인 항목 | 확인 방법 | 예방할 문제 |
|---|---|---|
| 프로세서 아키텍처 | ‘시스템 종류’에서 x64 또는 ARM64를 확인하고 다운로드 페이지의 패키지와 대조합니다. | 프로그램이 실행되지 않거나 아키텍처가 맞지 않는 종속성을 설치하는 문제 |
| 패키지 형식 | 압축 파일은 ‘모두 압축 풀기’를 사용하고, 설치 프로그램은 안내에 따라 설치합니다. | 설치 프로그램과 포터블 폴더를 같은 방식으로 취급하는 문제 |
| 런타임 | 실행 메시지에 표시된 .NET 런타임 종류, 주 버전, 아키텍처를 확인합니다. | SDK만 설치하거나 런타임 종류를 잘못 설치해 프로그램이 계속 실행되지 않는 문제 |
| 코어 파일 | 패키지의 폴더 구조를 유지하고 로그에 코어 파일 누락 메시지가 있는지 확인합니다. | 실행 파일만 복사해 인터페이스는 열리지만 연결은 되지 않는 문제 |
시작 창에서 .NET Desktop Runtime 설치를 명확히 요구한다면 안내된 주 버전과 아키텍처에 맞는 데스크톱 런타임을 설치하세요. 다른 런타임을 요구하면 해당 안내를 따릅니다. WPF는 데스크톱 런타임을 사용하지만 릴리스 패키지마다 종속성 포함 여부가 다르므로 모든 버전에 같은 버전 번호를 적용할 수는 없습니다. 누락 메시지가 없다면 ‘혹시 몰라서’ 개발 도구를 추가로 설치할 필요도 없습니다.
압축 해제 및 첫 실행: 순서대로 진행
-
패키지 다운로드
클라이언트 설치 패키지 페이지에서 Windows용 v2rayN 데스크톱 버전 또는 WPF 버전을 선택하세요. 파일을 저장한 뒤 압축 파일인지 설치 프로그램인지 먼저 확인하고 다음 단계로 진행합니다.
-
압축 파일 전체 풀기
압축 파일을 마우스 오른쪽 버튼으로 클릭하고 ‘모두 압축 풀기’를 선택하세요.
D:\Apps\v2rayN처럼 쓰기 권한이 있는 별도 폴더를 사용하면 됩니다. 압축 파일 미리 보기 창에서 바로 실행하거나 실행 파일 하나만 꺼내면 안 됩니다. -
프로그램 실행
압축을 푼 실제 프로그램 폴더에서 기본 실행 파일을 실행하세요. 런타임이 없다는 메시지가 나오면 종속성을 먼저 설치합니다. 기본 창이 보이지 않으면 작업 표시줄 알림 영역을 확인해 프로그램이 트레이로 최소화되었는지 살펴보세요.
-
로컬 설정 확인
‘설정’ → ‘매개변수 설정’을 열어 로컬 수신 포트와 관련 옵션을 확인하세요. 처음 연결을 확인할 때는 TUN을 끄고, 가상 네트워크 어댑터와 시스템 프록시를 동시에 사용하지 마세요.
-
바로 가기 만들기
프로그램이 정상적으로 실행되고 설정도 저장되는지 확인한 다음 기본 실행 파일의 바로 가기를 만드세요. 이후에는 바로 가기로 실행하고, 프로그램 파일을 옮기거나 압축을 푼 폴더를 임시 폴더처럼 삭제하지 마세요.
첫 구독 가져오기: 구독 주소와 노드 구분
구독 주소는 여러 서버 설정을 가져오는 데 사용하고, 개별 공유 링크에는 노드 하나의 정보가 담깁니다. 클라이언트를 설치해도 서버가 자동으로 추가되지는 않으므로 접근 권한이 있는 구독이나 노드 정보를 사용하세요. 구독 링크에는 액세스 토큰이 포함되는 경우가 많으니 스크린샷, 로그, 공개 문의 글에 전체 주소를 노출하지 마세요.
- ‘구독 그룹’ → ‘구독 그룹 설정’을 열고 ‘추가’를 선택하세요. 알아보기 쉬운 이름을 입력하고 주소 입력란에 구독 링크 전체를 붙여 넣은 다음 저장합니다. 인터페이스 버전에 따라 추가 버튼이 더하기 기호로 표시될 수 있지만 기능은 같습니다.
- 기본 창으로 돌아가 ‘구독 그룹’ 메뉴를 열고 처음에는 ‘모든 구독 업데이트(프록시 사용 안 함)’를 선택할 수 있습니다. 사용할 수 있는 노드가 없다면 첫 연결을 만들기 위해 ‘프록시를 통해 업데이트’에 먼저 의존하지 마세요.
- 업데이트가 끝나면 서버 목록을 확인하세요. 다른 그룹이 선택되어 있거나 검색어가 입력되어 있다면 대상 그룹으로 전환하고 검색 필터를 지우세요. 그래야 목록에 보이지 않는 것을 가져오지 못한 것으로 오해하지 않습니다.
- 사용할 서버를 선택한 뒤 마우스 오른쪽 버튼을 눌러 ‘활성 서버로 설정’을 선택하세요. 현재 활성 항목이 바뀌었는지 확인한 다음 코어 시작 정보를 살펴봅니다. 목록에서 행 하나를 선택하는 것만으로 활성 서버가 전환되는 것은 아닐 수 있습니다.
vmess:// 또는 vless://로 시작하는 개별 공유 링크가 있다면 복사한 뒤 ‘서버’ → ‘클립보드에서 공유 링크 가져오기’를 선택하세요. HTTP 주소가 필요한 구독 업데이트 입력란에 이런 링크를 넣으면 안 됩니다. 메뉴 문구는 버전에 따라 다를 수 있으니 ‘공유 링크 가져오기’와 ‘구독 업데이트’를 구분해 선택하세요.
시스템 프록시와 포트: 브라우저로 먼저 확인
활성 서버를 설정한 다음에는 앱의 요청이 로컬 프록시로 전달되도록 해야 합니다. 트레이 메뉴나 기본 창의 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택하세요. 라우팅은 우선 ‘중국 본토 우회’ 유형의 기본 프리셋을 사용합니다. 정확한 명칭은 현재 규칙 목록을 기준으로 확인하세요. 시스템 프록시는 앱의 연결 지점을 정하고 라우팅은 코어에 전달된 트래픽의 출구를 정합니다. 서로 대체할 수 있는 기능이 아닙니다.
이 포트는 이 컴퓨터의 앱이 클라이언트에 접속하는 진입점이지 원격 서버 포트가 아닙니다. 최신 설정은 HTTP와 SOCKS 요청을 하나의 혼합 포트로 처리할 수 있고, 구형 설정은 각각 별도로 수신할 수도 있습니다. 가이드에 나온 포트를 무조건 추가로 활성화하지 마세요. ‘설정’ → ‘매개변수 설정’과 실행 로그에 실제로 표시된 수신 정보를 기준으로 확인하세요.
첫 연결 확인
- 활성 서버
- 마우스 오른쪽 버튼 메뉴에서 활성 서버로 설정
- 시스템 프록시
- 시스템 프록시 자동 설정
- TUN 모드
- 첫 확인에서는 끄기
- 라우팅 설정
- 먼저 기본 프리셋을 사용하고 사용자 지정 규칙은 추가하지 않기
시스템 프록시를 따르는 브라우저가 정상적으로 접속되는지 먼저 확인한 뒤 다른 앱으로 범위를 넓히세요.
프록시 직접 입력
- 서버 주소
127.0.0.1- 포트 예시
10808(실제 수신 포트와 일치해야 함)- 프록시 유형
- 앱의 요구 사항에 따라 HTTP 또는 SOCKS5 선택
- 수신 범위
- 이 컴퓨터에서만 사용할 경우 로컬 루프백 수신 유지
앱이 시스템 프록시를 사용하지 않고 자체 프록시 설정을 제공할 때만 앱에서 직접 입력하세요.
먼저 권한이 있는 웹사이트를 브라우저에서 열고 로그에 새 연결 기록이 나타나는지 확인하세요. 브라우저가 접속되더라도 모든 프로그램이 프록시를 사용하는 것은 아닙니다. 일부 프로그램은 시스템 프록시를 무시하거나 자체 프록시 설정을 사용합니다. 이런 경우 해당 프로그램의 네트워크 설정을 먼저 확인하세요. ‘시스템 프록시 자동 설정’이 컴퓨터의 모든 트래픽을 가로채는 기능이라고 생각하면 안 됩니다.
실행 및 연결 문제: 단계별로 확인
프로그램을 두 번 클릭해도 반응이 없는데 다시 설치해야 하나요?
먼저 트레이에 이미 실행 중인 인스턴스가 있는지 확인한 다음 압축이 제대로 풀렸는지, 런타임 안내가 표시되는지 살펴보세요. 데스크톱 런타임이 필요하다는 메시지가 나오면 주 버전과 x64 또는 ARM64 아키텍처를 확인합니다. 기존 폴더에 다른 인터페이스 버전을 반복해서 덮어쓰지 말고 별도 폴더에서 실행해 문제를 확인하세요.
서버 목록은 있는데 코어가 시작되지 않는 이유는 무엇인가요?
기본 창 아래쪽의 로그 또는 정보 영역에서 파일 누락, 설정 미지원, 포트 점유 메시지가 있는지 확인하세요. 파일이 누락되었다면 압축을 다시 전체 해제합니다. 프로토콜이나 매개변수가 지원되지 않는다면 노드 요구 사항과 선택한 코어를 대조하세요. 목록에 가져오기에 성공했다고 설정까지 유효하다고 단정할 수는 없습니다.
포트가 사용 중이라고 나오면 어떤 포트를 바꿔야 하나요?
다른 클라이언트와 프록시 프로그램을 먼저 종료하세요. 필요한 경우 netstat -ano | findstr :10808을 실행해 포트 사용 내역을 확인한 다음 작업 관리자에서 PID로 프로세스를 식별합니다. 변경이 필요하다고 확인된 경우에만 로컬 수신 포트를 바꾸고, 프록시를 직접 입력한 앱의 설정도 함께 업데이트하세요.
프로그램을 종료한 뒤 브라우저도 접속되지 않나요?
클라이언트를 다시 실행한 뒤 ‘시스템 프록시’에서 ‘시스템 프록시 지우기’를 선택하고 정상적으로 종료하세요. 프로그램을 실행할 수 없다면 Windows ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 ‘프록시 서버 사용’을 확인하고 이번에 남은 로컬 프록시 설정을 제거합니다. 조직에서 관리하는 설정이라면 관리자에게 먼저 문의하세요.
인증서 오류도 재설치로 해결하려 해서는 안 됩니다. 먼저 Windows ‘설정’ → ‘시간 및 언어’ → ‘날짜 및 시간’이 올바른지 확인한 뒤 노드의 서버 이름과 TLS 설정을 확인하세요. 인증서 검증을 유지하고 로그에서 문제 필드를 찾으세요. ‘인증서 검증 건너뛰기’를 계속 사용하면 필요한 인증 기능이 사라집니다.
업데이트 및 일상 사용: 되돌릴 수 있도록 설정 보관
처음 실행에 성공하면 사용한 인터페이스 유형, 로컬 포트, 라우팅 프리셋, 구독 그룹 이름만 기록해 두면 됩니다. 서버 설정 전체를 공개할 필요는 없습니다. 다음에 업데이트할 때도 설치 패키지 페이지에서 패키지 종류를 확인하고 실행 중인 클라이언트를 종료한 뒤 해당 패키지의 업데이트 방법을 따르세요. 압축 파일은 기존 폴더에 덮어쓰기보다 새 폴더에서 시험 실행하는 편이 이전 파일의 잔여 문제를 찾기 쉽습니다.
- 백업 전 종료: 파일 저장 중 설정이 일치하지 않는 문제를 줄이려면 클라이언트를 완전히 종료한 뒤 개인 설정을 백업하세요. 백업에는 구독 인증 정보가 포함될 수 있으므로 접근을 제한해야 합니다.
- 업데이트 후 재확인: 활성 서버, 수신 포트, 시스템 프록시, 라우팅이 예상대로인지 확인한 뒤 브라우저 접속을 테스트하세요. 기본 창이 열리는지만 확인해서는 안 됩니다.
- 한 번에 하나씩 변경: 인터페이스 전환, 코어 변경, TUN 활성화, DNS 수정은 동시에 하지 마세요. 변경할 때마다 연결을 확인해야 문제가 생겼을 때 되돌릴 항목을 정확히 알 수 있습니다.
- 종료 전 프록시 해제: 더 이상 사용하지 않을 때는 시스템 프록시를 먼저 지운 뒤 프로그램을 종료하세요. 시작 프로그램 등록은 수동 연결이 안정적으로 되는지 확인한 뒤 활성화하세요.
이 단계를 마치면 기본 연결 구조를 파악할 수 있습니다. 앱은 로컬 수신 포트에 연결하고, 클라이언트는 라우팅 규칙에 따라 요청을 해당 아웃바운드로 전달하며, 코어가 원격 서버와 연결합니다. 시스템 프록시를 따르지 않는 앱도 연결하려면 고급 설정에서 TUN과 라우팅 안내를 확인하세요. 기본 설정에 여전히 궁금한 점이 있다면 문제 해결을 먼저 살펴보고, 원인을 찾지 못한 상태에서 옵션을 더 추가해 덮으려 하지 마세요.