클라이언트 및 설정 문서 Xray / V2Fly

V2Ray모바일

v2rayN 다운로드 가이드 보기

v2rayNG 및 v2rayN 클라이언트 다운로드

안드로이드에서 구독 가져오기부터 데스크톱 라우팅 설정까지, 운영체제에 맞는 클라이언트와 설정 안내를 확인하세요.

완전 무료 오픈 소스 GUI 설정
Windows Android macOS Linux

CONFIG / 설정 점검

구독, 라우팅 및 연결 설정

클라이언트는 입력값을 설정으로 만들고, 코어는 그 설정을 실행합니다. 이 역할을 먼저 이해하면 메뉴를 헤매지 않습니다. 구독은 서버 목록을 정하고, 라우팅은 트래픽의 목적지를 정하며, 시스템 프록시나 VPN 모드는 어떤 앱의 요청을 클라이언트로 보낼지 정합니다. 설정은 스위치를 많이 켠다고 좋은 게 아닙니다. 기본 연결부터 확인한 다음 항목별로 조정하세요.

V2Ray 라우팅 규칙: 먼저 매칭하고, 그다음 아웃바운드로

라우팅은 요청을 어디로 보낼지 정하지만 시스템 프록시를 켜지는 않습니다. v2rayNG의 ‘설정’에서 ‘LAN 및 중국 본토 주소 우회’를 선택하면 규칙에 해당하는 트래픽을 직접 연결할 수 있습니다. 데스크톱에서는 v2rayN의 ‘라우팅 설정’에서 규칙을 관리합니다. 규칙은 순서대로 매칭되므로 구체적인 도메인을 포괄적인 규칙보다 앞에 두세요. 아래 조각은 LAN 주소를 직접 연결하는 예시일 뿐이며, 전체 설정에 적용하려면 direct 태그가 지정된 아웃바운드가 있어야 합니다. 클라이언트마다 메뉴는 다르지만, 규칙과 코어가 지원하는 필드는 모두 확인해야 합니다.

