v2rayN 첫 설치 및 초기 설정: Windows·macOS 설치와 설정 가이드

설치 파일 선택: 운영체제·아키텍처·인터페이스 확인

v2rayN은 노드를 저장하고 설정을 생성한 뒤 프록시 코어를 실행하는 데스크톱 클라이언트입니다. 프로그램 화면이 열려도 코어가 실행 중이라는 뜻은 아니며, 노드가 표시되어도 브라우저 트래픽이 프록시를 거친다는 보장은 없습니다. 처음 설치할 때는 이 세 단계를 나눠 점검해야 웹페이지가 열리지 않는다고 프로그램을 반복해서 재설치하는 일을 피할 수 있습니다.

다운로드 센터에서 운영체제와 프로세서 아키텍처에 맞는 패키지를 선택하세요. Windows의 기존 WPF 인터페이스와 크로스 플랫폼 데스크톱 인터페이스는 서로 다른 빌드이며, macOS에서는 Windows 실행 파일을 사용할 수 없습니다. 다운로드 전에 해당 패키지의 실행 환경 안내를 확인하세요. 파일 크기만으로 런타임이나 코어 포함 여부를 판단해서는 안 됩니다.

아래 메뉴 설명은 일반적인 데스크톱 인터페이스의 한국어 명칭을 기준으로 합니다. 배포 버전에 따라 설정 항목이 같은 창의 다른 탭에 있을 수 있습니다. 명칭이 다르면 예전 스크린샷의 위치를 그대로 찾기보다 ‘구독 그룹’, ‘시스템 프록시’, ‘Core 유형’ 등 항목의 의미를 기준으로 찾아보세요.

프로그램 설치: Windows 압축 해제와 macOS 첫 실행

Windows에서 짧은 경로를 사용하는 것은 문제를 쉽게 찾기 위해서이지, 한글 경로에서는 반드시 실행할 수 없다는 뜻이 아닙니다. 폴더에 쓰기 권한이 있는지, 파일이 온전한지, 보안 프로그램이 종속 파일이나 코어를 격리했는지 확인하세요. 격리 기록이 있으면 파일 출처와 구체적인 안내를 먼저 확인하고 시스템 보호 기능을 일괄 해제하지 마세요.

런타임과 실행 로그: 프로그램 오류와 코어 오류를 구분해 해결하기

일부 Windows 빌드는 호환되는 .NET 런타임이 필요하고, 다른 빌드는 런타임을 자체 포함합니다. 런타임이 없다는 오류가 표시되면 실행 대화상자에 나온 프레임워크 이름, 주 버전, 아키텍처를 기준으로 확인하세요. WPF 빌드는 보통 해당 버전의 Desktop Runtime이 필요합니다. SDK만 설치하거나 다른 아키텍처용 런타임을 설치해도 요구 사항을 충족하지 못할 수 있습니다. 배포 버전마다 요구 사항이 다르므로 특정 런타임 버전을 일괄 지정하지 않습니다.

• 기본 창이 전혀 열리지 않음: 시스템 오류 메시지 전체를 기록하고 아키텍처, 런타임, 최소 시스템 요구 사항을 우선 확인하세요.
• 기본 창은 열리지만 코어가 없다는 메시지가 표시됨: 압축 파일이 완전히 풀렸는지, 패키지에 선택한 코어가 포함되어 있는지, 관련 파일이 격리되었는지 확인하세요.
• 코어가 실행되자마자 종료됨: 클라이언트 로그에서 처음 발생한 실행 오류를 확인하세요. 포트 충돌, 설정 항목, 프로토콜 지원 여부를 중점적으로 살펴보세요.
• macOS에서 아키텍처가 호환되지 않는다는 알림이 표시됨: Apple 칩용 패키지와 Intel용 패키지의 대응 관계를 다시 확인하세요. 아키텍처 문제를 구독 오류로 취급하지 마세요.

일반적인 시스템 프록시 사용에는 관리자 권한으로 계속 실행할 필요가 없습니다. TUN이나 라우팅 변경 같은 기능은 추가 권한이 필요할 수 있지만 첫 연결을 확인하는 데 필수는 아닙니다. 먼저 일반 권한으로 기본 프록시를 테스트하면 권한 변경과 네트워크 제어 기능이 동시에 개입해 문제를 일으킬 가능성을 줄일 수 있습니다.

