오픈소스 클라이언트 · 한국어 설정 가이드

V2Ray 커뮤니티 v2rayN 다운로드

클라이언트 선택부터 구독 가져오기와 라우팅 분기까지, 운영체제에 맞는 설치 파일을 찾고 동일한 점검 순서로 트래픽 경로를 확인하세요.

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

01 주요 설정

V2Ray 클라이언트 주요 기능

구독은 설정을 가져오고, 시스템 프록시나 TUN은 트래픽을 클라이언트로 전달하며, 라우팅은 트래픽의 목적지를 정합니다. 주요 설정을 하나씩 살펴보세요.

구독 URL과 단일 공유 링크

구독 URL은 서비스 제공자가 설정 목록을 가져오고 갱신하도록 제공하는 주소입니다. 단일 공유 링크에는 보통 연결 설정 하나만 담깁니다. v2rayN에서는 먼저 구독 그룹을 알아보기 쉬운 이름으로 지정하고 주소를 저장한 다음 해당 그룹을 갱신하세요. 항목을 하나씩 붙여 넣는 것보다 그룹 단위로 관리하면 설정의 출처를 파악하기 쉽고, 임시 테스트용 연결이 평소 사용하는 목록에 섞이는 일도 줄일 수 있습니다. 갱신 후 목록에 항목이 표시되는지 확인하고 연결 하나를 선택하세요. 가져오기에 성공했다고 연결까지 되는 것은 아닙니다.

  • 구독 URL을 바꾸기 전에 수정할 그룹이 맞는지 확인하세요.
  • 스크린샷을 공유할 때는 전체 URL을 가리세요. 경로 자체가 인증에 사용될 수도 있습니다.
구독 URL 예시 · 도메인만 표시, 사용할 수 없음
https://example.invalid/list

vmess:// 또는 vless://로 시작하는 단일 링크를 받았다면 공유 링크 가져오기 기능을 사용하세요.

02 설치 파일 선택

운영체제에 맞는 클라이언트 다운로드

먼저 운영체제를 확인하고, 이어서 칩이나 패키지 형식을 확인하세요. 앱 이름이 같아도 기기마다 같은 설치 파일을 사용할 수 있는 것은 아닙니다.

Windows

데스크톱 버전과 클래식 WPF 버전은 모두 v2rayN입니다. 처음 설치한다면 데스크톱 버전부터 살펴보세요. 기존 안내가 클래식 인터페이스를 기준으로 하거나 이전 메뉴에 익숙하다면 WPF 버전을 확인하면 됩니다. 설치 파일을 고르기 전에 시스템의 ‘정보’ 페이지에서 시스템 유형을 확인하고, 운영체제 이름만으로 아키텍처를 추측하지 마세요.

압축 파일을 받았다면 현재 계정에서 쓸 수 있는 폴더에 먼저 완전히 압축을 푼 뒤 실행하세요. 압축 프로그램의 미리보기에서 바로 실행하면 메인 프로그램만 실행되고 주변 파일이 누락될 수 있습니다. 기존 설정이 있다면 먼저 백업한 다음 다른 폴더에서 실행해 보세요. 구독과 라우팅 설정이 그대로 있는지 확인한 뒤 이전 폴더를 정리하세요.

다운로드 페이지로 이동

macOS

Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple 칩이라고 표시되면 Apple Silicon 패키지를, Intel 프로세서라고 표시되면 Intel 패키지를 선택하세요. v2rayN을 다운로드한 뒤 디스크 이미지의 안내에 따라 설치하고 응용 프로그램 폴더에서 실행하세요. 마운트한 디스크 이미지를 장기간 실행 경로로 사용하지 마세요.

