데스크톱: v2rayN
Android: v2rayNG / v2flyNG
먼저 운영체제를 선택한 다음 프로세서 아키텍처와 설치 파일 형식을 확인하세요. 클라이언트에서 구독을 가져오고 서버와 라우팅을 관리할 수 있습니다. 설치 후에는 입문 가이드에 따라 설정을 마치세요.
무료 오픈 소스 클라이언트 · 구독 정보와 서버 설정은 설치 파일에 포함되지 않습니다
같은 클라이언트라도 아키텍처별 설치 파일이 다를 수 있습니다. 데스크톱 인터페이스, 프로세서 아키텍처, 파일 형식을 각각 확인하세요.
x64 설치 파일을 제공합니다. 데스크톱 버전과 클래식 WPF 버전 중 익숙한 인터페이스를 선택하세요. 두 버전을 모두 설치할 필요는 없습니다.
차세대 크로스 플랫폼 UI를 적용했습니다. 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 인터페이스를 사용하고 싶은 분에게 적합합니다.
ZIP 압축 파일입니다. 압축을 완전히 푼 뒤 안에 있는 설치 프로그램을 실행하세요. 압축 프로그램의 미리보기에서 바로 실행하지 마세요.
Windows 설정에서 ‘시스템 → 정보’를 열어 시스템 종류와 프로세서 정보를 확인하세요. 이 페이지의 두 링크는 모두 x64 패키지입니다. 컴퓨터 브랜드나 화면 크기가 아니라 현재 시스템에서 실행할 수 있는 프로그램 아키텍처를 기준으로 선택하세요. 다른 아키텍처를 사용하는 기기라면 시스템 호환성을 먼저 확인하세요. 파일을 다운로드할 수 있다는 이유만으로 실행 가능하다고 판단하지 마세요.
압축 파일을 관리하기 쉬운 위치에 저장하고 완전히 푼 다음 안내에 따라 설치하세요. 처음 실행할 때 실행 환경 안내가 표시되면 선택한 인터페이스 버전에 필요한 항목을 확인하세요. 버전에 따라 필요한 실행 환경이 다를 수 있으므로 다른 버전의 오래된 가이드를 그대로 따르지 않는 것이 좋습니다. 일반적인 구독 관리는 관리자 권한이 필요하지 않습니다. TUN 또는 시스템 네트워크 구성 요소를 사용할 때 안내에 따라 권한을 부여하세요.
Desktop 버전과 WPF 버전은 인터페이스 구현과 조작 방식이 다를 뿐입니다. 특정 서버 설정이 반드시 작동한다는 뜻은 아닙니다. 인터페이스를 바꾸려면 기존 설정을 내보내고 기존 클라이언트를 종료한 뒤 새 클라이언트를 실행해 설정을 가져오세요. 두 인스턴스가 같은 로컬 포트를 동시에 사용하면 실행 실패, 프록시 연결 오류, 브라우저 연결 문제가 발생할 수 있습니다.
설치가 끝나면 기존 구독이나 단일 서버 설정을 가져오고 사용할 서버를 선택한 다음 시스템 프록시를 설정할지 결정하세요. 시스템 프록시는 앱의 트래픽을 로컬 클라이언트로 보내는 방법 중 하나입니다. 전체 라우팅이나 중국 본토 우회 같은 라우팅 설정은 이후 트래픽의 출구를 정하는 것으로, 시스템 프록시와는 별개의 설정입니다. 자세한 방법은 v2rayN 설정 가이드를 참고하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 운영체제 및 아키텍처 | Windows용이며 현재 링크는 x64입니다. 지원되는 세부 OS 버전은 설치 프로그램 안내를 확인하세요. |
| 설치 파일 | ZIP 파일의 압축을 완전히 푼 뒤 내부 설치 프로그램을 실행하세요. |
| 실행 환경 | Desktop 또는 WPF에서 표시하는 안내에 따라 필요한 구성 요소를 준비하세요. |
| 설정 준비 | 사용 권한이 있는 구독 주소 또는 서버 정보가 필요합니다. 클라이언트 자체는 서버를 제공하지 않습니다. |
먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인한 다음 Apple Silicon 또는 Intel에 맞는 링크를 선택하세요.
‘이 Mac에 관하여’에 Apple 칩이라고 표시되면 이 버전을 선택하세요. 칩에 맞는 네이티브 아키텍처 패키지를 우선 사용하세요.
두 링크 모두 DMG 형식입니다. 디스크 이미지를 열고 창의 안내에 따라 ‘응용 프로그램’에 설치한 뒤 응용 프로그램 폴더에서 실행하세요.
시스템 메뉴에서 ‘이 Mac에 관하여’를 열고 ‘칩’ 또는 ‘프로세서’ 항목을 확인하세요. Apple Silicon은 arm64, Intel은 x64에 해당합니다. 같은 모델명이라도 칩 구성이 다를 수 있으므로 시스템에 표시된 정보를 기준으로 선택하세요. 아키텍처가 맞더라도 앱이 요구하는 macOS 버전을 충족해야 합니다. 아키텍처 일치만으로 시스템 호환성이 보장되지는 않습니다.
DMG를 다운로드한 뒤 디스크 이미지를 열고 창에 표시되는 설치 안내를 따르세요. 앱을 ‘응용 프로그램’ 폴더에 넣어 두면 실행 위치를 일정하게 유지할 수 있으며, 임시로 마운트된 디스크 이미지에서 계속 실행하는 일을 방지할 수 있습니다. 설치가 끝나면 디스크 이미지를 추출해도 됩니다. 클라이언트를 업데이트하거나 삭제하기 전에는 앱을 종료하고 설정을 백업했는지 확인하세요.
개발자 확인 또는 실행 제한 안내가 표시되면 파일 출처와 선택한 설치 파일을 먼저 확인한 다음 시스템 설정의 ‘개인정보 보호 및 보안’을 살펴보세요. 출처를 명확히 확인한 앱에만 실행을 허용하세요. 클라이언트 하나를 설치하기 위해 시스템 전체의 보안 기능을 끄는 것은 권장하지 않습니다. 안내 문구가 예상과 다르면 반복해서 다시 다운로드하기보다 전체 팝업 내용을 보관하는 편이 문제를 파악하는 데 도움이 됩니다.
시스템 프록시를 처음 설정하거나 추가 권한이 필요한 네트워크 모드를 사용할 때 시스템에서 권한을 요청할 수 있습니다. 권한을 허용한 뒤에도 유효한 설정을 가져오고 서버를 선택한 다음 라우팅을 확인해야 합니다. 권한 허용만으로 연결이 되는 것은 아닙니다. 클라이언트를 종료하기 전 시스템 프록시가 복구되었는지 확인하세요. 앱을 종료했는데도 브라우저가 로컬 프록시 포트에 연결된다면 시스템의 네트워크 프록시 설정을 확인하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 운영체제 및 칩 | macOS용입니다. ‘이 Mac에 관하여’에서 Apple Silicon 또는 Intel을 확인하세요. |
| 파일 형식 | DMG 디스크 이미지입니다. 설치 창의 안내에 따라 응용 프로그램 폴더에 넣으세요. |
| 시스템 호환성 | 최소 지원 macOS 버전은 현재 앱의 설치 및 실행 안내를 확인하세요. |
| 네트워크 권한 | 사용할 모드에 맞게 권한을 허용하세요. 설정 가져오기와 시스템 권한 부여는 별도로 진행해야 합니다. |
먼저 v2rayNG를 권장합니다. 2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 됩니다. 아키텍처를 모르면 범용 버전을 고려하세요.
여러 아키텍처용 구성 요소가 포함되어 있어 기기 아키텍처를 모를 때 선택할 수 있습니다. 파일 크기는 단일 아키텍처 패키지보다 큰 편입니다.
카드의 버전과 설치 파일 경로는 별도의 목록 항목입니다. 이곳의 버전 표시는 2.2.6이지만 현재 파일명에는 2.3.11이 표시됩니다. 실제 다운로드 파일과 설치 후 ‘정보’ 화면을 확인해 패키지 버전을 판단하세요.
지원되는 프로토콜과 전송 기능은 코어 및 버전에 따라 달라집니다. 필요한 기능이 있다면 먼저 설정 요구 사항을 확인한 뒤 대안 클라이언트를 선택하세요.
기기의 출시 연도는 참고용일 뿐입니다. 프로세서 아키텍처와 시스템에서 실행 가능한 앱 유형을 기준으로 선택하세요. 프로세서가 필요한 기능을 지원하더라도 시스템에서 실행 가능한 앱 아키텍처를 제한할 수 있습니다. arm64 패키지가 호환되지 않는다는 안내가 표시되면 기기 사양을 확인한 뒤 범용 패키지를 고려하세요. 범용 패키지도 모든 시스템 버전 제한을 우회하지는 못합니다.
APK를 열면 Android에서 현재 브라우저나 파일 관리 앱에 앱 설치 권한을 허용하라는 안내가 표시될 수 있습니다. 실제 설치 파일을 여는 앱에만 권한을 부여하고, 완료 후 필요하면 권한을 해제하세요. 기존 클라이언트에 덮어 설치할 수 없다면 앱 출처와 서명, 버전 관계를 먼저 확인하세요. 바로 삭제하면 설정이 사라질 수 있으므로 먼저 백업하고, 삭제를 첫 번째 해결 방법으로 삼지 마세요.
처음 연결을 누르면 시스템에 VPN 연결 요청이 표시됩니다. 이는 클라이언트가 기기의 트래픽을 처리하기 위한 시스템 권한이며, 설치 파일에 원격 서버가 포함되어 있다는 뜻은 아닙니다. 기존 설정을 가져온 후 연결하고, 다른 VPN 앱이 실행 중인지 확인하세요. 한 기기에서 여러 앱이 네트워크 트래픽을 처리하면 충돌할 수 있으므로 현재 어떤 앱이 트래픽을 처리하는지 먼저 확인해야 합니다.
화면을 잠근 뒤 연결이 끊기면 시스템의 배터리 최적화, 백그라운드 실행, 네트워크 접근 제한을 확인한 다음 클라이언트 로그를 살펴보세요. v2flyNG로 바꾼다고 권한 문제가 자동으로 해결되거나 모든 설정이 그대로 옮겨지는 것은 아닙니다. 구독을 가져오고 라우팅을 선택하는 방법은 v2rayNG 사용 가이드를, 프로토콜 용어는 개념 빠른 참조를 확인하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 운영체제 및 아키텍처 | Android용입니다. arm64 지원 여부를 우선 확인하고, 세부 시스템 버전 요구 사항은 설치 안내를 따르세요. |
| 파일 형식 | APK 형식입니다. arm64는 단일 아키텍처 패키지이며 범용 버전에는 여러 아키텍처용 구성 요소가 포함됩니다. |
| 설치 권한 | APK를 실제로 여는 앱에만 권한을 부여하고, 관련 없는 앱에 설치 권한을 계속 허용하지 마세요. |
| 연결 권한 | 처음 연결할 때 시스템의 VPN 요청을 승인하고, 필요한 경우 백그라운드 실행 제한을 확인하세요. |
먼저 배포판의 패키지 형식을 확인한 다음 x64 또는 arm64를 선택하세요. 이 페이지에서는 그래픽 데스크톱용 클라이언트 패키지를 제공합니다.
DEB 패키지 관리 체계를 사용하고 필요한 의존성을 충족하는 x64 데스크톱 시스템에 적합합니다.
arm64 기기: DEB 패키지 다운로드 →해당 RPM 패키지의 대상 환경과 일치하고 필요한 의존성을 충족하는 x64 데스크톱 시스템에 적합합니다.
arm64 기기: RPM 패키지 다운로드 →DEB와 RPM은 확장자를 바꿔 서로 변환할 수 없습니다. RPM 파일명에 표시된 대상 환경을 확인하고 배포판 호환성을 확인한 뒤 설치하세요.
DEB와 RPM은 서로 다른 패키지 형식입니다. 시스템에 포함된 소프트웨어 설치 프로그램이나 패키지 관리 도구를 먼저 확인하세요. 같은 형식을 사용하는 배포판이라도 시스템 라이브러리 버전, 패키지 의존성, 대상 환경에 따라 설치되지 않을 수 있습니다. 특히 대상 환경이 표시된 RPM 패키지는 설치 프로그램이 안내하는 의존성 결과를 따르세요. 의존성을 무시하고 강제로 설치하지 않는 것이 좋습니다.
x64 패키지는 일반적인 64비트 데스크톱 프로세서용이며 파일명에 amd64 또는 x86_64로 표시될 수 있습니다. arm64 패키지는 aarch64로 표시되기도 합니다. 이 표기는 패키지 형식이 아니라 프로세서 아키텍처를 뜻합니다. 먼저 아키텍처를 확인하고 배포판의 패키지 관리 체계에 맞는 파일을 선택하면 형식은 맞지만 프로그램이 실행되지 않는 문제를 예방할 수 있습니다.
v2rayN은 그래픽 클라이언트이므로 사용 가능한 데스크톱 세션과 관련 그래픽 실행 환경이 필요합니다. 터미널만 사용하는 서버 환경은 패키지를 설치할 수 있다는 이유만으로 데스크톱 클라이언트 실행에 적합하다고 볼 수 없습니다. 설치 후 앱 메뉴에서 실행하고 설정 디렉터리에 쓰기 권한이 있는지 확인한 다음 기존 구독을 가져오세요. 디렉터리 권한 문제를 피하려고 클라이언트 전체를 높은 권한으로 계속 실행하지 마세요.
데스크톱 환경과 앱에 따라 시스템 프록시를 사용하는 방식이 다를 수 있습니다. 클라이언트에서 시스템 프록시를 설정해도 브라우저, 터미널 프로그램, 기타 앱이 모두 같은 경로를 사용하지는 않으므로 각각 확인하세요. TUN이 필요하다면 고급 설정의 권한 및 라우팅 안내를 참고하세요. 데스크톱 프록시, 환경 변수, TUN을 같은 설정으로 간주하면 문제를 찾기 어렵습니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 실행 환경 | Linux 그래픽 데스크톱 세션이 필요하며 설치 프로그램에 표시된 실행 의존성을 충족해야 합니다. |
| 프로세서 아키텍처 | x64는 amd64 / x86_64, arm64는 aarch64에 해당합니다. |
| 패키지 관리 체계 | 배포판에 맞는 DEB 또는 호환 RPM 패키지를 선택하고 의존성을 강제로 건너뛰지 마세요. |
| 설정 권한 | 현재 사용자가 설정 디렉터리에 쓸 수 있어야 합니다. 추가 네트워크 권한은 사용하는 모드에 따라 설정하세요. |
처음 설치할 때와 기존 설치를 덮어 업데이트할 때 필요한 준비는 다릅니다. 처음 설치한다면 아키텍처를 올바르게 선택하고 기존 설정을 준비하세요. 덮어 업데이트할 때는 기존 클라이언트를 종료하고 설정을 저장한 뒤 새 설치 위치를 확인하세요. 앱만 남기고 설정 디렉터리를 빠뜨리지 않도록 주의하세요.
구독 주소에 접근 정보가 포함될 수 있고 백업 파일에도 서버 설정이 들어갈 수 있습니다. 안전한 곳에 보관하고 문제를 확인할 때 구독 링크 전체, 계정 정보, 전체 설정을 공개하지 마세요. 로그를 공유해야 한다면 문제와 관련된 부분만 남기고 민감한 항목은 가리세요.
세 클라이언트의 용도 비교 →설정을 가져오기 전에 실행 환경, 디렉터리 권한, 시스템 권한 문제를 먼저 해결하세요. 실행 오류와 연결 오류는 나누어 확인해야 합니다.
구독 그룹이 정상적으로 가져와졌는지 확인하고 서버를 선택하세요. 설치가 완료되었다고 연결 준비까지 끝난 것은 아닙니다.
필요에 따라 시스템 프록시 또는 연결 권한을 활성화한 다음 라우팅 모드를 확인하세요. 문제를 추적하기 쉽도록 한 번에 한 종류의 설정만 변경하세요.
연결 모드, 구독 가져오기, DNS 문제 해결은 입문 가이드와 자주 묻는 질문에서 확인할 수 있습니다.
처음 사용한다면 차세대 크로스 플랫폼 인터페이스를 적용한 Desktop 버전을 선택해 보세요. 기존 Windows 방식에 익숙하다면 안정적인 클래식 WPF 버전이 적합합니다. 두 버전 모두 v2rayN 클라이언트입니다. 인터페이스를 바꾸기 전 설정을 백업하고, 같은 로컬 포트를 두 프로그램이 동시에 사용하지 않도록 기존 클라이언트를 종료하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64 버전을 우선 선택하면 됩니다. 다만 실제 기기 아키텍처와 시스템 지원 여부를 확인하세요. 범용 버전에는 여러 아키텍처용 구성 요소가 포함되어 있어 기기 아키텍처를 모를 때 사용할 수 있습니다. 설치 파일이 호환되지 않는다는 안내가 표시되면 아키텍처와 OS 버전, 기존 앱의 서명 출처를 확인하고 반복해서 덮어 설치하지 마세요.
클라이언트는 로컬 설정과 연결을 관리하는 기능을 제공합니다. 설치 파일에는 사용할 수 있는 구독 정보나 서버가 포함되어 있지 않습니다. 사용할 권한이 있는 구독 주소나 서버 설정을 준비해 가져온 다음 서버를 선택하고, 필요에 따라 시스템 프록시, 라우팅 또는 Android VPN 연결 권한을 설정하세요.
클라이언트의 백업 또는 내보내기 기능을 사용해 구독 그룹, 사용자 지정 라우팅, DNS 설정을 저장하세요. 백업에 구독 주소와 연결 정보가 포함될 수 있으므로 안전한 곳에 보관해야 합니다. 업데이트 전 클라이언트를 종료하고 기존 설정을 복사해 둔 뒤, 업데이트 후 설정이 정상적으로 불러와지는지 확인하세요.
카드의 버전 표기와 아키텍처별 설치 파일 경로는 목록의 서로 다른 항목을 참조하므로 업데이트 시점이 다를 수 있습니다. 카드의 버전만으로 실제 설치 파일 버전을 판단하지 마세요. 다운로드한 파일명과 설치 후 정보 화면을 함께 확인하고, 차이가 있다면 대상 아키텍처와 필요한 기능을 확인한 뒤 설치 여부를 결정하세요.
먼저 브라우저의 다운로드 목록과 저장 위치, 권한 안내를 확인한 다음 페이지를 새로고침하고 선택한 링크를 다시 시도하세요. 짧은 시간에 여러 설치 파일을 연달아 누르지 마세요. 계속 실패하면 플랫폼, 링크 이름, 브라우저에 표시된 안내를 기록하고 잠시 후 다시 시도하세요. 파일 확장자를 바꿔 다른 형식의 파일을 설치 파일처럼 실행하지 마세요.