v2rayN Windows 설치 및 설정 가이드: 데스크톱판과 WPF판 비교

데스크톱판과 WPF판, 무엇을 선택할까요?

먼저 인터페이스와 실행 환경을 살펴보세요. 버전 계열을 회선 성능 등급으로 혼동하지 않는 것이 중요합니다. 여기서 ‘데스크톱판’은 크로스 플랫폼 인터페이스를 사용하는 계열이며, WPF판은 Windows 전용 UI 기술을 사용합니다. 두 버전 모두 프록시 코어가 필요하며 실제 연결 성능은 노드, 프로토콜, 라우팅 및 코어 설정에 따라 달라집니다.

아키텍처는 시스템 정보를 기준으로 확인하세요. Windows에서 「설정」→「시스템」→「정보」를 열어 ‘시스템 종류’를 확인합니다. x64 기기에는 x64 패키지를, ARM64 기기에는 배포자가 제공하는 네이티브 호환 패키지를 우선 선택하세요. 시스템 아키텍처, 프로그램 아키텍처, 런타임 아키텍처를 모두 확인해야 합니다.

다운로드 파일은 어디에 두고 런타임은 어떻게 설치하나요?

압축을 완전히 푼 다음 기본 프로그램을 실행하세요. 현재 계정에서 쓸 수 있는 별도 폴더(예: D:\Tools\v2rayN)를 권장합니다. D 드라이브가 없다면 사용자 폴더에 저장해도 됩니다. 압축 파일 안에서 바로 실행하거나 실행 파일 하나만 꺼내면 설정 폴더, 코어 파일 또는 관련 리소스가 누락될 수 있습니다.

1. 설치 패키지 선택

   이 사이트의 다운로드 페이지에서 Windows 옵션을 열고 x64 또는 ARM64 아키텍처와 데스크톱판 또는 WPF판에 맞는 패키지를 선택하세요. 패키지의 실행 환경 안내도 함께 확인하세요.

2. 압축 파일 전체 해제

   파일 탐색기에서 압축 파일을 마우스 오른쪽 버튼으로 클릭한 뒤 「모두 압축 풀기」를 선택하세요. 대상 폴더를 열어 기본 프로그램과 관련 폴더가 함께 있는지 확인한 다음 v2rayN.exe를 실행합니다.

3. 런타임 설치

   실행 시 .NET이 없다는 안내가 표시되면 필요한 버전과 아키텍처를 확인하세요. WPF판은 필요한 경우 일반 Runtime이 아닌 해당 Desktop Runtime을 설치합니다. 자체 포함 패키지는 배포 안내를 따르세요.

4. 코어 파일 확인

   기본 화면의 로그 영역에서 시작 결과를 확인하세요. “파일을 찾을 수 없음” 오류가 나타나면 압축이 완전히 풀렸는지 먼저 확인합니다. 이어서 「Windows 보안」→「바이러스 및 위협 방지」→「보호 기록」에서 차단 내역을 확인하세요.

모든 배포 패키지에 공통으로 적용되는 고정 런타임 버전은 없습니다. 프로그램 업데이트에 따라 필요한 실행 환경이 달라질 수 있으므로 이전 컴퓨터에 특정 버전의 .NET이 설치되어 있어도 새 패키지의 요구 사항을 충족한다고 볼 수 없습니다. 현재 패키지 안내와 실행 오류를 기준으로 필요한 항목만 설치하고, 관련 없는 구성 요소를 여러 개 연달아 설치하지 마세요.

구독 링크는 어떻게 가져오고 노드는 어떻게 활성화하나요?

구독 그룹을 만든 뒤 업데이트하고 서버를 선택하세요. v2rayN은 클라이언트이므로 설치만으로 사용할 수 있는 노드가 자동 생성되지 않습니다. 구독 주소는 서비스 제공자가 발급하며 보통 비밀 토큰이 포함되어 있습니다. 계정 자격 증명처럼 안전하게 보관하고 공개 스크린샷이나 온라인 변환 사이트에 붙여넣지 마세요.

1. 구독 그룹 만들기

   일반적인 중국어 인터페이스에서는 「구독 그룹」→「구독 그룹 설정」으로 이동해 「추가」를 클릭하고, 이름과 구독 주소를 입력한 뒤 저장합니다. 현재 인터페이스에 ‘+’ 버튼이 있다면 같은 그룹 관리 화면에서 새 항목을 추가하세요.

