v2rayN 처음 설치 및 설정 완벽 가이드: Windows·macOS 공통 핵심과 자주 하는 실수

1. 다운로드 전에 시스템 아키텍처와 실행 방식을 확인하세요

v2rayN은 데스크톱 그래픽 클라이언트로 구독, 노드, 라우팅 규칙과 시스템 프록시를 관리하며, 실제 프로토콜 연결은 Xray 또는 v2fly 등의 코어 프로세스가 처리합니다. 처음 설치할 때 클라이언트 화면이 열린다고 해서 코어가 정상적으로 실행 중이라는 뜻은 아닙니다. 이후에는 메인 프로그램, 코어 파일과 로컬 수신 포트를 모두 확인해야 합니다.

다운로드 전에 기기의 아키텍처를 확인하세요. Windows에서는 「설정」→「시스템」→「시스템 정보」를 열고 “시스템 종류”에서 x64 또는 ARM64를 확인합니다. macOS에서는 왼쪽 상단 시스템 메뉴의 “이 Mac에 관하여”를 열어 Apple 실리콘인지 Intel 프로세서인지 확인합니다. 아키텍처를 잘못 선택하면 프로그램이 실행되지 않거나 코어가 즉시 종료되거나 앱이 호환되지 않는다는 시스템 안내가 나타날 수 있습니다.

1. 아키텍처 확인

   Windows에서는 “시스템 종류”, macOS에서는 프로세서 정보를 확인하세요. x64와 ARM64 설치 패키지는 임의로 바꿔 사용할 수 없습니다.

2. 클라이언트 받기

   사이트 다운로드 센터에서 현재 사용하는 데스크톱 운영체제에 맞는 v2rayN 7.x 버전을 선택하세요. 데스크톱 프로그램 대신 Android 클라이언트 패키지를 사용하면 안 됩니다.

3. 압축 파일 완전히 풀기

   압축 파일은 반드시 독립된 폴더에 모두 풀어야 합니다. Windows에서는 사용자 폴더 아래에 저장하고, 지속적인 관리자 권한이 필요한 위치는 피하는 것이 좋습니다.

4. 실행 환경 확인

   실행 환경에 의존하는 버전을 선택했다면 시작 안내에 따라 호환되는 .NET 8 Desktop Runtime을 설치하세요. 자체 포함 버전은 보통 별도 설치가 필요하지 않습니다.

5. 첫 실행

   Windows에서는 메인 프로그램을 실행하고, macOS에서는 앱을 “응용 프로그램” 폴더에 넣은 뒤 실행합니다. 시스템 안내가 나타나면 열기 권한을 확인하세요.

6. 원래 폴더 유지

   실행 후 개별 실행 파일만 따로 옮기지 마세요. 코어, 설정, 로그와 메인 프로그램은 전체 폴더 구조를 유지해야 합니다.

Windows에서 “실행 환경이 없습니다”라는 안내가 나타나면 먼저 다운로드한 파일이 런타임 의존 버전인지 자체 포함 버전인지 구분해야 합니다. 관리자 권한으로 반복 실행해도 누락된 구성 요소가 설치되지는 않습니다. macOS에서 처음 실행이 차단되면 「시스템 설정」→「개인정보 보호 및 보안」으로 이동해 차단된 앱 이름을 확인한 뒤 시스템에서 제공하는 “그래도 열기”를 사용하세요. 보안 속성을 삭제해 출처 확인을 우회하지 마세요.

2. 첫 실행에서는 코어를 선택한 뒤 기본 설정을 조정하세요

메인 화면에 들어간 뒤 「설정」→「매개변수 설정」→「Core 유형」을 여세요. 구독에 VLESS, Reality, XTLS Vision 등의 설정이 포함되어 있다면 Xray 코어를 우선 선택하세요. 기존 VMess 설정만 사용한다면 v2fly 코어로도 기본 연결이 가능합니다. 코어 유형은 노드 프로토콜 및 전송 매개변수와 호환되어야 합니다. 그렇지 않으면 노드를 가져오는 데는 성공해도 시작 단계에서 “지원되지 않는 필드” 오류가 나거나 바로 종료될 수 있습니다.

