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

V2Ray Hubv2rayN 설정 가이드

기기에 맞는 오픈 소스 클라이언트를 선택하고 구독 가져오기부터 시작해 라우팅과 TUN 모드를 차례로 설정하세요.

  • VMess / VLESS
  • Xray / V2Fly

설정 메뉴 / CLIENT SETTINGS

구독·프록시·라우팅 설정

먼저 설정을 가져오고, 어떤 트래픽을 클라이언트로 보낼지 정한 다음, 트래픽의 아웃바운드 경로를 조정하세요. 각각 구독 관리, 프록시 모드, 라우팅 규칙에 해당합니다. 어느 하나만 설정하면 모두 해결된다고 생각하지 마세요.

구독 주소와 공유 링크는 따로 가져오기

구독 주소는 서버 설정을 일괄로 가져올 때 사용하고, 공유 링크는 보통 설정 하나만 담고 있습니다. v2rayN의 ‘구독 그룹’에서 주소를 추가하고 알아보기 쉬운 메모를 입력한 뒤 저장하고 ‘모든 구독 업데이트’를 실행하세요. 공유 링크를 받았다면 복사한 다음 클립보드에서 가져오면 됩니다. 목록이 비어 있으면 같은 그룹을 반복해서 만들지 말고 먼저 업데이트 로그를 확인하세요. 설정을 하나씩 직접 입력하는 대신 구독을 사용하면 그룹을 유지하면서 한꺼번에 업데이트할 수 있습니다. 오른쪽은 가져온 뒤 사용하는 로컬 인바운드 설정 예시이며 구독 주소 형식이 아닙니다.

구독 가져오기 단계 보기 →
{
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ]
}

설정 창에는 관련 필드만 표시되며 전체 설정을 대신할 수는 없습니다. 그래픽 클라이언트는 인바운드, 아웃바운드, 라우팅, DNS를 조합합니다. 처음 사용할 때는 설정 화면에서 한 번에 한 항목씩 변경하고 변경 전 값을 기록해 두세요.

설치 안내 / PLATFORMS

플랫폼에 맞는 V2Ray 클라이언트 선택

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 고려하고 V2Fly 커널이 필요할 때 v2flyNG를 선택하세요. 먼저 운영체제와 프로세서를 확인한 뒤 설치 파일 형식을 고르세요. 파일명에 적힌 클라이언트 이름만 보고 설치 가능 여부를 판단하지 마세요.

Windows

v2rayN을 선택하세요. 다운로드 페이지에서 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존의 클래식한 조작 방식을 유지합니다. 익숙한 인터페이스를 선택한 뒤 패키지 안내에 따라 설치하거나 압축을 푸세요. 프로그램은 쓰기 가능한 고정 폴더에 두세요. 압축 파일 미리보기 창에서 바로 실행하면 설정 저장과 업데이트에 문제가 생길 수 있습니다.

처음 실행하면 먼저 사용할 수 있는 설정 하나를 가져와 커널이 시작되는지 확인한 다음 시스템 프록시를 켜세요. 포트가 이미 사용 중이라는 메시지가 표시되면 클라이언트가 중복 실행 중인지 확인하세요. 설치와 업데이트 전에 설정을 백업하고, 인터페이스 버전을 바꿀 때도 기존 구독 그룹과 라우팅 설정이 제대로 유지되는지 확인하세요.

다운로드

macOS

v2rayN을 선택하고 Apple Silicon과 Intel에 맞는 설치 파일을 고르세요. 시스템의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인할 수 있습니다. 컴퓨터를 구입한 연도만으로 판단하지 마세요. 설치가 끝나면 응용 프로그램 폴더에서 실행하세요. 시스템 보안 경고가 표시되면 먼저 구체적인 원인을 확인한 뒤 시스템에서 안내하는 방법으로 처리하세요.

시스템 프록시와 TUN은 필요한 권한이 다릅니다. 먼저 시스템 프록시로 브라우저에 접속한 다음 TUN이 필요한지 판단하세요. 절전 모드에서 깨어나거나 무선 네트워크를 바꾸거나 다른 네트워크 도구를 사용한 뒤 접속에 문제가 생기면 구독을 삭제하고 재설치하기 전에 시스템 프록시 주소와 커널 실행 상태를 확인하세요.

다운로드

Android

