데스크톱 플랫폼에서는 v2rayN, Android에서는 v2rayNG를 권장합니다. 먼저 운영체제를 선택한 다음 CPU 아키텍처를 확인하세요.
설치 파일에는 클라이언트만 포함되어 있습니다. 사용하려면 유효한 구독 주소나 공유 링크가 필요합니다. 처음 설정할 때는 사용 안내를 참고하세요.
두 설치 파일 모두 x64 시스템용입니다. 익숙한 UI를 선택하고 두 버전을 함께 설치하지 마세요.
데스크톱 버전은 차세대 크로스 플랫폼 UI를, 클래식 WPF 버전은 Windows의 기존 UI를 사용합니다. 두 버전 모두 GUI에서 설정을 관리할 수 있으며, 처음이라면 데스크톱 버전부터 사용해 보세요.
차세대 크로스 플랫폼 UI를 제공합니다. 처음 설치하거나 여러 데스크톱 플랫폼에서 비슷한 방식으로 사용하고 싶은 분에게 적합합니다.
기존 메뉴와 창 배치에 익숙하고 지금까지의 사용 방식을 이어가고 싶은 분에게 적합한 클래식 안정화 UI입니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 시스템 아키텍처 | 이 페이지에서는 x64 패키지를 제공합니다. ‘설정 → 시스템 → 시스템 정보’에서 시스템 종류를 확인하세요. 32비트 시스템에서는 두 설치 파일을 사용할 수 없습니다. |
| Windows 버전 | 보안 업데이트가 계속 제공되는 Windows 버전을 사용하세요. 최소 요구 사항은 현재 설치 파일의 안내를 확인해야 합니다. |
| 실행 환경 | 실행할 때 .NET Desktop Runtime이 없다는 안내가 나오면 필요한 버전과 x64 아키텍처를 확인하세요. DLL을 임의로 복사해 해결하려고 하지 마세요. |
| 저장 공간 및 권한 | 다운로드한 ZIP 파일 전체를 먼저 압축 해제한 다음, 폴더 안의 설치 프로그램이나 실행 파일을 여세요. 설정 폴더에는 쓰기 권한이 필요하며 설치 위치는 설치 마법사에서 확인할 수 있습니다. |
압축 파일 미리보기 창에서 프로그램을 바로 실행하지 마세요. 압축 파일 전체를 별도 폴더에 해제한 뒤 설치 파일을 확인하세요. 설치 또는 첫 실행 중 시스템 보안 경고가 나타나면 다운로드한 파일과 선택한 설치 항목이 맞는지 먼저 확인하고 시스템 안내에 따라 처리하세요. 클라이언트를 실행하기 위해 시스템 보호 기능을 계속 꺼 두지 마세요.
WPF 버전에서 데스크톱 버전으로 이전할 때는 기존 클라이언트에서 설정을 백업하고 구독 그룹, 라우팅 모드, 로컬 수신 포트를 기록하세요. 기존 인스턴스를 종료한 뒤 새 버전을 실행하고 가져온 설정을 확인하세요. 두 버전을 동시에 실행하면 로컬 포트 충돌이 발생하거나 시스템 프록시 설정이 서로 덮어쓰일 수 있습니다. UI가 열렸다고 해서 프록시가 제대로 적용된 것은 아닙니다.
설치 후 ‘구독 그룹 설정’에 구독 주소를 저장하고 구독 메뉴에서 업데이트를 실행하세요. 사용할 설정을 선택한 다음 라우팅 모드를 지정하고, 트레이 메뉴에서 ‘시스템 프록시 자동 설정’을 선택하세요. 시스템 프록시는 해당 설정을 따르는 앱에만 적용됩니다. 일부 프로그램은 프록시 주소를 별도로 지정해야 합니다. 자세한 방법은 구독 가져오기 및 첫 연결 단계를 확인하세요.
먼저 ‘이 Mac에 관하여’에서 칩 정보를 확인하고, 기기 구매 연도가 아니라 칩에 맞는 DMG 파일을 선택하세요.
구독 그룹, 라우팅 규칙, 시스템 프록시를 관리하는 데스크톱 GUI 클라이언트입니다. 두 설치 파일은 CPU 아키텍처가 다르므로 앱을 설치하기 전에 맞는 파일을 선택하세요.
‘이 Mac에 관하여’의 칩 항목에 Apple M 시리즈가 표시되면 이 패키지를 선택하세요. 하드웨어에 맞는 기본 아키텍처 버전을 권장합니다.
‘이 Mac에 관하여’의 프로세서 항목에 Intel이 표시되면 이 패키지를 선택하세요. macOS 버전명으로 프로세서 종류를 판단할 수 없습니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 프로세서 | Apple Silicon은 arm64, Intel은 x64에 해당합니다. 기기에 맞는 기본 아키텍처 패키지를 선택하세요. |
| Windows 버전 | 보안 업데이트가 계속 제공되는 macOS를 사용하세요. 최소 지원 버전은 현재 앱 패키지의 호환성 요구 사항에 따라 달라집니다. |
| 앱 설치 위치 | DMG를 열고 앱을 ‘응용 프로그램’ 폴더로 복사한 뒤 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하지 마세요. |
| 권한 설정 | 시스템 프록시를 변경하거나 관련 네트워크 기능을 켤 때 실제로 표시되는 권한 요청을 허용하세요. 일반 시스템 프록시와 TUN에 필요한 권한은 다릅니다. |
앱 복사가 끝나면 DMG 볼륨을 추출해도 됩니다. ‘개발자를 확인할 수 없어 앱을 열 수 없습니다’라는 안내가 나오면 앱 출처를 확인한 뒤 ‘시스템 설정 → 개인정보 보호 및 보안’에서 이번 실행을 허용하는 항목이 있는지 확인하세요. 버튼 위치는 macOS 버전에 따라 다를 수 있으므로 현재 시스템 안내를 따르세요. 보안 검사를 전체적으로 끌 필요는 없습니다.
처음 설정할 때 구독을 가져오고 설정을 선택한 다음 시스템 프록시를 켜세요. 권한 요청을 취소하면 UI는 정상적으로 표시되더라도 시스템 프록시 설정이 적용되지 않을 수 있습니다. 클라이언트에서 해당 작업을 다시 실행하고 현재 네트워크 서비스의 프록시 설정을 확인하세요. 메뉴의 선택 상태만 보고 연결 여부를 판단하지 마세요.
업데이트하기 전에 앱을 종료해 이전 버전과 새 버전이 동시에 실행되지 않도록 하세요. 업데이트 후 구독 그룹, 라우팅 모드, 로컬 포트가 유지되었는지 확인한 다음 브라우저로 테스트하세요. 브라우저와 다른 앱의 동작이 다르면 해당 앱이 시스템 프록시를 따르는지 먼저 확인하세요. 바로 프로토콜을 바꾸거나 같은 구독을 반복해서 가져오지 마세요.
먼저 v2rayNG를 선택하세요. V2Fly 설정을 사용해야 하는 경우에만 v2flyNG를 고려하세요.
구독과 공유 링크를 가져오고, 시스템 VPN 권한을 통해 트래픽을 처리하는 Android GUI 클라이언트입니다. 필요에 따라 라우팅과 앱별 프록시를 설정할 수 있습니다.
2015년 이후 출시된 대부분의 스마트폰에 적합합니다. 기기에서 64비트 앱을 지원하는지 확인하세요. 프로세서 사양만으로 판단하면 안 됩니다.
아키텍처를 모르거나 arm64 패키지가 호환되지 않는다는 안내가 나오면 선택하세요. 더 많은 아키텍처를 지원하며 파일 크기는 대체로 더 큽니다.
V2Fly 코어의 동작이 필요한 Android 설정에 적합합니다. 구독을 가져올 수 있다는 이유만으로 모든 프로토콜 매개변수가 지원된다고 판단하지 마세요. 특히 서버에서 사용하는 확장 기능을 확인해야 합니다.
64비트 앱을 지원하는 ARM 기기용입니다. 설치 전에 사용하려는 설정이 v2fly 코어와 호환되는지 확인하세요.
아키텍처를 모를 때 선택할 수 있는 대안 패키지입니다. 범용 버전을 선택해도 코어 종류는 바뀌지 않으며 다른 코어 전용 기능이 추가되지 않습니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 시스템 호환성 | 시스템 버전이 선택한 APK의 최소 요구 사항을 충족해야 합니다. 설치 프로그램에서 시스템이 너무 오래되었다고 안내하는 경우 범용 버전을 선택해도 해결되지 않습니다. |
| 앱 아키텍처 | 64비트 앱을 지원하는 ARM 기기에서는 arm64를 우선 선택하세요. 확실하지 않으면 범용 버전을 사용하고 설치 프로그램의 안내를 확인하세요. |
| 설치 권한 | 이번에 사용할 브라우저나 파일 관리자에 한해서 ‘출처를 알 수 없는 앱 설치’ 권한을 허용하세요. 설치를 마친 뒤 필요에 따라 권한을 다시 끌 수 있습니다. |
| 연결 권한 | 처음 연결할 때 시스템 VPN 요청을 확인하고 허용하세요. 일반적으로 한 사용자 공간에서는 VPN 연결 하나만 활성화할 수 있으므로 다른 VPN은 먼저 연결을 해제해야 합니다. |
| 백그라운드 실행 | 연결을 계속 유지하려면 시스템 배터리 관리에서 클라이언트의 백그라운드 실행을 허용하세요. 메뉴 이름은 기기 제조사에 따라 다를 수 있습니다. |
APK를 다운로드한 뒤 시스템 설치 프로그램으로 설치하세요. ‘앱이 설치되지 않았습니다’라는 안내가 나오면 구체적인 원인을 확인하세요. 아키텍처 불일치, 시스템 버전 미달, 저장 공간 부족, 서명 불일치는 서로 다른 문제입니다. 업데이트 설치에 실패해도 기존 버전을 바로 삭제하지 마세요. 삭제하면 로컬 설정까지 사라질 수 있으므로 먼저 백업한 뒤 처리하세요.
클라이언트를 열고 구독 그룹을 추가한 다음 주소를 입력해 구독을 업데이트하세요. 사용할 설정을 선택하고 연결을 누르면 시스템에서 VPN 연결 권한을 요청합니다. 허용한 뒤 실제 트래픽 처리가 시작됩니다. VPN 아이콘은 로컬 터널이 만들어졌다는 뜻일 뿐, 원격 서비스가 정상이라는 의미는 아닙니다. 계속 접속할 수 없다면 설정과 로그를 먼저 확인한 다음 라우팅과 DNS를 점검하세요.
앱별 프록시는 어떤 앱의 트래픽을 프록시로 보낼지 결정합니다. 필터를 켰다면 ‘선택한 앱만 프록시 사용’과 ‘선택한 앱은 프록시 우회’의 차이를 확인하세요. 브라우저가 적용 범위에 포함되지 않으면 클라이언트는 연결되어도 브라우저 트래픽은 프록시를 거치지 않을 수 있습니다. 필터를 변경한 뒤 클라이언트 안내에 따라 연결을 다시 설정해 새 범위를 적용하세요. 코어 선택과 프로토콜 호환성의 차이는 프로토콜 참고 자료에서 확인할 수 있습니다.
배포판에 맞춰 deb 또는 rpm을 선택한 뒤 x64와 64비트 ARM 아키텍처를 확인하세요.
GUI 데스크톱 환경을 갖춘 Linux 시스템용입니다. deb와 rpm은 서로 다른 패키지 형식이지 라우팅 모드가 다르다는 뜻은 아닙니다. 설치 가능 여부는 배포판에서 제공하는 의존성에도 달려 있습니다.
Debian·Ubuntu 계열 배포판에서 우선 확인하세요. 패키지명의 amd64는 일반적인 x86_64 프로세서 아키텍처를 가리킵니다.
RPM 패키지 관리자를 사용하는 배포판에서 확인하세요. 현재 파일에는 el10 빌드 표시가 있으므로 설치 전에 배포판 및 의존성 호환성을 반드시 확인해야 합니다.
| 확인 항목 | 요구 사항 및 안내 |
|---|---|
| 데스크톱 환경 | GUI 앱을 실행할 수 있는 데스크톱 세션이 필요합니다. 이 설치 파일은 데스크톱 클라이언트용이며 서버 설치용이 아닙니다. |
| 패키지 관리 형식 | 배포판에 맞춰 deb 또는 rpm을 선택하세요. 시스템 패키지 설치 프로그램에서 해당 패키지 형식과 의존성을 처리할 수 있어야 합니다. |
| CPU 아키텍처 | x64, x86_64, amd64는 일반적인 데스크톱 아키텍처를 가리키는 이름입니다. 64비트 ARM 패키지에는 arm64 또는 aarch64가 표시됩니다. |
| 의존성 및 권한 | GUI 실행에 필요한 의존성, 시스템 라이브러리 및 설치 권한이 충족되는지 확인하세요. 의존성 오류를 무시하고 설치를 강행하지 마세요. |
파일 관리자에서 패키지를 열고 배포판의 소프트웨어 설치 프로그램으로 패키지 정보, 아키텍처, 의존성을 확인하세요. 패키지 형식을 인식하지 못하면 deb와 rpm 중 잘못된 파일을 선택했는지 먼저 확인하세요. 의존성을 충족할 수 없다는 안내가 나오면 배포판 버전과 소프트웨어 저장소 상태를 점검하세요. 특정 배포판의 빌드 표시가 붙은 RPM은 확장자가 같다고 해서 모든 RPM 시스템에 적합한 것은 아닙니다.
설치 후 앱 메뉴에서 v2rayN을 실행하고 구독을 가져오세요. Linux 데스크톱 환경마다 시스템 프록시를 읽는 방식이 다릅니다. 일부 앱은 데스크톱 네트워크 설정을 따르지만, 다른 앱은 자체 설정에서 프록시를 지정해야 합니다. 테스트할 때는 프록시 설정을 명확히 지원하는 앱을 선택해 로컬 수신 주소와 포트를 확인한 뒤 다른 트래픽 처리 방식이 필요한지 판단하세요.
TUN 기능이 필요하면 먼저 일반 설정으로 연결을 확인한 다음 클라이언트가 요구하는 권한과 네트워크 환경을 점검하세요. 일상적으로 사용하는 데스크톱 세션 전체를 계속 높은 권한으로 실행하지 마세요. 패키지를 업데이트하기 전에 기존 프로세스를 종료하고 개인 설정 폴더를 보관하세요. 업데이트 후 실행에 문제가 생기면 GUI 의존성 문제와 설정 문제를 구분해 확인하고, 두 문제를 혼동해 구독을 반복해서 수정하지 마세요.
설정이 유효한지 먼저 확인한 다음 앱 트래픽을 프록시로 보내세요. 문제를 찾기 쉽도록 한 번에 한 항목씩 변경하세요.
구독 주소는 여러 설정을 한꺼번에 업데이트할 때 사용하고, 공유 링크는 보통 개별 설정을 가져올 때 사용합니다. 둘 다 접속 정보가 포함될 수 있으므로 댓글이나 스크린샷에 공개하지 마세요. 출처와 유효 기간을 확인한 다음 클라이언트에서 지원하는 가져오기 방식을 선택하세요.
구독 주소를 저장한 뒤 구독 업데이트도 실행해야 합니다. 설정 목록이 나타나면 사용할 항목을 선택하고 프로토콜 유형, 전송 방식, 보안 계층 매개변수를 확인하세요. 가져오기에 실패하면 먼저 형식 호환성을 확인하고 프로토콜을 임의로 바꿔 문제를 해결하려고 하지 마세요.
데스크톱에서는 시스템 프록시를 설정하고 Android에서는 VPN 권한을 허용한 뒤 라우팅 모드와 앱 적용 범위를 확인하세요. 연결이 확인되면 정상 작동하는 설정을 기록해 두세요. 사용을 중단할 때는 클라이언트에서 시스템 프록시를 해제하거나 연결을 끊어 잘못된 로컬 프록시 주소가 남지 않게 하세요.
연결 설정을 바꾸기 전에 시스템, 아키텍처, 설치 방식을 먼저 확인하세요.
처음 사용하는 경우 차세대 크로스 플랫폼 UI를 적용한 Desktop 버전을 권장합니다. 클래식 WPF 버전은 Windows의 기존 UI를 사용하므로 익숙한 사용 흐름을 유지하려는 사용자에게 적합합니다. 두 버전을 동시에 실행하지 마세요. 이전하기 전에 설정을 백업하고 구독, 라우팅, 로컬 포트를 확인하세요.
2015년 이후 출시된 대부분의 스마트폰에는 arm64 버전이 적합하지만, 시스템에서 64비트 앱을 지원하는지 확인해야 합니다. 아키텍처를 모르거나 arm64 패키지가 기기와 호환되지 않는다는 안내가 나오면 범용 버전을 선택하세요. 범용 버전은 더 많은 아키텍처를 지원할 뿐, 연결 속도가 더 빠르다는 뜻은 아닙니다.
Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. 칩 항목에 Apple M 시리즈가 표시되면 Apple Silicon을, 프로세서 항목에 Intel이 표시되면 Intel 버전을 선택하세요. macOS 버전명이 아니라 기기에 실제 탑재된 프로세서를 기준으로 다운로드해야 합니다.
설치 파일에는 바로 사용할 수 있는 서비스 설정이 포함되어 있지 않습니다. 먼저 유효한 구독 주소나 공유 링크를 준비하고, 가져온 뒤 설정을 선택하세요. 그런 다음 플랫폼에 따라 시스템 프록시를 켜거나 VPN 연결을 허용해야 합니다. 구독을 성공적으로 가져와도 서버에 연결할 수 있다는 보장은 없습니다.
현재 클라이언트의 백업 또는 내보내기 기능을 사용해 구독 그룹, 수동 설정, 라우팅 규칙, 필요한 DNS 설정을 보관하고 로컬 수신 포트를 기록하세요. 기존 인스턴스를 종료한 뒤 업데이트하세요. 백업에는 인증 정보가 포함될 수 있으므로 본인이 관리하는 안전한 위치에 보관해야 합니다.
먼저 배포판의 패키지 형식을 확인하세요. Debian·Ubuntu 계열은 보통 deb를 사용하고, RPM 패키지 관리자를 사용하는 배포판은 rpm을 사용합니다. 다음으로 CPU 아키텍처를 확인하세요. x86_64는 amd64, 64비트 ARM은 arm64 또는 aarch64에 해당합니다. 패키지 형식이 맞아도 의존성이 충족되는 것은 아니므로 패키지 관리자의 안내를 확인하세요.