2026-09-06 · 입문 가이드 · 약 9분

v2rayN 설치 및 첫 설정: Windows·macOS 설치, 코어와 권한 문제

v2rayN 설치부터 첫 실행, 코어 파일 위치, macOS 앱 허용까지 안내합니다. 경로 문제, 포트 충돌, 시스템 프록시가 작동하지 않을 때의 해결 방법도 확인하세요.

이 글 미리보기

이 글은 v2rayN을 처음 사용하는 Windows 및 macOS 사용자를 위한 안내입니다. 설치 파일 선택, 고정 폴더에 설치, 코어 실행 확인, 설정 가져오기, 시스템 프록시 설정 순으로 진행해 일반 프록시 연결부터 확인한 뒤 TUN 모드를 살펴보세요. 실행에 문제가 생기면 로그와 파일 경로, 로컬 수신 포트를 확인해 원인을 좁히세요. 모든 문제를 노드 탓으로 돌릴 필요는 없습니다.

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

v2rayN은 클라이언트 인터페이스이며, 실제 프록시 연결은 코어가 처리합니다. 프로그램 창이 열린다고 해서 코어가 제대로 설치되고 설정까지 완료된 것은 아닙니다. 처음 설치할 때는 배포 파일의 폴더 구조를 그대로 유지하세요. 실행 파일만 바탕 화면으로 복사하거나 서로 다른 배포 파일의 구성 요소를 섞지 마세요.

Windows에서는 ‘설정’ → ‘시스템’ → ‘정보’에서 시스템 종류를 확인하고, macOS에서는 Apple 메뉴 → ‘이 Mac에 관하여’에서 칩 또는 프로세서를 확인하세요. Apple 칩은 ARM64, Intel 프로세서는 x64에 해당합니다. Windows ARM 기기에서 x64 패키지를 기본 ARM64 패키지처럼 취급하지 마세요. 실행 가능 여부는 시스템의 호환성에 따라 달라집니다.

Windows 데스크톱 버전

추천

처음 설치한다면 다운로드 페이지에서 Windows 데스크톱 버전을 선택하세요. 안내에 따라 설치 프로그램과 압축 파일을 구분하면 됩니다. 설치 프로그램은 안내에 따라 설치하고, 압축 파일은 전체 압축을 푼 뒤 실행하세요.

추천 대상: 크로스 플랫폼 데스크톱 인터페이스를 사용하려는 Windows 신규 사용자

Windows WPF 버전

기존 Windows 인터페이스를 유지하는 버전입니다. 해당 인터페이스에 익숙하다면 선택할 수 있습니다. 데스크톱 버전의 설정 파일을 WPF 버전 폴더에 그대로 덮어쓰지 말고, 이전하기 전에 백업하세요.

추천 대상: 기존 Windows 메뉴와 창 배치에 익숙한 사용자

macOS 데스크톱 버전

프로세서에 맞춰 ARM64 또는 x64를 선택하세요. DMG 파일을 연 다음 앱을 ‘응용 프로그램’으로 드래그하고, 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하지 마세요.

추천 대상: Apple 칩 또는 Intel 프로세서가 탑재된 Mac 사용자

2. Windows 압축 해제와 첫 실행: 고정 폴더에 파일 전체 보관

