v2rayN 처음 설치 및 초기 설정: Windows·macOS 실행, 코어 선택과 시스템 프록시 설정

Windows와 macOS에서 v2rayN을 처음 실행할 때 필요한 런타임, 코어 선택, 시스템 프록시 설정과 초보자가 자주 놓치는 점을 정리했습니다.

이 글의 핵심

데스크톱에서 v2rayN을 처음 사용하는 분을 위한 안내입니다. 운영체제와 프로세서에 맞는 패키지를 선택하고, 메인 창과 프록시 코어가 각각 실행되는지 확인하세요. 사용 가능한 노드를 가져온 뒤 브라우저에서 시스템 프록시를 테스트하고, 프록시를 끈 후 직접 연결이 복구되는지도 확인합니다. 설치, 노드, 앱 연결 문제를 구분해 점검할 수 있습니다.

Windows·macOS 첫 실행

설치 파일이 컴퓨터의 아키텍처와 맞는지 먼저 확인하세요. Windows에서는 ‘설정’ → ‘시스템’ → ‘시스템 정보’(일부 버전에서는 ‘정보’)에서 ‘시스템 종류’를 확인합니다. x64 표기 패키지는 x64 프로세서용이므로, 운영체제가 64비트인지 여부만 보고 선택하지 마세요. macOS에서는 ‘이 Mac에 관하여’에서 ‘칩’ 또는 ‘프로세서’를 확인합니다. Apple 칩은 arm64, Intel 프로세서는 x64를 선택하세요.

배포 패키지 유형에 따라 실행

Windows

  • ZIP 파일을 받았다면 먼저 ‘압축 풀기’를 선택하세요. 압축을 푼 폴더에서 v2rayN.exe를 실행합니다. 압축 파일 미리보기에서 실행하거나 프로그램 파일만 바탕 화면으로 옮기지 마세요.
  • 현재 계정에서 쓸 수 있고 위치가 바뀌지 않는 폴더를 선택하세요. 설치 마법사가 포함된 EXE를 받았다면 안내에 따라 설치한 뒤 시작 메뉴에서 실행합니다. ZIP 파일에 해당하는 절차를 적용하지 마세요.
  • 데스크톱 버전과 WPF 버전은 인터페이스 패키지 옵션이지 노드 프로토콜 옵션이 아닙니다. 처음 설치할 때는 한 버전만 사용해 두 인스턴스가 같은 포트를 동시에 점유하지 않도록 하세요.

macOS

  • DMG를 열고 v2rayN을 ‘응용 프로그램’ 폴더로 드래그하세요. 복사가 끝나면 디스크 이미지를 추출한 뒤 ‘응용 프로그램’에서 실행합니다. 마운트된 창에서 계속 실행하지 마세요.
  • 압축 파일을 받았다면 먼저 압축을 푼 뒤 앱 전체를 ‘응용 프로그램’ 폴더로 옮기세요. 앱 패키지에서 같은 이름의 실행 파일만 꺼내 실행하지 마세요.
  • 시스템에서 실행을 차단하면 패키지 출처와 아키텍처, 릴리스 안내를 먼저 확인하세요. 앱이 손상되었다는 경고가 표시되면 해당 패키지를 다시 다운로드하세요. 문제를 확인하려고 시스템 보안 검사를 끄지 마세요.

메인 창이 열리고 종료 후 다시 실행되는지 먼저 확인하세요. 이 단계가 끝나면 노드를 가져오고 시스템 프록시를 설정하면 됩니다.

런타임 및 로컬 포트

Windows에서 두 번 클릭한 뒤 ‘You must install .NET to run this application’ 메시지가 표시되면, 안내에 나온 프레임워크 이름과 주 버전, 아키텍처를 확인하세요. 예를 들어 Microsoft.WindowsDesktop.App 8.0 x64가 없다고 표시되면 해당하는 .NET 8 Desktop Runtime x64를 설치합니다. 같은 주 버전의 일반 .NET Runtime만 설치해서는 데스크톱 앱에 필요한 구성 요소가 충족되지 않을 수 있습니다. 패키지마다 요구 사항이 다를 수 있으므로 .NET 8이 항상 필요하다고 단정하지 마세요. 자체 포함 패키지로 메인 창이 열리지만 연결만 실패한다면 런타임을 다시 설치하기보다 코어 로그를 확인하세요.

8.0
런타임 설치 예시: 실제 요구 사항은 실행 안내를 확인하세요
10808
흔히 사용하는 로컬 프록시 포트
10809
구버전에서 흔히 사용하는 별도 HTTP 프록시 포트

