1. v2rayN이란 무엇이며, 코어와 프로토콜은 어떻게 선택할까

v2rayN은 오픈소스이자 무료인 Windows / macOS / Linux용 데스크톱 프록시 클라이언트입니다. 그 자체는 프록시 프로토콜을 구현하지 않으며, Xray-core나 sing-box 같은 하위 "코어" 프로그램을 호출해 실제 암호화 통신을 처리합니다. 클라이언트는 노드 관리, 구독 동기화, 라우팅, GUI를 담당하며 현재 데스크톱에서 가장 널리 사용되는 V2Ray 계열 클라이언트 중 하나입니다.

Xray-core

V2Ray에서 파생된 강화판 구현으로, VMess, VLESS, Trojan, Reality 등의 프로토콜 지원이 가장 성숙하고 안정적입니다. v2rayN의 기본 코어이며, 특별한 이유가 없다면 기본값을 유지하는 것을 권장합니다.

sing-box

업데이트 속도가 빠르고 새로운 프로토콜과 새로운 규칙 세트 지원이 더 빠른 경향이 있습니다. 특정 프로토콜이 Xray 코어에서 연결 이상이 발생한다면 sing-box 코어로 전환해 시도해 보세요.

클라이언트가 지원하는 주요 프록시 프로토콜과 그 특징:

VMess / VLESS

V2Ray 계열의 네이티브 프로토콜로, TLS나 Reality 암호화와 함께 사용되며 간섭에 대한 저항력이 강해 현재 가장 널리 사용되는 프로토콜 중 하나입니다.

Trojan

트래픽 특징이 일반 HTTPS 요청을 모방하므로 위장성이 뛰어나고 설정도 간단합니다. 보통 TLS 인증서와 함께 사용됩니다.

Shadowsocks

역사가 길고 구현이 간단하며 리소스 소모가 적어 많은 오래된 노드 제공자들이 지금도 채택하고 있는 프로토콜 중 하나입니다.

2. 다운로드와 설치

설치 전에 먼저 사용 중인 OS 버전과 하드웨어 아키텍처를 확인하세요. 버전을 잘못 선택하는 것은 초보자가 가장 흔히 겪는 설치 문제입니다:

Windows

아키텍처(x64 / x86 / ARM64)에 맞는 압축 파일을 다운로드해 특수 문자나 공백이 없는 디렉터리에 압축을 풀고 v2rayN.exe를 더블클릭하면 바로 실행할 수 있습니다. 설치 프로그램은 필요 없으며 처음 실행 시 같은 폴더 내에 설정 파일이 생성됩니다.

macOS

사용 중인 칩(Intel / Apple Silicon)에 맞는 dmg를 다운로드해 "응용 프로그램" 폴더로 드래그하세요. 처음 실행 시 "손상되어 열 수 없습니다"라는 메시지가 뜨는 것은 설치 파일이 Apple 서명을 받지 않았기 때문입니다. 터미널에서 xattr -cr /Applications/v2rayN.app을 실행해 격리 속성을 제거하면 정상적으로 열립니다.

Linux

아키텍처에 맞는 압축 파일을 다운로드해 압축을 푼 후, 메인 프로그램에 실행 권한을 부여하세요(chmod +x v2rayN). 일부 배포판에서는 GUI를 정상적으로 표시하기 위해 추가 GTK 관련 라이브러리 설치가 필요할 수 있습니다.

자주 발생하는 설치 문제

더블클릭해도 반응이 없거나 충돌이 발생한다면, 대부분 아키텍처 선택 오류(64비트 시스템에서 잘못 x86 버전을 다운로드하는 등)나 디렉터리 경로에 특수 문자가 포함되어 있는 것이 원인입니다. 해당하는 버전을 다시 다운로드해 영숫자만 있는 디렉터리로 옮긴 후 다시 시도하세요.

전체 버전 목록(각 아키텍처별 설치 파일과 직접 다운로드 링크 포함)은 다운로드 센터에서 확인할 수 있습니다.

3. 메인 화면 상세 설명

처음 메인 창을 열면 주요 기능 영역은 다음 몇 가지로 나뉩니다. 이 진입점들에 익숙해지면 이후 설정이 순조롭게 진행됩니다:

서버 목록

가져온 모든 노드를 표시하며, 구독별 그룹 표시와 지연 시간이나 이름 순 정렬을 지원합니다. 노드를 더블클릭하면 연결을 전환할 수 있고, 우클릭하면 속도 테스트, 편집, 삭제, 그룹 이동을 할 수 있습니다.

상단 메뉴바