다음 단계는 압축 파일 배포판에 해당합니다. 설치 프로그램을 받았다면 먼저 설치를 완료하세요. 설치 프로그램을 압축 파일처럼 다루면 안 됩니다. 일반 시스템 프록시를 사용하는 데 TUN을 먼저 켤 필요는 없습니다. 모든 실행 문제에 ‘항상 관리자 권한으로 실행’을 해결책으로 적용하지 마세요.

  1. 압축 파일 전체 해제

    압축 파일을 마우스 오른쪽 버튼으로 클릭하고 ‘모두 압축 풀기’를 선택한 다음, D:\Tools\v2rayN처럼 현재 계정에 쓰기 권한이 있는 고정 폴더에 압축을 푸세요. 압축 프로그램의 미리보기 창에서 실행 파일을 바로 열지 마세요. 임시 폴더에 풀면 설정 파일과 코어가 서로 다른 위치에 놓일 수 있습니다.

  2. 실행 파일 실행

    압축을 푼 폴더를 열고 v2rayN.exe를 실행하세요. 같은 폴더의 종속 파일과 하위 폴더를 그대로 두세요. 바탕 화면에서 실행하려면 실행 파일을 옮기는 대신 바로 가기를 만드세요.

  3. 런타임 확인

    .NET Desktop Runtime 설치 안내가 표시되면 필요한 런타임 버전과 아키텍처를 확인한 뒤 진행하세요. 배포 파일에 런타임이 포함되어 있는지는 패키지마다 다릅니다. .NET이라는 문구만 보고 다른 아키텍처용 런타임을 임의로 설치하지 마세요.

  4. 구독 가져오기

    메인 화면에서 ‘구독 그룹’ → ‘구독 그룹 설정’을 열고 그룹을 추가한 뒤 주소를 입력하세요. 저장 후 ‘구독 그룹’ 메뉴에서 업데이트를 실행합니다. 버전에 따라 ‘추가’ 또는 ‘+’ 버튼이 표시될 수 있습니다. 단일 서버 편집란이 아니라 구독 그룹의 주소 입력란을 사용하세요.

  5. 서버 선택

    업데이트 후 서버 목록에서 항목을 선택하고 마우스 오른쪽 버튼 메뉴에서 ‘활성 서버로 설정’을 선택하세요. 그런 다음 메인 화면의 로그 영역에서 ‘프로세스 시작 실패’, ‘파일을 찾을 수 없음’, 포트 바인딩 오류가 없는지 확인한 뒤 시스템 프록시를 설정하세요.

3. macOS 앱 실행 허용: 앱 차단과 코어 실행 오류 구분

앱을 처음 열 때 표시되는 시스템 경고와 프록시 코어 실행 실패는 서로 다른 문제입니다. 전자는 앱을 여는 단계에서 발생하고, 후자는 보통 앱 로그에서 관련 파일을 확인해야 합니다. 앱 창은 열렸지만 연결 버튼이 작동하지 않는다면 로그를 확인하세요. 앱 전체를 ‘응용 프로그램’ 폴더에서 반복해서 꺼냈다 다시 넣을 필요는 없습니다.

  1. 먼저 앱 복사: 앱을 ‘응용 프로그램’ 폴더에 넣고 다운로드한 디스크 이미지를 추출한 다음, Finder에서 앱을 여세요. 압축 파일 배포판을 사용하는 경우 먼저 안정적인 위치에 압축을 푸세요. 다운로드 미리보기에서 실행하지 마세요.
  2. 첫 실행 차단 해제: 다운로드 출처를 확인한 뒤 Finder에서 Control 키를 누른 채 앱을 클릭하고 ‘열기’를 선택하세요. 그래도 차단되면 ‘시스템 설정’ → ‘개인정보 보호 및 보안’에서 관련 알림을 확인하세요. 이번에 실행하려는 앱이 맞는지 확인한 경우에만 ‘그래도 열기’를 선택하세요. 버튼 표시 방식은 시스템 버전에 따라 다를 수 있습니다.
  3. 코어 오류 확인: 로그의 permission denied는 실행 권한 또는 접근 권한 문제를, bad CPU type in executable은 아키텍처 불일치를 가리킵니다. 두 오류에 같은 해결 방법을 적용하면 안 됩니다.
  4. 필요한 권한만 허용: 시스템 프록시를 변경할 때 권한 요청이 표시되면 앱 이름을 확인한 뒤 진행하세요. 일반 프록시를 처음 테스트할 때 문제 해결을 위해 전체 디스크 접근 권한을 부여할 필요는 없습니다.

