데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 선택하세요. CPU 아키텍처를 확인한 뒤 알맞은 설치 파일을 다운로드하면 됩니다.
구독 정보가 있나요? 설치를 마쳤다면 구독 가져오기 단계를 확인하세요. 처음 사용할 때는 기본 프록시 연결을 먼저 설정한 다음 라우팅과 TUN을 구성하세요.
같은 클라이언트, 두 가지 UI. 아래 설치 파일은 모두 x64 시스템용입니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| CPU 아키텍처 | 이 페이지의 두 설치 파일은 모두 x64용입니다. 설정의 ‘시스템 정보’에서 시스템 종류를 확인하세요. 파일명에 x64가 있다고 해서 모든 아키텍처에서 사용할 수 있는 것은 아닙니다. |
| 운영체제 및 실행 환경 | 현재 클라이언트가 지원하는 Windows를 사용하세요. 최소 버전과 실행 환경은 설치 프로그램의 안내를 따르며, 필수 구성 요소가 없다면 안내에 따라 설치하세요. |
| 파일 및 권한 | 압축 파일을 쓰기 가능한 폴더에 완전히 풉니다. 일반적인 시스템 프록시 설정에는 상시 관리자 권한이 필요하지 않지만, TUN 사용 시 권한 상승이 필요할 수 있습니다. |
v2rayN을 실행한 뒤 구독을 가져오고 서버 목록을 업데이트하세요. 사용할 서버를 선택한 다음 ‘시스템 프록시 자동 설정’을 활성화합니다. 이 설정은 주로 시스템 프록시를 따르는 앱에 적용되며 모든 네트워크 트래픽을 가로채는 것은 아닙니다. 브라우저는 연결되지만 다른 앱은 연결되지 않는다면 설치 파일을 바꾸기 전에 해당 앱의 프록시 설정부터 확인하세요.
업데이트할 때는 기존 클라이언트를 종료한 다음 설치를 진행하세요. Desktop 버전과 WPF 버전을 동시에 실행하면 시스템 프록시 설정이 서로 덮어써질 수 있습니다. 설치 후 실행 오류가 발생하면 오류 메시지를 보관하고 실행 환경과 압축 해제 경로를 확인한 뒤 재설치 여부를 판단하세요. 프로그램 파일을 반복해서 덮어써도 설정이나 권한 문제는 대개 해결되지 않습니다.
‘이 Mac에 관하여’를 열어 칩 정보를 확인한 뒤 알맞은 DMG 설치 파일을 선택하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 칩 종류 | Apple M 시리즈는 arm64, Intel 프로세서는 x64를 선택하세요. 시스템 메뉴의 ‘이 Mac에 관하여’에서 확인할 수 있습니다. |
| 운영체제 버전 | 현재 클라이언트가 지원하는 macOS를 사용하세요. 실행 시 시스템 버전이 요구 사항을 충족하지 않는다는 안내가 나오면 내용을 먼저 확인하세요. 아키텍처를 바꾸는 것은 운영체제 업그레이드를 대신할 수 없습니다. |
| 설치 및 권한 | 응용 프로그램 복사를 마친 뒤 실행하세요. 시스템 프록시, 네트워크 확장 또는 TUN 관련 기능에서 권한을 요청할 수 있습니다. 현재 사용할 기능에 필요한 권한만 허용하세요. |
시스템에서 앱 호환성, 출처 또는 권한 관련 경고가 표시되면 전체 메시지를 읽은 뒤 시스템 설정에서 해당 항목을 확인하세요. 시스템 보호 기능을 끄는 것을 일반적인 설치 절차로 삼거나 출처를 알 수 없는 터미널 명령을 실행하지 마세요. 앱은 열리지만 네트워크에 연결되지 않는다면 설치 파일을 다시 실행하는 대신 구독, 서버, 프록시 설정을 점검하세요.
시스템 프록시를 켜기 전에 다른 클라이언트가 네트워크 프록시 설정을 함께 수정하고 있지 않은지 확인하세요. v2rayN을 종료하기 전 시스템 프록시를 해제하는 것이 좋습니다. 특히 프로그램을 삭제하거나 설정을 옮길 때는 꼭 확인하세요. 종료 후에도 브라우저 연결에 문제가 있으면 시스템 네트워크 설정에 프록시 항목이 남아 있는지 살펴보고 기본 연결로 복구하세요. 이렇게 하면 설치, 권한, 실제 통신 문제를 구분해 해결할 수 있습니다.
먼저 기본 클라이언트를 설치하고, 특정 코어가 필요한 경우에만 대안을 고려하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 앱 아키텍처 | 먼저 arm64 지원 여부를 확인하고, 확실하지 않으면 범용 버전을 선택하세요. 범용 패키지도 Android 버전과 클라이언트 호환 범위에 따라 사용할 수 있습니다. |
| 설치 권한 | 시스템에서 현재 브라우저나 파일 관리자의 앱 설치를 허용하도록 요청할 수 있습니다. 설치가 끝난 뒤에는 필요에 따라 해당 출처의 설치 권한을 해제할 수 있습니다. |
| 연결 권한 | 처음 프록시 연결을 시작할 때 시스템 VPN 권한 안내를 읽고 승인하세요. 다른 VPN 앱이 같은 연결을 사용 중일 수 있으므로 테스트 전에 연결을 해제하세요. |
‘앱이 설치되지 않았습니다’라는 메시지가 나오면 먼저 남은 저장 공간, 시스템 버전, 앱 아키텍처를 확인하세요. 같은 이름이지만 서명이 다른 버전이 설치되어 있는지도 살펴보세요. 오류가 발생했다고 기존 앱을 바로 삭제하지 마세요. 앱을 삭제하면 구독 그룹과 로컬 규칙도 함께 지워질 수 있습니다. 설치 출처를 바꿔야 한다면 필요한 설정을 먼저 내보내고, 구독 인증 정보가 포함된 파일은 안전하게 보관하세요.
페이지의 버전 표시와 설치 파일명은 서로 다른 목록 항목에서 가져오므로 업데이트 시점에 차이가 있을 수 있습니다. 파일명만으로 페이지에 표시된 버전을 추정하거나 이 차이를 설치 실패로 판단하지 마세요. 설치 후 클라이언트의 ‘정보’ 화면에서 실제 빌드 버전을 확인하세요. 연결 여부는 실제 연결 테스트로 확인하고, 프록시가 필요한 앱이 클라이언트의 앱별 라우팅 범위에 포함되어 있는지도 살펴보세요.
먼저 배포판의 패키지 관리 방식을 확인하고 CPU 아키텍처를 점검하세요.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 데스크톱 환경 | 이 페이지에서는 그래픽 클라이언트를 제공합니다. 사용 가능한 그래픽 데스크톱과 필요한 실행 종속성이 있어야 합니다. 이 패키지는 백그라운드 서비스 배포용이 아닙니다. |
| 패키지 형식 및 종속성 | 배포판에 맞춰 deb 또는 rpm을 선택하고 패키지 설치 프로그램에서 종속성을 확인하세요. 필요한 종속성이 없거나 대상 환경과 맞지 않으면 먼저 호환성 문제를 해결하세요. |
| CPU 아키텍처 | 일반 x64 PC에서는 기본 버튼을 선택하고 arm64 기기에서는 카드 안의 작은 링크를 사용하세요. 아키텍처는 시스템의 사용자 공간과 일치해야 합니다. |
| 네트워크 권한 | 앱이 시스템 프록시를 따르는지는 데스크톱 환경과 앱 동작에 따라 다릅니다. TUN에는 추가 권한이 필요할 수 있으므로 먼저 일반 프록시 연결을 확인하세요. |
설치가 끝나면 앱 메뉴에서 v2rayN을 실행하고 구독을 가져온 뒤 사용할 서버를 선택하세요. Linux 데스크톱의 브라우저, 명령줄 프로그램, 기타 앱이 같은 프록시 설정을 공유하지 않을 수 있습니다. 따라서 클라이언트가 실행 중이라는 사실만으로 모든 앱이 프록시를 사용한다고 볼 수 없습니다. 먼저 시스템 프록시를 따르는 앱 하나에서 연결을 확인한 다음 다른 앱의 네트워크 동작을 차례로 점검하세요.
패키지 설치 프로그램에서 종속성을 충족할 수 없다고 알리면 구체적인 패키지명과 버전 요구 사항을 기록하세요. 종속성을 강제로 무시하지 마세요. 업데이트 전에 프로그램 설정 경로를 확인하고 사용자 지정 라우팅과 DNS 설정을 보관하세요. 권한 문제가 발생하면 필요한 기능에만 권한을 부여하고, 일상적인 그래픽 세션 전체를 관리자 권한으로 실행하지 마세요.
설치 파일은 프로그램 설치만 담당합니다. 구독, 사용할 서버, 프록시 모드는 클라이언트에서 별도로 설정해야 합니다.
다운로드한 파일의 아키텍처가 기기와 맞는지 확인한 다음 압축을 풀거나 설치하세요. 클라이언트를 실행한 뒤 구독 그룹을 추가하고 사용할 권한이 있는 구독 URL을 입력해 저장한 다음 구독을 업데이트합니다. 서버 목록이 표시되면 설정이 완전한 서버를 선택해 현재 서버로 지정하세요. 마지막으로 시스템 프록시 또는 VPN 연결을 활성화합니다.
구독 업데이트는 서버 설정을 가져오는 작업이며, 사용할 서버를 선택해 주지는 않습니다. 처음 테스트할 때는 기본 라우팅을 사용하고 복잡한 DNS와 TUN 설정은 나중으로 미루세요. 먼저 연결 하나를 정상적으로 만든 다음 설정을 한 번에 하나씩 바꾸면 문제가 발생한 단계를 찾기 쉽습니다.
구독 가져오기 안내 계속 보기 →구독 그룹, 사용자 지정 라우팅, DNS 설정, 직접 추가한 서버 정보를 백업하세요. 백업에 접속 인증 정보가 포함될 수 있으므로 공개된 공간에 올리거나 문의용 스크린샷에 그대로 포함하지 마세요. 실행 중인 클라이언트를 종료한 뒤 설치를 진행하세요. 프로그램이 설정을 기록하는 동안 설정 폴더 전체를 복사하지 마세요.
업데이트 후 구독이 유지됐는지, 사용할 서버가 올바른지, 프록시 모드가 예상대로 설정됐는지 확인하세요. 브라우저와 자주 사용하는 앱의 연결이 정상인지 확인한 뒤 기존 폴더를 정리하세요. UI 버전이나 클라이언트를 바꿀 때는 형식을 알 수 없는 설정 파일을 그대로 덮어쓰지 말고 클라이언트에서 지원하는 가져오기 방식을 우선 사용하세요.
전체 유지 관리 절차 보기 →먼저 아키텍처와 패키지 형식을 확인한 뒤 설치 및 연결 문제를 해결하세요.
처음 사용한다면 차세대 크로스 플랫폼 UI를 적용한 Desktop 버전을 권장합니다. 클래식 UI가 익숙하다면 안정적인 WPF 버전을 선택하세요. 둘 다 v2rayN 클라이언트입니다. 버전을 바꾸기 전에 설정을 백업하고, 두 클라이언트가 동시에 시스템 프록시를 수정하지 않도록 하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 우선 선택하면 됩니다. 다만 기기의 운영체제가 지원하는 앱 아키텍처를 확인하세요. 아키텍처를 확인하기 어렵거나 arm64 패키지가 설치되지 않으면 범용 버전을 시도할 수 있습니다. 범용 버전이 기능이 더 많은 것은 아니며, 클라이언트의 시스템 요구 사항도 충족해야 합니다.
설치 파일에는 클라이언트 프로그램만 포함되며 바로 사용할 수 있는 구독 정보는 제공되지 않습니다. 사용할 권한이 있는 구독 URL이나 서버 설정을 준비해 가져온 뒤 구독을 업데이트하세요. 그런 다음 사용할 서버를 선택하고 프록시 모드를 설정하면 됩니다.
먼저 클라이언트를 종료하고 구독 그룹, 사용자 지정 라우팅, DNS 및 직접 수정한 설정을 백업하세요. 백업에 구독 인증 정보가 포함될 수 있으므로 안전하게 관리되는 위치에 보관해야 합니다. 기존 설정 사본은 새 버전의 연결이 정상인지 확인한 뒤 정리하세요.
목록의 버전 표기와 설치 파일 경로는 별도 항목이므로 업데이트 시점이 다를 수 있습니다. 페이지에는 목록에 제공된 버전 표기와 다운로드 경로를 그대로 표시하며, 파일명으로 버전을 추정하지 않습니다. 설치 후 클라이언트의 정보 화면에서 실제 빌드 버전을 확인할 수 있습니다.
먼저 구독 업데이트가 완료됐는지, 사용할 서버를 선택했는지 확인하세요. 이어서 시스템 프록시 또는 Android VPN 권한이 활성화됐는지 살펴보세요. 로그에 표시된 연결 오류를 확인한 뒤 서버 설정, 시스템 시간, DNS, 라우팅 순서로 점검하세요. 여러 설정을 한꺼번에 바꾸지 마세요.