"서버"에서 노드와 구독을 관리하고, "HTTP/Socks"에서 로컬 프록시 포트를 확인하며, "라우팅"에서 분류 규칙을 설정하고, "파라미터 설정"에서 코어, 언어, 시작 항목 등 전역 설정을 조정합니다.

시스템 프록시 전환

"시스템 프록시 변경 안 함", "시스템 프록시 자동 설정(PAC)", "전역 모드", "TUN 모드" 사이를 빠르게 전환할 수 있으며, 트레이 아이콘이 현재 상태를 동기화해 표시합니다.

로그 창

코어의 실행 로그와 요청 기록을 실시간으로 표시합니다. 연결 이상이 발생했을 때 로그 내 오류 정보(타임아웃, 인증서 오류, DNS 실패 등)로 문제의 방향을 빠르게 파악할 수 있습니다.

상태 표시줄

창 하단에 실시간 업로드/다운로드 속도와 사용된 트래픽 통계가 표시되어 현재 노드의 연결 상태를 언제든지 확인할 수 있습니다.

전역 단축키

파라미터 설정에서 "창 표시/숨기기", "시스템 프록시 전환", "다음 노드로 전환" 등의 작업에 전역 단축키를 지정할 수 있어 창에 포커스를 맞추지 않고도 조작할 수 있습니다.

4. 구독 가져오기

구독은 노드를 얻고 유지하는 주요 방법입니다. 구독 URL이 반환하는 내용은 보통 Base64로 인코딩된 일련의 공유 링크이며, 클라이언트는 주기적으로 해당 URL을 요청해 자동으로 디코딩한 후 해당 그룹 내의 노드 목록을 전체 교체합니다. 중복으로 쌓이지 않으며 오래된 노드를 수동으로 삭제할 필요도 없습니다.

  1. 구독 설정 열기

    상단 메뉴의 "서버" → "구독 설정"을 클릭해 구독 그룹 관리 창을 엽니다. 여기에는 추가된 모든 구독과 그 상태가 목록으로 표시됩니다.

  2. 구독 URL 추가

    "추가"를 클릭해 새 행을 만들고 완전한 구독 URL을 붙여넣은 후 저장하세요. 여러 소스를 구분하기 위해 커스텀 이름을 지정할 수도 있습니다. 일부 구독은 정상적으로 가져오기 위해 특정 HTTP 헤더가 필요할 수 있으니 "User-Agent"나 커스텀 헤더 필드에 제공자의 안내에 따라 입력하세요.

  3. 구독 업데이트

    메인 창으로 돌아가 "서버" → "구독 업데이트"를 클릭하면 프로그램이 자동으로 최신 노드 목록을 가져와 반영합니다. 각 구독은 서버 목록 내에서 독립된 그룹으로 표시되며 서로 간섭하지 않습니다. 서로 다른 소스의 여러 구독을 동시에 추가할 수도 있습니다.

일상적인 유지 관리 비용을 줄이기 위해 구독 설정에서 다음 자동화 옵션을 추가로 활성화하는 것을 권장합니다:

정기 자동 업데이트

고정된 업데이트 간격(예: 24시간마다)을 설정하면 프로그램이 백그라운드에서 자동으로 최신 노드를 가져옵니다. 다만 빈도를 너무 높게 설정하면 제공자의 속도 제한 정책에 걸릴 수 있으니 주의하세요.

업데이트 후 자동 속도 테스트/정렬/무효 노드 제외

업데이트가 완료될 때마다 새 노드의 지연 시간 테스트를 자동으로 실행하고 지연 시간 순으로 정렬하며, 테스트에 실패한 무효 노드를 자동으로 제외합니다. 이를 통해 목록을 항상 정돈되고 사용하기 쉬운 상태로 유지할 수 있습니다.

5. 노드 수동 추가

구독 URL이 아니라 단일 또는 소수의 노드 공유 링크나 QR코드만 가지고 있다면 구독을 거치지 않고 직접 추가할 수 있습니다:

공유 링크 붙여넣기

vmess://, vless://, trojan://, ss://로 시작하는 공유 링크를 복사하고 서버 목록을 우클릭해 "클립보드에서 가져오기"를 선택하세요. 여러 링크를 한 번에 붙여넣어 일괄 가져올 수도 있습니다.

QR코드 스캔

"스크린샷에서 가져오기"를 선택하고 노드의 QR코드가 포함된 화면 영역을 선택하면 자동으로 인식되어 추가됩니다. 제공자가 QR코드 이미지만 제공하는 경우에 편리합니다.

파라미터 수동 입력

