Android 클라이언트 및 데스크톱 설정 가이드

V2Ray 안드로이드판v2rayNG 다운로드 및 구독 설정

구독 가져오기부터 라우팅까지 메뉴에 따라 v2rayNG를 설정하고, 데스크톱에서는 v2rayN도 함께 살펴보세요.

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • Xray / v2fly
  • 구독 그룹 설정
    메모
    선택 주소 (url)
    업데이트 사용
    구독 업데이트

    v2rayNG / subscription

    구독 그룹

    그룹별로 주소를 저장한 다음 구독을 업데이트하세요.

  • 라우팅 설정
    도메인 전략
    AsIsIPIfNonMatchIPOnDemand
    사전 정의 규칙
    로컬 네트워크 주소 우회

    v2rayNG / routing

    라우팅 도메인 전략

    도메인 일치와 DNS 조회 후 IP 주소 일치를 구분합니다.

  • 앱별 프록시
    앱별 프록시 사용
    우회 모드

    v2rayNG / per-app

    앱별 프록시

    앱별로 트래픽 처리 범위를 정하고 우회 방향을 확인하세요.

  • VPN 설정
    로컬 DNS 사용
    모드
    VPN
    프록시만

    v2rayNG / vpn-dns

    로컬 DNS 및 VPN

    먼저 트래픽이 들어오는 경로를 정한 다음 DNS 조회 경로를 확인하세요.

v2rayNG 구독 및 프록시 설정

먼저 구독을 가져온 뒤 트래픽이 코어로 들어오는 경로를 정하고 라우팅을 조정하세요. 각 설정은 구성의 출처, 대상 매칭, 시스템 트래픽 처리, 앱 범위, 프로토콜 호환성을 각각 다룹니다. 다섯 가지를 모두 켜야 속도가 빨라지는 설정은 아닙니다.

처음 설정할 때는 작동하는 구독 하나와 기본 라우팅만 사용하세요. 연결을 확인한 뒤 한 번에 하나씩 변경하고 다시 연결해 변경 전후의 접속 결과를 기록하세요. 팝업에 표시된 내용은 각 항목의 역할을 설명하는 예시이며, 그대로 가져올 수 있는 완전한 설정 파일이 아닙니다.

주소 저장과 목록 업데이트는 별개의 단계입니다

구독 그룹 설정
메모 → 사용자 지정 그룹 이름
선택 주소 (url) → 구독 주소 입력
저장 → 구독 업데이트

사이드 메뉴에서 「구독 그룹 설정」을 열고 그룹을 만든 다음 메모를 입력하세요. 서비스 제공자가 안내한 전체 구독 주소를 주소 입력란에 붙여 넣습니다. 저장한 뒤 메인 화면으로 돌아와 구독을 업데이트하고 가져온 구성을 선택하세요. 구독 주소는 개별 노드 공유 링크와 다릅니다. 노드 링크는 클립보드에서 가져오기 기능으로 추가해야 합니다. 그룹을 나누면 업데이트와 오류 확인이 편리합니다. 목록이 비어 있으면 업데이트 결과, 주소 유효 기간, 응답 내용을 먼저 확인하고 같은 이름의 그룹을 반복해서 만들지 마세요. 구독 주소에 접속 정보가 포함될 수 있으므로 스크린샷을 공유하거나 문의하기 전에 전체 주소를 가리세요.

V2Ray 클라이언트 플랫폼별 다운로드

모바일에서는 v2rayNG, 데스크톱에서는 v2rayN을 우선 고려하세요. 운영체제와 프로세서 아키텍처를 확인한 뒤 설치 형식을 선택합니다. 클라이언트 다운로드는 실행 도구를 제공할 뿐이며, 구독 주소와 서버 매개변수는 별도로 준비해야 합니다. 설치했다고 바로 연결에 필요한 구성이 갖춰지는 것은 아닙니다.

Windows

v2rayN

다운로드 페이지에서 데스크톱 버전 또는 클래식 WPF 버전을 선택하세요. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 데스크톱 인터페이스를 유지합니다. 버튼 위치가 다를 수 있으므로 가이드를 볼 때는 창 모양이 아니라 기능 이름을 기준으로 찾으세요.

