v2rayN 첫 설치 및 초기 설정 가이드: Windows·macOS 공통 설정과 자주 하는 실수

이 글의 핵심

v2rayN을 처음 사용하거나 Windows에서 macOS로 옮기는 사용자를 위한 안내입니다. ‘설치 파일 확인 → 코어 실행 → 설정 가져오기 → 로컬 리스닝 확인 → 시스템 프록시 설정 → 요청 테스트’ 순서로 진행하세요. 먼저 노드 하나가 정상 작동하는지 확인한 뒤 라우팅과 다른 기능을 설정하는 편이 좋습니다. 본문에 나온 포트는 설정 예시이며 모든 버전의 기본값은 아닙니다. 메뉴 이름은 데스크톱 인터페이스 버전에 따라 달라질 수 있으므로 현재 설정 화면과 실행 로그를 함께 확인하세요.

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

v2rayN은 노드, 구독, 라우팅 및 코어 프로세스를 관리하는 데스크톱 GUI 클라이언트입니다. 실제 프록시 연결은 코어가 처리합니다. 메인 창이 열렸다는 것은 인터페이스가 실행되었다는 뜻일 뿐, 코어가 작동 중이거나 브라우저 트래픽이 프록시를 통과한다는 의미는 아닙니다. 처음 설치할 때는 각 단계를 따로 확인해야 합니다.

사용 환경	선택 기준	먼저 확인할 항목
Windows x64	해당 데스크톱용 패키지를 선택하세요. WPF는 Windows용 클래식 인터페이스이며 macOS 설치 파일이 아닙니다.	‘설정’ → ‘시스템’ → ‘시스템 정보’에서 시스템 종류를 확인하고 설치 파일의 실행 요구 사항을 읽어 보세요.
Apple Silicon Mac	arm64 DMG를 선택하세요.	Apple 메뉴 → ‘이 Mac에 관하여’에서 칩 정보를 확인하세요.
macOS Intel	x64 DMG를 선택하세요.	프로세서 종류와 소프트웨어에서 요구하는 최소 운영체제 버전을 확인하세요.

Windows 압축 파일은 먼저 C:\Tools\v2rayN처럼 쓰기 가능한 폴더에 모두 압축을 푼 다음, 그 안의 메인 프로그램을 실행하세요. 압축 프로그램의 미리 보기에서 바로 실행하거나 메인 프로그램만 따로 꺼내지 마세요. 코어, 리소스 및 기타 종속 파일이 압축 파일 안에 남아 있을 수 있습니다. 설치 프로그램을 받은 경우에는 설치 마법사의 안내를 따르면 되며, 압축 해제 절차를 억지로 적용할 필요는 없습니다.

macOS에서 DMG를 연 다음 앱을 ‘응용 프로그램’ 폴더로 드래그하고, 디스크 이미지를 꺼낸 뒤 ‘응용 프로그램’에서 실행하세요. 이후에도 임시로 마운트한 위치에서 실행하는 문제를 예방할 수 있습니다. 다른 기기로 옮길 때는 클라이언트의 가져오기 또는 백업 기능을 사용하세요. 특히 코어 경로와 파일 권한을 다시 확인하지 않은 채 다른 플랫폼의 프로그램 폴더 전체를 덮어쓰지 마세요.

2. 첫 실행: 기본 설정을 5단계로 완료하기

먼저 일반 시스템 프록시 모드로 기본 연결을 확인하세요. TUN, 복잡한 분할 라우팅, 사용자 지정 DNS, 자동 실행은 나중에 추가하는 편이 좋습니다. 여러 변수를 한꺼번에 바꾸지 않도록 하세요. 아래에는 흔히 쓰이는 메뉴 이름을 적었습니다. 플랫폼 간 인터페이스에서 메뉴 위치가 다르면 해당 설정 화면에서 항목 이름을 찾아보세요. 버튼 배열이 완전히 같을 필요는 없습니다.

실행 후 로그 확인

