v2rayN 첫 설치 및 초기 설정: Windows·macOS 설치와 자주 발생하는 문제

v2rayN 압축 해제와 실행, 코어 파일 확인, 로컬 포트·시스템 프록시 설정, 구독 가져오기를 안내하고 런타임 누락과 포트 충돌 등 초보자 문제를 정리합니다.

이 글의 핵심

Windows 또는 macOS에서 v2rayN을 처음 설정하는 사용자를 위한 안내입니다. 운영체제와 아키텍처에 맞는 패키지를 고른 뒤 구독을 가져오고 코어를 실행한 다음, 앱 하나로 로컬 프록시를 확인하세요. 이 순서대로 점검하면 프로그램 실행 실패, 구독 미등록, 앱의 프록시 미사용 문제를 구분할 수 있습니다.

설치 파일과 첫 실행

다운로드하기 전에 프로세서 아키텍처를 확인하세요. Windows에서는 ‘설정’ → ‘시스템’ → ‘정보’에서 시스템 종류를 확인해 x64와 ARM64를 구분합니다. macOS에서는 Apple 메뉴의 ‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인하세요. Apple 칩은 ARM64, Intel 프로세서는 x64를 선택하면 됩니다. 파일 이름이 비슷하다면 설치 파일인지 압축 파일인지, 코어가 포함되어 있는지도 확인하세요. 파일 크기만으로 판단하지 마세요.

Windows와 macOS에서 실행하기

Windows
  • 설치 파일을 사용한다면 설치 안내에 따라 진행하세요. 압축 파일은 현재 사용자에게 쓰기 권한이 있는 폴더에 빠짐없이 풀고 v2rayN.exe를 실행합니다. 압축 파일 미리 보기 창에서 바로 실행하지 마세요.
  • 실행할 때 .NET이 없다는 메시지가 표시되면 안내된 프레임워크 이름, 버전, 아키텍처를 기록하세요. Microsoft.WindowsDesktop.App이 필요하다고 표시되면 해당 버전의 .NET Desktop Runtime을 설치해야 합니다. 기본 런타임만으로는 충분하지 않습니다.
macOS
  • 디스크 이미지가 열리면 패키지 안내에 따라 앱을 ‘응용 프로그램’으로 옮기세요. 압축 파일은 먼저 완전히 푼 다음 앱을 이동합니다. 앱 내부의 실행 파일만 따로 꺼내 실행하지 마세요.
  • 시스템이 실행을 차단하면 먼저 설치 파일의 출처와 아키텍처, 표시된 메시지의 원문을 확인한 다음 ‘시스템 설정’ → ‘개인정보 보호 및 보안’에서 해당 알림을 살펴보세요. 악성 소프트웨어 경고가 나타나면 실행을 중단하고 시스템 전체 보안 기능을 끄지 마세요.

메인 창이 열렸다는 것만으로는 인터페이스가 실행된 상태일 뿐입니다. 설정을 가져온 뒤 로그에서 선택한 코어가 실행 중인지 확인하세요.

코어 선택 및 파일 확인

v2rayN은 구독, 서버, 로컬 설정을 관리하며 실제 연결은 코어가 처리합니다. 구독에는 연결 정보가 포함되지만 코어를 설치해 주지는 않습니다. 처음 사용하는 경우 필요한 코어가 패키지에 포함되어 있다고 명확히 안내된 배포판을 우선 선택하세요. 코어가 포함되지 않은 패키지를 사용한다면 인터페이스의 ‘업데이트 확인’ 메뉴에서 해당 코어를 다운로드하거나 업데이트할 수 있는지 먼저 살펴보세요.

Xray 코어

권장

서버에서 VLESS 및 REALITY 설정을 명시적으로 제공한다면 해당 설정과 호환되는 Xray 코어를 선택하세요. 가져온 뒤에는 서버 측에서 제공한 전송 및 보안 매개변수를 그대로 유지합니다.

적합한 경우: 처음 가져오는 구독에서 Xray를 명시적으로 요구할 때

V2Fly 코어

서비스 제공자가 V2Fly용 VMess 설정을 명시적으로 제공하는 경우, 사용 중인 배포판이 해당 코어를 지원한다면 선택할 수 있습니다. 전송 계층과 TLS 설정도 확인해야 하며, VMess라는 프로토콜 이름만으로 호환 여부를 판단해서는 안 됩니다.

적합한 경우: V2Fly 호환 조건이 명시된 기존 설정을 사용할 때

이 페이지가 안내하는 버전에서는 ‘설정’ → ‘매개변수 설정’ → ‘Core 유형’에서 프로토콜에 맞는 코어를 확인하세요. 로그에 코어를 찾을 수 없다고 표시되면 로그에 나온 경로에서 파일이 모두 갖춰졌는지 확인한 뒤 아키텍처를 점검합니다. 데스크톱 인터페이스가 열려도 별도로 다운로드한 코어가 호환된다는 뜻은 아닙니다. 다른 운영체제나 아키텍처용 실행 파일의 이름만 바꿔 넣지 마세요.

