v2rayN 첫 설치 및 초기 설정: Windows와 macOS 공통 핵심 사항과 자주 발생하는 문제

v2rayN 7.x는 더 이상 전통적인 Windows 트레이 프로그램에만 머물지 않으며, 최신 데스크톱 버전은 macOS와 Linux도 지원합니다. 처음 사용할 때 중요한 것은 복잡한 프로토콜 매개변수가 아니라 프로그램 폴더에 쓰기 권한이 있는지, 실행 환경이 완전한지, 코어 유형이 노드와 호환되는지, 시스템 프록시가 예상대로 적용됐는지입니다. 이 항목들을 순서대로 확인하면 VMess, VLESS 또는 구독 주소를 가져올 때 훨씬 수월합니다.

다운로드 및 압축 해제먼저 프로그램 폴더를 준비하세요

v2rayN 데스크톱 패키지는 보통 압축 파일이나 애플리케이션 패키지 형태로 배포됩니다. Windows에서는 압축 파일을 완전히 풀고 실행해야 하며, 압축 프로그램의 미리 보기 창에서 주 프로그램을 바로 실행하지 마세요. 미리 보기로 실행하면 임시 폴더가 창을 닫은 뒤 삭제될 수 있고, 데이터베이스·로그·다운로드한 코어 파일도 안정적으로 저장되지 않을 수 있습니다.

Windows에서는 D:\Apps\v2rayN, C:\Users\현재 사용자\Apps\v2rayN처럼 현재 계정에 쓰기 권한이 있는 고정 폴더를 선택할 수 있습니다. 추가 관리자 권한이 필요한 시스템 폴더에 바로 넣지 말고, 다운로드 폴더에서 계속 덮어쓰며 사용하지도 마세요. 경로에 한글이 포함되어도 되지만, 문제를 점검할 때는 짧은 경로와 영문 폴더명이 로그의 파일 위치를 파악하기 쉽습니다.

1. 플랫폼 확인

   Windows에서는 먼저 「설정」→「시스템」→「시스템 정보」에서 시스템 유형을 확인합니다. 일반적인 장치는 x64를, ARM 프로세서 장치는 arm64를 선택하세요. macOS에서는 「이 Mac에 관하여」에서 칩 유형을 확인한 뒤 해당 빌드를 선택합니다.

2. 완전히 압축 해제하기

   Windows에서는 압축 파일을 고정 폴더에 풀고, 주 프로그램과 함께 제공된 파일이 같은 단계에 있는지 확인하세요. 실행 파일만 따로 꺼내면 리소스 파일이나 코어 폴더를 찾지 못할 수 있습니다.

3. 첫 실행

   Windows에서는 v2rayN 주 프로그램을 실행하고, macOS에서는 앱을 「응용 프로그램」으로 이동한 뒤 엽니다. 출처 확인 메시지가 나타나면 시스템 설정의 보안 페이지에서 앱 이름을 확인한 다음 열기를 허용하세요.

4. 쓰기 권한 확인

   실행 후 인터페이스 언어나 창 설정을 한 번 변경하고 정상적으로 종료한 뒤 다시 엽니다. 설정이 유지되면 구성 폴더에 쓰기 권한이 있는 것입니다. 원래 상태로 돌아간다면 노드를 반복해서 가져오기보다 먼저 폴더 권한을 해결하세요.

macOS에서 앱 본체는 보통 「응용 프로그램」에 있으며, 구성과 캐시는 현재 사용자 폴더에 저장됩니다. 앱을 읽기 전용 디스크 이미지에서 직접 실행 중이라면 먼저 종료하고 「응용 프로그램」으로 옮기세요. Windows의 포터블 폴더와 macOS 앱 폴더는 구조가 다르므로 양쪽의 프로그램 파일을 섞어 복사해서는 안 됩니다.

런타임 및 코어노드 실행 가능 여부를 결정합니다

