Windows용 v2rayN 설정

1. 데스크톱 버전과 WPF 버전 중 선택하기

v2rayN은 노드, 구독, 라우팅과 로컬 프록시 연결을 관리하는 클라이언트이며, 실제 연결은 코어가 처리합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 Windows의 클래식 인터페이스를 유지합니다. 어느 한쪽만 VLESS를 지원한다고 단정할 수는 없습니다. 지원 프로토콜은 선택한 코어와 버전, 서버 설정의 호환 여부에 따라서도 달라집니다.

Windows 11에서 「설정」→「시스템」→「시스템 정보」를 열고 「시스템 종류」를 확인하세요. 일반적인 Intel·AMD 컴퓨터는 대개 x64를 선택합니다. ARM 장치에서는 x64와 ARM64를 같은 기본 아키텍처로 취급하지 마세요. 다운로드 페이지에 맞는 항목이 없다면 프로그램을 반복 실행하기보다 해당 릴리스의 시스템 지원 안내를 먼저 확인하세요.

2. 설치 폴더와 실행 환경

다운로드 페이지에서 Windows 설치 패키지를 선택하세요. 릴리스에 따라 설치 프로그램이나 압축 파일이 제공될 수 있습니다. 설치 프로그램은 안내에 따라 설치하고, 압축 파일은 먼저 전체 압축을 푼 다음 폴더 안의 v2rayN.exe를 실행하세요. 압축 프로그램의 미리보기 창에서 실행 파일을 바로 두 번 클릭하지 마세요. 실행 파일만 임시로 풀리고 종속 파일이나 코어 폴더는 준비되지 않을 수 있습니다.

1. 설치 폴더 정하기

   포터블 패키지는 D:\Tools\v2rayN처럼 현재 사용자에게 쓰기 권한이 있는 폴더에 두세요. 임시 폴더나 보호되는 시스템 폴더는 피하세요. 앱에서 설정, 로그, 구독 데이터도 저장해야 합니다.

2. 압축 파일 전체 풀기

   패키지에 들어 있는 폴더 구조를 그대로 유지하세요. 설치 프로그램이라면 설치를 완료하고, 설치 프로그램이 있는 폴더를 앱 데이터 폴더로 사용하지 마세요.

3. 필요한 종속 항목 확인

   시작할 때 .NET 설치 안내가 나오면 프레임워크 이름, 주 버전, 아키텍처를 확인하세요. WPF 패키지에 필요한 Desktop Runtime을 안내에 따라 설치해야 합니다. SDK만 설치하거나 다른 주 버전의 런타임을 설치해도 문제가 해결되지 않을 수 있습니다.

4. 처음 실행하기

   먼저 일반 사용자 권한으로 실행하세요. 「설정」→「매개변수 설정」에서 기본 설정을 확인하고 메인 화면의 로그를 살펴보세요. 메인 프로그램은 열렸지만 프록시 코어가 시작되지 않은 상태인지 확인해야 합니다.

3. 구독 가져오기와 노드 선택

구독 주소에는 보통 로그인 정보가 포함되므로 비밀번호처럼 다루세요. 전체 주소가 보이는 화면을 공개적으로 공유하지 마세요. 주소를 열었을 때 긴 텍스트가 표시된다고 해서 잘못된 주소인 것은 아닙니다. 클라이언트는 일반 웹페이지를 보여주는 것이 아니라 구독 응답을 해석합니다. 로그인 페이지, 오류 페이지, 만료 안내가 표시될 때 구독 자체를 확인하세요.

1. 그룹 추가하기

   메인 화면에서 「구독 그룹」→「구독 그룹 설정」을 열고 추가 기능을 선택하세요. 알아보기 쉬운 별칭과 구독 주소를 입력한 다음 저장합니다. 인터페이스 버전에 따라 추가 기능이 「추가」나 더하기 기호로 표시될 수 있습니다.

2. 구독 업데이트하기

   「구독 그룹」 메뉴로 돌아가 처음에는 「모든 구독 업데이트(프록시 사용 안 함)」를 선택하세요. 별도의 「프록시를 통해 업데이트」 옵션이 있다면 끈 상태로 두고, 구독 주소에 직접 접속할 수 있는지 먼저 확인하세요.

