v2rayN 첫 설치 및 초기 설정 가이드: Windows·macOS 공통 절차와 주의사항

설치 파일 선택: 운영체제와 프로세서 확인

v2rayN은 설정을 관리하는 데스크톱 클라이언트이며, 실제 연결은 코어가 처리합니다. 메인 창이 열렸다는 것만으로는 코어와 노드, 시스템 프록시까지 모두 준비됐다고 볼 수 없습니다. 처음 설치할 때는 클라이언트 다운로드 페이지에서 운영체제에 맞는 파일을 선택한 다음 프로세서 아키텍처와 패키지 설명을 확인하세요.

Windows에서는 ‘설정’ → ‘시스템’ → ‘정보’에서 시스템 종류를 확인할 수 있습니다. macOS에서는 Apple 메뉴의 ‘이 Mac에 관하여’에서 칩을 확인하세요. 일반적인 Intel 및 AMD 데스크톱은 보통 x64를 선택하고, ARM 프로세서를 탑재한 기기는 해당 아키텍처용 패키지를 선택하는 것이 좋습니다. 서로 다른 플랫폼의 코어 파일을 같은 폴더에 섞어 두지 마세요.

파일 배치: 압축을 모두 푼 다음 실행

Windows 압축 파일은 먼저 D:\Apps\v2rayN처럼 정해 둔 폴더에 모두 압축을 푼 뒤, 그 안의 실행 파일을 실행하세요. 압축 프로그램의 미리 보기에서 실행하거나 실행 파일만 바탕 화면으로 옮기지 마세요. 코어와 리소스 파일, 실행에 필요한 구성 요소가 압축 파일 안에 남아 있을 수 있습니다.

macOS에서 디스크 이미지나 앱 패키지를 내려받았다면 패키지 안내에 따라 앱을 ‘응용 프로그램’ 폴더에 넣은 뒤 실행하세요. 압축 파일을 받았다면 먼저 압축을 모두 푸세요. 처음 실행할 때 보안 알림이 표시되면 다운로드 출처와 패키지를 확인한 다음 ‘시스템 설정’ → ‘개인정보 보호 및 보안’에서 해당 앱의 안내를 확인하세요. 시스템 보안 기능 전체를 끄지는 마세요.

1. 고정 폴더

   Windows에서는 현재 계정으로 쓸 수 있는 폴더를 선택하고, macOS에서는 패키지 안내에 따라 앱을 배치하세요. 임시 압축 해제 폴더는 피하고, 여러 폴더에 둔 사본을 동시에 실행하지 마세요.

2. 첫 실행

   메인 화면을 열고 로그나 하단 정보 영역을 확인하세요. 실행 환경이 없다는 알림이 표시되면 안내에 따라 아키텍처에 맞는 실행 환경을 설치하세요. 임의의 동적 라이브러리를 프로그램 폴더에 복사하지 마세요.

3. 코어 확인

   ‘설정’ → ‘매개변수 설정’에서 코어 관련 옵션을 확인하고, 로그에서 실제로 실행된 코어를 확인하세요. 파일을 찾을 수 없다는 알림이 뜨면 압축이 제대로 풀렸는지, 선택한 코어의 폴더가 맞는지 살펴보세요.

4. 설정 가져오기

   ‘구독 그룹’ → ‘구독 그룹 설정’으로 이동해 그룹을 추가하고 구독 주소를 입력하세요. 저장한 뒤 ‘구독 그룹’ 메뉴에서 구독 업데이트를 실행합니다. 메뉴명이 조금 다르면 해당 그룹의 업데이트 명령을 선택하세요.

5. 서버 선택

   목록에서 설정 하나를 선택해 활성 서버로 지정한 다음 코어 실행 로그를 확인하세요. 목록에 노드가 표시되는 것과 현재 연결에 사용할 노드가 선택된 것은 다릅니다.

보안 프로그램이 코어 파일을 격리했다면 다운로드 출처를 확인한 뒤 격리 기록을 살펴보고 복원 여부를 결정하세요. 모든 보안 기능을 꺼서 문제를 숨기지 마세요. 업데이트하거나 압축을 다시 풀기 전에는 트레이에서 프로그램을 종료하고 구독 그룹, 라우팅, 사용자 지정 설정을 백업하세요.