v2rayN의 그래픽 인터페이스와 프록시 코어는 서로 다른 두 계층입니다. 인터페이스는 구독 저장, 노드 전환, 라우팅 수정 및 시스템 프록시 제어를 담당하고, Xray 또는 v2fly 코어는 로컬 포트를 수신 대기하고 아웃바운드 연결을 생성하며 라우팅 규칙을 실행합니다. 주 창이 열린다고 해서 프록시 코어까지 정상 실행된 것은 아닙니다.

v2rayN 7.x를 예로 들면 Windows 버전은 아키텍처에 맞는 .NET 8 Desktop Runtime이 필요할 수 있습니다. 실행 파일을 두 번 클릭해도 창이 전혀 나타나지 않거나, 이벤트 뷰어에 런타임 오류가 표시되거나, Microsoft.WindowsDesktop.App이 없다는 메시지가 나오면 먼저 프로그램 아키텍처와 일치하는 실행 환경을 설치하세요. x64 프로그램에는 x64 런타임을, arm64 빌드에는 arm64 런타임을 사용해야 하며 다른 아키텍처만 설치해서는 대체할 수 없습니다.

「설정」→「매개변수 설정」→「Core 유형」을 열고 현재 Xray를 사용 중인지 먼저 확인하세요. 구독 노드에 flow=xtls-rprx-vision, Reality 공개 키, 짧은 ID 또는 지문 매개변수가 포함되어 있다면 v2fly 코어로 바꾸지 마세요. 코어가 맞지 않으면 노드는 가져와지고 주소와 포트도 표시되지만, 시작 로그에 지원하지 않는 필드나 아웃바운드 초기화 실패가 나타나는 경우가 많습니다.

초기 매개변수포트와 시스템 프록시 동작을 통일하세요

로컬 포트는 브라우저·시스템 프록시·기타 앱이 v2rayN에 연결하는 진입점입니다. 버전이나 이전 구성에 따라 기본값이 다를 수 있으므로 튜토리얼의 포트를 고정된 값으로 받아들이지 마세요. 「설정」→「매개변수 설정」에서 현재 로컬 수신 대기 값을 확인하고 개발 서버, 다른 프록시 프로그램 또는 이전 v2rayN 인스턴스와 충돌하지 않는지 점검하세요.

처음 문제를 확인할 때는 로컬 mixed 포트를 10808로 설정하고 수신 주소는 127.0.0.1로 유지하면 편리합니다. 이는 로컬 컴퓨터의 연결만 허용하고 LAN에는 공개하지 않는다는 뜻입니다. 인터페이스에서 HTTP와 SOCKS 포트를 따로 제공한다면 HTTP 예시 값으로 10809, SOCKS 예시 값으로 10808을 사용할 수 있지만, 실제 값은 시스템 프록시 페이지 및 해당 프록시를 사용하는 앱의 설정과 일치해야 합니다.

시스템 프록시의 세 가지 주요 동작은 의미가 서로 다릅니다. 「시스템 프록시 설정」은 현재 시스템의 HTTP 또는 관련 프록시를 v2rayN으로 지정하고, 「시스템 프록시 해제」는 해당 프록시 값을 삭제하며, 「시스템 프록시를 변경하지 않음」은 코어만 시작하고 운영체제의 기존 설정은 수정하지 않습니다. 처음 설정할 때는 먼저 「시스템 프록시를 변경하지 않음」을 선택하고, 로그에서 127.0.0.1:10808이 수신 대기 중인지 확인한 다음 「시스템 프록시 설정」으로 전환하세요.

노드만 시작하고 시스템 프록시를 설정하지 않으면 브라우저가 여전히 직접 연결할 수 있습니다. 반대로 v2rayN을 종료한 뒤 시스템 프록시가 남아 있으면 브라우저는 이미 수신을 중지한 로컬 포트에 계속 접속해 모든 웹페이지가 즉시 실패합니다. 이 경우 v2rayN을 다시 열어 「시스템 프록시 해제」를 실행하거나 운영체제 네트워크 설정에서 수동 프록시를 끄세요.