초기 설정 순서: 언어, 코어, 구독 가져오기

네트워크 관련 기본 설정은 그대로 두고 꼭 필요한 항목만 변경하세요. 인터페이스 언어는 메뉴 표시를 바꿀 뿐 서버 프로토콜에는 영향을 주지 않습니다. 구독 주소는 노드 목록을 가져오는 데 사용하며 로컬 리스닝이나 시스템 프록시 설정을 대신하지 않습니다. 구독 링크에 접속 정보가 포함될 수 있으므로 스크린샷이나 문의용 로그에 전체 주소가 보이지 않도록 가리세요.

1. 인터페이스 언어 확인

   ‘설정’에서 언어 항목을 찾아 간체 중국어를 선택하세요. 일부 빌드에서는 ‘설정’ → ‘매개변수 설정’에서 언어를 바꿀 수 있습니다. 재시작 안내가 나오면 클라이언트를 정상 종료한 뒤 다시 열고 설정을 이어가세요.

2. 코어 확인

   ‘설정’ → ‘매개변수 설정’ → ‘Core 유형’에서 관련 프로토콜에 사용할 코어를 확인하세요. 이 항목은 별도의 탭에 있을 수 있습니다. 패키지에 필요한 코어가 있는지 확인한 뒤 저장하고, 네트워크 기능을 여러 개 동시에 바꾸지 마세요.

3. 구독 그룹 만들기

   ‘구독 그룹’ → ‘구독 그룹 설정’을 열고 그룹을 추가한 뒤 이미 보유한 구독 주소를 입력하세요. 그룹 이름은 로컬에서 구분하기 위한 것입니다. 주소 입력란에 공백, 설명 문구, 줄바꿈을 넣지 마세요.

4. 노드 목록 업데이트

   ‘구독 그룹’ 메뉴에서 모든 구독을 업데이트하는 항목을 선택하세요. 사용할 프록시가 아직 없다면 먼저 프록시를 사용하지 않는 업데이트 방식을 이용하세요. 업데이트가 완료되면 노드 수가 바뀌었는지 확인하고 노드 하나를 활성 서버로 선택합니다.

5. 시스템 프록시 사용

   코어 로그에 실행 오류가 없는지 확인한 뒤 클라이언트의 ‘시스템 프록시’ 메뉴에서 ‘시스템 프록시 자동 설정’을 선택하세요. 브라우저로 한 번 접속을 테스트한 다음 필요에 따라 라우팅 규칙이나 구독 자동 업데이트 간격을 조정합니다.

노드 공유 링크 하나만 있다면 구독 주소 입력란에 넣지 말고 ‘서버’ 메뉴에서 해당 링크를 가져오는 기능을 사용하세요. 구독 업데이트는 구독 서버에 접속하는 작업이고, 노드 가져오기는 노드 매개변수를 해석하는 작업입니다. 두 작업은 실패 원인과 점검 방법이 다릅니다.

코어 선택: 이름이나 속도가 아니라 노드 프로토콜로 확인

v2rayN은 클라이언트이고 Xray와 V2Fly는 프록시 코어 프로젝트입니다. 각 코어가 지원하는 프로토콜과 전송 방식은 완전히 같지 않습니다. 노드를 사용할 수 있는지는 노드 설정과 선택한 코어의 실제 지원 범위에 따라 달라집니다. 코어를 바꾼다고 반드시 빨라지는 것은 아니며, 만료된 서버 주소나 잘못된 인증 정보를 해결할 수도 없습니다.

Core 유형을 바꾼 뒤에는 연결을 다시 시작하고 실제 실행 로그를 확인하세요. 설정 화면에서 선택한 값이 실행 중인 코어에 즉시 반영되지 않을 수 있으므로 설정 창만 보고 변경이 끝났다고 판단하지 마세요. 설정 구조를 더 알아보려면 JSON 설정 안내서에서 인바운드, 아웃바운드, 라우팅 설명을 참고하세요.

연결 확인: 로컬 포트·시스템 프록시·라우팅을 각각 점검

