v2rayN Windows 설치 및 설정 가이드: WPF와 크로스 플랫폼 데스크톱 버전 비교

WPF와 크로스 플랫폼 데스크톱 버전, 무엇을 선택할까

v2rayN은 노드, 구독, 프록시 설정을 관리하는 클라이언트이며 실제 연결은 설정에 맞는 프록시 코어가 처리합니다. WPF 버전과 크로스 플랫폼 데스크톱 버전의 차이는 주로 인터페이스 기술과 사용 환경에 있으며, 프록시 프로토콜이 다른 것은 아닙니다. 노드 사용 가능 여부는 코어 기능, 설정값, 서버 상태에 따라 달라지므로 인터페이스 버전만으로 판단할 수 없습니다.

두 버전을 같은 폴더에 압축 해제하거나 시스템 프록시와 TUN을 동시에 켜지 마세요. 다른 버전을 시험하기 전에는 현재 버전의 시스템 프록시를 해제하고 트레이 프로그램을 종료하세요. 설정 파일이 서로 덮어써지는 일을 막고, 어떤 프로세스가 포트를 사용 중인지도 명확히 알 수 있습니다.

다운로드 전 아키텍처 확인, 쓰기 가능한 폴더에 압축 해제

먼저 Windows의 「설정」→「시스템」→「정보」에서 「시스템 종류」를 확인하세요. 일반적인 Intel·AMD 데스크톱 PC는 대개 x64 패키지를 선택합니다. ARM 기기는 다운로드 페이지와 릴리스 노트에서 아키텍처 지원 여부를 확인하세요. ‘64비트’라는 표시만으로 판단하면 안 됩니다. 다운로드 링크는 클라이언트 다운로드 페이지에 모아 두었습니다.

1. 설치 파일 확인

   패키지 이름에서 Windows용인지, 필요한 아키텍처와 WPF 또는 크로스 플랫폼 데스크톱 버전에 맞는지 확인하세요. 설치 프로그램이라면 안내에 따라 설치하고, 압축 파일이라면 아래 단계에 따라 압축을 푸세요.

2. 파일 전체 압축 해제

   압축 파일을 현재 계정에서 쓸 수 있는 고정 폴더(예: 사용자 폴더 아래 Apps\v2rayN)에 빠짐없이 압축 해제하세요. 압축 프로그램의 미리 보기 창에서 바로 실행하지 마세요.

3. 파일 구성 확인

   메인 프로그램과 패키지에 포함된 설정 및 코어 관련 폴더 구조를 그대로 유지하세요. v2rayN.exe만 바탕 화면에 복사하면 의존 파일이나 코어 파일을 찾지 못할 수 있습니다. 바로가기가 필요하면 바로 가기 아이콘을 만드세요.

4. 첫 실행

   일반 사용자 권한으로 메인 프로그램을 실행하고, 처음에는 TUN을 켜지 마세요. 메인 화면이 열리면 로그에서 설정 저장 실패, 파일 누락, 코어 실행 오류가 있는지 확인하세요.

실행되지 않을 때: 먼저 실행 환경 안내 확인

더블클릭해도 창이 뜨지 않는다고 노드에 문제가 있는 것은 아닙니다. 아직 네트워크 연결 단계에 도달하지 않았으므로 프로그램이 트레이로 최소화됐는지, 실행 환경이 부족한지, 아키텍처가 맞지 않는지, 보안 소프트웨어가 파일을 격리했는지부터 확인하세요. 작업 관리자에서 v2rayN 프로세스가 실행 중인지 확인하고 작업 표시줄 알림 영역도 살펴보세요.

실행 환경 요구 사항은 배포 패키지마다 달라지므로 오래된 가이드의 특정 주 버전 번호를 그대로 따르지 마세요. 실행 환경을 포함한 자체 포함 패키지와 시스템 실행 환경에 의존하는 패키지는 해결 방법도 다릅니다. 실제 시작 안내와 해당 릴리스 노트를 기준으로 확인하세요. 설치를 마친 뒤 클라이언트를 다시 실행해 오류가 계속 나타나는지 살펴보세요.

처음 구독 가져오기: 갱신한 다음 노드 활성화

구독 주소와 개별 노드 공유 링크는 입력 방식이 다릅니다. 구독은 보통 노드 목록을 가져오는 HTTPS 주소이며, VMess·VLESS 등의 공유 링크는 단일 설정을 나타냅니다. 웹페이지 주소, 로그인 페이지 주소, 불필요한 설명이 붙은 내용을 구독 입력란에 붙여 넣으면 갱신 후 노드가 표시되지 않을 수 있습니다.