설치 후 구독을 가져와 구성을 선택하고 시스템 프록시를 설정하세요. 시스템 프록시를 따르는 앱만 해당 경로를 통해 트래픽을 보냅니다. 특정 앱이 계속 직접 연결된다면 먼저 시스템 프록시를 사용하는 앱인지 확인하고 TUN이 필요한지 검토하세요. 로컬 리스닝 포트를 변경했다면 시스템 프록시가 가리키는 주소와 포트도 함께 확인해야 합니다.

macOS

v2rayN

먼저 시스템의 「이 Mac에 관하여」에서 칩 정보를 확인하세요. Apple Silicon이면 arm64 설치 항목을, Intel 프로세서면 x64 항목을 선택합니다. 설치 형식과 칩 아키텍처는 서로 다른 기준이므로 파일 확장자만 보고 기기와의 호환성을 판단할 수 없습니다.

실행 후 시스템 안내에 따라 필요한 권한을 허용하고 구성을 가져오세요. TUN을 켰을 때 권한이나 네트워크 인터페이스 오류가 발생하면 시스템 프록시로 돌아가 기본 연결을 확인해 노드 문제와 트래픽 처리 문제를 구분하세요. 모드를 바꾼 뒤에는 테스트 페이지를 새로 열어 이전 연결 결과를 새 규칙의 결과로 착각하지 않도록 하세요.

Android

우선 v2rayNG 고려

비교적 최신 스마트폰은 arm64를 먼저 고려할 수 있지만, 기기에서 실제로 지원하는 아키텍처를 기준으로 선택하세요. 확인하기 어렵다면 범용 버전 안내를 참고하세요. v2fly 계열 코어가 필요한 구성이라면 v2flyNG를 선택할 수 있습니다. 먼저 프로토콜 지원 범위를 확인한 뒤 전환 여부를 결정하세요.

설치할 때 시스템 안내에 따라 현재 출처의 앱 설치를 허용하고, 설치가 끝나면 클라이언트를 열어 구독을 가져오세요. 처음 연결할 때 VPN 권한을 승인한 뒤 기기에 맞춰 배터리 최적화와 백그라운드 제한을 조정합니다. 업무 프로필, 앱 복제 기능, 다른 VPN 도구는 트래픽 처리 범위에 영향을 줄 수 있으므로 테스트할 때 어떤 시스템 공간을 사용하는지 함께 확인하세요.

Linux

v2rayN

배포판의 패키지 형식에 맞춰 deb 또는 rpm을 선택한 다음 x64와 arm64 아키텍처를 확인하세요. 패키지 형식이 맞아도 아키텍처가 다를 수 있습니다. 그래픽 데스크톱 환경, 시스템 구성요소, 권한 설정도 실행과 네트워크 트래픽 처리에 영향을 줍니다. 플랫폼별 요구사항은 다운로드 페이지에서 확인할 수 있습니다.

먼저 그래픽 클라이언트로 구성을 가져와 로컬 프록시 경로가 작동하는지 확인한 뒤 데스크톱 환경의 시스템 프록시를 설정하거나 TUN을 켜세요. 일부 앱은 별도의 프록시 설정을 사용하므로 데스크톱 설정만으로 모든 트래픽이 처리된다고 단정할 수 없습니다. 실행에 실패하면 클라이언트 로그를 확인해 시스템 의존성 누락, 리스닝 포트 충돌, 구성 파싱 오류를 구분하세요.

기기를 바꿀 때는 구성을 옮긴 뒤 권한을 다시 승인하세요

여러 기기에서 같은 출처의 구독을 사용할 수 있지만, VPN 권한, 로컬 포트, 시스템 프록시, 앱별 목록은 기기마다 따로 설정해야 합니다. 다른 컴퓨터의 전체 리스닝 설정을 휴대폰에 그대로 덮어쓰거나, 휴대폰의 앱 선택을 데스크톱 라우팅 규칙으로 간주하지 마세요. 가져온 뒤 주소, 포트, 프로토콜, 보안 매개변수를 확인하고 실제 접속을 테스트하세요. 여러 기기의 동시 연결 허용 여부는 구독 제공자의 안내를 따르세요.

전체 클라이언트 보기 → 세 가지 클라이언트의 용도 비교

Project V, V2Fly 및 Xray 생태계

클라이언트, 코어, 프로토콜은 서로 다른 계층입니다. 이 차이를 먼저 이해해야 기능을 앱 화면에서 설정할지, 코어 지원 여부를 확인할지, 구성 제공자에게 문의할지 판단할 수 있습니다.

Project V에서 코어 계열까지