‘설정’ → ‘매개변수 설정’에서 로컬 수신 설정을 확인하세요. 최신 버전에서는 ‘로컬 혼합 수신 포트’를 흔히 사용하며, 같은 포트에서 HTTP와 SOCKS 요청을 모두 받을 수 있습니다. 구버전에서는 두 연결 지점이 분리되어 있을 수 있습니다. 위 숫자는 일반적인 설정을 알아보는 참고용일 뿐, 숫자만으로 프록시 유형을 판단하지 마세요. 앱에 수동으로 설정할 때는 현재 설정을 기준으로 주소에 127.0.0.1을 입력하고 해당 연결 지점의 포트를 지정합니다. 이 주소는 노드의 원격 주소가 아니며, 이 컴퓨터에서만 사용할 경우 ‘LAN에서 연결 허용’을 켤 필요가 없습니다.

로그에 address already in use가 표시되면 기존 인스턴스나 같은 포트를 사용하는 다른 프로그램을 먼저 종료하세요. 포트를 바꿔야 한다면 매개변수 설정에서 새 값을 저장하고 코어를 다시 시작한 뒤 시스템 프록시를 다시 적용합니다. 프록시를 수동으로 설정한 앱도 포트를 함께 변경해야 합니다. 클라이언트의 수신 포트만 바꾸면 브라우저가 이전 포트로 요청을 보낼 수 있습니다.

노드 가져오기 및 코어 선택

v2rayN은 노드를 관리하고 코어를 실행하는 데스크톱 인터페이스이며, 실제 연결은 코어가 노드 설정에 따라 처리합니다. 처음 설정할 때는 구독 하나 또는 작동이 확인된 노드 하나만 가져와 활성 서버로 지정하세요. 우선 기본 코어 설정으로 연결을 확인하고, 노드가 특정 전송 방식이나 보안 옵션을 요구하거나 로그에서 설정 미지원이 명확히 확인될 때만 코어를 변경하세요.

  1. 구독 주소를 받았다면 ‘구독 그룹’ → ‘구독 그룹 설정’을 열고 그룹을 추가한 다음 ‘주소(url)’에 전체 주소를 붙여 넣고 저장하세요. 메인 창으로 돌아와 ‘구독 그룹’ 메뉴에서 프록시를 사용하지 않는 업데이트를 실행합니다. 현재 네트워크에서 구독 주소에 접근할 수 없다면 구독 접근 조건부터 확인하고 코어를 반복해서 바꾸지 마세요.
  2. vmess:// 또는 vless:// 공유 링크 하나를 받았다면 링크 전체를 복사한 뒤 ‘서버’ 메뉴에서 ‘클립보드에서 URL 일괄 가져오기’를 선택하세요. 메인 창에 포커스가 있을 때 Ctrl + V(Windows)를 눌러도 됩니다. 공유 링크를 구독 그룹의 주소 입력란에 넣지 마세요.
  3. 노드가 현재 그룹에 표시되는지 확인하고, 대상 행을 두 번 클릭해 활성 서버로 지정한 뒤 로그에 코어 시작 오류가 있는지 살펴보세요. 코어 유형을 확인하려면 ‘설정’ → ‘매개변수 설정’에서 ‘Core 유형 설정’을 찾으세요. 화면의 문구는 릴리스 버전에 따라 달라질 수 있습니다.

Xray 코어

권장

노드가 VLESS와 REALITY를 명시적으로 사용하는 경우 Xray를 우선 선택하고, 링크를 가져올 때 적용된 전송 및 보안 매개변수는 그대로 두세요. Xray는 일반적인 VMess 설정도 지원하므로 링크가 vmess://로 시작한다는 이유만으로 코어를 바꿀 필요는 없습니다.

적합한 경우: VLESS + REALITY를 처음 설정하거나, 제공처에서 다른 코어를 지정하지 않은 일반 VMess 노드를 사용하는 경우.

V2Ray 코어

현재 버전에서 이 옵션을 제공하고, 노드 문서가 특정 VMess 설정을 재현하기 위해 V2Ray를 명시적으로 요구한다면 문서에 따라 선택하세요. 코어 파일 누락, 포트 충돌, 노드 시간 초과를 모두 호환성 문제로 보지 마세요.

적합한 경우: 버전과 설정 요구 사항이 명확한 VMess 환경.

구독 업데이트에 성공해도 클라이언트가 목록을 받아왔다는 뜻일 뿐, 목록의 모든 노드가 연결된다는 뜻은 아닙니다. ‘Core 유형 설정’은 같은 프로토콜을 사용하는 다른 노드에도 영향을 줄 수 있으므로 변경 전에 기존 값을 기록하고 한 번에 하나씩만 바꾸세요. 코어 실행 파일을 찾을 수 없다는 오류가 발생하면 선택한 패키지에 해당 코어가 포함되어 있는지, 압축이 온전히 풀렸는지 먼저 확인하세요. 프로토콜 항목을 바꿔가며 해결하려 하지 마세요.

시스템 프록시 및 브라우저 테스트