3. 업데이트 결과 확인

   로그에서 업데이트 결과를 확인한 다음 해당 그룹으로 전환하세요. 업데이트에 성공했는데 목록이 비어 있다면 검색창과 서버 필터를 비우고 다른 그룹이 선택되어 있지 않은지 확인하세요.

4. 활성 노드로 설정

   서버 목록에서 노드를 선택한 다음 마우스 오른쪽 버튼을 눌러 「활성 서버로 설정」을 선택하세요. 코어가 설정을 불러올 때까지 기다린 뒤 연결을 테스트합니다. 목록에서 행을 한 번 클릭하는 것만으로는 현재 활성 노드가 바뀌지 않을 수 있습니다.

구독 주소에 프록시를 통한 접속이 필요하다면 먼저 연결 가능한 노드 하나를 확보한 뒤 「모든 구독 업데이트(프록시 사용)」를 선택하세요. 이 옵션만으로 첫 연결을 만들 수는 없습니다. VLESS, VMess 등의 노드를 가져온 뒤에는 구독에 포함된 전송 방식, TLS, SNI 및 기타 매개변수를 그대로 유지하세요. 시험 삼아 여러 항목을 동시에 바꾸지 마세요.

4. 시스템 프록시와 로컬 포트

노드를 활성화한 다음 시스템 트레이 메뉴에서 「시스템 프록시」→「시스템 프록시 자동 설정」을 선택하세요. 현재 버전에서 해당 항목이 트레이 메뉴에 바로 표시되면 같은 이름의 작업을 선택하면 됩니다. 시스템 프록시는 Windows 프록시 설정을 따르는 앱이 로컬 프록시 포트로 요청을 보내도록 지정하는 기능입니다. 모든 프로그램이 자동으로 프록시를 사용하는 것은 아닙니다.

위 포트는 이 문서의 문제 해결 예시이며 모든 버전의 기본값은 아닙니다. 「설정」→「매개변수 설정」에서 현재 로컬 수신 포트와 수신 유형을 확인하세요. 최신 설정에서는 HTTP와 SOCKS 요청을 함께 받는 혼합 포트를 제공할 수 있습니다. 구형 설정 중에는 두 포트를 구분하는 경우도 있으므로, 인접한 포트 번호가 반드시 HTTP 포트라고 가정하고 오래된 안내를 그대로 따라 하지 마세요.

curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 15 -I https://www.microsoft.com/

해당 포트가 실제로 HTTP 프록시 요청을 받는 경우에만 이 명령을 사용하세요. HTTP 응답 헤더가 돌아오면 이번 요청이 지정한 경로를 통해 통신했다는 뜻일 뿐, 모든 웹사이트나 라우팅이 정상이라는 의미는 아닙니다. 테스트에 「프록시에 연결할 수 없음」이 표시되면 로컬 수신 상태부터 확인하세요. 원격 핸드셰이크 오류가 나타나면 노드를 점검하세요. 라우팅은 이해할 수 있는 기존 규칙 세트부터 사용하고, 첫 테스트에서 DNS와 사용자 지정 라우팅을 함께 수정하지 마세요.

5. TUN 모드는 언제 켤까?

브라우저는 시스템 프록시로 연결되지만 시스템 프록시를 사용하지 않는 프로그램은 연결되지 않을 때 TUN 모드를 고려하세요. TUN은 가상 네트워크 인터페이스로 설정에 해당하는 트래픽을 처리하며 라우팅과 DNS에도 영향을 줍니다. 시스템 프록시가 작동한다고 해서 TUN에 필요한 권한, 드라이버, 네트워크 어댑터 환경까지 준비된 것은 아닙니다.

• 먼저 기준 상태 저장: 정상 작동하는 노드, 시스템 프록시 상태, 라우팅 규칙을 기록해 나중에 되돌릴 기준을 마련하세요.
• 그다음 권한 확인: 메인 화면에서 「TUN 모드」를 켜세요. 버전에서 권한 상승을 요구하면 안내에 따라 다시 시작하거나 권한을 부여하세요. 일반 프록시 사용까지 모두 관리자 권한으로 실행할 필요는 없습니다.
• 시작 로그 확인: TUN에서 사용하는 코어가 정상적으로 시작됐는지 확인하고 권한 부족, 인터페이스 생성 실패, 라우팅 추가 실패 기록을 살펴보세요. 스위치 색상만 확인해서는 안 됩니다.
• 네트워크 충돌 분리: 다른 터널이나 가상 네트워크 어댑터 프로그램이 라우팅에 영향을 줄 수 있습니다. 문제를 확인할 때는 트래픽을 가로채는 방식을 한 번에 하나만 사용하세요. 회사 장비에서는 먼저 네트워크 관리 정책을 따르세요.
• 문제가 생기면 즉시 되돌리기: TUN을 끈 다음 시스템 프록시를 다시 테스트하세요. 정상화된다면 구독 전체를 삭제하기보다 TUN의 DNS, 라우팅, 네트워크 어댑터 설정부터 확인하세요.