Project V는 V2Ray를 중심으로 형성된 오픈소스 네트워크 도구 생태계입니다. 인바운드, 라우팅, 아웃바운드, 전송 기능을 나누어 설정하는 것이 기본 구조입니다. 그래픽 클라이언트는 관련 설정을 메뉴로 정리하고, 코어는 설정을 읽어 연결을 처리합니다. 「V2Ray 안드로이드판」을 검색했을 때 볼 수 있는 v2rayNG는 Android용 클라이언트이지 새로운 서버 프로토콜이 아닙니다.

V2Fly는 V2Ray의 커뮤니티 개발을 이어가고, Xray는 관련 코드 기반에서 독자적인 코어와 기능을 발전시켜 왔습니다. 설정의 기반은 일부 공유하지만 기능이 완전히 일치하지는 않습니다. 코어가 발전하면서 특정 필드, 전송 조합, 보안 옵션이 달라질 수 있으므로 실제 구성 요구사항을 확인해야 합니다. 클라이언트 이름에 모두 V2Ray가 들어간다고 서로 바꿔 쓸 수 있는 것은 아닙니다.

프로토콜 이름만으로 전체 매개변수를 알 수는 없습니다

VMess, VLESS, Trojan, Shadowsocks는 프록시 프로토콜 선택을 나타냅니다. 노드에는 TCP, WebSocket, gRPC 같은 전송 설정과 TLS 또는 REALITY 같은 보안 매개변수가 포함될 수도 있습니다. 가져온 뒤에는 이러한 필드의 조합을 함께 확인하세요. VMess를 VLESS로 바꾸거나 포트만 교체하는 것만으로 구성이 다른 방식으로 작동하지는 않습니다.

TLS 핸드셰이크 오류가 발생하면 먼저 시스템 시간과 서버 도메인, SNI가 일치하는지 확인한 뒤 로그에 기록된 원인을 살펴보세요. 인증서 검증을 임의로 끄면 연결의 보안 전제가 달라지고 실제 구성 오류를 가릴 수도 있습니다. 프로토콜 기초 용어는 용어 설명에서 확인하고, 실제 작업 순서는 사용 가이드를 참고하세요.

세 가지 오픈소스 클라이언트의 역할

v2rayNG는 Android용 클라이언트로 Xray 코어를 사용하며 구독, 라우팅, 시스템 VPN 트래픽 처리 기능을 제공합니다. v2flyNG도 Android용이며 v2fly 코어 계열을 사용하므로 구성 호환성을 확인한 사용자가 선택할 수 있습니다. v2rayN은 데스크톱용으로 구성, 로컬 리스닝, 시스템 프록시 등을 그래픽 인터페이스에서 관리합니다. 세 클라이언트 모두 오픈소스 프로젝트이며, 기기와 필요한 기능, 구성 호환성을 기준으로 선택하세요.

오픈소스는 해당 라이선스에 따라 소스 코드를 제공한다는 뜻이며, 라이선스에는 복사, 수정, 배포 조건도 명시되어 있습니다. 클라이언트 인터페이스, 코어, 포함된 구성요소에 서로 다른 라이선스가 적용될 수 있으므로 재배포할 때는 각각 확인해야 합니다. 공개 코드와 커뮤니티 협업은 구현을 이해하고 문제를 추적하는 데 도움이 되지만, 기기 권한 관리와 신뢰할 수 있는 구독 출처, 올바른 보안 매개변수를 대신하지는 않습니다.

인터페이스, 코어 및 규칙 리소스 업데이트

구독 업데이트는 구독 제공자가 반환한 구성 목록만 새로고침하며 클라이언트 자체를 업그레이드하지 않습니다. 클라이언트를 업그레이드해도 구독 주소가 자동으로 유효해지는 것은 아닙니다. 라우팅에 사용하는 도메인 및 주소 분류 리소스는 또 다른 계층입니다. 문제를 확인할 때는 어떤 항목을 업데이트하는지 먼저 구분하세요. 「구독 업데이트」가 모든 문제를 해결하는 만능 버튼은 아닙니다.

업그레이드 전에 필요한 구성을 저장하고 접속 정보가 포함된 내보내기 파일을 안전하게 보관하세요. 업그레이드 후에는 기존에 작동하던 구성을 먼저 테스트한 다음 새 기능을 하나씩 켜세요. 차이가 생기면 클라이언트 이름, 시스템 환경, 사용 모드, 민감 정보를 가린 로그 내용을 기록하세요. 단순히 「연결되지 않음」이라고 설명하는 것보다 원인을 찾기 쉽습니다. 단계별 학습 경로는 초급부터 고급까지 안내서에서 확인하세요.