시스템이 실행을 차단하면 안내가 호환성, 출처, 권한 중 어떤 문제를 가리키는지 먼저 확인하세요. 특정 앱 하나 때문에 기기 전체의 보호 기능을 끄지 마세요. 메뉴 막대에서 앱이 보인다고 시스템 프록시가 적용된 것은 아닙니다. 클라이언트에서 설정을 전환한 뒤 시스템 프록시를 따르는 앱으로 테스트하고, 터미널에는 별도 설정이 필요한지 확인하세요.

다운로드 페이지로 이동

Android

Xray 코어가 필요하면 v2rayNG를 확인하고, V2Fly 구현을 명시적으로 요구하는 경우에는 v2flyNG를 고려하세요. 최근 기기 대부분은 arm64를 선택할 수 있습니다. 기기의 아키텍처가 확실하지 않다면 범용 패키지를 확인하세요. 범용 패키지는 설치 아키텍처 문제를 해결할 뿐, 다른 코어가 지원하지 않는 프로토콜 조합까지 지원하게 하지는 않습니다.

브라우저나 파일 관리자에서 설치 파일을 열면 설치 권한은 보통 해당 출처에 부여되며, 설치 후에는 권한을 회수할 수 있습니다. 처음 연결할 때 시스템에서 VPN 권한을 요청할 수 있습니다. 이미 다른 앱이 해당 연결을 사용 중이라면 먼저 연결을 끊고 테스트하세요. 가져오기 과정에서는 구독 그룹 전체와 단일 공유 링크를 구분해야 합니다.

다운로드 페이지로 이동

Linux

v2rayN을 선택했다면 먼저 배포판에서 주로 사용하는 패키지 형식을 확인하세요. Debian·Ubuntu 계열은 보통 deb, Fedora 계열은 보통 rpm을 사용합니다. 그다음 x64와 arm64 중 맞는 패키지를 고르세요. 두 조건이 모두 맞는지 확인한 뒤 설치하고, 아키텍처 불일치와 실행 종속성 누락을 같은 문제로 취급하지 마세요.

데스크톱 환경의 프록시 설정이 터미널이나 백그라운드 서비스에 전달되지 않을 수 있습니다. 브라우저는 되는데 명령줄에서 시간 초과가 발생한다면 로컬 수신 주소와 포트, 명령줄 도구가 지원하는 프록시 유형, 현재 프로세스에 프록시 환경 변수가 전달됐는지 먼저 확인하세요. 이 부분을 확인한 뒤 클라이언트의 라우팅과 아웃바운드를 살펴보세요.

다운로드 페이지로 이동

03 프로젝트와 코어

Project V 오픈소스 생태계

가이드에서 설명하는 대상이 클라이언트인지, 코어인지, 서버인지 먼저 구분하세요. 세 계층을 이해해야 안내된 방법이 현재 기기에 맞는지 판단할 수 있습니다.