Xray 커널을 사용하는 v2rayNG를 우선 선택하세요. V2Fly 커널이 필요하다면 다운로드 페이지에서 대안으로 제공하는 v2flyNG를 선택할 수 있습니다. 최신 기기는 보통 arm64를 사용합니다. 프로세서 아키텍처를 모르면 기기 정보를 확인하거나 범용 버전을 선택하세요. 두 앱의 설정 호환성은 커널에 따라 달라지므로 한 클라이언트에서 가져올 수 있다고 다른 클라이언트에서도 실행된다고 볼 수는 없습니다.

구독을 가져온 뒤 설정을 선택하고 연결을 눌러 시스템의 VPN 권한 요청을 승인하세요. 백그라운드에서도 연결을 유지해야 한다면 배터리 최적화와 백그라운드 활동 제한을 확인하세요. 앱을 백그라운드로 전환한 뒤 연결이 끊기면 시스템이 프로세스를 종료했는지 먼저 확인하세요. 앱을 열어 둔 상태에서도 접속할 수 없다면 연결 로그와 구독 업데이트 결과를 살펴보세요.

다운로드

Linux

v2rayN을 선택한 뒤 배포판에 따라 deb 또는 rpm을, 프로세서에 따라 x64 또는 arm64를 고르세요. 설치 파일 형식과 프로세서 아키텍처는 서로 다른 조건이므로 하나로 다른 하나를 대신할 수 없습니다. 배포판에서 제공하는 그래픽 소프트웨어 설치 프로그램을 사용하세요. 종속 항목이 충족되지 않으면 클라이언트를 실행하기 전에 설치 프로그램에 표시된 구체적인 안내부터 해결하세요.

데스크톱 환경에 따라 시스템 프록시를 사용하는 방식이 다를 수 있으며 일부 앱은 SOCKS 또는 HTTP 주소를 별도로 설정해야 합니다. 먼저 프록시 설정을 따르는 앱 하나에서 테스트한 다음 다른 앱으로 범위를 넓히세요. TUN을 켜기 전에는 필요한 권한과 기존 가상 네트워크 인터페이스를 확인하세요. 문제를 해결할 때는 먼저 일반 프록시로 되돌려 동시에 바뀌는 설정 항목을 줄이세요.

다운로드

모든 클라이언트 보기 →설치 파일과 지원 대상 안내는 다운로드 센터에서 확인하세요.

설정 순서 / QUICK START

구독 가져오기부터 연결 확인까지

처음 설정할 때는 기본 라우팅과 일반 프록시를 사용하고 TUN과 LAN 공유는 꺼 둔 상태로 시작하세요. 기본 연결이 되는 것을 확인한 뒤 기능을 추가하면 문제가 생겼을 때 원인을 찾기 쉽습니다.

  1. 구독 추가 후 설정 목록 업데이트

    v2rayN에서 ‘구독 그룹’을 열고 구독 주소와 메모를 추가한 뒤 저장하고 업데이트를 실행하세요. Android용 v2rayNG에서는 ‘구독 그룹 설정’에서 주소를 관리한 다음 메인 화면으로 돌아가 구독을 업데이트하면 됩니다. 주소를 복사할 때 공백이나 줄바꿈, 설명 문구가 섞이지 않았는지 확인하세요. 공유 링크는 클립보드에서 가져와야 하며 구독 주소로 입력하면 안 됩니다.

    업데이트가 끝나면 목록에서 가져온 설정을 확인할 수 있어야 합니다. 목록이 비어 있다면 로그를 확인해 주소 접속 실패, 내용 없음, 형식 미지원 중 어떤 문제인지 구분하세요. 구독 링크에 접속 인증 정보가 포함될 수 있으므로 전체 주소를 공개 게시판에 올리지 마세요. 클라이언트는 설정을 읽어오는 역할만 하며 구독 서비스를 제공하지 않습니다.

  2. 설정을 선택한 뒤 프록시 모드 지정

    목록에서 사용할 서버 설정을 선택해 해당 커널을 실행하세요. 데스크톱에서 브라우저에 프록시를 적용하려면 ‘시스템 프록시 자동 설정’을 선택하세요. Android에서는 연결을 누르고 시스템 안내에 따라 VPN 연결 생성을 허용하세요. 처음 테스트할 때는 트래픽을 처리하는 도구를 여러 개 동시에 켜지 말고 경로를 하나로 명확히 하세요.

    이 단계에서는 라우팅 프리셋을 사용하고 인터넷에서 찾은 설정 파일 전체를 바로 붙여 넣지 마세요. 시스템 프록시는 앱이 로컬 포트로 요청을 보낼지 결정하고, 라우팅은 커널이 요청을 받은 뒤 어떤 아웃바운드를 선택할지 결정합니다. 앱이 시스템 프록시를 따르지 않는다면 라우팅 규칙을 계속 바꿔도 트래픽을 프록시로 보내는 문제는 해결되지 않습니다. 앱 자체의 네트워크 설정을 확인하세요.

  3. 실제 접속을 확인한 뒤 문제 해결

    브라우저로 평소 이용하는 페이지에 접속해 콘텐츠가 열리는지 확인하세요. 연결 아이콘이나 테스트 결과만 확인해서는 안 됩니다. 커널 테스트 성공은 특정 테스트 경로가 작동한다는 의미일 뿐 모든 앱과 도메인이 정상이라는 뜻은 아닙니다. 이어서 다른 종류의 대상에도 접속해 예상대로 직접 연결되는지 확인하고, 라우팅 정책이 로컬 서비스를 프록시 아웃바운드로 보내지 않는지 살펴보세요.

    문제가 생기면 ‘커널이 실행 중인가 → 앱 트래픽이 프록시로 들어오는가 → 라우팅 규칙이 적용되는가 → DNS가 정상인가’ 순서로 확인하세요. 연결 시간 초과, 인증서 오류, 도메인 이름 확인 실패는 원인이 서로 다르므로 관련 오류 정보를 보관하세요. 로그를 공유할 때는 구독 주소, 서버 인증 정보, 개인 경로를 먼저 삭제하세요.