우클릭해 "커스텀 서버 추가"를 선택하고 주소, 포트, 프로토콜 유형, 암호화 방식, 전송 방식 등의 파라미터를 하나씩 입력하세요. 모든 설정을 정확하게 제어하고 싶은 고급 사용자용 시나리오에 적합합니다.

텍스트 파일에서 일괄 가져오기

여러 공유 링크를 한 줄씩 텍스트 파일에 저장한 후 "파일에서 가져오기"로 일괄 추가할 수 있습니다. 대량의 기존 노드를 이전할 때 편리합니다.

6. 연결과 속도 테스트

서버 목록을 우클릭해 "모든 지연 시간 테스트"(TCPing, 포트 연결만 테스트하므로 빠름) 또는 "모든 실제 연결 테스트"(실제로 요청을 보내므로 실사용에 더 가깝지만 시간이 걸림)를 선택하세요. 완료되면 지연 시간이 가장 낮은 노드를 더블클릭해 연결을 전환할 수 있습니다.

연결 방식은 시스템 프록시 메뉴에서 필요에 따라 선택할 수 있으며, 세 가지 모드는 각각 적용되는 상황이 다릅니다:

시스템 프록시 자동 설정

가장 일반적인 방식으로 시스템 수준의 프록시 설정을 자동으로 기록합니다. 대부분의 브라우저와 앱이 자동으로 따르며 클라이언트를 종료하면 자동으로 원래대로 돌아갑니다.

PAC 자동 모드

라우팅 규칙과 결합해 각 요청에 프록시가 필요한지 자동으로 판단하므로 수동 분류 설정이 필요 없으며, 속도와 전반적인 접속 경험을 모두 챙길 수 있습니다.

TUN 전역 모드

네트워크 어댑터 계층에서 모든 트래픽을 처리하므로, 명령줄 도구나 게임 클라이언트 등 시스템 프록시 설정을 따르지 않는 상황에 적합합니다. 자세한 내용은 다음 섹션을 참고하세요.

7. 라우팅 규칙과 TUN 모드

라우팅 규칙은 각 네트워크 요청을 "직접 연결", "프록시", "차단" 중 어느 것으로 처리할지 결정하는, 프록시 도구를 더 스마트하고 트래픽을 절약하며 사용할 수 있게 해주는 중요한 기능입니다. 규칙은 목록의 위에서부터 순서대로 매칭되며 가장 먼저 일치하는 순간 즉시 적용되고 이후 규칙과의 매칭은 진행되지 않습니다.

내장 규칙 세트

"라우팅 설정"에는 중국 본토 사이트/IP 대역만 모아놓은 전용 프리셋인 "중국 본토 우회" 규칙 세트(GeoIP:cn 및 GeoSite:cn 데이터베이스 기반)가 내장되어 있어, 중국 본토 사이트에 접속할 일이 있다면 선택해서 해당 사이트만 직접 연결로 유지할 수 있습니다. 중국 본토 사이트를 이용할 필요가 없다면 이 프리셋은 켜지 않아도 되며, 전역 프록시 모드를 쓰거나 원하는 사이트만 직접 연결로 지정하는 커스텀 규칙을 추가하는 편이 더 실용적입니다.

커스텀 규칙 문법

도메인(domain:example.com), 도메인 키워드, IP 대역(geoip:private) 등의 방식으로 커스텀 규칙을 추가할 수 있습니다. 커스텀 규칙은 먼저 가로채이지 않도록 보통 내장 규칙 세트보다 앞에 배치해야 합니다.

광고 및 개인정보 필터링

커뮤니티가 유지보수하는 광고 필터링 규칙 세트를 불러오도록 선택할 수 있으며, 일치하는 도메인으로의 요청을 직접 차단해 광고 로딩을 줄이고 일부 추적 요청도 차단합니다.

TUN 모드의 역할

시스템 프록시는 해당 설정을 따르는 프로그램에만 적용되며, 명령줄 도구나 일부 게임 클라이언트는 프록시를 우회할 수 있습니다. TUN 모드는 네트워크 어댑터 계층에서 모든 트래픽(UDP 포함)을 처리하며, 라우팅 규칙과 결합해 진정한 의미의 전역 분류를 구현합니다.

TUN 모드를 활성화하기 전에 주의할 점이 있습니다: Windows에서는 가상 어댑터를 생성하기 위해 관리자 권한으로 클라이언트를 실행해야 합니다. 처음 활성화 시 시스템이 보안 경고를 표시할 수 있지만 허용을 선택하면 문제없습니다. 활성화 후 일부 소프트웨어가 인터넷에 연결되지 않는다면 클라이언트 재시작이나 시스템 프록시 모드로 일시적으로 전환해 드라이버 충돌 여부를 확인하세요.