시스템 프록시를 함께 유지할지는 현재 설정과 사용 환경에 따라 결정해야 합니다. 두 기능을 항상 동시에 켜야 하는 것은 아닙니다. 처음 문제를 해결할 때는 두 연결 방식을 따로 테스트하면 원인을 찾기 쉽습니다. 명시적 프록시 요청은 성공하지만 TUN에서는 접속되지 않는다면 같은 노드를 계속 바꾸기보다 트래픽 처리 경로를 확인하세요.

6. 시작 오류, 포트 충돌, 웹 접속 문제 해결

「메인 프로그램 → 코어 → 로컬 포트 → 노드 연결 → 앱 설정」순서로 확인하세요. 프로그램 창이 표시된다는 것은 인터페이스가 시작됐다는 뜻일 뿐입니다. 지연 시간 테스트에 결과가 나와도 브라우저가 프록시를 사용한다는 보장은 없습니다. 오류가 발생한 시점의 로그를 먼저 보관한 뒤 해당 문제를 해결하세요. 클라이언트를 재설치하고 포트를 바꾸고 라우팅까지 한꺼번에 변경하는 것보다 원인을 파악하기 쉽습니다.

netstat -ano -p tcp | findstr LISTENING | findstr ":10808 "

명령 출력의 마지막 열은 PID입니다. 출력이 없으면 포트 번호가 맞는지, 코어가 실제로 시작됐는지도 확인하세요. 로그에 인증서 만료, 이름 불일치, TLS 핸드셰이크 실패가 표시되면 Windows 시간이 맞는지 확인하고 구독의 SNI, 서버 주소, 전송 설정을 점검하세요. 「인증서 검증 건너뛰기」를 일반적인 해결책으로 사용하지 마세요. HTTP 프록시 프로토콜과 접속 대상의 HTTPS 암호화는 서로 다른 계층이므로 웹페이지가 HTTPS라는 이유로 로컬 연결 유형을 임의로 바꾸지 마세요.

7. 업데이트와 이전 전에 보관할 항목

정상 작동을 확인한 뒤 시작 시 자동 실행이나 구독 자동 업데이트 같은 편의 기능을 설정하세요. 업데이트 전에 v2rayN과 코어를 종료하고 실제 데이터 폴더를 백업하세요. 데이터 위치는 설치 방식에 따라 다를 수 있으므로 메인 프로그램 경로만 보고 판단하면 안 됩니다. 데스크톱 버전과 WPF 버전 사이를 이전할 때는 구독을 다시 가져온 뒤 라우팅과 포트를 확인하세요. 설정 호환성을 확인하지 않고 폴더 전체를 덮어쓰지 마세요.

• 구독 정보: 그룹 이름과 신뢰할 수 있는 구독 주소를 보관하세요. 백업 파일을 공개적으로 공유하지 마세요.
• 로컬 설정: 수신 포트, 시스템 프록시 모드, 라우팅 규칙, TUN 사용 여부를 기록하세요.
• 수동 설정: 직접 추가한 노드와 사용자 지정 규칙은 별도로 백업하세요. 구독을 다시 가져와도 이 항목들은 자동으로 복원되지 않습니다.
• 업데이트 후 재확인: 코어 시작, 구독 업데이트, 단일 프록시 요청 순으로 확인한 다음 TUN과 자동 시작을 점검하세요.

이 항목들을 확인한 뒤에는 구독 업데이트, 활성 노드 선택, 연결 방식 상태 확인이 주된 일상 관리 작업입니다. 문제가 생기면 같은 순서로 다시 점검하세요. 설치 문제와 네트워크 문제를 구분하고 마지막으로 정상 작동한 설정으로 쉽게 되돌릴 수 있습니다.