메인 프로그램을 열고 로그 영역에서 ‘코어 파일 없음’, ‘권한 부족’ 또는 실행 직후 종료 관련 오류가 없는지 확인하세요. 종속 항목이 누락된 경우 현재 설치 패키지의 안내에 따라 보완하세요. 출처가 불분명한 페이지에서 이름만 같은 실행 파일을 따로 내려받지 마세요.
구독 등록

‘구독 그룹’ → ‘구독 그룹 설정’으로 이동해 그룹을 추가하고 URL 입력란에 구독 주소를 넣은 다음 저장하세요. 이어서 ‘구독 그룹’ 메뉴에서 ‘모든 구독 업데이트(프록시 사용 안 함)’를 실행합니다. 일부 인터페이스에서는 그룹을 마우스 오른쪽 버튼으로 클릭해야 업데이트 메뉴가 표시됩니다.
노드 선택

업데이트 후 목록에 노드가 표시되는지 확인하세요. 사용할 노드를 선택하고 Enter 키를 누르거나, 마우스 오른쪽 버튼 메뉴에서 ‘활성 서버로 설정’을 선택합니다. 표의 행만 선택하고 실제 연결 설정을 전환하지 않은 상태가 아닌지 현재 활성 항목을 확인하세요.
코어 확인

‘설정’ → ‘매개변수 설정’의 ‘Core 유형’ 또는 해당 코어 설정 화면에서 현재 프로토콜에 사용할 코어를 확인하세요. 저장한 뒤 재시작 로그를 살펴봅니다. 버전에 해당 항목이 없다면 노드 편집 화면과 실제 실행 로그에 표시된 코어를 기준으로 판단하세요.
시스템 프록시 설정

Windows에서는 트레이 아이콘의 ‘시스템 프록시’ 메뉴에서 ‘시스템 프록시 자동 설정’을 선택하세요. 크로스 플랫폼 인터페이스에 상태 표시줄 메뉴가 있다면 같은 이름의 항목을 이용할 수 있습니다. macOS에서 프록시 설정 권한을 요청하면 안내를 읽은 뒤 시스템 네트워크 설정에 표시된 실제 프록시 주소와 포트를 확인하세요.

구독을 직접 연결해 업데이트할 수 없을 때는 사용 가능한 활성 노드가 이미 있는 경우에만 ‘모든 구독 업데이트(프록시 사용)’를 시도하세요. 목록이 비어 있거나 코어가 실행되지 않는 상태에서 이 옵션으로 바꿔도 첫 가져오기 문제는 대개 해결되지 않습니다. 단일 노드 공유 링크는 ‘서버’ → ‘클립보드에서 공유 링크 가져오기’를 사용하세요. 정기적으로 갱신하는 구독 주소로 입력하면 안 됩니다.

3. 코어 선택: 이름으로 성능을 추측하지 말고 노드 설정을 확인하세요

Project V는 관련 프록시 기술 생태계의 기반이며 V2Fly와 Xray는 서로 다른 코어 프로젝트입니다. v2rayN에서 특정 코어를 사용할 수 있는지는 해당 버전, 설치 패키지 및 설정 화면의 지원 여부에 따라 달라집니다. 인터페이스에 VMess나 VLESS가 표시된다는 이유만으로 어느 코어에서든 노드의 모든 확장 매개변수를 처리할 수 있다고 판단하지 마세요.

Xray 코어

권장

노드에 VLESS, REALITY 또는 Vision 매개변수가 포함되어 있다면 Xray의 지원 조건과 버전 요구 사항부터 확인하세요. 구독에서 제공한 전송 방식, 보안 계층, 서버 이름 및 Flow 등의 항목은 그대로 유지하세요. VMess 노드를 VLESS로 바꾸지 마세요.

적합한 경우: 서버에서 Xray를 명시적으로 요구하거나 관련 확장 매개변수를 사용하는 노드

V2Fly 코어

