안드로이드 설정 · 데스크톱 다운로드Xray / v2fly

V2Ray 안드로이드 클라이언트v2rayNG 다운로드와 설정

먼저 구독을 가져온 다음 필요에 따라 라우팅과 DNS를 설정하세요. 안드로이드에서는 v2rayNG, 데스크톱에서는 v2rayN을 사용합니다.

오픈 소스한국어 설정 가이드VMess / VLESS / Trojan / Shadowsocks

v2rayNG 주요 설정

먼저 설정이 정상적으로 연결되는지 확인한 다음 규칙을 하나씩 추가하세요. 아래 네 가지 설정은 각각 '어떤 경로로 보낼지', '목록을 어떻게 정리할지', '도메인을 어떻게 해석할지', '어떤 앱을 연결할지'를 다룹니다. 서로 같은 스위치처럼 취급하지 마세요.

{
  "rules": [
    {
      "type": "field",
      "ip": ["geoip:private"],
      "outboundTag": "direct"
    },
    {
      "type": "field",
      "domain": ["geosite:cn"],
      "outboundTag": "direct"
    }
  ]
}

라우팅 규칙은 요청을 어떤 아웃바운드로 보낼지 결정합니다. v2rayNG에서는 도메인과 IP를 기준으로 분류할 수 있습니다. 규칙에는 우선순위가 있으므로 범위가 명확한 예외 규칙을 포괄적인 규칙보다 앞에 두세요. 예시에서는 로컬 네트워크 IP와 지정된 도메인 목록을 직접 연결로 보내며, 설정에 direct 태그와 해당 규칙 데이터가 있어야 합니다. 구독 필터와 달리 라우팅은 서버를 숨기는 기능이 아니라 연결 시 목적지를 선택하는 기능입니다. 변경 후 연결을 다시 시작하고 클라이언트 로그에서 규칙이 적용됐는지 확인하세요. 웹페이지가 열리는지만으로 전체 라우팅이 올바른지 판단해서는 안 됩니다.

자세히 보기 →

플랫폼별 다운로드

먼저 운영체제에 맞는 설치 파일을 선택하고, 다음으로 프로세서 아키텍처를 확인하세요. 이름이 비슷한 클라이언트라도 설치 파일을 서로 바꿔 쓸 수 있는 것은 아닙니다. 아래 링크에서 플랫폼별 다운로드 페이지로 이동할 수 있으며, 제공되는 파일과 버전 정보는 해당 페이지에서 확인하세요.

v2rayN · 데스크톱 우선 추천

다운로드 페이지에서 데스크톱 버전과 클래식 WPF 버전을 제공합니다. 데스크톱 버전은 새로운 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 기존 레이아웃을 유지합니다. 한 가지를 골라 설정하면 되며 같은 구독을 가져오기 위해 두 버전을 모두 설치할 필요는 없습니다.

시스템 프록시를 켠 뒤에도 앱이 시스템 프록시를 따르는지 확인해야 합니다. 더 많은 트래픽을 가로채야 한다면 권한 요건과 함께 TUN 모드를 살펴보세요. 시스템 프록시와 TUN은 같은 기능이 아닙니다.

다운로드 페이지로 이동

v2rayN · 칩에 맞는 버전 선택

기기 칩에 따라 Apple Silicon 또는 Intel 설치 파일을 선택하세요. 먼저 시스템의 '이 Mac에 관하여'에서 칩 정보를 확인한 뒤 해당 파일을 다운로드하면 파일 이름만 보고 아키텍처를 추측하지 않아도 됩니다.

처음 실행할 때는 시스템 안내에 따라 앱 실행과 네트워크 접근 권한을 허용하세요. 앱은 열리지만 브라우저 트래픽이 프록시를 거치지 않는다면 모든 노드를 다시 가져오기보다 시스템 프록시 상태와 수신 주소부터 확인하세요.

다운로드 페이지로 이동

v2rayNG · v2flyNG 대안

먼저 Xray 커널을 사용하는 v2rayNG를 살펴보세요. 기존 v2fly 설정을 사용해야 한다면 v2flyNG를 고려할 수 있습니다. 비교적 최신 기기는 보통 arm64를 선택하며, 아키텍처를 모르면 기기 정보를 확인하거나 범용 버전을 사용하세요.

설치 후 처음 연결할 때 시스템 VPN 권한을 허용해야 합니다. 기기에 다른 VPN 연결이 활성화되어 있다면 먼저 충돌 여부를 확인하세요. 계속 사용할 때는 백그라운드 실행과 배터리 제한도 점검해 앱 전환 후 시스템이 연결을 종료하지 않도록 하세요.

다운로드 페이지로 이동

v2rayN · 배포판에 맞는 버전 선택

배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 선택하고 x64와 arm64도 구분하세요. 데스크톱 클라이언트는 설정을 관리하지만, 데스크톱 환경과 시스템 프록시 설정, 앱별 동작은 각각 따로 확인해야 합니다.