연결 문제는 경로, 라우팅, DNS 순으로 확인

먼저 클라이언트 서비스가 시작됐는지, 시스템 VPN 또는 프록시 경로가 작동하는지 확인한 다음 테스트할 앱이 트래픽 처리 범위에 포함되는지 확인하세요. 경로가 정상이라면 대상이 예상한 라우팅 규칙과 일치하는지 살펴보고, 마지막으로 DNS 조회와 원격 핸드셰이크를 확인합니다. 브라우저에서 페이지 하나가 열린다는 사실만으로 모든 앱, 도메인, 프로토콜의 연결 경로가 같다고 볼 수는 없습니다.

로컬 네트워크 기기에 접속할 수 없다면 사설 주소 규칙과 트래픽 처리 범위를 먼저 확인하세요. 구독 목록이 비어 있다면 구독 업데이트 결과를 확인하고, 코어가 시작되지 않으면 구성 파싱 로그를 먼저 살펴보세요. 증상마다 발생 단계가 다르므로 해결 순서도 달라집니다. 증상과 연결 경로에 따른 자세한 안내는 자주 묻는 질문에서 확인하세요. 원인을 찾기 전에 클라이언트를 반복해서 재설치할 필요는 없습니다.

V2Ray 구성 및 문제 해결 노트

문제에 맞는 글을 확인하세요. 노드 선택에서는 작동 조건을, 포트 충돌에서는 로컬 리스닝을, 인증서 오류에서는 핸드셰이크 매개변수를 살펴봅니다. 먼저 문제가 발생한 단계를 기록한 뒤 관련 글을 찾아보면 서로 다른 원인을 하나의 연결 문제로 혼동하지 않을 수 있습니다.

V2Ray 노드 선택법: 지연 시간·배율·지역·프로토콜 유형 비교

구독 목록의 지연 시간 테스트, 트래픽 배율, 지역 표시를 이해하고 VLESS, VMess, Trojan의 프로토콜 특성을 고려해 일상 사용에 적합한 노드를 선택하세요.

테스트가 연결 성립 시간을 측정하는지 실제 접속 결과를 측정하는지 먼저 확인한 다음 배율이 요금에 어떤 의미인지 살펴보세요. 지역 표시만으로 모든 대상에 대한 접속 품질을 판단할 수는 없습니다. 같은 네트워크에서 같은 대상에 접속해 비교하고, 기기가 해당 프로토콜 조합을 지원하는지도 확인하세요.

노드 선택 가이드 읽기 →

V2Ray TLS 핸드셰이크 실패 및 인증서 오류: 시스템 시간과 SNI 점검

기기 시간, 서버 인증서 이름, SNI부터 확인해 인증서 검증 실패와 연결 시간 초과를 구분하세요. 구성 출처에서 제공한 보안 매개변수를 확인하고, 검증 비활성화를 기본 해결책으로 삼지 마세요.

같은 노드가 기기마다 다르게 작동하면 시간 동기화, 시스템 인증서 환경, 가져온 필드를 먼저 비교하세요. 원래 오류 메시지를 보존해야 문제가 인증서 신뢰, 이름 일치, 또는 더 이른 네트워크 연결 단계 중 어디에서 발생했는지 판단할 수 있습니다.

TLS 문제 해결 노트 읽기 →

v2rayN 로컬 포트 사용 중: 10808 충돌 확인 및 리스닝 포트 변경

로컬 리스닝 포트를 사용 중인 프로세스를 확인한 뒤 v2rayN 설정에서 해당 포트를 변경하고 시스템 프록시도 함께 확인하세요. 로컬 리스닝 실패를 원격 노드 문제로 오인하지 마세요.

로컬 포트와 서버 포트는 용도가 다릅니다. 컴퓨터의 리스닝 포트를 변경한 뒤에는 해당 경로를 사용하는 앱의 프록시 설정도 업데이트해야 합니다. 구독의 원격 포트만 바꿔서는 로컬 포트를 비울 수 없고, 오히려 올바른 노드 설정이 잘못될 수 있습니다.

포트 문제 해결 노트 읽기 →