로컬 리스닝 주소는 앱이 클라이언트에 연결하는 입구이고, 원격 서버 포트는 코어가 노드에 연결할 때 사용하는 대상입니다. 두 포트는 서로 바꿔 쓸 수 없습니다. 아래에서는 127.0.0.1:10808로 포트 점검 방법을 설명합니다. 실제 포트와 연결 프로토콜은 ‘설정’ → ‘매개변수 설정’의 리스닝 항목과 로그를 확인하세요. 빌드에 따라 SOCKS, HTTP 또는 혼합형 입구가 제공될 수 있습니다.

Windows에서는 명령 프롬프트에서 예시 포트를 확인할 수 있습니다. 출력의 마지막 열은 보통 프로세스 ID입니다. 다른 클라이언트가 포트를 사용 중이라면 먼저 어떤 프로세스인지 확인한 뒤 충돌하는 프로그램을 정상 종료하거나 로컬 리스닝 포트를 변경하세요. 정체를 모르는 시스템 프로세스를 바로 종료하지 마세요.

netstat -ano -p tcp | findstr ":10808"

macOS에서는 터미널에서 같은 예시 포트를 리스닝 중인 TCP 프로세스를 확인할 수 있습니다. 결과가 없다는 것은 현재 명령에서 일치하는 리스닝 항목을 찾지 못했다는 뜻일 뿐입니다. 클라이언트의 실제 포트와 로그도 함께 확인해야 하며, 구독을 사용할 수 없다고 단정해서는 안 됩니다.

lsof -nP -iTCP:10808 -sTCP:LISTEN

• 로컬 리스닝 포트를 변경했다면 클라이언트의 시스템 프록시 설정을 다시 적용하고 브라우저나 다른 앱에 직접 입력한 프록시 주소도 함께 수정하세요.
• Windows는 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 시스템 프록시를 확인할 수 있습니다. macOS는 현재 네트워크 서비스의 ‘세부사항’ → ‘프록시’에서 확인하세요.
• 모든 앱이 시스템 프록시를 따르는 것은 아닙니다. 첫 연결 테스트는 시스템 프록시를 따르는 브라우저로 진행하고, 처음부터 TUN이나 브라우저 프록시 확장 기능을 함께 사용하지 마세요.
• 클라이언트를 종료하기 전에 시스템 프록시를 해제하세요. 프로그램이 중지된 뒤에도 시스템이 닫힌 로컬 포트로 요청을 보내는 문제를 막을 수 있습니다.

v2rayN 첫 설치 FAQ

설정 완료 후 보관할 항목과 재점검 순서

처음 연결에 성공하면 현재 사용할 수 있는 코어, 리스닝 포트, 라우팅 구성을 기록해 두세요. 이후 문제를 점검할 때는 한 번에 하나씩만 바꾸세요. 프로그램 실행 여부, 코어 로그, 노드 연결 상태, 앱의 프록시 사용 여부 순으로 확인하면 설치 환경 변경, 노드 오류, 시스템 설정 잔류를 구분하기 쉽습니다.

• 필요한 정보 기록: 클라이언트 버전, 패키지 아키텍처, 활성 코어, 포트를 기록하되 구독 주소와 노드 인증 정보는 공개하지 마세요.
• 설정을 저장하기 전에 종료: 클라이언트 설정을 백업할 때는 정상 종료한 뒤 복사하세요. 기록 중인 데이터를 복사하는 일을 막을 수 있습니다. 설정에 민감한 정보가 들어 있을 수 있으니 안전하게 보관하세요.
• 업데이트 안내 확인: 인터페이스 종류가 다르거나 버전 차이가 큰 경우 기존 폴더를 그대로 덮어써도 된다고 가정하지 마세요. 먼저 복구할 수 있는 설정 사본을 보관하세요.
• 종료 후 동작 확인: 정상 종료한 뒤 시스템 프록시가 해제되는지, 컴퓨터를 다시 시작한 뒤에도 일반 네트워크를 사용할 수 있는지 확인하세요.

구독 가져오기와 라우팅 설정을 더 알아보려면 입문 가이드를 따라 진행하세요. 첫 설치의 목표는 기능을 한꺼번에 모두 켜는 것이 아니라, 원인을 파악하고 다시 확인할 수 있는 기본 설정을 마련하는 것입니다.