기본 매개변수는 한 번에 모두 바꿀 필요가 없습니다. 먼저 기본 로그 수준을 유지하고 로컬 SOCKS 포트와 HTTP 포트를 확인한 다음 로그인 시 자동 실행을 켜세요. 일반적인 설정은 SOCKS 포트 10808, HTTP 포트 10809이지만 실제 값은 반드시 「설정」→「매개변수 설정」에 표시된 로컬 수신 설정을 기준으로 해야 합니다.

• Core 유형: 일반적인 새 설정에는 Xray를 선택하고, 기존 v2fly 설정과의 호환이 명확히 필요할 때만 전환하세요.
• 로컬 주소: 본인 컴퓨터에서만 사용할 때는 127.0.0.1을 유지하세요. 문제를 확인한다는 이유로 모든 네트워크 인터페이스에서 수신하도록 바꾸지 마세요.
• SOCKS 포트: 예시는 10808이며 SOCKS5를 지원하는 앱에 개별적으로 입력합니다.
• HTTP 포트: 예시는 10809이며 브라우저, 명령줄 도구 또는 시스템 프록시에서 사용할 수 있습니다.
• 로그 수준: 처음 설정할 때는 info를 유지하세요. 원인을 확인할 때만 잠시 debug로 변경하고, 점검이 끝나면 로그가 빠르게 쌓이지 않도록 되돌리세요.

3. 구독을 가져온 뒤 노드 필드를 확인하세요

전체 구독 링크를 준비한 뒤 메인 화면에서 「구독 그룹」→「구독 그룹 설정」→「추가」로 이동합니다. 그룹 메모를 입력하고 링크를 붙여 넣은 다음 저장 후 “모든 구독 업데이트”를 실행하세요. 7.x 세부 버전에 따라 버튼 위치는 조금 다를 수 있지만, 순서는 항상 구독 그룹을 먼저 만든 뒤 업데이트하는 방식입니다. 구독 주소를 개별 노드 링크처럼 바로 가져오면 안 됩니다.

업데이트 성공 여부는 “완료” 안내가 떴는지가 아니라 메인 목록에 노드가 나타나고 프로토콜, 주소, 포트, 전송 방식 등의 열에 유효한 값이 표시되는지로 판단해야 합니다. 목록이 비어 있다면 먼저 링크 앞뒤에 공백이 붙었는지, 메신저에서 복사한 내용이 잘리지 않았는지, 구독 서비스가 기존 프록시를 통해서만 업데이트되는지 확인하세요.

노드를 가져온 뒤 하나를 선택해 활성 서버로 지정하고 하단 상태와 코어 로그를 확인하세요. 연결 과정은 보통 설정 생성, 코어 시작, 로컬 포트 수신의 세 단계를 거칩니다. 설정 생성 전에 로그가 중단되면 먼저 노드 필드를 확인하세요. 주소가 이미 사용 중이라는 안내가 나타나면 로컬 포트 충돌입니다. 코어가 정상적으로 수신 중인데 연결 시간이 초과되면 노드 사용 가능 여부, 네트워크 경로와 시스템 프록시를 확인하세요.

4. 시스템 프록시와 로그인 시 자동 실행은 따로 설정하세요

v2rayN 코어가 시작되면 본인 컴퓨터에 사용할 수 있는 프록시 포트가 생길 뿐이며, 모든 프로그램이 자동으로 해당 포트를 사용하는 것은 아닙니다. 시스템 네트워크 설정을 따르는 브라우저와 앱에서 프록시를 사용하려면 v2rayN 트레이 메뉴나 시스템 프록시 기능에서 “시스템 프록시 자동 구성”을 선택해야 합니다. 클라이언트를 종료하기 전에는 시스템 프록시를 복원하여 이미 수신이 중단된 127.0.0.1:10809을 계속 가리키지 않도록 하세요.

Windows의 “관리자 권한으로 실행”과 “시작 시 자동 실행”은 서로 다른 기능입니다. 일반적인 로컬 프록시는 매번 권한 상승이 필요하지 않습니다. 방화벽 규칙, 보호된 폴더에 파일 쓰기 또는 특정 시스템 설정에 권한이 필요할 때만 시스템 안내가 나타납니다. 프로그램을 보호된 폴더에 계속 두면 설정 저장과 자동 업데이트에서 권한 문제가 반복될 수 있으므로 현재 사용자가 읽고 쓸 수 있는 고정 폴더에 보관하는 것이 좋습니다.