브라우저에서는 연결되지만 다른 프로그램이 실패한다면 먼저 해당 프로그램이 사용하는 프록시 프로토콜과 로컬 포트를 확인하세요. TUN을 켜기 전에 관련 권한과 라우팅, DNS 가로채기를 점검하고 원래 설정으로 되돌리는 방법도 준비하세요.

다운로드 페이지로 이동

클라이언트는 회선 서비스를 제공하지 않습니다. 설치 후 설정을 읽고 연결을 시작할 수 있지만, 사용할 권한이 있는 구독이나 서버 설정은 별도로 준비해야 합니다. 구독 주소에는 접속 정보가 포함될 수 있으므로 계정 정보처럼 안전하게 보관하세요. 공개 스크린샷이나 게시물, 공유 문서에 노출하지 마세요.

구독 가져오기와 첫 연결

처음 사용할 때는 '설정을 목록에 추가 → 트래픽을 클라이언트에 연결 → 실제 앱에서 확인' 순서로 진행하세요. 먼저 노드 하나로 재현 가능한 연결을 만든 뒤 자동 업데이트, 라우팅, 앱 선택을 추가하면 어떤 변경 때문에 문제가 생겼는지 파악하기 쉽습니다.

01

구독 또는 공유 링크 추가

v2rayNG에서는 사이드 메뉴의 구독 그룹 설정으로 이동해 그룹 메모와 구독 주소를 입력하고 저장한 뒤 메인 화면에서 구독을 업데이트하세요. v2rayN에서는 구독 그룹 설정에서 출처를 추가한 다음 구독 업데이트를 실행합니다. 버전에 따라 메뉴 이름은 조금 다를 수 있지만, 먼저 출처를 저장한 뒤 내용을 가져오면 됩니다.

vmess://, vless://, trojan://, ss://로 시작하는 단일 공유 링크는 보통 클립보드에서 설정을 가져오는 메뉴를 이용합니다. 구독 주소는 여러 설정을 가져오는 데 사용되며, 링크 길이만으로 유형을 판단할 수 없습니다. 업데이트 후 노드 메모, 프로토콜, 그룹이 예상한 대로인지 확인하세요.

02

노드와 연결 방식 선택

사용 가능한 설정 하나를 선택하세요. 안드로이드에서는 보통 VPN 모드로 시작해 연결을 누르고 시스템 권한을 허용합니다. 프록시 전용 모드는 앱이 로컬 프록시를 직접 사용해야 하므로 시스템 전체 트래픽을 처리하는 방식과 다릅니다. 데스크톱에서는 먼저 시스템 프록시가 켜져 있는지 확인하고 브라우저가 시스템 프록시를 사용하는지, 별도 프록시를 설정했는지 살펴보세요.

첫 연결에서는 Mux, 복잡한 DNS 설정, 사용자 지정 아웃바운드를 사용하지 마세요. 서버에서 요구하는 주소, 포트, 전송 매개변수, TLS, SNI를 그대로 맞춰야 합니다. 설정을 단순하게 보이게 하려고 항목을 삭제하거나 수정하지 마세요. 인증서 오류가 발생하면 시스템 시간과 도메인을 먼저 확인하고, 인증서 검증을 건너뛰는 방식은 일반적인 해결책으로 사용하지 마세요.

03

앱과 규칙 확인

연결 상태가 시작됨으로 표시되면 대상 앱을 열어 실제로 접속한 뒤 클라이언트 로그를 확인하세요. 시작 성공은 로컬 서비스가 실행 중이라는 뜻일 뿐, 원격 핸드셰이크와 DNS 조회, 대상 서버 연결까지 모두 성공했다는 의미는 아닙니다. 확인할 때는 프록시가 필요한 트래픽뿐 아니라 로컬 네트워크 접속도 점검해 직접 연결이 필요한 경우를 놓치지 마세요.

일부 앱만 실패한다면 앱별 프록시와 해당 앱의 자체 프록시 설정을 먼저 확인하세요. 모든 도메인에 접속할 수 없다면 DNS, 서버 연결 가능 여부, 핸드셰이크 오류를 살펴보세요. 한 번에 하나씩만 바꾸고 변경 전후 결과를 기록하세요. 연결이 안정된 뒤 규칙을 추가하면 문제가 생겼을 때 이전 설정으로 되돌리기 쉽습니다.

Project V, V2Fly, Xray

커널과 클라이언트의 역할 구분

클라이언트는 설정을 관리하고 커널은 연결을 처리합니다

V2Ray 공식 사이트, V2Ray 다운로드, Xray 커널을 검색하다 보면 프로젝트명과 커널명, 클라이언트명이 뒤섞여 나오는 경우가 많습니다. 사용할 때는 먼저 설정을 관리할 인터페이스를 확인하고, 다음으로 어떤 커널이 설정을 실행하는지 살펴보세요. 같은 이름의 설정을 찾지 못하는 혼란을 줄일 수 있습니다.

Project VV2Fly / v2flyXray
사이트 소개와 콘텐츠 원칙 →

생태계와 커널 계열