브라우저에서 먼저 시스템 프록시를 사용하도록 설정하세요. TUN을 함께 켜거나 브라우저의 수동 프록시 설정을 추가로 변경하지 마세요. 그러면 ‘앱 트래픽이 로컬 프록시에 들어오는지’를 따로 확인할 수 있습니다. 라우팅은 그다음 단계입니다. 트래픽이 코어에 들어온 뒤 라우팅 규칙에 따라 직접 연결할지 노드를 거칠지 결정됩니다. 시스템 프록시를 켜도 모든 앱이 프록시를 사용하거나 모든 대상이 노드를 거치는 것은 아닙니다.

시스템 프록시 메뉴실제 기능처음 설정할 때 선택
시스템 프록시 자동 설정시스템 프록시 설정을 지정합니다. 시스템 설정을 따르는 앱에서 사용할 수 있습니다.노드를 활성 서버로 지정한 뒤 브라우저 연결 테스트에 사용하세요.
시스템 프록시 해제시스템 프록시 설정을 지웁니다. 프로그램을 종료하거나 앱 자체에 저장된 프록시 설정을 지우는 기능은 아닙니다.테스트가 끝난 뒤 직접 연결로 복구할 때 사용하세요. 회사 프록시를 설정한 컴퓨터라면 복구할 수 있도록 기존 값을 먼저 기록해 두세요.
시스템 프록시 변경 안 함현재 시스템 프록시를 변경하지 않으며, 이전에 남은 설정도 자동으로 지우지 않습니다.특정 앱에만 로컬 프록시를 수동으로 설정하거나 기존 시스템 설정을 유지하려는 경우에 사용하세요.
  1. v2rayN의 트레이 메뉴나 메인 화면에서 ‘시스템 프록시’를 열고 ‘시스템 프록시 자동 설정’을 선택하세요. Windows에서는 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 현재 설정을 확인합니다. macOS에서는 ‘시스템 설정’ → ‘네트워크’ → 현재 네트워크 서비스의 ‘세부사항’ → ‘프록시’에서 주소와 포트를 확인하세요.
  2. 시스템 프록시를 따르는 브라우저에서 작동이 확인된 HTTPS 페이지를 열어 한 번 새로고침하고 v2rayN 로그를 확인하세요. 요청 기록이 있으면 트래픽이 코어에 들어왔다는 뜻입니다. 노드를 거치는지 확인하려면 해당 요청의 아웃바운드가 직접 연결이 아닌 프록시인지 추가로 확인하세요.
  3. 확인이 끝나면 ‘시스템 프록시 해제’를 선택한 뒤 같은 브라우저에서 원래 직접 연결되던 페이지를 엽니다. 연결이 복구된 것을 확인한 다음 프로그램을 종료하세요. 그래야 코어가 꺼진 뒤에도 앱이 로컬 프록시 포트로 요청을 보내는 상황을 막을 수 있습니다.

첫 실행 시 자주 발생하는 문제

두 번 클릭해도 반응이 없어요. 런타임이 설치되지 않은 건가요?

먼저 트레이나 메뉴 막대에 v2rayN이 이미 실행 중인지 확인하세요. 창이 앞에 표시되지 않은 것일 수도 있습니다. 프로세스가 없다면 아키텍처와 압축을 푼 폴더, 런타임 안내를 확인하세요. 메인 창은 열리지만 코어가 시작되지 않는다면 메인 화면의 로그를 확인하고 첫 번째 시작 오류부터 해결하세요.

지연 시간은 표시되는데 웹페이지가 열리지 않는 이유는 무엇인가요?

지연 시간 테스트만으로 브라우저가 프록시를 사용한다고 볼 수는 없습니다. 활성 노드를 선택하고 ‘시스템 프록시 자동 설정’을 적용한 뒤, 시스템에 표시된 포트와 코어 수신 포트가 일치하는지 확인하세요. 페이지를 새로고침해도 요청 기록이 없다면 브라우저 자체 프록시 설정이나 프록시를 가로채는 확장 프로그램을 확인하세요.

브라우저는 열리는데 다른 프로그램은 연결되지 않아요.

먼저 해당 프로그램이 시스템 프록시를 읽는지 확인하세요. 별도의 프록시 설정이 있다면 지원되는 HTTP 또는 SOCKS 유형에 맞춰 로컬 연결 정보를 입력하고 따로 테스트합니다. 시스템 프록시를 지원하지 않고 수동 설정 항목도 없는 프로그램이라면 v2rayN의 시스템 프록시 모드를 반복해서 바꿔도 연결 방식은 달라지지 않습니다.

v2rayN을 종료한 뒤 직접 연결 웹페이지까지 열리지 않는 이유는 무엇인가요?

v2rayN을 다시 열고 ‘시스템 프록시 해제’를 선택하세요. 프로그램이 열리지 않으면 시스템 프록시 설정 화면에서 이번 설정으로 추가된 로컬 프록시를 제거합니다. 회사 네트워크에서 원래 사용하던 프록시가 있다면 미리 기록한 값으로 복구하세요. 한 앱에서만 인터넷에 연결되지 않는 경우에는 해당 앱의 프록시 설정을 확인하세요.

v2rayN 다운로드