2. 구독 업데이트

   프록시 연결이 아직 없는 첫 실행에서는 「구독 그룹」→「모든 구독 업데이트(프록시 사용 안 함)」를 선택해 가져오기를 시도하세요. 사용 가능한 프록시 연결이 있을 때만 프록시를 통한 업데이트 옵션을 사용하세요.

3. 활성 서버로 설정

   서버 목록에서 항목을 선택하고 마우스 오른쪽 버튼을 눌러 「활성 서버로 설정」을 선택한 뒤 로그에서 코어 실행 결과를 확인하세요. 메뉴 이름은 버전에 따라 조금 다를 수 있으니 활성 서버 상태를 기준으로 확인하세요.

4. 설정값 확인

   서버를 더블 클릭해 프로토콜, 주소, 포트 및 전송 매개변수를 확인하세요. 구독에서 제공한 VLESS, VMess 등의 설정은 그대로 유지하는 것이 좋습니다. 항목 형식을 맞추려고 임의로 수정하지 마세요.

업데이트에 성공했다는 것은 노드 목록을 가져왔다는 뜻일 뿐, 모든 회선에 연결할 수 있다는 의미는 아닙니다. 업데이트 후 목록이 비어 있다면 계정 관리 웹페이지 주소를 붙여넣지는 않았는지 먼저 확인하고, 구독 만료 여부와 필요한 형식을 확인하세요. 지원하지 않는 형식이라는 오류가 나면 시스템 프록시 설정을 계속 바꾸기보다 클라이언트에서 인식할 수 있는 구독 주소를 제공자에게 요청하세요.

시스템 프록시는 어떻게 켜고 로컬 포트에는 무엇을 입력하나요?

먼저 로컬에서 연결을 수신하는지 확인한 뒤 시스템 프록시를 켜세요. 코어는 이 컴퓨터에서 연결을 수신하고, 시스템 프록시는 Windows 프록시 설정을 따르는 앱에 해당 로컬 주소로 연결하라고 알립니다. 두 기능은 서로 다른 설정입니다. 서버만 선택하고 시스템 프록시를 켜지 않으면 브라우저가 계속 직접 연결할 수 있습니다.

「설정」→「매개변수 설정」에서 로컬 수신 포트를 확인하세요. 버전에 따라 ‘기본 설정’이나 ‘인바운드 설정’에 있을 수 있습니다. 여기서는 10808을 예로 들며, 모든 버전의 기본값이라는 뜻은 아닙니다. 이전 설정은 SOCKS와 HTTP 포트를 따로 제공할 수 있고, 최신 설정은 혼합 포트를 제공할 수도 있습니다. 실제 인바운드 유형에 맞춰 입력하세요.

작업 표시줄 알림 영역의 v2rayN 아이콘을 마우스 오른쪽 버튼으로 클릭하고 「시스템 프록시」→「시스템 프록시 자동 설정」을 선택하세요. 그런 다음 Windows 「설정」→「네트워크 및 인터넷」→「프록시」에서 프록시 주소와 포트가 로컬 HTTP 또는 혼합 인바운드와 일치하는지 확인합니다. 브라우저에 별도의 프록시 규칙이 설정되어 있다면 시스템 설정을 덮어쓰는지 먼저 확인하세요.

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

이 명령은 연결 확인을 위한 예시이지 속도 측정용이 아닙니다. socks5h는 대상 도메인의 이름 확인을 프록시에서 처리하도록 지정합니다. HTTP 응답이 돌아오면 해당 요청에 응답 경로가 있었다는 뜻이지만, 실제로 사용된 아웃바운드는 로그와 함께 확인해야 합니다. 터미널은 보통 Windows 시스템 프록시 설정을 자동으로 따르지 않으므로 터미널 테스트 실패만으로 브라우저 프록시가 작동하지 않는다고 단정할 수 없습니다.

라우팅 모드와 TUN, 첫 설정에서 바꿔야 할까요?

첫 연결에서는 이해하기 쉽고 확인 가능한 라우팅 규칙을 유지하고 여러 트래픽 가로채기 방식을 동시에 켜지 마세요. 시스템 프록시는 어떤 앱의 요청을 클라이언트로 보낼지 결정하고, 라우팅 분기는 클라이언트에 들어온 연결이 어떤 아웃바운드를 사용할지 결정합니다. 따라서 시스템 프록시가 켜져 있어도 규칙에 따라 직접 연결될 수 있습니다.