조작 인터페이스부터 연결 처리까지
  1. 클라이언트설정을 가져오고 편집한 뒤 사용할 항목을 선택
  2. 코어인바운드 연결을 받고 규칙에 따라 아웃바운드 선택
  3. 연결 대상매칭 결과에 따라 직접 연결하거나 프록시 아웃바운드로 전달
  1. Project V: 클라이언트와 코어는 왜 분리되어 있을까

    Project V는 이 도구들을 이해하는 출발점입니다. 초기 V2Ray는 인바운드, 아웃바운드, 라우팅을 조합 가능한 설정으로 분리하는 데 중점을 뒀습니다. 인바운드는 연결을 받고, 아웃바운드는 연결을 내보내며, 라우팅은 여러 아웃바운드 중 하나를 선택합니다. 덕분에 연결을 시작하는 앱, 트래픽을 전달하는 코어, 설정을 다루는 그래픽 인터페이스를 하나의 프로그램에 모두 넣을 필요가 없습니다. 이후 커뮤니티에서 나온 데스크톱 및 모바일 클라이언트는 이러한 역할 분담을 바탕으로 더 편리한 조작 환경을 제공합니다.

    이런 배경을 알면 문제 해결에 도움이 됩니다. 예를 들어 클라이언트에 구독 항목이 보인다는 것은 인터페이스에서 데이터를 확인할 수 있다는 뜻일 뿐입니다. 설정을 불러올 수 있는지는 코어의 시작 결과를 확인해야 하고, 특정 앱이 코어를 거치는지는 트래픽이 들어오는 경로를 확인해야 합니다. 이 세 가지를 혼동하면 네트워크 문제 때 구독을 반복해서 가져오면서도 앱이 프록시를 사용하지 않는 사실을 놓치기 쉽습니다.

  2. V2Fly와 Xray: 공통 기반에서 각자의 발전으로

    V2Fly 커뮤니티는 V2Ray 코어의 개발과 유지보수를 이어왔습니다. Xray는 이 코드 기반에서 분리된 뒤 독자적으로 발전했습니다. 두 프로젝트는 설정 개념이 비슷하고 일부 프로토콜과 필드도 같아 보이지만, 같은 기반에서 출발했다는 사실만으로 호환성이 보장되지는 않습니다. 특히 새로운 전송 방식이나 보안 계층 옵션은 한쪽에서 읽을 수 있는 매개변수 조합을 다른 쪽에서 같은 방식으로 처리하지 않을 수 있습니다. 판단할 때는 서버에서 요구하는 항목을 먼저 확인하고 현재 클라이언트가 어떤 코어를 사용하는지 살펴보세요.

    기기를 바꿀 때 기존 설정 전체를 그대로 옮길 수 있다고 가정하지 마세요. 개별 연결에 필요한 매개변수, 클라이언트에 저장된 구독 그룹, 로컬 수신 포트와 시스템 프록시 설정은 서로 다른 계층입니다. 먼저 연결 항목을 옮겨 새 기기에서 하나를 테스트한 뒤 라우팅 규칙을 하나씩 추가하세요. 연결에 실패하더라도 매개변수 비호환 문제인지 새 기기의 로컬 설정이 아직 끝나지 않은 문제인지 구분하기 쉬워집니다.

  3. 오픈소스 라이선스와 프록시 프로토콜은 다릅니다

    VMess와 VLESS는 통신하는 양측이 데이터를 주고받는 방식을 설명하고, 오픈소스 라이선스는 코드를 사용·수정·재배포하는 조건을 정합니다. 두 종류의 문서는 서로 다른 문제를 다룹니다. V2Fly 코어는 MIT 라이선스를, Xray-core는 Mozilla Public License 2.0을 사용합니다. MIT 라이선스는 재배포 조건이 비교적 간단하지만 관련 저작권 및 라이선스 고지를 보존해야 합니다. MPL 2.0의 의무는 주로 라이선스가 적용되는 파일에 해당하며, 해당 파일을 수정해 배포할 때는 조건에 따라 관련 소스 코드를 제공해야 합니다.

    구성 요소는 각각 관리되므로 라이선스도 따로 확인해야 합니다. 그래픽 클라이언트, 함께 포함된 코어, 기타 구성 요소를 설치 파일 이름만 보고 같은 조건으로 묶을 수는 없습니다. 일반 사용자가 클라이언트를 설정하기 전에 라이선스 문서를 전부 읽을 필요는 없습니다. 다만 재패키징, 수정, 파생 버전 배포를 계획한다면 각 구성 요소에 포함된 라이선스를 하나씩 확인하세요. 프록시 서비스의 계정, 요금제, 이용 조건은 서비스 제공자가 정하며 오픈소스 라이선스에 포함되지 않습니다.

  4. 세 가지 클라이언트와 설정 요구사항

    v2rayN은 구독 그룹, 연결 선택, 라우팅, 시스템 프록시를 한 화면에서 관리하는 오픈소스 데스크톱 클라이언트입니다. 여러 설정 그룹을 관리하거나 앱별로 문제를 확인할 때 유용합니다. v2rayNG는 Xray를 사용하는 오픈소스 Android 클라이언트이며 v2flyNG도 오픈소스이고 V2Fly 코어를 사용합니다. 이름이 비슷하다고 모바일 기기에 두 앱을 모두 설치할 필요는 없습니다. 서버 매개변수와 클라이언트의 지원 범위에 맞춰 하나를 고르고 기본 연결을 확인한 다음 설정 차이를 비교하세요.

    문제를 설명할 때는 ‘연결 실패’ 화면만 올리는 것보다 앱 이름, 코어, 오류가 발생한 단계를 함께 적는 편이 도움이 됩니다. 구독 갱신 중 데이터를 가져오지 못했는지, 항목을 선택한 뒤 코어에서 오류가 났는지, 아니면 특정 터미널 도구만 프록시를 거치지 않는지 구체적으로 확인하세요. 경우마다 점검 위치가 다릅니다. 로그를 공유할 때는 시간, 재현 단계, 오류 유형을 남기고 구독 URL, 계정 정보, 공개하면 안 되는 서버 매개변수는 가리세요.

  5. 클라이언트 업데이트, 코어 업데이트, 구독 갱신

    클라이언트 업데이트는 메뉴 배치, 설치 방식, 설정 저장 위치를 바꿀 수 있습니다. 코어 업데이트는 지원 필드와 시작 동작에 영향을 줄 수 있고, 구독 갱신은 제공자에게서 최신 항목을 다시 가져오는 작업입니다. 서로를 대신할 수는 없습니다. 업데이트 전에 선택된 항목, 코어, 라우팅 모드, 로컬 수신 포트를 기록하고 필요한 사용자 지정 규칙은 따로 백업하세요. 한 번에 한 계층만 변경하고 같은 앱과 대상으로 다시 테스트해야 어떤 변경이 영향을 줬는지 알 수 있습니다.

    업데이트 후 모든 앱이 동시에 연결되지 않으면 코어가 실행 중인지, 인바운드가 수신 대기 중인지 먼저 확인하세요. 한 앱만 문제가 있다면 해당 앱의 자체 연결 설정을 살펴보세요. 구독 갱신 후 항목이 줄었다면 로컬 수동 설정을 바로 덮어쓰지 말고, 어느 그룹을 갱신했는지와 제공자가 실제로 항목을 삭제했는지 먼저 확인하세요. 단계별 설정은 전체 플랫폼 가이드를 참고하세요. 연결은 되지만 트래픽 경로가 잘못됐다면 도움말 센터에서 라우팅과 프록시 문제를 확인하세요.

