Windows 또는 macOS에서 v2rayN을 처음 설정하는 분을 위한 안내입니다. 먼저 클라이언트와 코어를 정상적으로 실행한 다음 구독을 가져오고 노드를 선택해 수신 포트를 확인하세요. 마지막으로 시스템 프록시를 켜고 같은 앱에서 설정 전후를 비교합니다. 문제가 생기면 어느 단계에서 발생했는지 먼저 파악한 뒤 관련 설정만 조정하세요.
설치 파일, 압축 해제 위치, 실행 환경
운영체제와 프로세서 아키텍처에 맞는 패키지를 선택하세요. x64는 64비트 Intel 또는 AMD 프로세서용이고, ARM64는 Windows ARM 기기나 Apple 칩이 탑재된 Mac용입니다. 운영체제가 64비트라고 해서 프로세서가 x64인 것은 아닙니다. 아래에서는 v2rayN 7.x의 일반적인 화면을 기준으로 설명합니다. 세부 버전이나 빌드에 따라 메뉴 이름과 위치가 조금 다를 수 있습니다.
- Windows:「설정」→「시스템」→「정보」에서 「시스템 종류」를 확인하세요. 압축 파일은 쓰기 권한이 있는
D:\Tools\v2rayN같은 폴더에 완전히 풀고v2rayN.exe를 실행하세요. 압축 파일 미리 보기에서 바로 실행하거나 본 프로그램만 바탕 화면으로 옮기지 마세요. 설정 파일과 함께 제공되는 코어가 원래 폴더에 있어야 할 수 있습니다. - macOS: Apple 메뉴 →「이 Mac에 관하여」에서 「칩」 또는 「프로세서」를 확인하세요. Apple 칩이면 ARM64, Intel 프로세서면 x64를 선택합니다. 디스크 이미지 파일을 받았다면 열어서 패키지 안내에 따라 앱을 「응용 프로그램」으로 옮기세요. 압축 파일을 받았다면 먼저 완전히 풀고 앱을 이동합니다. 보안 경고가 표시되면 다운로드 출처와 경고 내용을 확인하세요. 앱을 실행하려고 시스템 보호 기능 전체를 끄지는 마세요.
- 실행 환경: Windows에서 .NET이 없다는 오류가 표시되면 안내에 나온 프레임워크 이름, 주 버전, 아키텍처를 먼저 확인하세요. 예를 들어 x64용
Microsoft.WindowsDesktop.App 8.0이 필요하다고 명시되어 있다면 일반 런타임이 아니라 8.0 계열의 x64 .NET Desktop Runtime을 설치해야 합니다. 자체 포함 빌드를 선택했다면 해당 .NET 런타임을 따로 설치하지 않아도 되는 경우가 많습니다. 메인 창이 열린다고 프록시 코어까지 실행된 것은 아닙니다.
코어 종류: 노드 요구 사항에 맞게 선택
v2rayN은 데스크톱 클라이언트이며, 프록시 코어는 노드 설정을 읽고 연결을 수립합니다. 구독 그룹 이름이 아니라 노드에서 실제 사용하는 프로토콜, 전송 방식, 보안 설정을 기준으로 판단하세요. 예를 들어 VLESS는 프로토콜이고 REALITY는 보안 설정의 일부입니다. 코어 선택 목록에서 이 둘을 코어 이름으로 찾으면 안 됩니다.
처음 설치할 때 선택할 수 있는 두 가지
Xray 코어
권장서버에서 VLESS, REALITY, Vision 흐름 제어를 명시했다면 서버 요구 사항에 따라 Xray를 우선 사용하세요. 가져온 뒤에는 기존 필드를 그대로 유지하고, 일반 TLS 노드를 수동으로 REALITY 노드로 바꾸지 마세요.
적합한 경우: 노드에서 Xray를 명시적으로 요구하거나 구독 설정이 Xray 기능에 의존하는 경우
V2Ray 코어
제공업체가 V2Fly의 V2Ray 코어를 사용한다고 안내했다면 문서에서 프로토콜과 전송 방식을 확인하세요. VMess에 WebSocket과 TLS를 함께 사용한다고 반드시 코어를 바꿔야 하는 것은 아닙니다. 클라이언트에서 해당 옵션을 제공하고 코어가 준비되어 있으며 설정이 지원되는 경우에만 전환을 고려하세요.
적합한 경우: 제공업체가 V2Ray 코어 설정을 명확히 안내했고, 안내에 따라 구성해야 하는 노드
구독을 처음 가져오고 시스템 프록시 사용하기
구독 주소는 노드 목록을 가져오는 주소이며 개별 노드 링크와는 다릅니다. 먼저 서비스 제공업체가 안내한 구독 주소와 그룹 이름을 준비하세요. 처음 테스트할 때는 노드 하나만 선택하고 DNS, 라우팅, TUN을 동시에 변경하지 마세요. 그래야 로그에 오류가 나타났을 때 원인을 파악하기 쉽습니다.
빈 목록에서 연결 확인까지
구독 그룹 추가
메인 창에서 「구독 그룹」→「구독 그룹 설정」을 열고 그룹을 추가한 다음 별칭과 구독 주소를 입력해 저장하세요. 일부 버전에서는 그룹 표시줄의 「+」를 사용할 수 있습니다. 주소를 붙여넣은 뒤 전체가 들어갔는지 확인하세요. 특히 물음표 뒤의 매개변수를 지우지 마세요. 여기에 접속 정보가 포함될 수 있으니 공개 스크린샷에 노출하지 마세요.
현재 구독 업데이트
새로 만든 그룹을 선택한 뒤 「구독 그룹」 메뉴에서 「현재 구독 업데이트」에 해당하는 항목을 찾으세요. 사용할 수 있는 프록시가 없다면 먼저 「프록시 사용 안 함」 방식으로 업데이트하세요. 업데이트 후 해당 그룹으로 돌아가 노드가 실제로 목록에 표시되는지 확인합니다. 업데이트 성공은 클라이언트가 목록을 가져와 해석했다는 뜻일 뿐, 노드 연결까지 확인된 것은 아닙니다.
활성 노드로 지정
목록에서 노드를 마우스 오른쪽 버튼으로 클릭하고 「활성 서버로 설정」을 선택하세요. 메인 창에 표시된 활성 노드가 방금 선택한 노드와 일치하는지 확인합니다. 기본 코어를 확인하려면 「설정」→「매개변수 설정」→「Core 유형 설정」에서 해당 프로토콜을 살펴보세요. 버전에서 노드별 코어 지정도 지원한다면 해당 노드 설정도 확인해야 합니다.
로컬 수신 상태 확인
메인 창의 상태 표시줄과 로그를 확인한 다음 「설정」→「매개변수 설정」에서 로컬 수신 설정을 살펴보세요. 현재 혼합 포트가
10808로 표시된다면 이후에도 이 포트를 확인하면 됩니다. 다른 값이 표시되면 실제 값을 기준으로 하세요. 로그에 포트 사용 중 또는 코어 시작 실패가 나타나면 먼저 수신 문제를 해결하고 시스템 프록시는 나중에 켜세요.프록시 켜고 확인하기
시스템 트레이 메뉴나 메인 창의 「시스템 프록시」에서 「시스템 프록시 자동 설정」을 선택하세요. 시스템 프록시 설정을 따르는 브라우저에서 테스트 페이지를 열고, 클라이언트 로그에 해당 요청이 기록되는지도 확인합니다. 전환 전후로 웹페이지가 모두 열린다면 라우팅 결과도 확인하세요. 요청이 로그에 찍혔다고 해서 현재 노드를 통해 전달된다는 뜻은 아닙니다.
로컬 포트와 시스템 프록시 확인
로컬 수신 주소는 앱의 요청을 v2rayN에 전달하는 진입점이고, 구독에 포함된 서버 주소와 포트는 코어가 원격 서버에 연결할 때 사용합니다. 두 값을 서로 바꿔 입력하면 안 됩니다. 처음 사용할 때는 로컬에서만 수신하도록 두고 「LAN에서 연결 허용」은 켜지 마세요.
두 설정에서 확인할 값
클라이언트 수신
- 로컬 주소
127.0.0.1- 혼합 포트 예시
10808, 화면에 표시된 값 기준- LAN 접근
- 사용 안 함
- 오류 단서
address already in use는 수신 주소와 포트가 이미 사용 중이라는 뜻입니다
혼합 포트는 HTTP와 SOCKS 요청을 모두 받을 수 있습니다. 화면에 두 포트가 따로 표시된다면 앱에서 선택한 프록시 유형에 맞는 값을 입력하세요.
시스템 프록시
- Windows 확인 경로
- 「설정」→「네트워크 및 인터넷」→「프록시」
- macOS 확인 경로
- 「시스템 설정」→「네트워크」→ 현재 네트워크 서비스 →「세부사항」→「프록시」
- 브라우저 테스트
- 시스템 프록시 설정 사용. 브라우저에서 별도의 프록시 규칙은 함께 켜지 않기
- 종료하기 전에
- 클라이언트에서 「시스템 프록시 해제」를 선택하고, 필요하면 이전에 기록한 설정으로 복원하세요
시스템 프록시는 해당 설정을 따르는 앱에만 영향을 줍니다. 종료 전에 설정을 정리하면 앱이 종료된 로컬 포트로 계속 요청을 보내는 일을 방지할 수 있습니다.
자주 발생하는 문제: 증상별 확인 방법
실패가 발생한 시간, 활성 노드, 로컬 포트를 기록한 뒤 같은 상황을 한 번 더 재현하세요. 구독 다운로드 여부, 코어의 수신 여부, 앱에서 요청이 예상대로 전송되는지 세 가지를 구분해야 합니다. 한 번에 하나씩만 변경하고, 변경 후 같은 앱에서 같은 페이지에 접속해야 설정이 적용됐는지 알 수 있습니다.
첫 설정 관련 자주 묻는 질문
구독 업데이트는 성공했는데 목록이 비어 있는 이유는 무엇인가요?
먼저 방금 업데이트한 그룹을 선택하고 목록 검색 조건을 지운 다음, 현재 그룹이 아니라 다른 그룹을 업데이트한 것은 아닌지 확인하세요. 로그에 해석 오류가 표시되면 제공업체에 해당 주소가 로그인 페이지나 계정 페이지가 아니라 v2rayN에서 지원하는 구독 형식을 반환하는지 문의하세요. 문제를 알릴 때는 민감한 정보를 가린 오류 내용만 전달하세요.
구독 업데이트 시간이 초과됐는데 프록시를 사용하도록 바꿔야 하나요?
먼저 현재 네트워크에서 일반 웹페이지가 정상적으로 열리는지 확인한 다음 구독 주소와 클라이언트 로그를 살펴보세요. 이미 정상 작동이 확인된 활성 노드가 있다면 「프록시 사용」으로 업데이트를 시도하고 두 결과를 비교해 보세요. 막 설치해 목록에 노드가 하나도 없다면 업데이트 방식을 바꿔도 프록시 연결이 생기지는 않습니다. 먼저 제공업체에 주소에 접근할 수 있는 조건을 확인하세요.
포트가 사용 중인데 10818로 바로 바꿔도 되나요?
먼저 프로그램이 중복 실행 중인지 확인하고, 기존 인스턴스를 정상적으로 종료한 뒤 다시 시도하세요. 기존 포트를 다른 앱에 사용해야 하고 10818이 비어 있다면 혼합 포트를 이 값으로 변경한 뒤 코어를 다시 불러오고 v2rayN에서 시스템 프록시를 다시 적용할 수 있습니다. 이전에 포트를 직접 입력한 앱도 함께 변경해야 계속 옛 포트에 연결되지 않습니다.
웹페이지에 연결이 거부됐다고 나오는데 노드가 끊긴 건가요?
오류가 가리키는 위치부터 확인하세요. 127.0.0.1:10808에서 연결이 거부됐다면 먼저 코어가 실행 중인지, 앱에 입력한 포트가 현재 수신 포트와 일치하는지 확인하세요. 클라이언트가 앱 요청을 받았지만 로그에 원격 연결 실패가 표시된다면 노드 주소와 포트, 현재 네트워크를 확인합니다. 로컬 진입점 오류를 원격 서버 문제로 오해하지 마세요.
v2rayN을 종료한 뒤 브라우저에서 인터넷이 안 되는 이유는 무엇인가요?
시스템 프록시가 여전히 로컬 포트를 가리키는지, 브라우저에 프록시가 수동으로 설정되어 있는지 확인하세요. 이번 테스트에서 설정한 값이 남아 있다면 클라이언트를 다시 열어 「시스템 프록시 해제」를 선택하고 종료한 뒤 확인하세요. 컴퓨터에 회사나 학교 프록시 설정이 원래 있었다면 테스트 전에 기록한 값으로 복원하고, 기존 설정을 그대로 덮어쓰지 마세요.