• 라우팅 규칙이 적용됐는지 먼저 확인: 테스트 요청을 보낸 뒤 로그에서 대상, 아웃바운드 태그 및 오류를 확인하세요. 요청이 로그에 전혀 나타나지 않으면 앱의 프록시 설정부터 확인해야 합니다.
• 규칙을 수정한 뒤 다시 불러오기: 설정을 저장하고 코어가 성공적으로 다시 로드됐는지 확인하세요. 기존 연결은 이전 경로를 계속 사용할 수 있으므로 필요한 경우 테스트할 앱을 다시 시작하세요.
• TUN은 필요한 경우에만 사용: 시스템 프록시를 따르지 않는 앱의 트래픽을 처리할 때 유용하지만, 해당 권한과 가상 네트워크 설정이 필요합니다. 켜기 전에 일반 프록시 연결이 작동하는지 확인하세요.
• LAN 접근은 별도로 판단: 프린터, 공유 폴더 및 내부 도메인에는 적절한 직접 연결과 DNS 설정이 필요합니다. 문제를 해결하려고 모든 트래픽을 장기간 원격으로 강제 전송하지 마세요.

오류를 없애려고 코어를 함부로 바꾸지 마세요. 노드 프로토콜과 확장 매개변수를 지원하는 코어가 필요하며, 특히 VLESS의 특정 전송 및 보안 설정을 확인해야 합니다. “지원하지 않는 필드” 오류가 발생하면 구독 필드를 삭제하지 말고 현재 코어 유형과 버전 요구 사항을 먼저 확인하세요.

실행 불가, 시간 초과, 포트 충돌은 어떻게 구분하나요?

프로그램 실행 여부, 로컬 수신 여부, 원격 연결 여부 순으로 확인하면 불필요한 변경을 줄일 수 있습니다. 기본 창이 정상적으로 표시된다는 것은 인터페이스가 실행됐다는 뜻일 뿐입니다. 코어 프로세스가 종료됐다면 시스템 프록시가 계속 로컬 주소를 가리켜도 사용할 수 있는 프록시 인바운드는 없습니다.

포트를 확인할 때는 다음 명령을 사용할 수 있습니다. 수신 중인 항목이 표시되면 마지막 열이 프로세스 PID입니다. 작업 관리자의 「세부 정보」에서 PID로 프로그램을 확인하세요. 포트 번호만 보고 정체를 모르는 시스템 프로세스를 종료하지 마세요. HTTP와 SOCKS 인바운드가 서로 다른 경우 같은 주소와 포트를 함께 사용하지 않도록 합니다.

netstat -ano | findstr ":10808"

원격 연결이 시간 초과되면 별도의 노드로 비교 테스트하고 주소, 포트, TLS 서버 이름, 전송 경로 등의 설정이 제공자가 안내한 값과 일치하는지 확인하세요. 로그를 다른 사람에게 보내기 전에 구독 주소, 사용자 ID 및 접속 대상을 가리세요. 원본 설정 전체를 공개하는 것은 일반적으로 적절하지 않습니다.

사용을 마친 뒤 어떻게 종료하고 업데이트하나요?

종료하기 전에 시스템 프록시를 해제하고, 업데이트하기 전에 설정을 백업하세요. 클라이언트를 닫은 뒤에도 Windows가 중지된 로컬 포트로 앱 요청을 보내는 상황을 방지할 수 있습니다. 새 버전과 설정이 호환되지 않을 때도 백업이 있으면 원인을 확인하기 쉽습니다.

1. 트레이 메뉴에서 「시스템 프록시」→「시스템 프록시 해제」를 선택한 다음 프로그램을 종료하세요. 비정상 종료 후에는 Windows 프록시 설정을 직접 확인해 남아 있는 주소를 삭제하세요.
2. 클라이언트 설정 폴더와 필요한 사용자 지정 라우팅을 백업하세요. 백업 파일에도 민감한 정보가 포함될 수 있으므로 접근이 제한된 위치에 보관해야 합니다.
3. 업데이트할 때는 기존 프로그램을 먼저 종료해 사용 중인 코어 파일이 덮어써지지 않도록 하세요. 버전 계열을 바꾼다면 두 버전의 파일을 섞지 말고 새 폴더에서 먼저 테스트하세요.
4. 다시 시작한 뒤 활성 서버, 코어 로그, 로컬 포트, 시스템 프록시를 차례로 확인한 다음 실제 웹페이지에 접속해 보세요.

이 네 가지를 확인한 뒤 자동 시작, 구독 정기 업데이트, TUN 등의 옵션을 고려하세요. 첫 설정의 목표는 모든 기능을 한꺼번에 켜는 것이 아니라 확인 가능한 연결 경로를 만드는 것입니다. 정상 작동이 확인된 설정을 하나 보관해 두면 이후 문제도 쉽게 비교하고 원인을 찾을 수 있습니다.