routing · LAN 직접 연결 예시
{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

전체 플랫폼 안내에서 라우팅과 프록시 설정 확인하기 →

DOWNLOAD / 운영체제별 패키지

네 가지 플랫폼의 클라이언트 다운로드

데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하고, V2Fly 코어가 필요하면 v2flyNG를 대안으로 고려하세요. 같은 플랫폼에서도 CPU 아키텍처를 확인해야 합니다. 먼저 운영체제, 다음으로 칩을 확인한 뒤 설치 파일을 고르세요. 각 링크는 해당 플랫폼의 다운로드 페이지로 연결되며, 파일과 릴리스 정보는 클라이언트 다운로드 카드에서 확인할 수 있습니다.

Windows · v2rayN

시스템 프록시, 구독 그룹, 사용자 지정 라우팅이 필요한 데스크톱 사용자에게 적합합니다. 다운로드 센터에서 데스크톱 버전과 클래식 WPF 버전을 모두 확인할 수 있습니다. 데스크톱 버전은 차세대 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 조작 방식을 유지합니다. 사용 습관과 현재 시스템 환경에 맞춰 선택하세요. 같은 구독을 가져오기 위해 클라이언트 두 개를 동시에 실행할 필요는 없습니다.

설치 후 메인 화면을 열어 코어가 시작되는지 확인한 다음 구독을 추가하세요. 창이 뜨자마자 종료되면 안내에 따라 실행 환경, 설치 폴더 권한, 보안 소프트웨어 기록을 확인하세요. 시스템 프록시를 켜면 보통 해당 설정을 따르는 앱에만 적용됩니다. 특정 프로그램이 계속 직접 연결된다면 먼저 프로그램 자체의 프록시 설정을 확인하고, 필요할 때 TUN을 고려하세요. 시스템 프록시와 라우팅 모드를 같은 스위치로 생각하는 것이 흔한 첫 번째 실수입니다.

Windows 다운로드

macOS · v2rayN

데스크톱 GUI로 서버와 라우팅을 관리하려는 사용자에게 적합합니다. 먼저 ‘이 Mac에 관하여’에서 칩을 확인하세요. Apple Silicon은 arm64, Intel은 x64를 선택합니다. 아키텍처를 잘못 고르면 앱이 정상적으로 시작되지 않을 수 있으며, 구독을 다시 가져와도 해결되지 않습니다. 설치 파일 형식과 시스템 요구 사항은 다운로드 센터의 안내를 확인하세요.

처음 실행할 때 시스템 보안 경고가 표시되면 파일 출처를 확인한 뒤 시스템 설정에서 허용하세요. 연결한 후에는 현재 네트워크 서비스의 프록시 설정과 클라이언트 라우팅을 각각 확인하세요. 메인 화면의 실행 상태만 확인해서는 안 됩니다. TUN을 사용할 때는 관련 권한도 설정해야 합니다. TUN은 일반 시스템 프록시와 적용 범위가 다릅니다. 클라이언트를 종료하기 전에 켜 둔 프록시를 끄면 앱이 종료된 뒤에도 시스템이 로컬 포트로 요청을 보내는 상황을 예방할 수 있습니다.

macOS 다운로드

Android · v2rayNG / v2flyNG

v2rayNG는 Xray 코어를 사용하며 Android에서 널리 쓰이는 선택지입니다. v2flyNG는 V2Fly 코어를 사용하므로 해당 코어의 동작에 의존하는 기존 설정에 적합합니다. 최근 출시된 일반적인 스마트폰은 대개 arm64를 선택하면 됩니다. 아키텍처가 확실하지 않으면 기기 정보를 확인하거나 다운로드 센터의 안내에 따라 범용 버전을 선택하세요. 클라이언트를 설치한 뒤 유효한 설정을 직접 가져와야 합니다.

처음 연결하면 시스템에서 VPN 권한을 요청합니다. 허용한 다음 대상 사이트에 접속되는지 확인하세요. 권한을 허용했다고 서버 연결까지 완료된 것은 아닙니다. 대기 모드가 길어진 뒤 연결이 끊기면 배터리 최적화, 백그라운드 실행 제한, 네트워크 전환 여부를 확인하세요. 두 클라이언트에서 VPN 연결을 동시에 만들지 마세요. 테스트할 클라이언트를 바꿀 때는 이전 클라이언트를 먼저 중지한 후 다음 클라이언트를 실행해야 시스템 권한과 백그라운드 상태가 서로 간섭하지 않습니다.

Android 다운로드

Linux · v2rayN

Linux 데스크톱 환경에서 GUI로 구독을 관리하려는 사용자에게 적합합니다. Ubuntu와 Debian 계열은 보통 deb, Fedora와 openSUSE 환경은 보통 rpm을 선택합니다. 그런 다음 CPU에 맞춰 x64 또는 arm64를 고르세요. 패키지 형식은 설치 방법일 뿐입니다. 필요한 의존성이 갖춰졌는지, 데스크톱 환경을 사용할 수 있는지도 앱 실행에 영향을 줍니다.

설치 후 앱 메뉴에서 실행해 설정 디렉터리에 쓸 수 있는지 확인하세요. 데스크톱 시스템 프록시를 설정해도 모든 터미널 프로그램이 자동으로 프록시를 사용하는 것은 아닙니다. 일부 도구에는 별도의 네트워크 설정이 있습니다. TUN에는 권한과 라우팅 설정도 필요하므로 일반 프록시 연결이 정상 작동한 뒤 구성하는 것이 좋습니다. 로그인 시 자동 실행과 부팅 시 백그라운드 서비스는 다릅니다. 전자는 데스크톱 세션에 의존하고 후자는 별도의 서비스 관리가 필요하므로 같은 체크박스 안내로 설명할 수 없습니다.

Linux 다운로드

모든 클라이언트 보기 →

QUICKSTART / 입력부터 연결 확인까지

V2Ray 사용법: 세 단계로 설정 완료

클라이언트와 유효한 구독 주소를 준비한 뒤 아래 단계를 진행하세요. 설치 파일은 로컬 프로그램만 제공하며, 구독과 서버 연결 정보는 별도로 준비해야 합니다. 처음 설정할 때는 기본값을 유지하고 최소 연결이 확인된 후 라우팅, DNS, 다중화를 조정하세요. 한 번에 하나씩 변경해야 문제가 생겼을 때 어떤 설정을 건드렸는지 알 수 있습니다.

  1. 구독을 저장하고 서버 목록 업데이트하기

    v2rayN에서 ‘구독 그룹 설정’을 열고 새 그룹을 추가한 뒤 메모와 구독 주소를 입력하고 저장하세요. 다음으로 ‘구독 그룹’ 메뉴에서 업데이트를 실행합니다. v2rayNG도 먼저 ‘구독 그룹 설정’에 주소를 저장하고, 메인 화면으로 돌아와 ‘구독 업데이트’를 선택하면 됩니다. 웹페이지 안내 문구를 주소와 함께 복사하지 않도록 주의하고, 주소 앞뒤에 공백이나 줄바꿈이 없는지 확인하세요.

    vmess:// 또는 vless://로 시작하는 공유 링크를 받았다면 구독 주소로 저장하지 말고 ‘클립보드에서 가져오기’ 관련 메뉴를 사용하세요. 가져온 뒤 메인 화면에 서버가 표시되는지 확인하고, 포트와 전송 방식, TLS 설정이 제공자의 안내와 일치하는지 살펴보세요. 구독 업데이트가 실패해도 기존 목록은 유지하세요. 현재 네트워크에서 주소에 접속할 수 있는지 확인하고, ‘요청 실패’를 ‘모든 서버가 작동하지 않음’으로 오해하지 마세요.

  2. 서버를 선택하고 프록시와 라우팅을 구분하기

    서버 목록에서 사용할 설정을 선택하세요. 데스크톱에서는 필요에 따라 시스템 프록시를 켜고, Android에서는 연결을 시작해 시스템 VPN 권한을 허용하세요. 먼저 일반 프록시나 기본 VPN 모드로 테스트하고 고급 옵션을 한꺼번에 켜지 마세요. 시스템 프록시는 앱의 요청을 어디로 보낼지 정하고, 라우팅 모드는 클라이언트가 받은 요청을 어디로 전달할지 정합니다. 두 설정을 구분해 확인하세요.

    일상적으로 사용할 때는 필요에 따라 LAN 및 중국 본토 주소 우회 등의 라우팅 방식을 선택하세요. 글로벌 모드로 바꾸면 클라이언트에 들어온 트래픽의 경로가 바뀔 뿐, 시스템 프록시를 무시하던 앱까지 자동으로 연결되지는 않습니다. 데스크톱 프로그램에 별도의 프록시 설정이 있다면 주소와 포트, 프록시 유형을 확인하세요. 더 많은 트래픽을 처리해야 할 때는 플랫폼 안내에 따라 TUN을 설정하고 권한 및 다른 네트워크 도구와의 충돌에 유의하세요.

  3. 실제 접속 확인 후 로그 살펴보기

    접속 가능한 것으로 확인된 웹페이지를 연 다음 실제로 사용하려는 대상 사이트도 테스트하세요. 모든 요청이 실패하는지, 특정 도메인만 실패하는지, 한 앱에서만 문제가 생기는지 먼저 구분하세요. 클라이언트에 실행 중이라고 표시되는 것은 로컬 상태만 보여줍니다. 서버 접속 가능 여부, 인증 정보, DNS 확인은 실제 요청을 통해 확인해야 합니다. 목록에 표시된 테스트 결과만으로 브라우저 접속을 대신할 수는 없습니다.

    오류가 발생하면 로컬 트래픽 처리, 도메인 확인, 원격 연결, 라우팅 매칭 순서로 범위를 좁히세요. 시간 초과는 네트워크와 서버 주소를 먼저 확인하고, 인증 오류는 로그인 정보를, 인증서나 핸드셰이크 오류는 시스템 시간과 서버 이름, TLS 매개변수를 점검하세요. 로그를 공유하기 전에는 구독 주소와 사용자 식별 정보, 서버의 민감한 정보를 가리세요. 오류 유형과 발생 위치만 남겨도 충분합니다. 이런 정보를 준비하는 것이 스위치를 계속 바꾸는 것보다 진단에 도움이 됩니다.

전체 가이드 보기 →

ECOSYSTEM / 클라이언트와 코어의 역할

Project V, V2Fly 및 Xray 생태계

Project VV2FlyXray-core커뮤니티 관리

V2Ray는 생태계 이름이지, 공통 설치 파일 하나를 뜻하지 않습니다

Project V는 모듈형 네트워크 프록시 도구를 기반으로 하며, V2Ray는 이 생태계에서 널리 사용되는 이름입니다. ‘V2Ray 모바일’을 검색하는 사용자는 대개 코어 설정 파일을 직접 편집하는 방법이 아니라 휴대폰에서 설정을 가져와 연결을 시작할 수 있는 GUI 클라이언트를 찾습니다. 데스크톱의 v2rayN, Android의 v2rayNG와 v2flyNG가 바로 이 역할을 합니다. 인터페이스를 제공하고 서버 정보를 저장해 설정을 만든 다음 해당 코어를 호출해 네트워크 기능을 실행합니다.

따라서 이 사이트는 다운로드와 설정 안내를 나누어 제공합니다. 다운로드 센터에서는 플랫폼과 설치 파일을 선택하고, 시작 가이드에서는 최소한의 연결 절차를 확인하며, 전체 문서에서는 플랫폼별 권한과 프록시, 문제 해결 방법을 살펴볼 수 있습니다. 문제가 생기면 먼저 어느 단계에 해당하는지 확인하세요. 인터페이스가 열리지 않으면 클라이언트나 실행 환경 문제이고, 구독을 가져오지 못하면 주소나 요청 과정의 문제이며, 연결 핸드셰이크가 실패하면 코어 설정과 서버 매개변수를 살펴봐야 합니다. 이름이 비슷해도 문제 해결 경로는 같지 않습니다.

V2Fly와 Xray: 공통 기반과 서로 다른 발전 방향

V2Fly는 V2Ray 관련 도구를 계속 관리하는 커뮤니티입니다. Xray-core는 관련 코드 기반에서 발전해 독자적인 기능 개발 경로를 형성했습니다. 두 코어는 일부 설정 개념을 공유하지만 프로토콜 기능, 매개변수 지원, 기본 동작에는 차이가 있습니다. 가이드의 필드는 실제 사용하는 코어에 맞춰 해석해야 합니다. 둘 다 ‘V2Ray 클라이언트’라고 해서 모든 설정이 서로 호환되는 것은 아닙니다.

코어를 선택할 때는 먼저 서버 요구 사항을 확인하고 클라이언트가 실제로 지원하는 기능을 살펴보세요. 공유 링크를 읽을 수 있다는 것은 클라이언트가 링크 형식을 인식한다는 뜻일 뿐, 현재 코어가 모든 매개변수를 실행할 수 있다는 보장은 아닙니다. 특히 최신 프로토콜 기능을 사용할 때는 클라이언트와 코어의 업데이트 안내를 모두 확인하세요. 코어를 바꾸면 호환성을 확인할 수 있지만, 서버 주소와 인증 정보, 전송 설정을 기본적으로 점검하는 일을 대신할 수는 없습니다.

오픈 소스 클라이언트 세 가지, 플랫폼과 코어에 맞춰 선택

v2rayN은 Windows, macOS, Linux용 오픈 소스 데스크톱 클라이언트로, GUI에서 여러 구독을 관리하고 서버를 전환하며 라우팅을 편집하는 데 적합합니다. v2rayNG는 Xray 코어를 사용하는 오픈 소스 Android 클라이언트로 일반적인 모바일 연결과 구독 관리에 적합합니다. v2flyNG는 V2Fly 코어를 사용하는 오픈 소스 Android 클라이언트로, 관련 호환성이 필요한 경우 대안으로 쓸 수 있습니다. 추천 순서는 플랫폼별 용도를 기준으로 한 것이며 임의의 속도 순위가 아닙니다.

세 클라이언트는 모두 커뮤니티에서 관리하는 소프트웨어 프로젝트이며 무료로 사용할 수 있습니다. 무료 클라이언트와 원격 서버 서비스는 별개입니다. 서버 비용과 이용 기간, 접속 조건은 제공자가 정합니다. 이 사이트는 클라이언트 다운로드와 사용 안내를 정리하며, 프로그램 설치만으로 원격 연결 자원이 제공되는 것은 아닙니다. 메뉴와 플랫폼, 코어 차이를 비교하려면 세 클라이언트 비교를 읽고 보조 클라이언트가 필요한지 결정하세요.

오픈 소스 라이선스: 사용 권한과 책임 범위 확인

Project V 생태계의 클라이언트와 코어는 각각 소스 코드를 공개하며, 각 오픈 소스 라이선스에서 사용과 수정, 재배포 조건을 정합니다. V2Fly의 V2Ray 코어와 Xray-core는 MPL-2.0을 사용하고, 클라이언트 라이선스는 각 프로젝트의 배포 자료를 확인해야 합니다. 소스 코드를 공개적으로 읽을 수 있다는 점은 확인 가능한 프로젝트 특성이지만, 이를 근거로 모든 타사 서버나 구독 서비스의 동작을 단정할 수는 없습니다.

실제로 사용할 때는 구독 주소를 안전하게 보관하고 VPN 권한과 프록시 적용 범위를 이해하며 현재 환경의 네트워크 이용 규정을 준수해야 합니다. 설정 스크린샷이나 로그, 공유 링크를 다른 사람에게 보내기 전에 계정을 식별할 수 있는 정보를 삭제하세요. 출처가 불분명한 설정은 메모 이름만 보지 말고 서버 주소와 포트, 전송 방식, 라우팅 목적지를 확인해야 클라이언트에 어떤 동작이 지정됐는지 알 수 있습니다.

클라이언트 업데이트 후 설정 호환성도 확인하세요

클라이언트 업데이트는 인터페이스를 바꾸거나 가져오기 문제를 수정하고 코어 기능 변경에 대응할 수 있습니다. 코어 업데이트는 프로토콜 지원과 설정 해석 방식에 영향을 줄 수 있습니다. 업데이트 전에 구독 그룹과 사용자 지정 라우팅을 백업하고 현재 프록시 방식을 기록하세요. 업데이트 후에는 작동이 확인된 설정 하나로 먼저 검증한 다음 고급 옵션을 복원하세요. 새 인터페이스의 차이와 이전 필드의 호환성, 네트워크 변화를 한꺼번에 판단하지 않도록 합니다.

이 사이트의 메인 페이지에서는 개별 릴리스 정보를 다루지 않습니다. 현재 다운로드 파일과 릴리스 정보는 다운로드 센터에 모아 두었습니다. 문서에 나오는 메뉴 이름은 기능을 찾기 위한 안내입니다. 클라이언트 인터페이스가 바뀌었다면 기능과 업데이트 안내를 기준으로 확인하세요. 이전 스크린샷과 픽셀 단위로 똑같을 필요는 없습니다. 구독이 어디에 저장되는지, 프록시를 언제 켜는지, 규칙이 어떤 아웃바운드로 향하는지 이 세 가지는 계속 확인해야 합니다.

NOTES / 사용 팁

공유 링크, 프록시 모드 및 시작 문제 해결

아래 글 세 편은 게시일 순으로 정렬되어 있으며, 각각 가져오기 메뉴, 트래픽 경로, 클라이언트 시작 문제를 다룹니다. 고급 매개변수부터 읽기보다 현재 증상에 맞는 글을 선택하세요. 구독 가져오기 문제와 연결 오류는 서로 다릅니다. 클라이언트가 실행되지 않을 때는 원격 서버 설정을 먼저 바꿀 필요가 없습니다.

입문 가이드

vmess:// 및 vless:// 공유 링크 가져오기: 단일 서버 링크와 구독 주소의 차이

공유 링크 하나는 보통 서버 하나에 해당하고, 구독 주소는 정기적으로 업데이트할 수 있는 서버 목록을 제공합니다. 둘 다 복사할 수 있지만 같은 입력란에 넣어서는 안 됩니다. 이 글에서는 형식 차이와 v2rayNG 및 v2rayN의 가져오기 메뉴를 설명하고, 단일 링크를 가져와도 이후 서버 변경 사항이 자동으로 반영되지 않는 이유를 살펴봅니다. 링크를 받은 뒤 어떤 메뉴를 사용해야 할지 모르는 사용자에게 적합합니다.

공유 링크 가져오기 안내 읽기 →
입문 가이드

시스템 프록시, 글로벌 모드, 중국 본토 우회 중 무엇을 선택할까? V2Ray 프록시 모드 비교

시스템 프록시 스위치와 라우팅 모드는 서로 다른 계층을 다룹니다. 이름은 비슷해도 역할은 다릅니다. 이 글에서는 글로벌 모드와 중국 본토 우회, 직접 연결 시 트래픽이 어떻게 흐르는지 비교하고, ‘글로벌’이 기기의 모든 프로그램을 프록시에 연결한다는 뜻이 아닌 이유를 설명합니다. 브라우저 접속, LAN 서비스, 별도 프록시를 사용하는 앱 등 상황별 선택 방법도 안내합니다. 특정 앱이 계속 직접 연결될 때 프록시 적용 범위를 확인하는 데 도움이 됩니다.

프록시 모드 비교 읽기 →
문제 해결

v2rayN 실행 직후 종료되거나 시작 중 충돌할 때: 런타임 누락 및 권한 문제 해결

창이 제대로 열리지 않는다면 먼저 로컬 환경을 점검하세요. 이 글에서는 .NET 런타임 환경과 압축 해제 경로, 보안 소프트웨어 기록, 폴더 쓰기 권한을 차례로 확인하고 클라이언트 시작 문제와 코어 시작 문제를 구분하는 방법을 설명합니다. 한 번에 원인 하나씩 조치하고 다시 실행해 보세요. 같은 권한 문제를 남긴 채 반복해서 재설치하는 일을 막을 수 있습니다. 구독이 유효한지는 메인 화면이 정상적으로 열린 다음 확인하면 됩니다.

시작 중 충돌 문제 해결 읽기 →

모든 글 보기 →