구독 및 노드정해진 순서로 첫 연결을 완료하세요

구독 주소는 업데이트 가능한 노드 목록이며, VMess 또는 VLESS 공유 링크는 보통 하나의 노드만 나타냅니다. 둘 다 v2rayN으로 가져올 수 있지만 관리 방식은 다릅니다. 구독은 정기적으로 업데이트해야 하고, 단일 링크는 서버에 새로 추가되거나 변경된 노드를 자동으로 받지 못합니다. 가져오기 전에 클립보드 내용이 완전한지, 불필요한 공백이나 줄바꿈으로 잘리지 않았는지 확인하세요.

v2rayN 7.x의 세부 버전에 따라 메뉴 문구가 조금 다를 수 있지만, 구독 관련 기능은 보통 「구독 그룹」 메뉴에 있습니다. 먼저 그룹을 만들고 구독 주소를 저장한 다음 업데이트하세요. 주소만 추가하고 업데이트하지 않으면 주 목록에 노드가 자동으로 생성되지 않습니다.

1. 구독 추가

   「구독 그룹」→「구독 그룹 설정」→「추가」를 열고 알아보기 쉬운 별칭과 전체 구독 주소를 입력한 뒤 저장하고 주 화면으로 돌아갑니다.

2. 그룹 업데이트

   「구독 그룹」→「모든 구독 업데이트」를 실행하세요. 상태 표시줄에 추가되거나 업데이트된 노드 수가 표시되어야 합니다. 0으로 표시되면 그룹이 활성화되어 있는지와 주소가 완전한지 확인하세요.

3. 노드 선택

   노드 목록에서 프로토콜과 코어가 일치하는 항목을 선택해 활성 서버로 지정하세요. 전송 방식, TLS, SNI, UUID 또는 Reality 매개변수를 한 번에 여러 개 변경하지 마세요.

4. 코어 시작

   시작한 뒤 로그를 열어 로컬 포트 수신 대기가 성공했는지, 포트 사용 중·지원하지 않는 필드·도메인 확인 실패·핸드셰이크 실패가 없는지 확인하세요.

5. 프록시 적용

   「시스템 프록시」→「시스템 프록시 설정」을 선택한 뒤 브라우저로 서로 다른 사이트 두 곳에 접속하세요. 그런 다음 「시스템 프록시 해제」로 전환해 브라우저가 직접 연결을 복구하는지도 확인합니다.

지연 시간 테스트는 특정 탐색 요청의 응답 결과만 보여줄 뿐, 전체 웹 트래픽이 반드시 작동한다는 뜻은 아닙니다. 어떤 노드가 80ms로 표시되어도 TLS 매개변수, 전송 경로 또는 출구 정책이 잘못되면 실제 연결을 만들지 못할 수 있습니다. 첫 확인에서는 노드 지연 시간, 코어 로그, 브라우저 접속 결과를 함께 살펴보세요.

자동 시작 및 라우팅연결 테스트 후에 설정하세요

자동 시작은 프로그램을 자동으로 실행할 뿐, 사용할 수 없는 노드·잘못된 구독·포트 충돌을 자동으로 해결하지는 않습니다. 최소 한 번은 시작, 연결, 프록시 해제, 종료, 재실행의 전체 과정을 완료한 뒤 「설정」에서 자동 시작을 활성화하세요. 이렇게 해야 로그인할 때마다 사용할 수 없는 프록시 값이 즉시 기록되는 일을 막을 수 있습니다.

Windows에서 자동 시작을 활성화한 뒤 「설정」→「앱」→「시작 프로그램」에서 v2rayN이 활성 상태인지 확인할 수 있습니다. macOS에서는 「시스템 설정」→「일반」→「로그인 항목」에서 확인하세요. v2rayN 자체 옵션은 켜져 있지만 시스템 목록에 해당 항목이 없다면 먼저 옵션을 끄고 프로그램을 정상 종료한 다음 다시 실행해 한 번 더 활성화하세요.