디렉터리 전체의 보안 속성을 재귀적으로 삭제하는 터미널 명령을 그대로 따라 하지 마세요. ‘앱이 손상되었습니다’라는 알림을 무조건 시스템 제한을 우회해야 한다는 뜻으로 해석해서도 안 됩니다. 먼저 해당 아키텍처에 맞는 배포 파일을 다시 받고 시스템 알림을 확인하세요. 조직에서 관리하는 기기는 정책이 적용될 수 있으므로 관리자에게 확인해야 합니다.

4. 코어 파일 위치 확인: 로그에 표시된 실행 경로 기준

v2rayN은 서버와 설정을 관리하고, Xray와 V2Fly 같은 코어는 해당 설정을 실행합니다. 프로토콜 이름과 코어 이름은 서로 다른 개념입니다. VLESS와 REALITY를 함께 사용하려면 해당 조합을 지원하는 코어가 필요합니다. 두 코어가 일부 프록시 프로토콜을 처리할 수 있다는 이유만으로 서로 바꿔 써도 된다고 볼 수는 없습니다.

Windows 확인 항목

프로그램
v2rayN.exe
코어 예시
Xray 실행 파일은 보통 xray.exe라는 이름을 사용합니다.
일반적인 폴더
배포 파일의 bin 하위 폴더 및 코어 하위 폴더
경로 확인 기준
로그에 실제로 표시된 실행 파일 경로

폴더 구조는 배포 파일마다 다릅니다. 오래된 안내를 보고 같은 이름의 폴더를 임의로 만들지 마세요.

macOS 확인 항목

앱 위치
/Applications 안의 앱 패키지
코어 예시
Xray 실행 파일에는 보통 .exe 확장자가 없습니다.
아키텍처 확인
선택한 배포 파일에 맞는 ARM64 또는 x64
오류 확인 기준
로그에 표시된 실행 경로, 권한 오류, 아키텍처 오류

앱 패키지 안의 리소스와 사용자 데이터 폴더가 분리되어 있을 수 있습니다. 현재 사용하는 배포 파일과 시작 로그를 기준으로 확인하세요.

코어 선택을 확인하려면 ‘설정’ → ‘매개변수 설정’을 열고 현재 인터페이스에서 제공하는 코어 관련 옵션을 확인하세요. 일부 인터페이스에서는 ‘Core 유형’으로 표시되거나 프로토콜별로 설정할 수 있습니다. 오류가 없는데 코어를 반복해서 바꾸지 마세요. 로그에 코어를 찾을 수 없다고 명확히 표시된다면 해당 배포 파일을 다시 완전히 설치하거나 클라이언트의 코어 업데이트 기능을 사용하세요. 임의로 받은 실행 파일의 이름을 바꿔 넣지 마세요.

5. 시스템 프록시와 포트: 로컬 연결부터 확인

코어가 정상적으로 시작되면 메인 화면의 ‘시스템 프록시’ 메뉴에서 ‘시스템 프록시 자동 설정’을 선택하세요. 시스템 프록시는 시스템 설정을 따르는 앱의 요청을 로컬 프록시로 보내고, 라우팅 규칙은 요청이 코어에 들어온 뒤 프록시를 거칠지 직접 연결할지를 정합니다. 라우팅을 ‘전역’으로 설정해도 모든 앱의 트래픽이 자동으로 전달되지는 않으며, 시스템 프록시 설정을 대신하지도 않습니다.

‘설정’ → ‘매개변수 설정’에서 로컬 수신 포트를 확인하세요. 해당 항목은 기본 설정 페이지에 있을 수 있습니다. 아래에서는 문제 확인 예시로 127.0.0.1:10808을 사용하지만, 모든 설치 환경의 기본값이라는 뜻은 아닙니다. 실행하기 전에 화면에 표시된 실제 포트로 바꾸고 HTTP 또는 혼합 프록시 연결을 제공하는지 확인하세요.

포트를 사용 중인 프로세스 확인