8. 일반 파라미터 설정

"파라미터 설정" 창에는 자신의 사용 습관에 맞게 조정하는 것을 추천하는 몇 가지 옵션이 있습니다:

시작 시 자동 실행

활성화하면 시스템 시작 시 클라이언트가 자동으로 실행됩니다. 장시간 연결을 유지하고 싶은 사용자에게 적합하며, "시작 후 마지막 노드에 자동 연결"과 함께 사용하면 시작과 동시에 연결할 수 있습니다.

코어 업데이트 확인

"업데이트 확인"에서 Xray / sing-box의 코어 버전만 개별적으로 업데이트할 수 있어, 클라이언트 전체 업데이트를 기다릴 필요 없이 프로토콜 수준의 수정과 새 기능을 빠르게 받아볼 수 있습니다.

인터페이스 언어

중국어 간체, 중국어 번체, 영어 등 여러 언어의 인터페이스를 지원하며, 파라미터 설정에서 언제든지 전환할 수 있어 재설치가 필요 없습니다.

로컬 프록시 포트

시스템 프록시를 지원하지 않는 다른 도구(일부 명령줄 프로그램 등)가 수동으로 지정해 사용할 수 있도록 로컬 HTTP/SOCKS 프록시 대기 포트를 커스터마이징할 수 있습니다.

자주 묻는 질문

구독과 수동으로 추가한 노드를 동시에 사용할 수 있나요?

네. v2rayN의 서버 목록은 구독 노드와 수동 추가 노드가 공존할 수 있으며 서로 영향을 주지 않습니다. 목록에서 전환하기만 하면 되며, 서로 다른 소스의 노드를 그룹별로 나누어 관리하고 그룹마다 업데이트 파라미터를 개별 설정할 수도 있습니다.

라우팅 규칙과 TUN 모드는 어떤 관계가 있나요?

라우팅 규칙은 어떤 트래픽이 프록시를 거치고 어떤 것이 직접 연결될지를 결정하며, 시스템 프록시 모드와 TUN 모드 모두에 적용됩니다. TUN 모드는 단지 시스템 프록시 설정을 따르지 않는 프로그램이나 UDP 트래픽 등 더 많은 종류의 트래픽을 라우팅 규칙으로 처리할 수 있게 해줄 뿐이며, 두 개념은 대체 관계가 아니라 보완 관계입니다.

TUN 모드로 전환한 후 일부 소프트웨어가 인터넷에 연결되지 않는 이유는 무엇인가요?

일부 보안 소프트웨어, VPN 클라이언트, 가상 네트워크 어댑터 드라이버가 TUN 모드의 가상 어댑터와 충돌할 수 있습니다. 클라이언트 재시작, 가상 어댑터 드라이버(WinTun 등) 업데이트를 시도하거나, 일시적으로 시스템 프록시 모드로 되돌려 충돌 여부를 확인한 후 하나씩 점검해 보세요.

특정 사이트를 프록시를 거치지 않고 직접 연결하려면?

라우팅 설정에서 도메인이나 IP 기반의 직접 연결 규칙을 직접 추가하면 됩니다. 참고로 중국 본토 사이트/IP만 모아놓은 전용 프리셋인 "중국 본토 우회" 규칙 세트(GeoIP:cn 및 GeoSite:cn 기반)도 내장되어 있는데, 이는 중국 본토 사이트에 접속할 일이 있을 때 사용하는 규칙이며 모든 사용자에게 필수는 아닙니다.

Xray 코어와 sing-box 코어 중 어느 것을 선택해야 하나요?

두 코어 모두 일상적인 사용에는 충분합니다. Xray는 VMess / VLESS / Reality 지원이 더 성숙하고 안정적이며, sing-box는 업데이트 빈도가 높고 새로운 프로토콜이나 규칙 세트 지원이 더 빠른 경향이 있습니다. 특별한 이유가 없다면 기본 코어를 사용하고, 특정 프로토콜에서 연결 문제가 발생하면 다른 코어로 전환해 시도해 보세요.

커스텀 라우팅 규칙의 우선순위는 어떻게 되나요?

라우팅 규칙은 목록의 위에서부터 순서대로 매칭되며, 가장 먼저 일치한 규칙이 즉시 적용되고 이후의 매칭은 진행되지 않습니다. 따라서 커스텀 규칙은 보통 내장 규칙 세트보다 앞에 배치해야 합니다. 그렇지 않으면 위쪽에 있는 범용 규칙에 먼저 가로채일 수 있습니다.

전체 FAQ 보기