현재 v2rayN 버전에서 해당 코어를 선택할 수 있고 서버 설정과 호환된다는 점이 확인되면 요구 사항에 따라 사용할 수 있습니다. VMess를 가져온 경우에도 전송 방식, 보안 계층 및 코어 버전을 확인해야 합니다. 코어 변경이 모든 문제를 해결하는 방법은 아닙니다.

적합한 경우: V2Fly 설정이 명시적으로 요구되며 기존 설정 동작을 유지해야 하는 환경

코어가 실제로 적용되었는지는 드롭다운 항목이 아니라 설정 저장 후 생성된 실행 기록과 오류 메시지로 확인하세요. 알 수 없는 필드, 설정 분석 실패 또는 지원되지 않는 보안 설정이 표시되면 코어 버전과 노드 매개변수가 서로 맞는지 먼저 확인하세요. 연결 시간 초과라면 네트워크 연결 상태, 서버 주소 및 포트를 확인해야 합니다. 두 오류는 서로 다른 단계에서 발생합니다.

한 번에 하나씩 변경하세요: 먼저 현재 설정을 기록하고 코어나 노드 매개변수를 조정해야 변경 사항을 되짚을 수 있습니다.
구독에 포함된 항목을 우선하세요: 자동으로 가져온 뒤 SNI, 전송 경로 또는 공개 키를 임의로 수정하지 마세요.
인터페이스와 코어는 별개입니다: 인터페이스를 업데이트해도 모든 코어 파일이 갱신되는 것은 아닙니다. 설치 패키지 안내와 실행 기록을 기준으로 확인하세요.

4. 로컬 포트: 프록시 진입점과 원격 서버를 구분하세요

브라우저는 컴퓨터의 로컬 프록시 진입점에 연결하고, 코어는 다시 원격 서버에 연결합니다. 노드의 원격 포트(예: 443)를 시스템 프록시의 로컬 포트 입력란에 넣으면 안 됩니다. 아래는 문제를 진단하기 위한 예시입니다. 실제 값은 ‘설정’ → ‘매개변수 설정’의 로컬 리스닝 설정에서 확인하세요.

127.0.0.1

로컬 루프백 주소 예시

10808

SOCKS 또는 혼합 프록시 진입점 예시

10809

별도 HTTP 프록시 진입점 예시

일부 버전은 SOCKS와 HTTP 포트를 별도로 제공하고, 일부는 혼합 진입점을 사용합니다. 해당 포트가 HTTP 프록시를 지원하는지 확인한 경우에만 시스템 HTTP/HTTPS 프록시에 지정하세요. 예시를 그대로 복사해 해당 포트가 이미 열려 있다고 가정하지 마세요. 다른 기기에서 접속할 수 있도록 리스닝 범위를 모든 네트워크 인터페이스로 바로 넓히는 것도 피하세요.

클라이언트 리스닝 예시

리스닝 주소: 127.0.0.1
SOCKS 진입점: 10808, 활성화 여부 확인 필요
HTTP 진입점: 10809, 활성화 여부 확인 필요
LAN 접속: 첫 점검 중에는 비활성화

설정 예시이며 고정 기본값이 아닙니다. 혼합 진입점은 현재 버전의 실제 설정을 따르세요.

시스템 프록시 확인

서버 주소: 127.0.0.1
HTTP 포트: 클라이언트의 HTTP 또는 혼합 진입점과 동일
HTTPS 요청: CONNECT를 지원하는 로컬 HTTP 프록시 사용
종료 후 처리: 클라이언트를 끄기 전에 해당 프록시 설정 해제

HTTPS 프록시 입력란도 보통 로컬 HTTP 프록시 진입점을 가리킵니다. 루프백 주소에 인증서를 설치할 필요는 없습니다.

Windows에서는 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 시스템 프록시를 확인할 수 있습니다. macOS에서는 ‘시스템 설정’ → ‘네트워크’ → 현재 네트워크 서비스 → ‘세부사항’ → ‘프록시’를 확인하세요. 클라이언트가 PAC를 사용한다면 자동 프록시 구성 항목을 살펴보고, 수동 HTTP 프록시를 사용한다면 서버와 포트를 확인하세요. 한쪽 설정만 확인해서는 안 됩니다.