전체 가이드 보기 →

프로젝트 관계 / OPEN SOURCE

Project V, V2Fly, Xray

클라이언트는 조작 인터페이스이고 커널은 프로토콜 연결과 트래픽 처리를 담당합니다. 클라이언트를 선택할 때 이 두 계층을 구분해야 각 설정을 어느 프로젝트가 제공하는지, 같은 공유 링크가 클라이언트마다 다르게 작동할 수 있는 이유를 파악할 수 있습니다.

도구 생태계에서 커널 분기까지

Project V는 네트워크 프록시 도구를 중심으로 형성된 오픈 소스 생태계이며 V2Ray는 그중 중요한 구성 요소입니다. V2Fly 커뮤니티는 V2Ray 커널의 개발과 유지 관리를 이어 왔고, Xray는 V2Ray에서 발전한 또 다른 커널 분기입니다. 두 커널은 일부 개념과 설정 구조를 공유하지만 지원되는 프로토콜 기능, 전송 방식, 필드는 계속 달라질 수 있습니다. 이름이 비슷하다고 설정까지 완전히 같다고 볼 수는 없습니다.

VMess와 VLESS는 프로토콜 이름이고 WebSocket과 gRPC는 전송 방식입니다. TLS는 연결의 전송 보안 설정과 관련됩니다. 설정을 가져올 때는 각 매개변수가 서버 설정과 일치해야 합니다. 프로토콜 이름이 맞더라도 전송 경로, 서버 이름, 포트가 틀릴 수 있으므로 문제를 해결할 때 모든 옵션을 한꺼번에 바꾸지 말고 항목별로 확인하세요.

그래픽 클라이언트와 커널의 역할

v2rayN은 데스크톱에서 구독 그룹, 서버 선택, 시스템 프록시, 라우팅을 관리하는 인터페이스를 제공하고 설정을 해당 커널에 전달해 실행합니다. v2rayNG는 Android용 Xray 커널 기반 오픈 소스 클라이언트이며 v2flyNG는 V2Fly 커널을 사용하는 대안입니다. 세 클라이언트 모두 오픈 소스 프로젝트지만 인터페이스, 패키징, 유지 관리 주기는 서로 다릅니다. 기능 사용 여부는 실제로 사용하는 커널의 지원 범위에도 달려 있습니다.

먼저 플랫폼을 확인하고 기존 설정이 요구하는 프로토콜과 전송 기능을 살펴보세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 고려하고 V2Fly와의 호환 동작이 필요할 때 v2flyNG를 검토하세요. 커널 이름만 다르다는 이유로 연결 속도에 고정적인 차이가 있다고 단정하지 마세요. 서버 경로, 네트워크 환경, 설정이 접속 결과에 더 직접적인 영향을 주는 경우가 많습니다.

오픈 소스 프로젝트마다 라이선스가 다릅니다