Windows에서는 PowerShell에서 첫 번째 명령을, macOS에서는 터미널에서 두 번째 명령을 실행하세요. 수신 대기 기록이 보여도 포트를 어떤 프로세스가 사용 중인지 알 수 있을 뿐입니다. 해당 프로세스가 이번에 실행한 코어인지 추가로 확인해야 합니다.

# Windows PowerShell
Get-NetTCPConnection -State Listen -LocalPort 10808 |
  Select-Object LocalAddress, LocalPort, OwningProcess

# macOS 터미널
lsof -nP -iTCP:10808 -sTCP:LISTEN

프록시를 지정해 연결 테스트

아래 요청은 HTTP 프록시 연결이 가능한지 확인하는 데 사용합니다. Windows에서는 curl.exe, macOS에서는 curl을 사용하세요. 대상 주소는 연결 테스트 예시일 뿐입니다. 라우팅에서 해당 주소를 직접 연결로 설정한 경우, 응답에 성공해도 원격 프록시 노드가 작동한다는 뜻은 아닙니다.

# Windows
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/

# macOS
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/

6. 첫 설치 관련 자주 묻는 질문과 종료 후 복구

두 번 클릭해도 창이 뜨지 않아요. 설치에 실패한 건가요?

먼저 작업 표시줄 알림 영역이나 macOS 메뉴 막대에서 프로그램이 이미 실행 중인지 확인하세요. Windows에서는 작업 관리자에서 중복 프로세스가 있는지도 확인하세요. 런타임 설치 안내가 나오면 안내에 따라 처리하세요. 프로그램을 연속해서 여러 번 실행하지 마세요. 뒤에 실행된 코어가 포트 충돌을 일으킬 수 있습니다.

구독 업데이트에 실패하면 먼저 재설치해야 하나요?

먼저 재설치할 필요는 없습니다. 단일 vmess:// 또는 vless:// 공유 링크가 아니라 전체 구독 주소를 입력했는지 확인하세요. 단일 링크는 클립보드 가져오기 기능으로 추가해야 합니다. 다음으로 시스템 날짜와 시간을 확인하고 로그를 통해 시간 초과, 인증서 오류, 서버 거부를 구분하세요. 문제 해결 화면을 공유할 때는 구독 주소와 인증 정보를 가리세요.

속도 테스트는 되는데 웹페이지가 열리지 않아요.

속도 테스트 결과만으로 브라우저가 시스템 프록시를 사용한다고 볼 수는 없습니다. 코어 로그, 로컬 수신 대기 상태, 시스템 프록시 주소, 브라우저 확장 프로그램 순으로 확인하세요. 프록시를 지정한 요청은 성공하지만 브라우저만 실패한다면 앱 연결 설정부터 확인하세요. 둘 다 실패하면 노드, 라우팅, DNS 오류를 확인하세요.

v2rayN을 종료한 뒤 일반 웹페이지도 열리지 않아요.

먼저 클라이언트를 다시 열고 ‘시스템 프록시’에서 ‘시스템 프록시 해제’를 선택한 뒤 정상적으로 종료하세요. Windows에서는 ‘설정’ → ‘네트워크 및 인터넷’ → ‘프록시’에서 수동 프록시 설정을 확인할 수 있습니다. macOS에서는 ‘시스템 설정’ → ‘네트워크’ → 현재 네트워크 → ‘세부사항’ → ‘프록시’에서 남아 있는 설정을 확인하세요. 변경 전에 원래 설정을 기록하고, 조직에서 설정한 프록시는 함부로 삭제하지 마세요.

첫 설정을 마친 뒤에는 프로그램 설치 폴더, 현재 사용 중인 코어, 로컬 수신 주소와 포트 세 가지만 기록해 두면 됩니다. 다음에 문제가 생기면 이 정보와 로그부터 확인하고, 설정은 한 번에 하나씩 변경하세요. 업그레이드 전에 클라이언트에서 제공하는 설정 데이터를 백업하세요. 구독 인증 정보가 들어 있는 전체 설정 파일을 공개 게시판에 올리지 마세요.

v2rayN 다운로드운영체제와 설치 형식 선택