구독을 처음 가져오고 노드 활성화하기

  1. 그룹 추가

    ‘구독 그룹’ → ‘구독 그룹 설정’을 열고 추가를 선택하세요. 알아보기 쉬운 별칭을 입력하고 서비스 제공자가 준 구독 URL을 ‘선택 주소’에 붙여 넣은 뒤 저장하고 해당 그룹으로 전환합니다. 구독 URL이 아니라 단일 공유 링크를 받았다면 ‘서버’ 메뉴에서 클립보드 가져오기를 선택하세요.

  2. 현재 그룹 업데이트

    현재 네트워크에서 구독 주소에 직접 접속할 수 있다면 ‘구독 그룹’ 메뉴에서 ‘현재 구독 업데이트(프록시 사용 안 함)’를 선택하세요. 로그에 업데이트 결과가 표시될 때까지 기다린 뒤 현재 그룹에 서버 항목이 생겼는지 확인합니다. 그룹을 저장하는 것은 주소를 저장하는 것일 뿐, 주소가 유효하다는 뜻은 아닙니다.

  3. 활성 서버로 설정

    그룹에서 노드를 선택하고 마우스 오른쪽 버튼을 눌러 ‘활성 서버로 설정’을 선택하세요. 메뉴 이름은 버전에 따라 다를 수 있으므로 실제 활성화 상태를 기준으로 확인합니다. 행을 선택하는 것만으로는 연결이 전환되지 않습니다. 실행한 뒤 로그에서 설정 파싱이나 리스닝 오류가 없는지 확인하세요.

  4. 앱 하나로 테스트

    먼저 수동 프록시를 지원하는 앱 하나에 v2rayN에 표시된 로컬 주소와 포트를 설정한 다음, 평소 접속되는 웹페이지를 열어 보세요. 이 단계에서는 라우팅 규칙을 변경하거나 TUN을 켜지 마세요. 앱 하나로 테스트하면 로컬 프록시 연결과 시스템 프록시 적용 범위를 나눠서 확인할 수 있습니다.

구독 URL에는 계정 토큰이 포함될 수 있으므로 문제 해결을 위해 캡처한 화면에서는 전체 URL을 가리세요. 로그를 공유할 때도 서버 주소가 포함될 수 있으니 주의해야 합니다. 업데이트 성공으로 표시되는데 그룹이 비어 있다면 다른 그룹을 보고 있거나 목록 필터가 적용된 것은 아닌지 확인한 뒤, 서비스 제공자가 구독 데이터가 아닌 로그인 페이지나 만료 안내를 반환했는지 살펴보세요.

로컬 포트와 시스템 프록시

‘설정’ → ‘매개변수 설정’에서 로컬 리스닝 설정을 확인하고, 인터페이스와 로그에 표시된 포트를 기준으로 사용하세요. 아래 숫자는 입력 방법을 설명하기 위한 예시이며 버전 공통 기본값이 아닙니다. 특히 혼합 리스너는 하나의 포트에서 HTTP와 SOCKS 요청을 모두 받을 수 있으므로, 포트 하나가 보인다고 다른 포트도 반드시 존재한다고 판단하면 안 됩니다.

127.0.0.1
같은 컴퓨터의 루프백 주소
10808
로컬 리스닝 포트 예시
10818
충돌 시 확인할 대체 포트

처음 설정할 때 자주 겪는 문제

실행 파일을 두 번 눌렀는데 런타임이 없다고 나와요.

먼저 메시지에 표시된 프레임워크와 아키텍처를 확인한 뒤 해당 런타임을 설치하고 다시 실행하세요. 메시지가 없다면 압축이 완전히 풀렸는지, GUI 본 프로그램을 실행했는지 확인합니다. 다른 컴퓨터에서 동적 라이브러리 파일 몇 개만 복사해 의존성을 채우지 마세요.

로그에 포트가 사용 중이라고 나옵니다. 어떻게 확인하나요?

오류가 발생한 포트가 10808이라면 Windows에서 netstat -ano | findstr :10808을 실행하고 리스닝 행의 프로세스 ID를 확인하세요. macOS에서는 lsof -nP -iTCP:10808 -sTCP:LISTEN을 실행하면 됩니다. 직접 실행한 이전 인스턴스인지 확인한 뒤 해당 인스턴스만 종료하세요. 포트를 바꿔야 한다면 저장한 후 코어를 다시 시작하고 앱에 수동 입력한 포트도 함께 변경합니다.

구독 업데이트 시간이 초과되고 목록이 비어 있어요.

현재 네트워크에서 구독 서비스에 접속할 수 있는지, 그룹에 저장된 URL이 완전한지 먼저 확인하세요. 사용할 수 있는 노드가 아직 없다면 ‘프록시 사용’으로 업데이트해도 처음 가져오는 문제는 해결되지 않는 경우가 많습니다. 서비스 제공자에게 직접 접속 가능한 구독 주소를 문의하거나, 별도로 제공된 사용 가능한 노드를 먼저 가져온 다음 업데이트하세요.

노드에 지연 시간이 표시되는데 웹페이지가 열리지 않아요.

속도 측정 결과는 해당 시점의 탐색에 응답이 있었다는 뜻일 뿐, 브라우저가 같은 경로를 사용한다는 의미는 아닙니다. 활성 서버가 올바른지 확인하고 코어가 정상적으로 리스닝 중인지 점검한 다음 브라우저의 프록시 유형과 포트를 확인하세요. 수동 설정으로는 접속되지만 시스템 프록시로는 안 된다면 시스템 설정과 앱이 해당 설정을 읽는지 살펴보세요.

종료한 뒤 일반 웹페이지도 열리지 않아요.

먼저 시스템 프록시 설정에서 v2rayN의 로컬 포트를 가리키고 있는지 확인하세요. 코어가 종료되면 남아 있는 프록시 주소는 더 이상 응답하지 않습니다. 이번에 추가한 설정을 해제하거나 설정 전 기록해 둔 주소와 포트로 복구한 뒤 같은 웹페이지를 다시 열어 보세요.

클라이언트 다운로드플랫폼에 맞는 v2rayN / v2rayNG 선택