5. 연결 확인: 진입점부터 브라우저까지 테스트

시스템 프록시는 시스템 프록시 설정을 따르는 프로그램에만 영향을 줍니다. 컴퓨터의 모든 트래픽을 제어하는 기능은 아닙니다. 라우팅 규칙은 요청이 코어에 들어온 뒤 직접 연결할지 프록시를 사용할지 결정합니다. ‘시스템 프록시 켜기’와 ‘모든 요청을 원격 노드로 보내기’는 서로 다른 동작입니다. 처음 테스트할 때는 프록시 규칙이 적용될 대상 하나를 정하고 로그도 함께 확인하세요.

활성 노드, 코어 실행 시각 및 로컬 리스닝 포트를 확인해 프로세스가 시작되지 않은 상황부터 배제하세요.
명령에서 프록시를 명시적으로 지정해 로컬 진입점부터 원격 대상까지의 연결을 확인하세요.
그다음 브라우저에서 같은 대상에 접속하세요. 명령은 성공하지만 브라우저에서 실패한다면 시스템 프록시와 브라우저 자체 설정을 집중적으로 확인하세요.
기본 연결이 안정된 후 라우팅, DNS 및 다른 트래픽 처리 방식을 하나씩 조정하고, 변경할 때마다 다시 테스트하세요.

다음 명령은 127.0.0.1:10808이 SOCKS 진입점임을 확인한 상태를 전제로 합니다. socks5h는 대상 도메인 처리를 프록시 측에 맡기므로 앱이 직접 도메인을 조회하는 경우와 비교하기 좋습니다. 이 명령만으로 컴퓨터에서 다른 DNS 요청이 전혀 발생하지 않는다는 점까지 확인할 수는 없습니다.

Windows PowerShell

Get-NetTCPConnection -LocalPort 10808 -State Listen
curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com

macOS 터미널

lsof -nP -iTCP:10808 -sTCP:LISTEN
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com

여기서 10초 연결 시간 초과와 20초 전체 제한 시간은 진단을 위한 값이지 실측 지연 시간이 아닙니다. 리스닝 확인 결과가 없으면 로컬 진입점부터 복구하세요. 연결 거부가 표시되면 포트, 프로세스 및 진입점 유형을 확인하세요. HTTP 응답을 받았다면 해당 요청이 대상에 도달해 응답을 받은 것입니다. 다만 직접 연결과 프록시 중 어느 경로를 거쳤는지는 라우팅 로그와 함께 판단해야 합니다. 인증서 오류가 나면 시스템 시간과 신뢰 체인도 확인해야 하며, 인증서 검증을 바로 끄면 안 됩니다.

6. 자주 하는 실수: 보안 경고, 포트 충돌, 종료 후 인터넷 연결 끊김

Windows 보안 프로그램이 차단했습니다. 바로 허용해도 될까요?

파일 이름만 보고 오탐지라고 판단하지 마세요. ‘Windows 보안’ → ‘바이러스 및 위협 방지’ → ‘보호 기록’을 열어 탐지 이름과 차단된 경로를 기록하고, 다운로드 출처와 패키지 파일, 배포 안내를 확인하세요. 확인이 끝날 때까지 전체 보호 기능을 끄거나 다운로드 폴더 전체를 제외 항목에 추가하지 마세요. 판단하기 어렵다면 우선 실행을 중단하세요.

macOS에서 개발자를 확인할 수 없다는 알림이 표시되면 어떻게 하나요?

먼저 앱의 출처와 시스템 버전 요구 사항을 확인하세요. 시스템에서 사용자가 실행을 허용할 수 있는 개발자 확인 알림이라면 실행을 시도한 뒤 ‘시스템 설정’ → ‘개인정보 보호 및 보안’으로 이동해 ‘그래도 열기’ 옵션이 있는지 살펴보세요. 악성 소프트웨어 위험이 포함된 알림이라면 작업을 중단하고 추가로 확인하세요. 모든 보안 경고를 일반적인 첫 실행 안내로 여겨서는 안 됩니다.