1. 그룹 추가

   메인 화면에서 「구독 그룹」→「구독 그룹 설정」으로 이동한 뒤 추가 또는 「+」를 선택하세요. 알아보기 쉬운 그룹 이름을 입력하고 전체 구독 주소를 주소 입력란에 붙여 넣은 다음 저장합니다. 일부 인터페이스에서는 그룹 관리 버튼 안에 메뉴가 있으니 같은 이름의 기능을 찾으세요.

2. 구독 갱신

   처음 설정해 사용할 수 있는 프록시가 없다면 「구독 그룹」→「모든 구독 갱신(프록시 사용 안 함)」을 선택하세요. 구독 주소에 프록시를 통해서만 접속할 수 있다면 먼저 사용 가능한 설정을 준비한 뒤 「모든 구독 갱신(프록시 사용)」을 선택하세요.

3. 목록 확인

   갱신 로그가 성공으로 표시되는지 확인하고, 방금 만든 그룹이 선택되어 있는지 살펴보세요. 목록이 비어 있다면 구독이 만료됐는지, 응답이 로그인 페이지인지, 그룹 필터가 다른 노드를 숨기고 있는지 확인하세요.

4. 활성 노드로 설정

   사용할 노드를 선택한 뒤 마우스 오른쪽 버튼 메뉴에서 「활성 서버로 설정」을 눌러 활성화하세요. 로그에서 해당 코어가 정상적으로 실행되는지 확인한 다음 연결을 테스트하세요. 목록에서 행 하나를 선택하는 것만으로는 전환이 완료되지 않을 수 있습니다.

구독 링크에는 계정 접근 토큰이 포함되는 경우가 많으므로 공개 채팅방에 올리거나 전체 링크가 보이는 스크린샷을 모르는 사람에게 보내지 마세요. 문제를 확인할 때는 오류 메시지, 프로토콜, 갱신 시각만 기록하면 됩니다. 클라이언트 로그에 노드 주소나 사용자 식별 정보가 포함되어 있다면 공유 전에 가리세요.

노드 테스트 결과는 참고 자료일 뿐입니다. TCP 연결 성공이 TLS, 인증, 이후 요청까지 성공한다는 뜻은 아닙니다. 테스트 시간 초과도 테스트 대상에 연결할 수 없어서 발생할 수 있습니다. 노드를 활성화한 뒤 로그와 실제 웹 요청을 함께 확인하고, 지연 시간 숫자만 보고 반복해서 전환하지 마세요.

시스템 프록시 설정: 먼저 로컬 수신 포트 확인

「설정」→「환경 설정」에서 로컬 수신 포트와 해당 인바운드 프로토콜을 확인하세요. 아래 세 숫자는 설정을 식별하기 위한 예시이며, 모든 버전이 이 포트를 동시에 수신하는 것은 아닙니다. 특히 오래된 가이드의 HTTP 포트를 새 버전에 그대로 적용하지 마세요. 실제 값은 현재 설정과 시작 로그를 기준으로 확인해야 합니다.

• 노드가 활성 서버로 설정되어 있고 코어 로그에 시작 오류가 없는지 먼저 확인하세요.
• 메인 화면 하단이나 트레이 아이콘의 마우스 오른쪽 버튼 메뉴에서 「시스템 프록시」→「시스템 프록시 자동 구성」을 선택하세요. 메뉴 위치는 인터페이스에 따라 다를 수 있으며, 이 기능은 Windows 프록시 설정을 적용합니다.
• Windows의 「설정」→「네트워크 및 인터넷」→「프록시」를 열고 주소와 포트가 클라이언트에서 실제로 제공하는 로컬 HTTP 또는 혼합 수신 포트를 가리키는지 확인하세요.
• 브라우저 확장 프로그램이 프록시를 별도로 관리한다면 Windows 프록시 설정을 따르도록 변경하세요. 확장 프로그램 설정이 Windows 프록시를 덮어쓰는 일을 막을 수 있습니다.
• 대상 웹페이지에 접속해 클라이언트 로그를 확인하세요. 테스트가 끝난 뒤 클라이언트를 종료할 예정이라면 먼저 「시스템 프록시 해제」를 선택하세요.

「시스템 프록시 자동 구성」이라는 메뉴 이름은 모든 앱이 프록시를 사용하거나 가장 빠른 노드가 자동 선택된다는 뜻이 아닙니다. Windows 시스템 프록시를 따르는 앱만 이 설정을 사용하고, 다른 프로그램은 계속 직접 연결할 수 있습니다. 요청이 코어에 들어온 뒤 프록시를 사용할지 직접 연결할지는 클라이언트의 라우팅 규칙에 따라 달라집니다.

포트 충돌과 권한 부족: 증상별 확인 방법

