Windows나 macOS에서 v2rayN을 처음 사용한다면 세 가지를 차례로 확인하세요. 기본 창이 열리는지, 선택한 노드가 로컬 프록시를 통해 요청을 보내는지, 브라우저가 시스템 프록시 설정을 사용하는지 확인합니다. 앞 단계가 정상 작동하기 전에는 다음 단계로 넘어가지 마세요. 그러면 강제 종료, 빈 구독 목록, 브라우저 연결 실패가 발생해도 어느 부분을 점검해야 할지 알 수 있습니다.
설치 파일, 압축 해제 위치, 첫 실행 권한
데스크톱 앱과 프록시 코어는 별개입니다. 더블 클릭해도 기본 창이 열리지 않으면 설치 파일, 실행 환경 또는 시스템 알림부터 확인하세요. 기본 창은 열리지만 노드를 선택한 뒤 로그에 오류가 표시된다면 코어 파일, 노드 설정, 포트를 점검해야 합니다. 아래 메뉴 이름은 v2rayN 7.x 중국어 UI를 기준으로 하며, 세부 버전에 따라 메뉴와 버튼 위치가 다를 수 있습니다.
- Windows에서는 먼저 시스템 종류를 확인하세요.「설정」→「시스템」→「정보」에서 「시스템 종류」를 확인합니다. 일반적인 Intel 또는 AMD 64비트 PC는 x64를 선택하고, ARM 기기는 시스템 아키텍처에 맞는 패키지를 선택하세요. 압축 파일은 현재 계정에서 쓸 수 있는 고정 폴더에 완전히 압축 해제합니다. 예:
%LOCALAPPDATA%\Programs\v2rayN. 압축 프로그램의 미리 보기 창에서 앱을 바로 실행하거나, 앱만 따로 꺼내지 마세요. 함께 제공되는 코어와 종속 파일도 필요합니다. - 런타임은 실행 안내와 패키지 설명을 기준으로 설치하세요.예를 들어 Windows WPF 패키지에서
Microsoft.WindowsDesktop.App 8.0이 필요하다고 안내하면 앱 아키텍처에 맞는 .NET 8 Desktop Runtime을 설치하세요. 같은 8.0 버전의 일반 .NET Runtime은 데스크톱 런타임을 대신하지 않습니다. 다른 주 버전을 설치해도 요구 사항을 충족하는 것은 아닙니다. 패키지에 실행 환경이 포함되어 있다면 안내에 따라 먼저 실행하고, 별도로 설치하지 않아도 됩니다. - macOS에서는 칩 종류와 앱 위치를 확인하세요.Apple 메뉴의 「이 Mac에 관하여」에서 「칩」이 표시되고 Apple 칩이라면 arm64를, Intel 「프로세서」라면 x64를 선택합니다. 디스크 이미지 파일을 받았다면 패키지 안내에 따라 앱을 「응용 프로그램」으로 복사한 뒤 해당 폴더에서 실행하세요. 압축 파일은 먼저 완전히 압축 해제합니다. 마운트한 디스크 이미지나 다운로드 폴더에서 계속 실행하지 마세요.
- 보안 차단과 권한 부족은 알림 내용을 보고 구분하세요.시스템 보안 알림이 표시되면 다운로드 출처, 시스템 버전, 패키지 종류를 먼저 확인한 다음 Windows 보안의 「보호 기록」이나 macOS 「시스템 설정」→「개인정보 보호 및 보안」에서 구체적인 원인을 확인하세요. 앱이 손상되었거나 악성 소프트웨어로 의심된다는 알림이 나오면 실행을 멈추고 출처를 다시 확인하세요. 로그에 설정 폴더를 쓸 수 없다는 메시지만 표시된다면 쓰기 가능한 폴더로 옮기세요. 매번 관리자 권한으로 실행하는 것은 해결 방법이 아닙니다.
구독 하나를 추가하고 노드 하나부터 확인
구독 주소를 추가하는 것은 업데이트 경로를 저장하는 일이며, 노드를 가져오는 데 성공했다는 뜻은 아닙니다. 처음 설정할 때는 구독 출처 하나와 노드 하나만 사용해 구독 업데이트, 코어 실행, 시스템 프록시를 각각 확인하세요. 구독 주소에 계정 토큰이 포함될 수 있으므로 화면을 공유하기 전에 전체 주소를 가리고, 로그에 주소가 출력됐는지도 확인하세요.
구독 그룹 추가
기본 화면에서 「구독 그룹」→「구독 그룹 설정」을 열고 창에서 「추가」를 누릅니다. 알아보기 쉬운 이름을 메모에 입력하고, 주소 입력란에 구독 주소 전체를 붙여 넣은 뒤 저장하세요.
vmess://또는vless://로 시작하는 단일 공유 링크라면 「서버」 메뉴의 클립보드 가져오기 기능을 사용하세요. 구독 주소 입력란에 넣으면 안 됩니다.현재 그룹 업데이트
기본 창으로 돌아가 새 그룹을 선택한 다음 「구독 그룹」 메뉴에서 현재 구독을 업데이트합니다. 처음에는 프록시를 사용하지 않는 업데이트 옵션을 선택해도 됩니다. 로그에서 가져오기가 성공했는지, 그룹에 노드가 표시되는지 확인하세요. 구독 업데이트 성공은 목록을 가져왔다는 의미일 뿐, 노드 연결까지 보장하지는 않습니다.
사용할 노드 선택
목록에서 사용 가능한 노드를 마우스 오른쪽 버튼으로 클릭하고 「활성 서버로 설정」을 선택합니다. 행을 한 번 클릭하는 것은 일반적으로 목록 항목 선택일 뿐, 코어가 전환됐다는 뜻은 아닙니다. 전환한 뒤 기본 화면의 현재 노드와 로그를 확인해 코어 실행 실패나 포트 바인딩 오류가 없는지 살펴보세요.
로컬 포트 확인
「설정」→「매개변수 설정」을 열고 「v2rayN 설정」에서 로컬 수신 포트를 확인합니다. 실제 포트 번호를 기록한 뒤 아래의 명시적 프록시 요청으로 테스트하세요. 이 단계에서 노드 전환, 라우팅 규칙 변경, TUN 활성화를 함께 하지 마세요. 요청이 실패했을 때 원인을 구분하기 어려워집니다.
노드 설정에 맞는 코어 선택
v2rayN은 데스크톱 클라이언트이고 Xray와 V2Ray는 연결을 처리하는 코어입니다. 「설정」→「매개변수 설정」→「Core 유형」에서 보통 설정 유형에 맞는 코어를 선택합니다. 모든 노드를 하나의 프로토콜로 변환하는 기능은 아닙니다. 구독을 가져온 뒤에는 기존 설정을 그대로 두세요. 로그에 설정이 지원되지 않는다는 내용이 명확히 표시될 때만 코어와 버전을 확인합니다.
Xray 코어
권장VLESS + REALITY 설정을 가져왔다면 서버 안내에 따라 Xray를 우선 사용하세요. 전송 방식, 보안 옵션, Flow는 서버 설정과 일치해야 합니다. 노드에 Flow가 지정되어 있지 않다면 예시를 그대로 따라 임의로 추가하지 마세요. 알 수 없는 옵션이 표시되면 로그에서 실행 중인 코어와 버전을 먼저 확인하세요.
적합한 경우: 구독에 VLESS + REALITY가 명시되어 있거나 서버 안내에서 Xray를 지정한 경우
V2Ray 코어
현재 클라이언트에 이 항목이 있고 관리자가 적합한 V2Ray 버전과 VMess 설정을 안내했다면 해당 지침에 따라 선택할 수 있습니다. VMess + WebSocket + TLS 설정의 경로와 서버 이름은 기존 값을 그대로 유지하세요. 코어만 V2Ray로 바꿔도 잘못 입력한 경로나 인증서 이름이 수정되지는 않습니다.
적합한 경우: V2Ray 서버 설정 안내가 명확하고 기존 설정에 맞춰 연결해야 하는 경우
로컬 수신 포트와 시스템 프록시를 따로 확인
노드 세부 정보에 표시되는 서버 포트는 원격 연결 정보이며, 브라우저나 터미널에서 사용하는 포트는 이 컴퓨터의 로컬 수신 포트입니다. 서로 다른 설정입니다. 아래에서는 10808을 예로 듭니다. 매개변수 설정과 로그에서 해당 포트가 HTTP 프록시 요청을 받는 것을 확인한 경우에만 예시를 그대로 실행하세요. SOCKS 전용 포트라면 오른쪽 카드의 방법으로 테스트합니다. 처음 점검할 때는 로컬에서만 사용하고, 문제 해결을 위해 「LAN 연결 허용」을 켜지 마세요.
HTTP 또는 혼합 수신
- 로컬 주소
127.0.0.1- 예시 포트
10808, 실제 HTTP 또는 혼합 포트로 바꾸세요- 프록시 주소
http://127.0.0.1:10808
대상 URL이 HTTPS를 사용하더라도 일반적인 로컬 HTTP 프록시 주소는 http://로 시작합니다.
SOCKS 수신
- 로컬 주소
127.0.0.1- 예시 포트
10808, 실제 SOCKS 또는 혼합 포트로 바꾸세요- 프록시 주소
socks5h://127.0.0.1:10808
이 형식은 curl에서 사용할 수 있으며, 프록시가 대상 호스트 이름을 확인하도록 합니다. 시스템 설정의 HTTP 프록시 입력란에는 넣지 마세요.
시스템 프록시는 잠시 끄고 TUN도 비활성화한 상태에서 명시적 프록시로 일반 웹 요청을 보내세요. Windows PowerShell에서는 curl.exe를 사용하고, macOS 터미널에서는 명령어 앞부분을 curl로 바꾸세요. 아래 예시의 연결 제한 시간은 5초, 전체 요청 제한 시간은 15초입니다. 이번 진단을 위한 제한값이며 성능 지표가 아닙니다.
curl.exe --proxy http://127.0.0.1:10808 --noproxy "" --connect-timeout 5 --max-time 15 -I https://example.org/
- 연결이 거부됨:클라이언트가 실행 중인지, 포트 번호가 맞는지 확인한 다음 로그에서 수신 실패가 있는지 살펴보세요.
address already in use가 표시되면 남아 있는 클라이언트 프로세스를 종료하거나 사용 중이 아닌 포트로 바꾸세요. 설정을 적용한 뒤 새 포트로 다시 테스트합니다. 200 Connection established만 표시됨:이는 프록시의 CONNECT 응답이지 대상 웹페이지의 최종 응답이 아닙니다. 대상 사이트의 HTTP 상태 코드가 이어서 표시되는지 확인하세요. 핸드셰이크 실패나 시간 초과가 발생하면 같은 요청의 코어 로그에서 노드 연결 및 인증서 오류를 확인합니다.- 대상 서버의 응답을 받음:이번 요청이 로컬 프록시를 통과했다는 뜻이지만, 원격 노드를 거쳤다는 보장은 없습니다. 규칙에 따라 테스트 도메인이 직접 연결될 수 있습니다. 노드의 외부 연결을 확인하려면 기존 규칙상 프록시를 사용해야 하는 테스트 도메인을 선택하고, 코어 로그에서 적용된 출구를 확인하세요.
- 명시적 프록시 요청이 정상 작동한 뒤 시스템 프록시를 켜세요:트레이 아이콘이나 상태 메뉴에서 「시스템 프록시 자동 설정」을 선택하고 브라우저를 다시 열어 테스트합니다. Windows에서는 「설정」→「네트워크 및 인터넷」→「프록시」에서 확인할 수 있습니다. macOS에서는 「시스템 설정」→「네트워크」→ 현재 네트워크 서비스의 「세부사항」→「프록시」에서 확인하세요. 기존 값을 먼저 기록해 두고, 테스트가 끝나면 클라이언트에서 「시스템 프록시 해제」를 선택하세요. 필요한 경우 원래 설정을 복원합니다.
첫 설정에서 자주 발생하는 문제
구독 업데이트가 시간 초과되고 목록이 비어 있나요?
로그에서 구독 도메인 이름 확인, 연결, 서버 응답 중 어느 단계에서 실패했는지 확인하세요. 주소를 잘못 붙여 넣지 않았는지, 올바른 그룹을 선택했는지 점검합니다. 401 또는 403 응답이 오면 구독 제공자에게 토큰과 접근 권한을 문의하세요. 연결 시간 초과가 발생하고 이미 사용 가능한 노드가 있다면 「프록시를 통해 업데이트」를 시도할 수 있습니다. 사용할 노드가 없다면 이 옵션을 반복해서 바꿔도 연결이 저절로 생기지 않습니다.
웹페이지는 열리는데 터미널은 왜 직접 연결되나요?
브라우저는 시스템 프록시를 사용하더라도 터미널 프로그램은 같은 설정을 사용하지 않을 수 있습니다. 먼저 위의 --proxy 옵션으로 단일 요청에 프록시를 지정하세요. 요청이 성공하면 사용 중인 도구가 HTTPS_PROXY를 지원하는지, NO_PROXY가 대상 주소를 제외하고 있는지 확인합니다. 처음부터 환경 변수를 전역 시작 설정에 추가하지 마세요.
재시작한 뒤 구독과 설정이 모두 사라졌나요?
바로 가기가 가리키는 프로그램 경로를 확인해 다른 압축 해제 폴더의 앱을 실행한 것은 아닌지 살펴보세요. 먼저 클라이언트를 종료하고 현재 버전을 고정된 쓰기 가능 위치에 둔 다음 다시 실행합니다. 구분하기 쉬운 설정 하나를 변경하고 재시작해 저장되는지 확인하세요. 로그에 쓰기 실패가 표시되면 폴더 권한을 수정하거나 현재 계정에서 쓸 수 있는 위치로 옮깁니다.
종료한 뒤 컴퓨터 전체에서 웹페이지가 열리지 않나요? 재설치가 필요한가요?
시스템 프록시가 종료된 127.0.0.1 수신 포트를 가리키는지 먼저 확인하세요. 클라이언트를 실행할 수 있다면 「시스템 프록시 해제」를 선택한 다음 종료하세요. 실행할 수 없다면 시스템 프록시 설정에서 이번 테스트로 입력한 값을 되돌립니다. 업무용 네트워크 설정이 있다면 이전에 기록한 값으로 복원하고, 다른 프록시 항목은 임의로 지우지 마세요.