로그에 address already in use가 표시되나요?

리스닝 주소 또는 포트 충돌입니다. Windows에서는 netstat -ano | findstr :10808, macOS에서는 lsof -nP -iTCP:10808 -sTCP:LISTEN을 실행한 뒤 프로세스 정보로 포트를 점유한 항목을 확인하세요. 먼저 중복 실행된 클라이언트를 종료하세요. 포트를 바꿔야 한다면 저장 후 코어를 재시작하고 시스템 프록시 및 앱의 수동 프록시 설정도 함께 업데이트하세요.

프로그램을 종료했더니 브라우저에서 인터넷이 안 되는 이유는 무엇인가요?

시스템 프록시가 종료된 루프백 프록시를 계속 가리키고 있을 수 있습니다. v2rayN을 다시 열고 ‘시스템 프록시’ → ‘시스템 프록시 설정 지우기’를 실행하세요. 실행할 수 없다면 시스템 프록시 화면에서 해당 수동 프록시나 PAC를 비활성화하세요. 회사에서 관리하는 기기라면 기존 설정을 먼저 기록하고 조직에서 배포한 프록시 설정은 삭제하지 마세요.

노드 지연 시간이 표시되는데 웹페이지가 열리지 않나요?

지연 시간 테스트는 해당 테스트 방식이 확인하는 일부 연결만 보여 주며, 앱에서 실제로 접속되는지를 대신 확인하지는 못합니다. 앞서 안내한 프록시 명시 명령으로 다시 테스트한 다음 활성 노드, 라우팅 규칙 적용 여부, DNS 오류 및 브라우저 프록시 설정을 확인하세요. 여러 노드가 같은 단계에서 실패한다면 클라이언트를 계속 재설치하기보다 공통 로컬 설정부터 살펴보세요.

7. 기본 설정 기록: 업데이트와 이전에 대비하기

처음 연결에 성공하면 정상 작동하는 최소 설정을 기록하세요. 클라이언트 및 코어 버전, 운영체제 버전, 활성 노드가 속한 그룹, 리스닝 포트, 시스템 프록시 방식과 라우팅 모드를 남겨 두면 나중에 업데이트 후 문제가 생겼을 때 ‘어제는 됐는데’라는 기억보다 원인을 찾기 쉽습니다. 플랫폼 간 설정은 직접 가져온 뒤 다시 확인해야 합니다. 프로그램 폴더, 권한 또는 시스템 프록시 설정이 자동으로 동기화된다고 가정하지 마세요.

업데이트 전: 현재 클라이언트에서 제공하는 백업 또는 내보내기 기능으로 설정을 저장하고, 구독 정보와 백업 파일은 안전하게 관리하세요.
업데이트 후: 기존 노드와 프록시 명시 명령을 먼저 다시 테스트한 뒤 새 기능을 사용하세요. 문제가 생기면 최초 오류 로그를 보관하세요.
문의할 때: 시스템 아키텍처, 코어 시작 오류 및 재현 절차를 제공하고 구독 주소, 사용자 식별 정보 및 노드 접속 정보는 가리세요.
이전 후: 다른 기기의 경로를 그대로 복사하지 말고 로컬 포트, 코어 파일 위치, 시스템 프록시 및 방화벽 알림을 다시 확인하세요.

설치가 완료되었다고 판단하려면 ‘창이 열린다’만으로는 부족합니다. 코어가 안정적으로 시작되고 로컬 진입점이 리스닝 중이며, 프록시를 명시한 요청이 작동하고, 브라우저가 예상한 대로 프록시를 사용하며, 종료 후 시스템 네트워크가 정상으로 복구되는지 확인하세요. 오류 증상에 따라 더 자세히 확인하려면 문제 해결에서 시작, 리스닝, 연결, 이름 확인 및 라우팅 단계를 차례로 살펴보세요.