Project V는 프록시 통신 도구를 중심으로 형성된 오픈 소스 생태계이며, V2Ray는 그중 널리 사용되는 프로젝트명입니다. V2Fly는 관련 커뮤니티의 개발을 이어가며, v2fly 커널은 프로토콜 처리와 네트워크 연결을 담당합니다. Xray는 관련 기술 흐름에서 발전한 또 다른 커널 계열입니다. 일부 설정 개념을 공유하지만 지원 기능과 필드 동작이 완전히 같다고 볼 수는 없습니다.

설정을 받았다면 먼저 필요한 프로토콜과 전송 기능을 확인한 뒤 클라이언트에 내장되었거나 선택한 커널이 이를 지원하는지 살펴보세요. VMess, VLESS, Trojan, Shadowsocks는 프로토콜 이름이며 전송 방식, TLS, 보안 매개변수, 도메인 설정은 별개의 항목입니다. 프로토콜 이름이 같다는 이유만으로 전체 설정을 그대로 옮길 수 있는 것은 아닙니다.

클라이언트 3종의 오픈 소스 라이선스

v2rayN, v2rayNG, v2flyNG는 모두 오픈 소스 GUI 클라이언트입니다. v2rayN은 데스크톱용으로 설정 목록, 구독, 프록시 메뉴를 제공합니다. v2rayNG는 안드로이드용이며 Xray 커널 기능과 VPN 연결, 앱별 설정을 지원합니다. v2flyNG는 v2fly 커널이 필요한 안드로이드 사용자를 위한 대안입니다. 이 사이트는 세 클라이언트의 다운로드 경로와 가이드를 안내하며 커널 프로그램과 GUI 설치 파일을 구분합니다.

오픈 소스 라이선스는 코드의 사용, 수정, 재배포 조건을 정하며 구독 출처와 서버 관리자, 기기 권한을 판단하는 절차를 대신하지 않습니다. 클라이언트 인터페이스와 커널, 각 의존성은 서로 다른 라이선스를 사용할 수 있으므로 배포나 2차 개발 전 해당 라이선스를 각각 확인하세요. 일상적으로 사용할 때는 설정에 포함된 서버 주소와 인증 정보, 인증서 매개변수를 이해하고 출처를 알 수 없거나 설명할 수 없는 사용자 설정 전체를 가져오지 마세요.

업데이트와 설정 이전

GUI 클라이언트 업데이트, 커널 업데이트, 구독 업데이트는 서로 다른 작업입니다. 클라이언트 업데이트는 메뉴와 설정 생성 방식에 영향을 줄 수 있고, 커널 업데이트는 프로토콜 지원이나 필드 요구 사항을 바꿀 수 있습니다. 구독 업데이트는 서비스 제공자가 공개한 설정을 다시 가져오는 작업입니다. 노드 목록이 바뀌었다고 클라이언트가 업데이트된 것은 아니며, 새 옵션이 생겼다고 현재 구독에서 사용할 수 있다는 뜻도 아닙니다.

업데이트 전에 작동 모드, 그룹 메모, 사용자 지정 라우팅, DNS 선택을 기록하고 클라이언트의 내보내기 또는 백업 기능으로 필요한 설정을 저장하세요. 설정을 복원할 때는 기본 연결부터 확인하고 고급 옵션을 하나씩 되살리세요. 클라이언트 간 이전은 양쪽에서 지원하는 공유 형식을 우선 사용하세요. 전체 설정 파일과 인터페이스 환경설정, 로컬 그룹 데이터가 서로 호환된다고 단정할 수 없습니다.

한국어 가이드의 적용 범위

이 사이트는 다운로드 경로와 사용 방법을 정리한 안내 사이트이며 Project V, V2Fly, Xray의 공식 배포처가 아니고 구독 회선을 제공하지도 않습니다. 문서에서는 일반적으로 사용되는 메뉴 이름을 기준으로 설명하며 실제 옵션은 설치된 클라이언트 버전에 따라 달라질 수 있습니다. 시스템 권한, 회사 네트워크 또는 업무용 기기를 다룰 때는 기기 관리 규정을 따르고 해당 지역의 법률과 관련 서비스 약관에 부합하는 방식으로 사용하세요.

TUN, FakeDNS, 여러 구독 관리, 사용자 지정 아웃바운드를 설정해야 한다면 먼저 연결 가능한 기본 설정을 백업한 뒤 고급 가이드를 살펴보세요. 복잡한 설정은 스위치를 더 많이 켜기 위해서가 아니라 명확한 요구를 충족할 때 의미가 있습니다. 문제가 생기면 '작동하지 않음'이라는 설명보다 로그에 나타난 오류 단계가 더 도움이 됩니다. 로그를 공유하기 전 구독 주소와 계정 정보, 개인 네트워크 정보를 삭제하세요.

고급 설정 가이드 보기 →

클라이언트 사용 팁

구체적인 메뉴와 오류 증상에서 출발해 단계별로 확인할 수 있는 해결 과정을 정리했습니다. 설치, 구독, 핸드셰이크, 트래픽 연결 중 문제가 발생한 단계를 먼저 파악한 뒤 관련 문서를 확인하세요. 서로 다른 단계의 문제를 한꺼번에 조정하지 않는 것이 좋습니다.