macOS에서 로그인 시 실행을 켠 뒤에는 「시스템 설정」의 로그인 항목 페이지에서 v2rayN이 백그라운드에서 실행하도록 허용되었는지 확인해야 합니다. 로그인 후 프로그램은 실행 중인데 프록시가 적용되지 않는다면 코어 실행 여부, 활성 노드 유지 여부와 시스템 프록시 전환 여부를 각각 확인하세요. 메뉴 막대 아이콘만 보고 연결 상태를 판단하면 안 됩니다.

5. 포트, 명령어와 로그로 첫 설정을 점검하세요

첫 설정을 마친 뒤 두 차례 테스트하는 것이 좋습니다. 첫 번째는 시스템 프록시를 우회하고 v2rayN의 HTTP 포트로 직접 요청을 보내 코어와 노드가 작동하는지 확인합니다. 두 번째는 시스템 프록시를 켜고 브라우저로 사이트에 접속해 시스템 설정이 로컬 포트를 올바르게 가리키는지 확인합니다. 이렇게 하면 노드 장애, 포트 충돌과 시스템 프록시 오류를 하나의 문제로 혼동하지 않을 수 있습니다.

Windows에서 10809 포트 확인:
netstat -ano | findstr 10809

macOS에서 10809 포트 확인:
lsof -nP -iTCP:10809 -sTCP:LISTEN

로컬 HTTP 프록시 테스트:
curl --proxy http://127.0.0.1:10809 https://v2raymap.com/

포트 확인 명령에 아무 출력도 없다면 코어가 해당 포트를 수신하고 있지 않은 것입니다. 먼저 v2rayN에서 코어 로그와 로컬 포트 설정을 확인하세요. 포트는 존재하지만 curl이 연결 거부를 반환하면 HTTP 포트와 SOCKS 포트 중 어느 것을 입력했는지 확인하세요. SOCKS5로 테스트할 때는 매개변수를 해당 SOCKS5 프록시 형식으로 바꾸고 실제 포트를 사용해야 합니다.

로그를 확인할 때는 마지막 줄만 보지 말고 처음 나타난 명확한 오류부터 살펴보세요. 포트 충돌에는 보통 “address already in use”가 포함되고, 호환되지 않는 노드 필드는 구체적인 설정 항목을 가리킵니다. 도메인 해석이나 원격 연결 실패에는 timeout, connection refused 등의 메시지가 자주 나타납니다. 오류가 발생한 시간을 기록하고 직전에 수행한 작업과 대조하면 노드를 계속 바꿔 보는 것보다 빠르게 원인을 찾을 수 있습니다.

6. Windows와 macOS에서 가장 흔한 설치 문제

두 운영체제에서 공통으로 발생하는 문제는 주로 폴더가 완전하지 않거나 아키텍처가 맞지 않거나 실행 환경이 없거나 포트 설정이 서로 다른 경우입니다. Windows에서는 보호된 폴더에 파일을 쓰는 문제, 방화벽 권한과 이전 프로세스 잔류가 영향을 주기 쉽습니다. macOS에서는 첫 실행 권한, 승인되지 않은 로그인 항목과 종료 후 복원되지 않은 시스템 프록시 문제가 더 흔합니다.

설치가 끝나면 재현 가능한 기준 설정을 하나 남겨 두는 것이 좋습니다. Core 유형은 Xray, 로컬 주소는 127.0.0.1로 두고 SOCKS와 HTTP 포트는 실제 값을 각각 기록하세요. 하나 이상의 노드가 명령줄 테스트를 통과하고 시스템 프록시를 수동으로 켜고 복원할 수 있어야 합니다. 이 기준이 안정된 뒤에 라우팅 분할, 로컬 네트워크 공유 또는 더 복잡한 규칙을 추가하세요.

• 클라이언트를 업데이트하기 전에 구독 그룹, 라우팅 규칙과 사용자 지정 설정을 백업하세요.
• 포트를 변경한 뒤 시스템 프록시와 수동으로 프록시를 입력한 모든 앱도 함께 수정하세요.
• 노드를 사용할 수 없을 때는 먼저 같은 구독의 다른 노드로 바꿔 보세요. 바로 클라이언트를 다시 설치하지 마세요.
• 구독 업데이트 실패와 노드 연결 실패는 서로 다른 경로의 문제이므로 오류를 따로 확인해야 합니다.
• 프로그램을 종료하기 전에 시스템 프록시를 복원하여 로컬의 비어 있는 포트를 가리키는 네트워크 설정이 남지 않게 하세요.