오픈 소스는 해당 라이선스에 따라 코드가 공개되고 사용, 수정, 재배포 조건이 정해져 있다는 뜻입니다. V2Fly의 V2Ray 커널과 Xray 커널은 MPL 2.0을 사용하지만 클라이언트와 종속 구성 요소에는 다른 라이선스가 적용될 수 있습니다. 일반 사용자는 기능과 유지 관리 안내를 확인하면 됩니다. 소프트웨어를 수정하거나 패키징 또는 배포하려면 클라이언트, 커널, 포함된 구성 요소의 라이선스 파일을 각각 확인하세요.

공개된 코드를 바탕으로 커뮤니티에서 구현을 논의하고 문제를 제보하며 변경 사항을 검토할 수 있지만, 설정 출처에 대한 판단까지 대신해 주지는 않습니다. 구독 제공자, 서버 운영자, 그래픽 클라이언트는 서로 다른 역할을 합니다. 가져오기 전에 설정 출처를 확인하고 사용 중에는 연결이 어떤 서버를 거치는지 파악하세요. 클라이언트가 오픈 소스라는 사실을 제3자 서비스의 신뢰성과 동일하게 여겨서는 안 됩니다.

업데이트 전 되돌릴 수 있도록 설정 보관

클라이언트 업데이트로 메뉴, 설정 생성 방식, 커널 구성 요소, 규칙 데이터가 바뀔 수 있습니다. 업데이트 전에 구독 그룹, 라우팅, 필요한 사용자 설정을 백업하고 정상 작동하던 조합을 기록하세요. 업데이트 후 기존 설정부터 테스트한 다음 새 기능을 시도하세요. 기본 연결이 되지 않으면 같은 구독을 반복해서 가져오기보다 로그와 설정 변경 사항을 먼저 비교하세요.

구독 업데이트, 클라이언트 업데이트, 커널 업데이트, 규칙 데이터 업데이트는 서로 다른 작업입니다. 구독 업데이트는 서버 설정을 새로 고치는 기능이며 모든 클라이언트 호환성 문제를 자동으로 해결하지 않습니다. 라우팅 데이터가 오래되었다고 앱을 다시 설치해야 하는 것도 아닙니다. 유지 관리할 때는 어느 계층을 업데이트해야 하는지 먼저 확인하고 해당 기능을 사용해 문제를 파악하기 전에 변경 범위를 넓히지 마세요.

세 가지 클라이언트 비교 보기 →초보자부터 고급 설정까지 살펴보기 →

관련 글 / ARTICLES

구독 형식, 프로토콜, LAN 공유

기본 연결을 마친 뒤 사용 목적에 맞는 글을 확인하세요. 다른 기기에 연결을 공유하려면 LAN 설정을, 가져오기에 실패했다면 구독 형식을 먼저 살펴보세요. 프로토콜을 비교할 때는 이름만 보지 말고 실제 설정 요구 사항을 확인하세요.

고급 설정

v2rayN에서 LAN 연결 허용하기: 휴대폰, 태블릿, TV에서 PC 프록시 공유

PC의 LAN 주소, 실제 수신 포트, 방화벽 인바운드 규칙을 기준으로 다른 기기에서 프록시를 설정하는 방법을 안내합니다. 같은 네트워크에서 기기가 서로 보이는 경우, 네트워크 격리, 앱에서 수동 프록시를 지원하지 않는 경우를 구분해 공유 옵션만 켜고 접속 조건을 놓치는 일을 방지합니다.

글 읽기 →
프로토콜 기초

VMess와 VLESS의 차이점: 두 프로토콜을 1분 만에 알아보기

프로토콜 자체의 암호화, 외부 전송 보안, 시간 조건을 기준으로 차이를 설명합니다. 설정을 가져올 때는 서버에서 제공한 매개변수를 유지해야 합니다. 프로토콜 이름만 다른 것으로 바꾼다고 이전이 완료되는 것은 아닙니다. 클라이언트 커널이 지원하는 범위도 함께 확인해야 하는 이유를 살펴봅니다.

글 읽기 →
구독 관리

V2Ray 구독 형식 총정리: Base64 구독, 기본 JSON, 공유 링크 간 변환

구독 콘텐츠, 단일 공유 링크, 전체 커널 설정의 차이를 구분하고 디코딩과 클라이언트 내보내기에서 각각 어떤 정보를 보존할 수 있는지 알아보세요. 지원되지 않는 형식이라면 입력 유형을 먼저 확인한 뒤 적절한 가져오기 메뉴를 선택하세요. 전체 설정을 구독 주소 입력란에 붙여 넣지 않도록 주의하세요.

글 읽기 →

전체 글 보기 →질문별 자주 묻는 질문 보기 →