04 기술 노트

시스템 프록시·라우팅·구독 문제 해결

구체적인 증상에 따라 점검 위치를 찾아보세요. 터미널이 연결되지 않는 문제, 트래픽이 잘못된 아웃바운드로 가는 문제, 여러 구독 그룹을 정리하기 어려운 문제는 각각 원인이 다릅니다.

v2rayN 시스템 프록시가 작동하지 않을 때: 브라우저는 되는데 터미널은 프록시를 사용하지 않는다면

브라우저와 터미널을 나눠 확인하세요. 시스템 프록시가 설정됐는지, 브라우저 확장 프로그램이 프록시를 가로채는지 살펴본 뒤 터미널 환경 변수와 로컬 포트를 점검해 v2rayN 시스템 프록시가 작동하지 않는 원인을 찾습니다.

클라이언트를 바로 재설치하지 마세요. 브라우저 확장 프로그램, 시스템 프록시, 터미널 매개변수가 각각 다른 경로를 가리킬 수 있습니다. 프로그램이 실제로 어느 포트에 연결했는지 확인한 뒤에야 전달 경로를 점검할 필요가 있습니다. 연결이 클라이언트에 들어오지 않는다고 확인됐다면 아웃바운드나 라우팅을 바꿔도 해결되지 않습니다.