Windows 사용자는 먼저 시스템 아키텍처에 맞는 패키지를 고른 다음 WPF와 Desktop 중 인터페이스를 선택하면 됩니다. 처음 압축을 푸는 단계부터 런타임 오류 대처, 구독 업데이트, 시스템 프록시와 라우팅 설정, 로그인 후 연결 확인까지 차례로 살펴봅니다. 먼저 일반 시스템 프록시로 연결을 확인한 뒤 TUN을 설정하면 여러 설정이 한꺼번에 바뀌어 문제를 찾기 어려워지는 일을 줄일 수 있습니다.
WPF와 Desktop: 인터페이스와 배포 패키지 구분하기
WPF는 Windows 전용 UI 기술이며, v2rayN Desktop 버전은 여러 플랫폼에서 사용할 수 있는 데스크톱 UI 기술을 적용합니다. 두 버전의 차이는 UI 구현 방식과 조작감, 실행 환경에 있으며 노드 프로토콜이 다른 것은 아닙니다. 서버 연결 여부는 구독 설정, 실제로 사용하는 프록시 코어, 네트워크 환경에 따라 달라지므로 창 모양만 보고 판단할 수 없습니다.
WPF: Windows에서 주로 사용
추천Windows에서만 사용하고 특별히 다른 플랫폼과 동일한 UI가 필요하지 않다면 WPF부터 사용해 보세요. 실행할 때 .NET 데스크톱 런타임이 없다는 메시지가 표시되면 해당 배포 패키지의 요구 사항에 맞게 설치하세요. 노드 설정을 바꿀 필요는 없습니다.
추천 대상: Windows를 주로 사용하며 WPF의 조작 방식에 익숙한 사용자
Desktop: 여러 플랫폼에서 익숙한 UI
여러 데스크톱 운영체제에서 비슷한 UI를 사용하고 싶다면 Desktop을 선택할 수 있습니다. Windows에서는 사용 중인 아키텍처에 맞는 Windows 패키지를 내려받아야 합니다. Desktop이라는 이름만으로 런타임이 포함되어 있다고 단정할 수 없으며 프록시 속도가 더 빠르다는 뜻도 아닙니다.
추천 대상: 여러 플랫폼에서 일관된 UI를 원하거나 두 버전의 사용 경험을 비교해 보고 싶은 사용자
배포 방식도 별도로 확인해야 합니다. 포터블 압축 파일은 전체 압축을 푼 뒤 실행해야 하며, 설치 프로그램은 안내에 따라 설치 위치를 지정하면 됩니다. 코어 포함 여부나 런타임 내장 여부는 다운로드 페이지 설명과 패키지 내용을 확인하세요. WPF나 Desktop이라는 이름만으로는 알 수 없습니다. 두 UI를 각각 시험해 볼 수 있지만, 같은 로컬 수신 포트를 두 프로그램이 동시에 사용하지 않도록 주의하세요.
다운로드 전 아키텍처와 런타임 확인
Windows의 「설정」→「시스템」→「정보」에서 시스템 종류를 확인하세요. 일반적인 Intel 및 AMD PC는 대개 x64 패키지를 사용합니다. Windows on Arm 기기라면 배포처에서 제공하는 ARM64 패키지를 우선 선택하세요. 프로세서 제조사만으로 아키텍처를 판단하지 말고, 패키지와 런타임의 아키텍처가 서로 맞는지도 확인해야 합니다.
WPF 실행 전 확인
- UI 기술
- Windows Presentation Foundation
- 아키텍처 선택
- 시스템 종류에 맞춰 x64 또는 ARM64 선택
- 필요한 구성 요소
- .NET 프레임워크에 의존하는 패키지는 .NET Desktop Runtime이 필요할 수 있습니다
- 런타임 버전
- 실행 안내와 배포 노트에 명시된 주 버전을 기준으로 확인
.NET SDK만 설치했거나 다른 주 버전의 런타임을 설치한 것만으로는 현재 프로그램에 필요한 데스크톱 런타임을 충족하지 못할 수 있습니다.
Desktop 실행 전 확인
- UI 기술
- Avalonia 데스크톱 UI
- 아키텍처 선택
- Windows와 아키텍처에 맞는 배포 패키지 다운로드
- 필요한 구성 요소
- 패키지가 자체 포함 방식으로 배포되었는지에 따라 다릅니다
- 환경이 없는 경우
- 실행 안내에 표시된 .NET 런타임 설치
자체 포함 패키지는 해당 .NET 런타임을 따로 설치하지 않아도 되는 경우가 많지만, 운영체제 버전 및 기타 네이티브 구성 요소의 영향을 받을 수 있습니다.
“앱을 실행하려면 .NET을 설치하거나 업데이트해야 합니다”라는 메시지가 표시되면 먼저 안내에 나온 프레임워크 이름, 주 버전, 아키텍처를 확인하세요. WPF에 필요한 Windows Desktop Runtime은 기본 .NET Runtime과 다릅니다. 관련 없는 런타임을 여러 개 설치하거나 출처를 알 수 없는 DLL 파일을 내려받아 프로그램 폴더에 넣지 마세요. 실제 의존성 문제를 가릴 수 있습니다.
- 프레임워크가 없다는 안내가 표시되면 이름과 주 버전을 확인해 설치한 다음 클라이언트를 다시 실행하세요.
- 이 PC에서 실행할 수 없다는 안내가 표시되면 지원되는 운영체제인지, 아키텍처가 맞는지, 다운로드한 파일을 빠짐없이 압축 해제했는지 확인하세요.
- 메인 창은 열리지만 노드 실행에 실패하면 UI 런타임을 다시 설치하기보다 코어 파일과 실행 로그를 확인하세요.
압축 해제와 구독 추가: 순서대로 설정하기
아래에서는 Windows 포터블 압축 파일을 기준으로 설명합니다. 배포 버전에 따라 메뉴 이름이 조금 다를 수 있으므로 실제 UI를 확인하세요. 기본 순서는 고정된 폴더에 압축 해제, 클라이언트 실행, 구독 저장, 목록 업데이트, 서버 선택입니다. 압축 프로그램의 미리보기에서 실행 파일을 바로 실행하면 설정이나 코어 파일을 제대로 찾지 못할 수 있습니다.
-
배포 패키지 선택
클라이언트 다운로드 페이지에서 Windows, 프로세서 아키텍처, UI 종류에 맞는 항목을 선택하세요. 배포 패키지 설명을 먼저 확인한 뒤 포터블 버전과 설치 프로그램 중 하나를 고르면 됩니다.
-
전체 파일 압축 해제
모든 파일을 현재 계정에서 쓸 수 있는 고정 폴더에 압축 해제하세요. 예:
D:\Tools\v2rayN.v2rayN.exe만 따로 복사하지 말고, 장기간 사용할 설정을 임시 압축 해제 폴더에 두지 마세요. -
메인 프로그램 실행
v2rayN.exe를 실행하세요. 일반 시스템 프록시를 사용하는 데 관리자 권한은 보통 필요하지 않습니다. 런타임 안내가 표시되면 앞 절의 내용을 참고해 해결한 후 설정을 계속하세요. -
구독 저장
메인 화면에서 「구독 그룹」→「구독 그룹 설정」을 열고 그룹을 추가한 뒤 이름과 구독 주소를 입력해 저장하세요. 구독 주소는 접근 권한이 있는 정보이므로 공개 스크린샷에 포함하지 마세요.
-
목록 업데이트
「구독 그룹」에서 「전체 구독 업데이트(프록시 사용 안 함)」를 실행하세요. 사용할 수 있는 프록시가 아직 없다면 현재 네트워크로 구독을 가져오면 됩니다. 구독 출처에 별도의 접속 조건이 있다면 제공업체의 안내를 따르세요.
-
활성 서버로 설정
가져온 서버를 선택한 뒤 마우스 오른쪽 버튼 메뉴에서 「활성 서버로 설정」을 선택하세요. 로그에서 해당 코어가 정상적으로 시작되었는지 확인한 다음 시스템 프록시를 설정합니다. 목록에 추가된 것만으로 연결에 성공했다고 볼 수는 없습니다.
구독 주소 저장과 구독 내용 다운로드는 별개의 단계입니다. 목록이 비어 있다면 업데이트를 실행했는지, 로그에 요청 실패가 표시되는지, 다른 그룹이 선택되어 있지는 않은지 확인하세요. 구독 응답이 로그인 페이지나 만료 안내, 오류 문구라면 업데이트를 반복해도 사용할 수 있는 노드가 생기지 않습니다. 먼저 구독 출처 문제를 해결하세요.
시스템 프록시, 라우팅, TUN: 처음에는 연결 방식 하나만 사용
v2rayN은 코어를 실행한 뒤 로컬에 프록시 수신 주소를 제공합니다. Windows 시스템 프록시는 이 주소를 시스템 설정에 등록하는 기능이며, 시스템 프록시를 따르는 프로그램만 해당 주소를 사용합니다. 라우팅은 트래픽이 코어에 들어온 다음 연결을 직접 연결할지, 프록시로 보낼지, 차단할지 결정합니다. 두 기능은 서로 다른 단계입니다.
첫 연결 확인: 시스템 프록시부터, TUN은 필요할 때
일반 시스템 프록시
- 트레이 아이콘을 마우스 오른쪽 버튼으로 클릭해 「시스템 프록시」→「시스템 프록시 자동 설정」을 선택하세요.
- 시스템 프록시를 사용하는 브라우저에서 웹페이지가 열리는지 먼저 확인하세요.
- 메인 화면의 라우팅 선택 항목에서 현재 규칙 모드를 확인하세요.
- 종료하기 전에 시스템 프록시를 해제해, 중지된 포트가 계속 지정되지 않도록 하세요.
TUN 모드
- 시스템 프록시를 따르지 않지만 가상 네트워크 어댑터를 통해 트래픽을 처리해야 하는 프로그램에 적합합니다.
- 관리자 권한이 필요할 수 있으며 네트워크 어댑터, 라우팅, DNS 설정에 영향을 줍니다.
- 사용 중인 코어와 클라이언트의 안내에 따라 설정하세요. 출처를 알 수 없는 매개변수는 복사하지 마세요.
- 처음 문제를 확인할 때는 TUN을 끄고 일반 프록시가 작동하는 상태부터 확인하세요.
시스템 프록시와 TUN을 반드시 동시에 사용할 수 없는 것은 아닙니다. 처음 시험할 때 연결 방식을 단순하게 유지하면 노드 문제와 트래픽 처리 문제를 구분하기 쉽습니다.
로컬 포트를 확인하려면 「설정」→「매개변수 설정」에서 수신 포트 관련 항목을 찾으세요. 이전 버전과 최신 버전은 항목 이름과 기본값이 다를 수 있습니다. 아래에서는 HTTP 호환 로컬 주소 127.0.0.1:10808을 예로 듭니다. 숫자는 설명을 위한 예시입니다. 실제 수신 포트가 다르면 명령의 포트도 함께 바꿔야 합니다. 해당 포트가 SOCKS만 지원한다면 HTTP 프록시 명령을 그대로 사용할 수 없습니다.
curl.exe --proxy http://127.0.0.1:10808 --head --connect-timeout 10 https://example.com/이 명령은 시스템에 curl.exe가 있고 예시 포트가 HTTP 프록시를 지원하는 경우에 사용할 수 있습니다. HTTP 응답을 받았다는 것은 해당 요청에 응답이 왔다는 뜻일 뿐, 모든 사이트에 접속할 수 있거나 성능이 좋다는 의미는 아닙니다. 로컬 포트에 연결할 수 없다는 메시지가 나오면 클라이언트의 수신 상태를 확인하세요. 로컬 프록시에 연결된 뒤 시간 초과가 발생하면 활성 서버, 라우팅, DNS, 원격 연결을 확인하세요.
로그인 시 자동 실행: 클라이언트 실행과 프록시 복구를 따로 확인
데스크톱 클라이언트의 ‘시작 시 자동 실행’은 보통 사용자가 Windows에 로그인한 뒤 UI 프로그램을 시작한다는 뜻입니다. 로그인 전부터 프록시를 사용할 수 있다는 의미는 아닙니다. 먼저 수동 실행이 정상적으로 되는지 확인한 뒤 자동 시작을 설정하세요. 그렇지 않으면 로그인할 때마다 같은 오류가 반복됩니다.
- 「설정」→「매개변수 설정」에서 ‘시작 시 자동 실행’ 관련 옵션을 찾아 저장하세요. 옵션이 있는 탭은 버전에 따라 다를 수 있습니다.
- Windows의 「설정」→「앱」→「시작 프로그램」에서 관련 항목이 꺼져 있는지 확인하세요. 등록 방식에 따라 작업 스케줄러도 확인해야 할 수 있습니다.
- 프로그램 폴더 위치를 유지하세요. 폴더를 옮기면 기존 시작 항목이 이전 실행 파일을 가리킬 수 있으므로 다시 설정해야 합니다.
- 로그아웃한 뒤 다시 로그인해 트레이 아이콘, 활성 서버, 수신 포트를 확인하세요. 작업 관리자에 프로세스가 있는지만 확인해서는 안 됩니다.
- TUN이 필요하다면 권한 요청과 시작 방식도 확인하세요. 일반 로그인 시 자동 실행만으로 관리자 권한이 자동 부여되지는 않습니다.
클라이언트 실행과 시스템 프록시 복구는 각각 확인해야 합니다. 브라우저에서 직접 연결이 계속된다면 시스템 프록시가 켜지지 않았을 수 있습니다. 시스템 프록시를 사용하는 모든 프로그램이 연결되지 않는다면 Windows에 프록시 주소는 남아 있지만 클라이언트 코어가 아직 수신을 시작하지 않았을 수 있습니다. Windows의 「설정」→「네트워크 및 인터넷」→「프록시」에서 ‘수동 프록시 설정’의 주소와 포트를 확인하세요. 트레이 아이콘만 보고 판단하지 마세요.
자주 발생하는 문제와 UI 전환 시 확인 순서
WPF와 Desktop을 바꿔 보는 것은 UI 호환성 문제를 확인하는 데 도움이 되지만 모든 연결 문제를 해결하는 방법은 아닙니다. 창은 열리지만 노드 연결이 시간 초과된다면 로그를 먼저 확인하세요. 창 자체가 시작되지 않는 경우에만 아키텍처, 런타임, 파일 권한을 먼저 살펴보세요. 파일을 계속 덮어쓰기보다 문제가 발생한 단계에 따라 나누어 확인하는 편이 효과적입니다.
| 증상 | 우선 확인할 항목 | 해결 방법 |
|---|---|---|
| 실행 파일을 두 번 클릭한 뒤 프레임워크가 없다는 메시지가 표시됨 | 런타임 종류, 주 버전, 아키텍처 | 안내에 맞는 런타임을 설치하세요. 구독 설정은 변경하지 마세요. |
| 창은 열리지만 코어가 시작되지 않음 | 로그의 파일 경로, 설정 오류, 포트 충돌 | 파일을 빠짐없이 압축 해제했는지 확인하고 테스트용 인스턴스 하나만 실행하세요. |
| 업데이트한 뒤에도 서버가 표시되지 않음 | 구독 응답과 그룹 필터 | 업데이트 로그를 확인해 주소가 유효한지, 올바른 그룹을 선택했는지 확인하세요. |
| 브라우저는 되지만 다른 프로그램은 연결되지 않음 | 해당 프로그램이 시스템 프록시를 사용하는지 여부 | 앱 안내에 따라 프록시를 설정하고, TUN은 필요한 경우에만 검토하세요. |
| 클라이언트를 종료한 뒤 웹페이지가 열리지 않음 | Windows에 수동 프록시 설정이 남아 있는지 | 작동하지 않는 로컬 프록시를 해제한 뒤 직접 연결이 복구되는지 확인하세요. |
| 자동 실행 후 설정을 찾을 수 없음 | 실행 경로, 사용자 계정, 데이터 폴더 | 실제로 사용하는 데이터 위치를 확인해 다른 복사본을 실행하지 않도록 하세요. |
업그레이드와 버전 전환 전 복구 가능한 사본 보관
업그레이드 전에 클라이언트를 종료하고 실제 데이터 폴더와 현재 사용 중인 설정을 백업하세요. 포터블 버전은 프로그램 폴더에 데이터를 저장하는 경우가 많지만, 모든 배포 방식이 같은 위치를 사용한다고 단정할 수는 없습니다. 현재 클라이언트의 데이터 폴더 기능이나 설정, 배포 노트를 확인하세요. 백업에는 구독 주소와 서버 인증 정보가 포함될 수 있으므로 안전하게 보관해야 합니다.
- 새 배포 패키지는 별도 폴더에 압축 해제해 실행 중인 프로그램과 코어를 바로 덮어쓰지 마세요.
- 클라이언트의 내보내기 및 가져오기 기능을 우선 사용하세요. 수동으로 옮길 경우에는 양쪽 버전의 데이터 형식이 호환되는지 먼저 확인하세요.
- 새 복사본만 실행해 구독, 활성 서버, 라우팅, 시스템 프록시를 확인한 뒤 시작 항목을 다시 등록하세요.
- 새 버전에서 저장한 데이터를 이전 버전에서 읽을 수 있다고 보장할 수 없습니다. 이전 버전으로 되돌릴 때는 업그레이드 전 백업을 복원하고, 이전 프로그램에서 마이그레이션된 데이터를 직접 열지 마세요.
선택은 어렵지 않습니다. Windows에서만 사용한다면 WPF부터 써 보고, 여러 플랫폼에서 비슷한 UI를 원한다면 Desktop을 사용해 보세요. 어느 쪽이든 아키텍처 확인, 전체 압축 해제, 런타임 점검, 일반 시스템 프록시 연결 확인을 먼저 마친 뒤 로그인 시 자동 실행, 규칙 변경, TUN을 추가하세요. 기본 설정은 입문 가이드를 참고하고, 연결 문제가 있으면 사용 설명서에 따라 단계별로 확인하세요.