• 자동 시작: 사용자가 로그인한 뒤 v2rayN을 실행할 뿐, 노드 연결 성공을 보장하지는 않습니다.
• 최소화하여 시작: 설정을 완료한 일상적인 사용에 적합하며, 처음 문제를 해결할 때는 주 창과 로그를 계속 표시하는 것이 좋습니다.
• 시스템 프록시 자동 설정: 활성 노드가 안정적으로 작동한 뒤 켜고, 프로그램 종료 시 정리 작업이 실행되는지 확인하세요.
• 구독 자동 업데이트: 먼저 수동 업데이트가 성공하는지 확인한 뒤 업데이트 간격을 설정해 시작 단계에서 여러 변수가 동시에 생기지 않도록 하세요.
• 라우팅 모드: 첫 연결에서는 내장된 기본 규칙을 사용하고, 출처가 불분명한 사용자 지정 규칙을 여러 개 동시에 가져오지 마세요.

라우팅 분할은 어떤 도메인이나 IP를 프록시, 직접 연결 또는 차단으로 보낼지 결정하며, 시스템 프록시 활성화 여부와는 다른 계층입니다. 시스템 프록시는 앱의 트래픽을 v2rayN으로 전달하고, 로컬 코어가 라우팅 규칙에 따라 출구를 선택합니다. 웹페이지가 열리지 않으면 먼저 트래픽이 로컬 포트로 들어갔는지 확인한 다음 올바른 출구로 라우팅되었는지 판단하세요.

초보자가 흔히 하는 실수는 TUN을 켜고 DNS를 바꾸고 라우팅 규칙을 가져온 뒤 포트까지 한 번에 수정하는 것입니다. 이렇게 하면 문제가 발생했을 때 어느 단계가 원인인지 파악하기 어렵습니다. 더 안전한 순서는 일반 시스템 프록시로 연결한 뒤 작동하는 구성을 하나 보관하고, 이후에는 한 번에 한 항목만 변경하면서 로그를 확인하고 다시 테스트하는 것입니다.

자주 발생하는 시작 문제증상별로 하나씩 확인하세요

문제를 해결할 때 프로그램을 자주 재설치하지 마세요. v2rayN의 인터페이스, 구성 데이터베이스, 프록시 코어, 시스템 프록시는 각각 다른 계층이므로 증상에 따라 먼저 해당 계층을 찾는 편이 효과적입니다. 프로그램이 열리지 않으면 런타임과 폴더를 확인하고, 프로그램은 열리지만 코어가 실패하면 포트와 코어 유형을 확인하며, 코어는 정상인데 웹페이지가 열리지 않으면 시스템 프록시·노드·라우팅을 점검하세요.

로그에 노드 연결 시간 초과만 표시되더라도 UUID, 포트, 전송 경로 또는 서버 이름을 바로 바꾸지 마세요. 이러한 필드는 보통 구독에서 제공되며, 임의로 추측해 수정하면 복구 가능한 구성이 더 어긋날 수 있습니다. 먼저 구독을 업데이트하고 같은 그룹의 다른 노드로 전환한 뒤, 컴퓨터의 시간과 시간대가 정확한지 확인하고 단일 노드 문제인지 판단하세요.

첫 설정을 완료한 뒤에는 현재 v2rayN 버전, 코어 버전, 로컬 포트, 활성 구독 그룹 및 시스템 프록시 모드를 기록해 두는 것이 좋습니다. 이후 업그레이드나 마이그레이션을 할 때 이 정보를 항목별로 비교하면 변경이 그래픽 인터페이스·코어·노드·운영체제 네트워크 설정 중 어디에서 발생했는지 빠르게 파악할 수 있습니다.