CLIENT WORKBENCH / 설치 파일 선택
v2rayN 데스크톱 클라이언트 · v2rayNG 및 v2flyNG Android 클라이언트
운영체제를 먼저 선택한 다음 아키텍처를 확인하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 권장합니다. 설치 파일은 프로그램을 설치하는 용도이며 구독과 프록시 설정은 이후에 진행합니다.
플랫폼 탭은 방향키로 전환할 수 있습니다. 링크에 포함된 플랫폼 앵커를 이용하면 해당 목록을 바로 열 수 있습니다.
DESKTOP / x64
v2rayN 데스크톱 버전 다운로드차세대 크로스 플랫폼 UI입니다. 처음 설치한다면 Desktop 버전부터 시작해 보세요. 데스크톱 운영체제 간에도 인터페이스 사용 방식이 비슷해 적응하기 쉽습니다. 이 링크는 x64 설치 압축 파일을 제공합니다. 다운로드한 뒤 압축을 풀고 내부의 설치 프로그램을 실행하세요.
CLASSIC WPF / x64
v2rayN 클래식 WPF 버전 다운로드안정적인 클래식 버전으로 Windows WPF 인터페이스를 사용합니다. 서버 목록, 트레이 메뉴, 기존 설정 위치에 익숙하다면 이 버전을 계속 사용할 수 있습니다. 별도의 프록시 소프트웨어가 아니라 인터페이스 기술과 사용 방식에 차이가 있는 v2rayN 버전입니다.
두 링크 모두 v2rayN 버전입니다. 먼저 하나를 설치하고, UI 버전을 바꾸기 전에는 구독 그룹과 라우팅 설정을 백업하세요.
| 확인 항목 | 선택 및 준비 |
|---|---|
| 운영체제 및 아키텍처 | 시스템 업데이트가 계속 제공되는 Windows 10 또는 11을 권장합니다. 이 페이지의 두 설치 파일은 모두 x64입니다. 「설정 → 시스템 → 정보」에서 시스템 종류를 확인하세요. |
| 설치 파일 형식 | ZIP 압축 파일입니다. 쓰기 가능한 로컬 폴더에 압축을 푼 다음 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. |
| 실행 환경 | .NET 런타임이 별도로 필요한지는 현재 배포 패키지와 시작 시 안내를 확인하세요. 필요한 경우 아키텍처와 종류가 일치하는 런타임을 설치하세요. |
| 프록시 권한 | 일반 시스템 프록시는 일반 사용자 권한으로 실행하세요. TUN을 활성화하면 관리자 권한과 가상 네트워크 인터페이스 지원이 필요할 수 있습니다. |
파일 이름에 Setup이 있어도 전체 파일은 ZIP일 수 있습니다. 먼저 압축을 풀고 설치 프로그램과 함께 제공된 파일을 같은 폴더에 둔 다음 안내에 따라 설치하세요. 경로는 짧게 유지하고 작업 폴더를 읽기 전용 위치, 동기화 프로그램이 사용 중인 폴더, 추가 권한이 필요한 위치에 두지 않는 것이 좋습니다. 시작에 실패하면 먼저 오류 메시지를 확인하세요. 런타임, 권한, 설정 손상은 서로 다른 문제이므로 재설치 전에 원인을 구분해야 합니다.
v2rayN을 실행하고 「구독 그룹 설정」에서 새 그룹을 추가한 뒤 본인의 구독 주소를 입력하고 저장하세요. 그런 다음 「구독 업데이트」를 눌러 노드를 가져옵니다. 사용할 서버를 선택하고 클라이언트가 실행 중인지 확인한 다음 시스템 프록시 메뉴에서 「시스템 프록시 자동 설정」을 선택하세요. 시스템 프록시는 앱의 연결 지점이고 라우팅은 트래픽의 경로를 정하므로 서로 다른 설정입니다.
이전 버전에서 옮기는 경우 기존 클라이언트를 먼저 종료해 두 프로그램이 같은 로컬 포트를 차지하지 않도록 하세요. 구독 주소는 대개 다시 업데이트할 수 있지만 수동 노드, 사용자 지정 라우팅, DNS 설정은 별도로 보관해야 합니다. 먼저 일반 시스템 프록시로 연결한 뒤 TUN을 시도하세요. 기본 연결부터 되지 않는 상태에서 가상 네트워크 어댑터를 추가하면 문제 해결이 더 복잡해집니다.
Windows 전체 설치 및 설정 안내 보기 →
APPLE SILICON / arm64
Apple Silicon 버전 다운로드Apple Silicon 칩이 탑재된 컴퓨터라면 이 링크를 선택하세요. arm64는 칩 아키텍처를 가리키며 운영체제 버전 번호가 아닙니다. Apple 메뉴의 「이 Mac에 관하여」에서 「칩」 항목을 확인하고 Apple M 시리즈로 표시되면 이 패키지를 선택하세요.
INTEL / x64
Intel 버전 다운로드Intel 프로세서가 탑재된 컴퓨터에는 x64 패키지를 선택하세요. 「이 Mac에 관하여」에 Intel 프로세서라고 표시되면 이 항목을 선택하면 됩니다. 컴퓨터 외관이나 구매 연도로 아키텍처를 추측하지 마세요. 칩 이름을 확인하면 재설치할 필요가 없습니다.
| 확인 항목 | 선택 및 준비 |
|---|---|
| 프로세서 | Apple Silicon은 arm64, Intel은 x64를 선택하세요. 「이 Mac에 관하여」에서 확인할 수 있습니다. |
| 시스템 호환성 | 시스템 업데이트가 계속 제공되는 macOS를 사용하세요. 정확한 최소 버전은 현재 앱의 배포 요구 사항과 시스템 설치 안내를 확인하세요. |
| 설치 파일 형식 | DMG 디스크 이미지입니다. 이미지를 연 뒤 앱을 「응용 프로그램」으로 복사하고 로컬 앱 폴더에서 실행하세요. |
| 네트워크 권한 | 시스템 프록시 설정이나 TUN 활성화 시 시스템에 표시되는 권한 요청을 따르세요. 앱을 일반적으로 실행했다고 해서 네트워크가 자동으로 프록시를 통과하는 것은 아닙니다. |
DMG를 다운로드한 뒤 브라우저에서 저장이 완료될 때까지 기다린 다음 디스크 이미지를 여세요. v2rayN을 「응용 프로그램」으로 복사하고 마운트된 이미지 안에서 계속 실행하지 마세요. 복사가 끝나고 로컬 앱이 실행되는 것을 확인한 뒤 이미지를 추출할 수 있습니다. 시스템에서 실행을 차단하면 먼저 그 이유를 읽고 「시스템 설정 → 개인정보 보호 및 보안」에서 관련 기록을 확인하세요. 보안 검사를 전부 끄는 것으로 문제를 대신 해결하지 마세요.
처음 실행하면 구독을 가져와 노드를 업데이트한 뒤 서버를 선택하세요. 시스템 프록시를 켠 다음 「시스템 설정 → 네트워크」에서 현재 네트워크 서비스의 프록시 설정을 확인하면 클라이언트가 연결 지점을 설정했는지 확인하는 데 도움이 됩니다. Wi-Fi, 유선 네트워크 또는 회사 네트워크를 바꾼 뒤에는 프록시 상태를 다시 점검해야 할 수 있습니다. 브라우저에서 인터넷이 된다고 해서 모든 터미널 프로그램도 시스템 프록시를 사용하는 것은 아닙니다.
TUN을 사용하려면 먼저 정상 작동하는 기본 설정을 저장한 다음 앱 안내에 따라 권한을 요청하세요. 연결에 문제가 생기면 노드, DNS, 라우팅을 한꺼번에 바꾸지 말고 새로 켠 모드를 끄고 기본 설정으로 돌아가세요. 앱을 종료하기 전에는 프록시를 끄세요. 특히 새 버전을 설치하거나 클라이언트를 바꿀 때는 앱이 종료된 뒤에도 시스템 프록시가 응답하지 않는 로컬 포트를 가리키지 않도록 주의하세요.
macOS 전체 설치 및 설정 안내 보기 →
Xray 코어 · 구독 그룹 · VPN 모드
arm64-v8a / 주요 아키텍처
v2rayNG arm64 다운로드2015년 이후 출시된 일반적인 스마트폰은 보통 arm64를 먼저 선택하면 됩니다. 이 패키지에는 해당 아키텍처용 구성 요소만 포함되어 있으므로 64비트 앱을 지원하는 기기에 적합합니다. 최종 선택은 기기의 실제 실행 환경을 기준으로 하세요. 프로세서가 64비트를 지원해도 시스템에서 같은 앱 아키텍처를 지원하지 않을 수 있습니다.
UNIVERSAL / 다중 아키텍처 패키지
v2rayNG 범용 버전 다운로드앱 아키텍처를 확인하기 어렵다면 범용 버전을 선택하세요. 여러 아키텍처용 구성 요소를 포함하므로 단일 아키텍처 패키지보다 용량이 큰 편입니다. 범용 버전은 아키텍처 선택을 편리하게 해 주지만 앱의 최소 시스템 버전 요구 사항을 낮추지는 않습니다.
v2fly 코어 · 설정 호환성에 따라 선택
arm64-v8a / 주요 아키텍처
v2flyNG arm64 다운로드v2fly 코어가 필요하고 기기에서 arm64 앱을 지원하는 경우 적합합니다. 기존 설정이 같은 코어 생태계를 기반으로 한다면 대체 클라이언트로 사용할 수 있습니다. 프로토콜과 전송 방식은 서버 설정과 일치해야 하며, 코어 이름만으로 설정 호환성을 판단할 수는 없습니다.
UNIVERSAL / 다중 아키텍처 패키지
v2flyNG 범용 버전 다운로드아키텍처를 모른다면 범용 패키지를 선택하세요. v2flyNG와 v2rayNG는 서로 다른 앱이므로 설정과 권한도 각각 지정해야 합니다. 전환을 테스트할 때는 다른 클라이언트의 연결을 먼저 중지하고 한 번에 하나의 앱만 VPN을 제어하도록 하세요.
| 확인 항목 | 선택 및 준비 |
|---|---|
| 앱 아키텍처 | 일반적인 기기는 arm64를 우선 선택하고, 아키텍처를 확인할 수 없다면 범용 버전을 선택하세요. 설치 프로그램에서 아키텍처가 호환되지 않는다고 표시되면 시스템이 실제로 지원하는 아키텍처를 다시 확인하세요. |
| 시스템 버전 | 최소 시스템 요구 사항은 클라이언트 배포 버전에 따라 달라집니다. 설치 프로그램의 안내를 확인하세요. 범용 버전도 최소 시스템 요구 사항을 낮추지는 않습니다. |
| 설치 권한 | APK를 설치하려면 현재 브라우저나 파일 관리자에 「알 수 없는 앱 설치」 권한을 허용해야 합니다. 설치가 끝나면 해당 앱의 설치 권한을 해제할 수 있습니다. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 권한을 승인해야 합니다. 백그라운드에서 계속 실행하려면 배터리 설정에서 해당 앱의 제한을 완화해야 할 수 있습니다. |
다운로드한 APK를 열고 시스템 안내에 따라 현재 파일을 연 앱에 설치 권한을 허용하세요. 여기서 ‘앱’은 브라우저나 파일 관리자처럼 파일을 연 프로그램을 말합니다. 휴대폰 전체의 보안 설정을 모두 변경할 필요는 없습니다. 설치 프로그램에 「앱이 설치되지 않았습니다」라고 표시되면 먼저 전체 오류 내용을 확인한 뒤 아키텍처, 저장 공간, 시스템 버전, 기존 앱의 서명을 점검하세요. 모든 실패를 다운로드 파일 탓으로 돌리지 마세요.
v2rayNG의 「구독 그룹 설정」에 구독 주소를 저장하고 메인 화면으로 돌아와 「구독 업데이트」를 실행하세요. 단일 공유 링크를 받았다면 「클립보드에서 가져오기」를 사용하고 구독 주소 입력란에 넣지 마세요. 가져온 뒤 노드를 선택하고 연결 버튼을 누른 다음 VPN 권한을 승인하세요. VPN 모드는 앱 트래픽이 클라이언트로 들어가는 경로를 제공하며, 직접 연결할지 프록시를 사용할지는 라우팅 설정에 따라 달라집니다.
백그라운드에서 연결이 끊기면 먼저 시스템 배터리 정책이 앱을 중지했는지 확인한 다음 노드 로그를 살펴보세요. 해당 클라이언트의 백그라운드 권한만 조정하면 되며 모든 앱의 제한을 완화할 필요는 없습니다. v2rayNG는 Xray 코어를, v2flyNG는 v2fly 코어를 사용합니다. 두 앱은 지원하는 설정 세부 사항, 특히 특정 프로토콜과 전송 방식 조합에서 차이가 날 수 있습니다. 사용 중인 서비스 설정에 Xray 기능이 명시되어 있다면 v2rayNG를 계속 사용하는 것이 좋습니다.
v2rayNG 구독 가져오기 및 첫 연결 안내 보기 →
DEB / x64
v2rayN DEB 패키지 다운로드Ubuntu, Debian 등 DEB 패키지 관리 체계를 사용하는 x64 데스크톱에서 선택하세요. 파일 이름의 amd64는 일반적으로 x86_64와 같은 아키텍처를 가리키며 특정 프로세서 브랜드에 한정되지 않습니다. 설치할 때는 시스템 소프트웨어 설치 프로그램을 이용해 의존성을 처리하세요.
RPM / x64
v2rayN RPM 패키지 다운로드Fedora, openSUSE 등 RPM 체계를 사용하는 x64 데스크톱에서는 이 링크를 선택하세요. 같은 패키지 형식을 사용해도 배포판별 의존성이 모두 같지는 않습니다. 설치 프로그램에서 라이브러리 누락이나 패키지 버전 충돌이 표시되면 해당 배포판에 맞게 해결하세요.
ARM64 데스크톱은 아래에서 해당 패키지를 선택하세요. 위의 x64 파일을 설치하지 마세요:
| 확인 항목 | 선택 및 준비 |
|---|---|
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 Linux 데스크톱 세션이 필요합니다. 이 페이지에서 제공하는 것은 그래픽 클라이언트이며 서버 배포 패키지가 아닙니다. |
| 프로세서 아키텍처 | x86_64 / amd64는 x64를, aarch64 / arm64는 ARM64를 선택하세요. 시스템의 「정보」 또는 하드웨어 정보 화면에서 확인할 수 있습니다. |
| 패키지 관리 체계 | Ubuntu와 Debian은 deb를, Fedora와 openSUSE 등 RPM 계열 배포판은 rpm을 선택하세요. 현재 배포판과의 의존성 호환성도 확인해야 합니다. |
| 권한 및 의존성 | 소프트웨어 패키지를 설치하려면 관리자 권한이 필요합니다. 일반적으로 그래픽 UI는 일반 사용자로 실행하고 TUN은 안내에 따라 별도로 권한을 부여하세요. |
Linux 패키지를 선택할 때는 두 가지를 확인하세요. 먼저 패키지 관리 체계, 다음으로 프로세서 아키텍처를 확인합니다. DEB와 RPM은 설치 형식이고 x64와 ARM64는 실행 아키텍처이므로 서로 대체할 수 없습니다. 파일 확장자를 바꿔도 패키지 형식이 변환되지는 않습니다. 설치 파일을 두 번 클릭해 시스템 소프트웨어 설치 프로그램으로 열고 의존성 안내를 확인한 뒤 설치하세요. 설치 프로그램에서 배포판이 호환되지 않는다고 명확히 표시하면 중단하고 의존성 경고를 무시하지 마세요.
설치가 끝나면 앱 메뉴에서 v2rayN을 실행하고 구독 그룹을 추가한 뒤 노드를 업데이트하세요. Linux 데스크톱에서 시스템 프록시가 적용되는지는 데스크톱 환경과 앱에 따라 다릅니다. 브라우저는 데스크톱 프록시 설정을 읽을 수 있지만 명령줄 도구는 그렇지 않을 수 있습니다. 먼저 시스템 프록시를 지원하는 앱으로 테스트한 다음 다른 프로그램의 프록시 연결 방식을 확인하세요. 노드는 정상인데 앱이 프록시를 사용하지 않는 경우와 노드 연결 자체가 안 되는 경우를 구분해 기록하세요.
로그인할 때 자동으로 실행하려면 데스크톱 환경의 「시작 프로그램」 또는 비슷한 설정에 v2rayN을 추가하세요. 로그인 시 자동 실행과 시스템 부팅 시 서비스 실행은 다릅니다. 그래픽 클라이언트는 사용자 세션이 준비된 다음 실행해야 합니다. 업데이트 전에는 앱을 정상 종료하고 개인 설정을 보관하세요. TUN을 켠 뒤 네트워크 문제가 생기면 일반 프록시 방식으로 되돌린 다음 권한, 인터페이스, 라우팅을 확인하세요.
Linux 데스크톱 설치 및 자동 시작 안내 보기 →다운로드는 첫 단계일 뿐입니다. 클라이언트, 구독, 트래픽 진입점, 라우팅은 각각 다른 역할을 하므로 순서대로 설정하면 문제를 찾기 쉽습니다. 먼저 가장 단순한 연결부터 확인하고 분할 라우팅, DNS, TUN을 차례로 추가하세요. 한 번에 하나씩 설정을 바꾸면 로그를 비교하기 쉽습니다.
01 / 설정 가져오기
업데이트 가능한 구독 주소인지, vmess:// 또는 vless:// 등으로 시작하는 단일 노드 링크인지 확인하세요. 구독 주소는 「구독 그룹 설정」에 입력하고 공유 링크는 클립보드에서 가져오기를 사용하세요. 웹페이지 주소, 로그인 페이지 주소, 구독 주소가 서로 다를 수 있으니 가져오기 전에 서비스 안내를 확인하세요.
02 / 프록시 연결
데스크톱에서는 시스템 프록시를 활성화하고 Android에서는 VPN 권한을 승인하세요. 노드가 목록에 표시되는 것은 가져오기가 끝났다는 뜻일 뿐입니다. 프로그램을 실행하고 앱 트래픽이 클라이언트로 들어와야 연결을 테스트할 수 있습니다. 포트 사용, 시스템 프록시 설정 덮어쓰기, VPN 충돌을 막으려면 다른 프록시 프로그램은 먼저 종료하세요.
03 / 연결 확인
평소 사용하는 브라우저로 테스트할 사이트에 접속하고 클라이언트 로그에 연결 기록이 나타나는지 확인하세요. 접속에 성공한 다음 적절한 라우팅 모드를 선택하면 됩니다. 시스템 프록시와 「LAN 및 중국 본토 주소 우회」 같은 라우팅 옵션은 서로 다른 계층입니다. 라우팅을 바꿔도 빠뜨린 시스템 프록시 설정이 자동으로 추가되지는 않습니다.
다운로드 목록은 버전이 업데이트될 때마다 바뀌며 데스크톱과 Android 클라이언트는 각각 별도로 관리되므로 버전 숫자를 일치시킬 필요는 없습니다. 현재 필요한 기능과 릴리스 변경 사항을 고려해 업데이트 여부를 결정하세요. 기존 설정이 정상 작동한다면 업데이트 전에 백업하세요. 문제가 생겼을 때는 반복해서 재설치하기보다 업그레이드 전후의 차이를 기록하는 것이 도움이 됩니다. 전체 절차는 사용 안내에서, 플랫폼별 내용은 전체 플랫폼 설치 및 설정 문서에서 확인하세요.
설정을 바꾸기 전에 설치 문제인지 연결 문제인지 먼저 구분하세요.
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 Desktop 버전을 먼저 선택하세요. 기존 Windows 인터페이스와 사용 방식에 익숙하다면 WPF 버전을 선택하면 됩니다. 두 버전 모두 v2rayN입니다. 다운로드 전에 패키지 이름을 확인하고, 버전을 바꾸기 전에는 설정을 백업하세요. 두 클라이언트가 동시에 시스템 프록시를 제어하지 않도록 주의하세요.
2015년 이후 출시된 일반적인 스마트폰은 보통 arm64를 먼저 선택하면 됩니다. 단, 기기에서 실제로 지원하는 앱 아키텍처를 기준으로 확인하세요. 아키텍처를 알 수 없다면 범용 버전을 선택할 수 있습니다. 설치 실패는 다운로드 중단, 시스템 버전, 서명 충돌, 설치 권한 문제 때문일 수도 있으므로 구매 연도만으로 판단하지 마세요.
설치 파일에는 클라이언트 프로그램만 포함되며 바로 사용할 수 있는 구독은 제공되지 않습니다. 구독 주소나 공유 링크는 이용 중인 서비스 또는 직접 구축한 서버에서 받아야 합니다. v2rayN은 「구독 그룹 설정」에 주소를 저장한 뒤 구독을 업데이트하세요. v2rayNG도 「구독 그룹 설정」에 주소를 저장한 다음 구독을 업데이트하면 됩니다. 주소에 접근 인증 정보가 포함될 수 있으니 공개적으로 공유하지 마세요.
먼저 구독 그룹, 라우팅 설정 및 필요한 설정을 백업한 뒤 기존 클라이언트를 종료하세요. 같은 앱이고 서명이 호환된다면 Android에서는 보통 덮어써서 설치할 수 있습니다. 데스크톱은 설치 프로그램의 안내에 따라 업데이트하세요. 서명 충돌이 발생하거나 배포 패키지 또는 UI 버전을 바꾸는 경우에는 기존 데이터를 바로 삭제하지 말고, 새 클라이언트에서 설정을 가져올 수 있는지 먼저 확인하세요.
먼저 브라우저에서 다운로드가 완료됐는지, 파일 확장자가 선택한 플랫폼에 맞는지 확인하세요. Windows ZIP 파일은 먼저 압축을 풀어야 합니다. Android는 APK, macOS는 DMG를 사용하고 Linux는 배포판에 따라 DEB 또는 RPM을 선택하세요. 다운로드가 중단됐다면 다시 다운로드하고, 시스템이 설치를 차단하면 표시된 안내를 확인하세요. 모든 보안 기능을 무작정 끄지는 마세요.
설치, 가져오기, 프록시 연결은 서로 다른 단계입니다. 먼저 노드를 선택하고 클라이언트를 실행한 다음, 데스크톱에서는 시스템 프록시가 활성화됐는지, Android에서는 VPN 권한이 승인됐는지 확인하세요. 브라우저 프록시 설정, 다른 프록시 프로그램, 라우팅 규칙, DNS도 연결에 영향을 줄 수 있습니다. 로그에 표시된 오류를 하나씩 확인하고 여러 설정을 한꺼번에 바꾸지 마세요.
계속 확인하기: 자주 묻는 질문 · 세 가지 클라이언트 비교