Android에서는 v2rayNG, 데스크톱에서는 v2rayN을 우선 추천합니다. 먼저 운영체제와 프로세서 아키텍처를 확인한 뒤 알맞은 설치 파일을 다운로드하세요.
설치 파일은 클라이언트 설치용입니다. 구독 주소와 연결 설정은 별도로 준비해야 합니다. 이미 설치한 경우 업그레이드 전에 현재 설정을 내보내세요.
운영체제 탭을 선택해 설치 파일을 확인하세요. 링크에 플랫폼 정보가 저장되어 다시 열면 해당 운영체제가 표시됩니다.
Windows x64에서는 Desktop과 클래식 WPF, 두 가지 설치 옵션을 제공합니다. 처음 설치한다면 Desktop을 먼저 선택해 보세요. 기존 클래식 인터페이스에 익숙하다면 WPF를 선택할 수 있습니다.
차세대 크로스 플랫폼 UI를 사용합니다. 처음 설정하거나 여러 데스크톱 운영체제에서 비슷한 인터페이스를 사용하고 싶은 경우에 적합합니다.
Windows용 클래식 안정 버전입니다. 기존 사용 방식에 익숙한 경우에 적합하며, Desktop과 메뉴 이름이나 위치가 일부 다릅니다.
다운로드 파일은 ZIP 압축 파일입니다. 별도 폴더에 압축을 푼 다음 안에 있는 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하지 마세요.
| 확인 항목 | 이 페이지의 설치 파일 요구 사항 | 확인 위치 |
|---|---|---|
| 프로세서 아키텍처 | x64, 32비트 시스템은 지원하지 않음 | 설정 → 시스템 → 정보 → 시스템 종류 |
| 운영체제 | 시스템 업데이트가 제공되는 Windows 10 또는 11 사용을 권장합니다. 최소 버전은 설치 프로그램 안내를 확인하세요. | 설정 → 시스템 → 정보 |
| 설치 환경 | ZIP 압축 해제 및 설치 폴더에 파일을 쓸 수 있어야 합니다. 필요한 구성 요소가 없으면 설치 프로그램의 안내를 따르세요. | 다운로드 폴더 및 설치 화면 |
덮어쓰기 설치 전에 실행 중인 v2rayN을 종료하세요. 기존 클라이언트에서 시스템 프록시를 사용 중이라면 트레이 메뉴에서 먼저 끄는 것이 좋습니다. 설치 도중 브라우저가 중지된 로컬 포트를 계속 사용하지 않도록 하기 위해서입니다. 설치가 끝나면 클라이언트를 열어 구독 그룹이 유지됐는지 확인한 뒤 프록시 설정을 다시 켜세요.
Desktop과 WPF는 인터페이스 방식의 차이일 뿐, 구독 서비스가 다른 것은 아닙니다. 둘 중 하나만 사용하면 되며 연결을 위해 두 버전을 동시에 실행할 필요는 없습니다. 두 프로그램이 같은 로컬 수신 포트를 사용하면 충돌할 수 있습니다. 다른 버전을 사용해 보려면 현재 버전을 완전히 종료하고 설정 폴더를 별도로 백업하세요.
설치 후 구독 그룹에 주소를 추가하고 업데이트하세요. 브라우저에서 프록시를 사용하려면 시스템 프록시를 켜세요. 시스템 프록시를 읽지 않는 앱의 트래픽까지 처리해야 한다면 사용 안내의 TUN 설명을 확인하세요. 시스템 프록시와 TUN은 서로 다른 설정입니다.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple M 시리즈 칩이 표시되면 Apple Silicon을, Intel 프로세서가 표시되면 Intel을 선택하세요.
arm64 아키텍처용입니다. 컴퓨터 구입 연도가 아니라 ‘이 Mac에 관하여’에 표시된 칩을 기준으로 선택하세요.
| 확인 항목 | 이 페이지의 설치 파일 요구 사항 | 확인 위치 |
|---|---|---|
| 칩 아키텍처 | Apple Silicon은 arm64, Intel은 x64 사용 | Apple 메뉴 → 이 Mac에 관하여 |
| 운영체제 | 시스템 업데이트가 제공되는 macOS를 사용하세요. 최소 버전은 앱 설치 안내를 확인하세요. | 시스템 설정 → 일반 → 정보 |
| 설치 권한 | 앱을 응용 프로그램 폴더에 복사할 수 있어야 합니다. 네트워크 설정을 변경할 때는 시스템 안내에 따라 권한을 승인하세요. | Finder 및 시스템 설정 |
DMG를 다운로드한 뒤 더블 클릭해 마운트하고, 앱을 ‘응용 프로그램’ 폴더에 복사한 다음 해당 폴더에서 실행하세요. 복사가 끝나면 디스크 이미지를 추출해도 됩니다. 마운트된 이미지에서 클라이언트를 계속 실행하면 업데이트하거나 다운로드 파일을 정리할 때 실제 사용 위치를 혼동하기 쉽습니다.
처음 실행할 때 시스템 보안 안내가 표시되면 내용을 읽고 앱 이름과 파일 출처를 확인한 뒤 ‘시스템 설정 → 개인정보 보호 및 보안’에 표시된 절차를 따르세요. 앱을 실행하기 위해 시스템 전체의 보안 보호 기능을 끄지 마세요. 시스템에서 파일이 손상되었거나 위험할 수 있다고 안내하면 설치를 중단하고 다운로드 상태를 다시 확인하세요.
구독을 가져온 다음 먼저 설정을 선택해 연결을 시작하고, 시스템 프록시를 설정할지 결정하세요. 네트워크를 바꾸거나 절전 모드에서 깨어난 뒤, 또는 클라이언트를 종료한 뒤 브라우저에 접속할 수 없다면 시스템 프록시가 여전히 로컬 수신 포트를 가리키는지 확인하세요. 클라이언트가 실행 중이고 포트가 일치해야 이 설정으로 요청을 전달할 수 있습니다.
Android에서는 v2rayNG를 우선 추천합니다. 2015년 이후 출시된 대부분의 휴대폰은 arm64를 선택하면 됩니다. 시스템 아키텍처를 확인할 수 없다면 범용 버전을 선택하세요.
목록에 표시된 버전과 패키지 이름의 버전이 일시적으로 다를 수 있습니다. 설치 전에는 시스템 설치 화면의 버전을 확인하고, 설치 후에는 클라이언트의 ‘정보’ 화면을 기준으로 확인하세요.
기존 설정이 v2fly 코어용으로 명확히 지정된 경우 v2flyNG를 고려할 수 있습니다. 선택하기 전에 프로토콜, 전송 방식과 설정 항목을 클라이언트 내장 코어가 지원하는지 확인하세요.
기기 아키텍처를 모를 때 사용하세요. 범용 패키지를 설치해도 코어에서 지원하지 않는 프로토콜을 사용할 수 있게 되는 것은 아닙니다.
| 확인 항목 | 이 페이지의 설치 파일 요구 사항 | 확인 위치 |
|---|---|---|
| 기기 아키텍처 | arm64 패키지는 arm64-v8a 지원이 필요합니다. 확인하기 어렵다면 범용 버전을 선택하세요. | 기기 사양 또는 시스템 앱 호환성 정보 |
| 시스템 버전 | 설치 화면에 표시되는 호환성 안내를 확인하세요. 구형 시스템에서는 최신 패키지를 설치하지 못할 수 있습니다. | 설정 → 휴대전화 정보 → Android 버전 |
| 설치 권한 | APK를 실제로 여는 브라우저 또는 파일 관리자가 이번 설치를 수행하도록 허용 | 설정 → 앱 → 특별한 앱 액세스 → 알 수 없는 앱 설치 |
| 연결 권한 | VPN 모드를 처음 실행할 때 시스템 연결 요청을 승인해야 합니다. | 클라이언트가 연결을 시작할 때 표시되는 시스템 대화상자 |
다운로드가 끝나면 브라우저의 다운로드 목록이나 파일 관리자에서 APK를 여세요. 시스템에서 권한을 요청하면 파일을 여는 앱에만 설치 권한을 부여하세요. 설치가 끝난 뒤 설정에서 해당 권한을 끌 수 있습니다. 휴대폰 제조사에 따라 메뉴 이름이 다를 수 있으므로 실제 시스템 화면을 기준으로 확인하세요.
프로세서가 64비트를 지원한다고 해서 시스템도 반드시 64비트 앱을 지원하는 것은 아닙니다. 일부 구형 기기는 다른 시스템 빌드를 사용하므로 출시 연도만으로 판단할 수 없습니다. arm64 패키지가 설치되지 않으면 먼저 시스템 안내를 확인하세요. 호환되지 않는다는 안내가 있을 때만 범용 패키지를 시도하고, 같은 파일을 반복해서 다운로드하지 마세요.
설치 후 ‘구독 그룹 설정’을 열고 메모와 구독 주소를 입력한 뒤 저장하세요. 메인 화면으로 돌아와 구독을 업데이트합니다. 설정 목록이 나타나면 사용할 항목을 선택하고 연결을 누르세요. VPN 모드를 처음 켤 때는 시스템 권한을 승인해야 합니다. 휴대폰에서 다른 VPN 연결을 사용 중이라면 어느 쪽을 유지할지 먼저 결정하세요. 일반적으로 한 사용자에서 활성 VPN 서비스는 하나만 사용할 수 있습니다.
v2rayNG와 v2flyNG는 서로 다른 코어 계열을 사용하므로 인터페이스가 비슷하다고 설정도 완전히 호환된다고 볼 수 없습니다. 특히 VLESS, REALITY 또는 최신 전송 설정을 사용할 때는 코어의 지원 여부를 먼저 확인하세요. 일반적인 사용에는 두 클라이언트를 동시에 실행할 필요가 없습니다. 차이점을 비교하려면 세 클라이언트 비교를 확인하세요.
배포판에 맞춰 deb 또는 rpm을 선택한 다음 프로세서 아키텍처를 확인하세요. 아래의 기본 다운로드 옵션 두 가지는 모두 x64용이며, arm64 기기는 작은 링크에서 해당 패키지를 선택하세요.
deb 패키지 관리 체계를 사용하는 배포판용입니다. 설치 가능 여부는 배포판 버전과 의존성에 따라 달라집니다.
arm64 기기: deb 다운로드rpm 패키지 관리 체계를 사용하는 배포판용입니다. 패키지 형식이 같더라도 모든 배포판에서 실행에 필요한 의존성을 충족하는 것은 아닙니다.
arm64 기기: rpm 다운로드| 확인 항목 | 이 페이지의 설치 파일 요구 사항 | 확인 위치 |
|---|---|---|
| 데스크톱 환경 | 그래픽 앱을 실행할 수 있는 데스크톱 세션 | 시스템 설정 → 정보 |
| 프로세서 아키텍처 | x64는 amd64 / x86_64, arm64는 arm64 / aarch64에 해당 | 시스템 정보의 하드웨어 및 아키텍처 항목 |
| 패키지 형식 | 배포판에 맞춰 deb 또는 rpm을 선택하고 패키지 관리자가 안내하는 의존성을 충족하세요. | 시스템 소프트웨어 설치 프로그램 |
| 권한 | 설치에는 적절한 시스템 권한이 필요합니다. TUN 권한은 일반 시스템 프록시와 다릅니다. | 설치 및 네트워크 모드 권한 안내 |
파일 관리자에서 설치 패키지를 열고 배포판의 소프트웨어 설치 프로그램으로 패키지 정보와 의존성을 확인하세요. 의존성이 없거나 필요한 버전이 충족되지 않으면 시스템 안내에 따라 먼저 해결하세요. 의존성 확인을 건너뛰고 강제로 설치하지 마세요. 설치가 끝나면 앱 메뉴에서 v2rayN을 실행한 뒤 구독을 가져오세요.
Linux 데스크톱의 시스템 프록시는 데스크톱 환경과 앱의 동작에 따라 달라집니다. 일부 앱은 시스템 프록시를 읽지만, 다른 앱은 네트워크 설정에 로컬 프록시 주소를 직접 입력해야 합니다. 먼저 클라이언트가 실행 중인지, 로컬 수신 포트와 앱에 입력한 포트가 일치하는지 확인한 다음 TUN으로 트래픽을 처리할지 판단하세요.
arm64 기기에서는 기본 버튼이 더 눈에 띈다는 이유로 x64 패키지를 다운로드하지 마세요. 파일 이름의 amd64와 x86_64는 이 페이지에서 x64에 해당하고, aarch64는 arm64에 해당합니다. 설치 프로그램에서 아키텍처가 맞지 않는다고 안내하면 파일 확장자를 바꾸지 말고 이 페이지로 돌아와 알맞은 옵션을 선택하세요.
먼저 설정 하나가 정상적으로 연결되는지 확인한 다음 라우팅, 앱별 프록시 또는 TUN을 추가하세요. 한 번에 하나씩 변경하면 문제를 찾기 쉽습니다.
클라이언트의 구독 그룹 메뉴에서 그룹을 추가하고 전체 주소를 붙여넣으세요. 주소를 저장해도 그룹만 만들어질 뿐 설정을 가져온 것은 아닙니다. 구독 메뉴로 돌아가 업데이트한 뒤 목록을 확인하세요. 주소에 액세스 정보가 포함되어 있다면 전체 주소를 그대로 유지하고, 브라우저에 표시되는 생략된 텍스트를 완전한 주소로 착각하지 마세요.
구독은 연결 설정을 가져오는 출처이고, 클라이언트는 해당 설정을 실행하는 도구입니다. 클라이언트를 다운로드해도 사용할 수 있는 구독이 자동으로 생성되지 않으며 기존 구독의 유효 기간도 바뀌지 않습니다. 업데이트에 실패하면 먼저 주소가 유효한지 확인한 뒤 로그를 살펴보세요. 반복해서 앱을 설치하는 것으로 문제를 해결하려 하지 마세요.
설정 하나를 선택해 연결을 시작하고 코어 시작 오류가 표시되지 않는지 확인하세요. Android에서는 VPN 권한을, 데스크톱에서는 시스템 프록시나 앱 프록시가 켜져 있는지 확인합니다. 웹페이지 접속 여부는 DNS, 라우팅, 대상 서비스에도 영향을 받으므로 한 번의 테스트 결과만으로 전체 연결 상태를 판단할 수 없습니다.
기본 연결이 정상적으로 작동하면 필요에 따라 로컬 네트워크 우회, 도메인 규칙 또는 앱별 프록시를 설정하세요. 한 번에 한 종류의 설정만 바꾸고 복구할 수 있는 백업을 남겨 두세요. 설정 순서를 자세히 알고 싶다면 안내서의 핵심 개념부터 살펴보세요. 처음 설치할 때 모든 고급 옵션을 켤 필요는 없습니다.
안내에 따라 패키지 유형과 시스템 환경을 먼저 확인하세요. 연결 단계에서 문제가 발생하면 자주 묻는 질문을 확인하세요.
2015년 이후 출시된 대부분의 휴대폰은 arm64를 우선 선택하면 됩니다. 다만 시스템이 64비트 앱을 지원하는지 확인하세요. 아키텍처를 모르거나 arm64 설치 파일이 호환되지 않는다는 안내가 나오면 범용 버전을 선택하세요. 범용 버전은 용량이 더 클 수 있지만 연결 속도가 빠른 것은 아닙니다.
Desktop은 차세대 크로스 플랫폼 UI를 사용하고, WPF는 Windows용 클래식 안정 버전입니다. 처음 설치한다면 Desktop을 먼저 선택해 보세요. WPF 사용 방식에 익숙하다면 계속 WPF를 사용해도 됩니다. 두 버전은 메뉴 위치가 다를 수 있으므로 전환 전에 구독과 설정을 백업하세요.
클라이언트는 설정을 읽고 연결을 구성하는 프로그램이며, 바로 사용할 수 있는 구독은 포함되어 있지 않습니다. 설치 후 사용할 권한이 있는 구독 주소나 설정을 가져오고 업데이트한 다음, 설정을 선택해 연결을 시작하세요. Android에서는 처음 실행할 때 시스템 VPN 권한을 승인해야 하는 경우가 많습니다.
설치 파일 다운로드가 완료됐는지, 저장 공간이 충분한지, 기기 아키텍처와 맞는지 먼저 확인하세요. 기존 앱을 덮어써서 설치하지 못하는 경우 앱 서명이 다르거나 버전을 낮추려는 상황일 수 있습니다. 설정을 백업한 뒤 설치된 버전과 새 설치 파일의 출처를 확인하세요. 바로 앱을 삭제하지 마세요.
같은 앱에 서명이 호환되는 덮어쓰기 업데이트는 보통 데이터를 유지하지만, 백업을 대신하지는 않습니다. 업데이트 전에 설정을 내보내고 구독 그룹, 라우팅, 로컬 포트를 기록해 두세요. 다른 클라이언트로 옮기거나 버전을 낮추거나 삭제 후 다시 설치할 때는 설정 호환성을 별도로 확인해야 합니다.
버전 표시와 파일 경로는 목록의 서로 다른 항목에서 가져오므로 업데이트 중에 일시적으로 일치하지 않을 수 있습니다. 설치 전에는 시스템 설치 화면에 표시되는 앱 버전을 확인하고, 설치 후에는 클라이언트의 정보 화면에서 실제 버전을 확인하세요. 페이지에 표시된 문구를 근거로 다운로드 주소나 파일 이름을 바꾸지 마세요.