로그에 address already in use 또는 바인딩 실패가 표시되면 설정을 바로 삭제하지 말고 수신 포트부터 확인하세요. 가장 흔한 원인은 이전 프로세스가 트레이에서 계속 실행 중이거나 다른 클라이언트가 같은 포트를 사용 중인 경우입니다. 아래 명령은 로컬 TCP 수신 상태를 조회할 뿐 네트워크 설정을 변경하지 않습니다.

netstat -ano -p tcp | findstr LISTENING | findstr ":10808"
tasklist /FI "PID eq 1234"

첫 번째 명령의 마지막 열에 PID가 표시됩니다. 두 번째 명령의 1234는 사용 예시이므로 첫 번째 명령에서 실제로 확인한 PID로 바꾸세요. 로컬 주소의 포트가 실제로 10808인지 확인한 뒤 프로세스의 용도를 판단하세요. 숫자가 포함된 텍스트만 보고 프로세스를 종료하지 마세요.

• 다른 v2rayN이 실행 중인 경우: 해당 프로그램의 트레이 메뉴에서 정상 종료하고, 포트가 해제된 것을 확인한 뒤 현재 버전을 실행하세요. 두 프로그램이 시스템 프록시를 동시에 제어하게 두지 마세요.
• 필수 프로그램이 포트를 사용 중인 경우: 「설정」→「환경 설정」에서 로컬 수신 포트를 사용 가능한 값(예: 10818)으로 변경하세요. 해당 포트가 비어 있는지 확인하고 저장한 다음 관련 코어를 다시 시작하세요.
• 변경 후에도 접속되지 않는 경우: 시스템 프록시를 다시 적용하고, 포트를 직접 지정한 브라우저 확장 프로그램이나 터미널 도구도 함께 수정하세요. 클라이언트만 바꾸면 다른 프로그램은 계속 이전 포트로 요청합니다.
• 포트가 비어 있는데 액세스 거부가 표시되는 경우: 시스템 예약 포트, 보안 정책, 엔드포인트 보호 기록을 확인하세요. 일반 포트 수신과 TUN의 권한 상승은 서로 다른 문제입니다. 이를 해결하려고 항상 관리자 권한으로 실행하지 마세요.

설정 완료 후 점검 및 업그레이드 백업

시작, 프록시, 종료의 세 단계를 모두 점검하세요. 웹페이지가 한 번 열렸다는 사실만으로 당시 특정 요청이 성공했다는 것만 확인할 수 있습니다. 클라이언트를 닫은 뒤 잘못된 프록시 설정이 남지 않는지, 재시작 후 예상한 설정을 복구하는지도 확인해야 합니다. 아래 순서대로 살펴보면 이후 문제가 생겼을 때 변경된 지점을 찾기 쉽습니다.

1. 시작 확인: 프로그램을 종료했다가 다시 열어 구독 그룹, 활성 노드, 로컬 포트가 유지되는지 확인하고, 로그에 코어 시작 실패가 반복되지 않는지 살펴보세요.
2. 프록시 확인: 시스템 프록시를 켠 뒤 직접 연결해야 하는 대상과 프록시를 거쳐야 하는 대상에 각각 접속해 로그에서 라우팅을 확인하세요. 캐시된 웹페이지 하나만으로 연결 성공을 판단하지 마세요.
3. 종료 확인: 먼저 시스템 프록시를 해제한 뒤 프로그램을 종료하고 일반 네트워크가 정상적으로 작동하는지 확인하세요. 프로그램이 예기치 않게 종료됐다면 Windows 프록시 설정에서 남아 있는 수동 프록시를 확인하고 제거하세요.
4. 백업 확인: 업그레이드 전에 프로그램을 종료하고 현재 버전의 사용자 설정과 구독 그룹 정보를 백업하세요. 포터블 방식은 전체 폴더를 백업할 수 있고, 설치형은 실제 사용자 데이터 위치를 확인해 백업해야 합니다.
5. 이전 확인: 인터페이스 버전을 바꿀 때는 클라이언트가 제공하는 가져오기·내보내기 기능을 우선 사용하세요. 명확한 이전 안내가 없다면 구독을 다시 가져오고 주요 설정을 확인하세요. 두 프로그램의 폴더를 그대로 합쳐 덮어쓰지 마세요.

백업 파일에도 구독 토큰과 노드 인증 정보가 포함될 수 있으므로 본인만 접근할 수 있는 곳에 보관하세요. 업그레이드 후 인터페이스에만 문제가 있다면 로그와 기존 백업을 보존한 뒤 릴리스 노트를 확인하세요. 웹페이지 접속에 문제가 있다면 로컬 수신, 시스템 프록시, 노드 로그 순서로 점검하세요. 기본 사용법은 빠른 시작에서, 복잡한 연결 문제는 문제 진단에서 확인할 수 있습니다.