구독과 프로토콜: 가져온 뒤 주요 항목 확인

구독 주소는 설정 목록을 가져오는 데 쓰이며 로컬 프록시 주소가 아닙니다. 구독에는 인증 정보가 포함될 수 있으므로 화면을 공유할 때 전체 링크와 사용자 ID, 비밀번호를 가리세요. 공유 링크가 하나뿐이라면 ‘서버’ → ‘클립보드에서 URL 일괄 가져오기’와 같은 가져오기 명령을 사용하세요. 공유 링크를 시스템 프록시의 서버 입력란에 넣지 마세요.

• 먼저 구독 결과를 확인하세요: 업데이트 후 그룹에 설정이 표시되는지, 로그에 다운로드 실패·파싱 실패·빈 응답이 기록되는지 살펴보세요. 업데이트 성공과 서버 연결 성공은 별개의 문제입니다.
• 그다음 프로토콜을 확인하세요: VMess와 VLESS는 서로 다른 프로토콜입니다. WebSocket은 전송 방식이고 TLS는 연결 보안 설정이므로 서로 대체할 수 없습니다. 가져온 설정에서 서버가 요구하는 조합을 그대로 유지하세요.
• 설정에 맞는 코어를 선택하세요: VLESS와 REALITY 같은 설정에는 해당 기능을 지원하는 코어와 버전이 필요합니다. Xray와 V2Fly의 기능은 완전히 같지 않으므로 코어 전환을 만능 해결책처럼 사용하지 마세요.
• 매개변수를 무작정 바꾸지 마세요: 서버 주소, 포트, 사용자 ID, 전송 경로, SNI, 공개 키 등의 정보는 서버 설정과 일치해야 합니다. 구독에 올바르게 입력된 항목은 다른 튜토리얼 화면을 보고 다시 작성하지 마세요.

수신 포트: 클라이언트와 앱 설정 맞추기

로컬 수신 포트는 브라우저, 시스템 또는 명령줄 도구가 v2rayN에 연결할 때 사용하는 진입점이지 원격 서버의 포트가 아닙니다. ‘설정’ → ‘매개변수 설정’에서 로컬 수신 또는 인바운드 관련 항목을 찾아 실제 주소와 포트, 지원하는 프록시 유형을 기록하세요. 버전이나 기존 설정에 따라 포트가 다를 수 있으므로 튜토리얼에서 본 번호를 그대로 입력하지 마세요.

아래 두 카드의 예시는 현재 127.0.0.1:10808에서 HTTP와 SOCKS 요청을 모두 받는 혼합 수신이 설정되어 있다고 가정합니다. 클라이언트가 수신 포트를 분리해 사용한다면 실제 포트를 각각 입력하세요. 예시를 그대로 따라 하려고 두 진입점을 억지로 같은 포트로 바꾸면 안 됩니다.

이 기기에서만 사용할 때는 루프백 수신을 유지하고 LAN 연결 허용은 켜지 않아도 됩니다. 포트를 변경했다면 코어가 설정을 다시 불러오도록 하고 수동 프록시를 사용하는 앱도 함께 수정하세요. 로그에 address already in use가 표시되면 임의의 포트를 계속 시도하지 말고, 클라이언트가 중복 실행 중인지 확인한 다음 포트를 점유한 프로세스를 찾으세요.

시스템 프록시: 코어를 확인한 뒤 앱 트래픽 연결

처음 문제를 확인할 때는 TUN을 켜지 말고 로컬 프록시 연결부터 검증하는 것이 좋습니다. 사용 가능한 노드가 있고 코어가 수신 중인지 확인한 뒤 메인 창이나 트레이 메뉴의 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’을 선택하세요. 여기서 ‘자동 설정’은 클라이언트 메뉴의 동작을 뜻하며, PAC 스크립트 주소를 직접 입력하라는 의미가 아닙니다.

• Windows: ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 프록시 주소와 포트가 현재 수신 주소를 가리키는지 확인하세요. 조직 정책으로 관리되는 기기에서는 변경이 제한될 수 있으니 먼저 관리 정책을 확인하세요.
• macOS: ‘시스템 설정’ → ‘네트워크’ → 현재 네트워크 서비스 → ‘세부사항’ → ‘프록시’에서 확인하세요. 시스템 버전에 따라 네트워크 프록시를 변경할 때 권한이 필요할 수 있으므로 권한 안내를 놓치지 마세요.
• 앱 적용 범위: 모든 프로그램이 시스템 프록시를 따르는 것은 아닙니다. 일부 명령줄 도구와 게임, 자체 프록시를 설정한 앱은 별도의 네트워크 경로를 사용하므로 한 앱의 결과만으로 모든 트래픽이 정상이라고 판단할 수 없습니다.
• 종료 순서: 사용을 마치기 전에 시스템 프록시를 해제한 다음 클라이언트를 종료하세요. 종료 후 웹 페이지가 열리지 않으면 시스템 프록시가 여전히 로컬 포트를 가리키는지 먼저 확인하세요.

프록시를 지정해 요청 경로 분리하기

Windows에서는 PowerShell에서 아래 명령을 실행하세요. macOS 터미널에서는 curl.exe를 curl로 바꾸면 됩니다. 이 예시는 로컬 10808 포트에서 HTTP 프록시를 수신해야 합니다. 테스트 주소 https://example.com/는 연결 확인용이며 전용 속도 측정 서비스가 아닙니다.

curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

HTTP 응답을 받으면 해당 요청이 지정한 프록시 진입점을 통해 전달된 것입니다. 그렇다고 모든 웹사이트나 UDP 트래픽이 사용 가능하다는 뜻은 아닙니다. 로컬 포트에 연결할 수 없다는 메시지가 나오면 먼저 수신 설정을 확인하세요. 프록시 연결 후 TLS 오류나 원격 연결 시간 초과가 발생하면 코어 로그에서 노드, 시스템 시간, 네트워크 상태를 확인하세요. 프록시를 지정한 요청은 정상인데 브라우저에서 실패한다면 브라우저 자체 프록시 설정과 확장 프로그램, 시스템 프록시를 살펴보세요. 곧바로 클라이언트를 다시 설치할 필요는 없습니다.

첫 실행에서 자주 겪는 문제: 증상별 확인 방법

설정 완료 확인: 작동하는 구성을 저장한 뒤 고급 설정하기

처음 설정이 성공하면 실제로 작동한 설정을 기록한 다음 시작 시 자동 실행, 라우팅 규칙, TUN을 검토하세요. 시스템 프록시는 앱이 연결을 클라이언트에 전달할지 결정하고, 라우팅 분기는 코어에 들어온 연결을 어느 출구로 보낼지 결정합니다. 서로 다른 단계이므로 시스템 프록시를 켰다고 모든 대상이 원격 노드를 거치는 것은 아닙니다.

• 정해 둔 폴더의 프로그램이 다시 실행되는지, 코어 로그에 시작 오류가 없는지 확인하세요.
• 활성 구독 그룹, 노드 프로토콜, 사용 중인 코어와 로컬 수신 포트를 기록하세요. 백업할 때 구독 인증 정보는 안전하게 보호하세요.
• 프록시를 지정한 요청 하나와 시스템 프록시를 따르는 브라우저 접속을 각각 테스트하세요.
• 시스템 프록시를 해제한 상태에서도 네트워크에 정상 접속되는지 테스트해, 다음에 클라이언트를 종료한 뒤 인터넷이 끊겼다고 오해하지 않도록 하세요.
• 고급 설정은 한 번에 하나씩 변경하세요. 변경 전 라우팅, DNS, 인바운드 설정을 보관해 문제가 생기면 항목별로 되돌릴 수 있도록 하세요.

전체 절차를 확인하려면 클라이언트 설정 가이드를 참고하세요. VMess, VLESS, 전송 방식과 코어 지원 기능을 구분하려면 프로토콜 안내서를 확인할 수 있습니다. ‘설정 가져오기’, ‘코어 실행’, ‘포트 접속’, ‘앱의 프록시 사용’ 네 가지 상태를 차례로 확인하면 설치 파일을 반복해서 내려받는 것보다 문제를 찾기 쉽습니다.