클라이언트 설치 파일 / 운영체제 및 아키텍처
v2rayN은 데스크톱용, v2rayNG는 Android용입니다. 먼저 운영체제를 선택한 뒤 알맞은 설치 파일을 고르세요.
세 클라이언트는 모두 무료 오픈 소스 소프트웨어입니다. 다운로드 후 유효한 구독이나 서버 설정을 가져와야 합니다. 설치 파일, 구독 주소, 프록시 모드 설정은 각각 별도의 단계입니다.
x64 설치 항목 두 가지 중 평소 사용하는 인터페이스에 맞게 선택하세요. 기본 설치 및 구독 가져오기 순서는 같습니다.
차세대 크로스 플랫폼 UI를 사용합니다. 처음 설치하거나 여러 데스크톱 운영체제에서 비슷한 방식으로 사용하려는 경우에 적합합니다.
데스크톱 버전 다운로드 · x64 ZIP 압축 파일 · 압축을 푼 뒤 설치 프로그램 실행기존 Windows 인터페이스를 유지합니다. WPF 사용에 익숙하거나 익숙한 메뉴 구성을 계속 사용하려는 경우에 적합합니다.
WPF 버전 다운로드 · x64 ZIP 압축 파일 · 압축을 푼 뒤 설치 프로그램 실행프로토콜 지원을 늘리려고 두 버전을 모두 설치할 필요는 없습니다. 인터페이스 종류와 코어 설정은 서로 다른 개념이며, 기능은 현재 클라이언트의 실제 설정을 기준으로 확인하세요.
먼저 '설정 → 시스템 → 정보'에서 시스템 종류를 확인하세요. 두 항목 모두 x64 Windows용이며, x64 패키지는 ARM 네이티브 패키지가 아닙니다. 다운로드가 끝나면 ZIP 파일을 일반 사용자에게 읽기·쓰기 권한이 있는 폴더에 완전히 압축 해제한 뒤 안에 있는 설치 프로그램을 실행하세요. 압축 프로그램의 미리보기 창에서 바로 실행하지 마세요.
설치가 끝나면 '구독 그룹 설정'을 열어 구독 출처 이름과 주소를 입력하고 저장한 뒤 구독을 업데이트하세요. 서버 목록이 표시되면 사용할 항목을 선택하고 하단의 시스템 프록시 메뉴에서 '시스템 프록시 자동 설정'을 선택하세요. 브라우저에만 프록시가 필요하다면 우선 이 방법으로 확인하고, 처음부터 TUN을 켤 필요는 없습니다.
WPF와 데스크톱 버전 사이를 전환하거나 업데이트하기 전에 구독, 라우팅 규칙 및 사용자 설정을 백업하고 이전 프로세스를 완전히 종료하세요. 두 인스턴스가 동시에 시스템 프록시를 제어하거나 같은 포트를 수신하지 않도록 하세요. 실행 환경이 없다는 메시지가 표시되면 오류에 나온 환경 이름과 아키텍처를 확인하세요. 클라이언트 이름만 보고 필요한 구성 요소를 추측하지 마세요.
Windows 설치 과정과 인터페이스 선택 →| 확인 항목 | 선택 기준 |
|---|---|
| 프로세서 | x64. 시스템 정보에서 시스템 종류를 확인하세요. |
| 시스템 호환성 | 현재 설치 프로그램의 안내를 따르세요. 구형 시스템과의 호환성은 보장되지 않습니다. |
| 설치 폴더 | 파일을 완전히 압축 해제하고 함께 제공된 파일을 유지하세요. 설정 폴더에 쓰기 권한이 있어야 합니다. |
| 실행 환경 | 필수 환경이 없다는 메시지가 나오면 필요한 실행 환경과 비트 수를 확인하세요. |
| 권한 | 일반 프록시와 TUN에 필요한 권한은 다릅니다. TUN은 보통 권한 상승이 필요합니다. |
먼저 '이 Mac에 관하여'에서 칩 정보를 확인한 뒤 DMG를 선택하세요.
'이 Mac에 관하여'에 Apple M 시리즈 칩이 표시되면 선택하세요. arm64 아키텍처용입니다.
Apple Silicon 버전 다운로드 DMG 디스크 이미지 · arm64컴퓨터 외관이나 구매 연도가 아니라 칩 종류를 기준으로 선택하세요. Apple Silicon 기기에서는 해당 네이티브 아키텍처 패키지를 우선 사용하세요.
DMG를 다운로드한 뒤 두 번 클릭해 마운트하고, 앱을 '응용 프로그램' 폴더로 옮긴 다음 해당 폴더에서 실행하세요. 마운트된 이미지에서 계속 실행하지 마세요. 이미지를 꺼내거나 재시동하면 원래 실행 위치를 찾지 못할 수 있습니다. 시스템에서 앱을 열 수 없다는 메시지가 나오면 전체 안내, 다운로드 출처와 칩 아키텍처를 먼저 확인한 뒤 시스템 설정에서 이번 실행과 관련된 보안 알림을 살펴보세요.
처음 실행한 뒤 구독 그룹을 만들고 구독을 업데이트해 서버 목록이 비어 있지 않은지 확인하세요. 시스템 프록시는 시스템 프록시 설정을 따르는 앱에 주로 적용됩니다. 자체 네트워크 설정을 사용하는 일부 프로그램은 시스템 프록시 변경을 따르지 않을 수 있습니다. 이때는 TUN을 켜기 전에 앱 자체의 프록시 옵션부터 확인하세요. 네트워크 범위를 점검하는 대신 앱을 반복해서 다시 설치하지 마세요.
TUN을 켤 때 시스템 승인이나 보조 구성 요소 권한이 필요할 수 있습니다. 현재 버전의 안내에 따라 진행하세요. 업데이트 전에는 실행 중인 클라이언트를 종료해 이전 프로세스가 백그라운드에서 포트를 점유하지 않도록 하세요. 앱 파일을 덮어써도 사용자 설정이 삭제되는 것은 아니지만, 중요한 설정은 미리 내보내는 것이 좋습니다. 특히 직접 추가한 라우팅 규칙과 사용자 지정 DNS 설정을 백업하세요.
macOS 설치 및 권한 안내 보기 →| 확인 항목 | 선택 기준 |
|---|---|
| 칩 종류 | Apple M 시리즈는 arm64, Intel은 x64를 선택하세요. |
| 시스템 호환성 | 현재 앱의 시스템 요구 사항과 실행 안내를 따르세요. |
| 설치 위치 | 앱을 '응용 프로그램' 폴더로 옮긴 뒤 실행하세요. |
| 최초 권한 승인 | 시스템 보안 안내를 읽고 앱 출처와 요청 권한을 확인하세요. |
| 네트워크 모드 | 먼저 시스템 프록시를 확인하세요. TUN은 필요한 경우에만 권한을 승인하고, 여러 네트워크 제어 도구를 동시에 실행하지 마세요. |
우선 v2rayNG를 선택하세요. 기존 V2Fly 설정을 유지해야 한다면 v2flyNG를 고려하세요.
2015년 이후 출시된 대부분의 휴대전화는 이 항목을 선택하면 됩니다. 기기 시스템이 64비트 앱을 지원하는지 확인하세요.
v2rayNG 다운로드 · arm64 APK 설치 파일 · arm64-v8a아키텍처를 모를 때 선택할 수 있습니다. 여러 아키텍처 구성 요소를 포함하므로 설치 파일 크기가 더 큰 편입니다.
v2rayNG 다운로드 · 범용 버전 APK 설치 파일 · universal버전 표기와 설치 파일 경로는 별도로 업데이트됩니다. 파일 이름의 숫자가 버전 표기와 일시적으로 다를 수 있으니 다운로드 주소를 직접 수정하지 마세요.
기존 V2Fly 설정이 있고 휴대전화가 64비트 앱을 지원하는 경우에 적합합니다. 프로토콜 매개변수가 코어 기능과 호환되는지 확인하세요.
v2flyNG 다운로드 · arm64 APK 설치 파일 · arm64-v8a아키텍처를 모를 때 사용하세요. 범용 패키지는 아키텍처 선택 문제를 줄여 주지만 모든 구형 시스템을 지원하는 것은 아닙니다.
v2flyNG 다운로드 · 범용 버전 APK 설치 파일 · universal브라우저나 파일 관리자에서 APK를 열면 Android에서 해당 출처의 앱 설치를 허용하라는 메시지가 표시될 수 있습니다. 현재 사용하는 출처에만 권한을 부여하고 설치가 끝나면 시스템 설정에서 권한을 해제할 수 있습니다. 파싱 오류가 표시되면 파일 다운로드가 완료됐는지, 시스템 버전과 아키텍처가 맞는지 확인하세요. 다운로드가 끝나지 않은 같은 파일을 계속 설치하지 마세요.
v2rayNG를 열고 '구독 그룹 설정'으로 이동해 유효한 주소를 입력한 뒤 저장하세요. 메인 화면으로 돌아와 구독을 업데이트합니다. 가져오기에 성공해도 연결된 것은 아닙니다. 서버를 선택하고 서비스를 시작해야 합니다. 처음 시작할 때 Android VPN 연결 권한 요청이 표시됩니다. 승인해야 클라이언트가 로컬 트래픽을 제어하는 인터페이스를 만들 수 있습니다. 이 권한으로 서버나 구독이 자동 생성되지는 않습니다.
'앱별 프록시'를 사용하기 전에 선택한 앱에 프록시를 적용할지, 선택한 앱을 프록시에서 제외할지 확인하세요. 두 설정 방향은 서로 바꿔 쓸 수 없습니다. 시스템의 다른 VPN 도구가 같은 연결 슬롯을 사용 중일 수도 있으므로 문제를 확인할 때는 먼저 해당 도구를 중지하세요. 백그라운드에서 연결이 자주 끊기면 배터리 최적화, 백그라운드 실행 제한과 절전 모드를 확인하세요. 설치 파일을 먼저 바꿀 필요는 없습니다.
v2rayNG와 v2flyNG는 서로 다른 클라이언트이므로 모든 프로토콜과 보안 매개변수를 서로 바꿔 쓸 수 있다고 가정하지 마세요. 특히 VLESS 또는 REALITY를 사용할 때는 설정을 옮기기 전에 코어 지원 여부를 확인하세요. 전환 전에 기존 구독과 수동 설정을 보관하고 따로 테스트해, 동시에 실행하여 문제가 헷갈리지 않도록 하세요.
v2rayNG 구독 가져오기 단계 보기 →| 확인 항목 | 선택 기준 |
|---|---|
| 앱 아키텍처 | 64비트 앱을 지원하면 arm64를 우선 선택하세요. 확실하지 않다면 범용 버전을 고려하세요. |
| 시스템 호환성 | 현재 APK의 최소 시스템 요구 사항과 설치 안내를 따르세요. |
| 설치 권한 | 필요한 경우 브라우저나 파일 관리자의 앱 설치를 허용하세요. |
| 연결 권한 | 서비스를 시작할 때 시스템 VPN 권한을 승인하세요. |
| 덮어쓰기 설치 | 앱 이름이 같아도 서명이 호환되어야 합니다. 제거하기 전에 설정을 백업하세요. |
먼저 배포판의 패키지 형식을 확인한 뒤 x64와 arm64 중 선택하세요.
deb 패키지 관리 방식을 사용하는 배포판용입니다. 일반적인 데스크톱 PC는 보통 x64를 선택하지만 시스템 아키텍처를 확인하세요.
deb 다운로드 · x64 arm64 기기: deb 다운로드 →rpm 패키지 관리 방식을 사용하는 배포판용입니다. 패키지 형식이 맞더라도 현재 배포판의 종속성 요구 사항을 충족해야 합니다.
rpm 다운로드 · x64 arm64 기기: rpm 다운로드 →amd64와 x86_64는 일반적인 x64 표기이며, arm64는 aarch64에 해당하는 ARM 64비트 아키텍처입니다. 확장자만으로 호환성을 판단하지 마세요.
시스템의 '정보' 페이지에서 배포판과 프로세서 정보를 확인하세요. deb 패키지 체계를 사용하는 시스템에는 deb를, rpm 체계를 사용하는 시스템에는 rpm을 선택하세요. 같은 패키지 형식이라도 모든 배포판 버전에서 설치되는 것은 아닙니다. 현재 패키지에 필요한 그래픽 구성 요소, 시스템 라이브러리와 데스크톱 환경을 갖춰야 합니다. 설치 프로그램이 표시하는 구체적인 안내를 기준으로 진행하세요.
다운로드한 파일을 배포판 설치 프로그램으로 열어 패키지 관리자가 종속성을 확인하도록 하세요. 라이브러리가 없거나 버전 충돌이 발생하면 전체 메시지를 먼저 기록하고 배포판 버전에 맞춰 해결하세요. 파일 확장자를 바꾸거나 종속성을 강제로 무시해 설치하지 마세요. 이 파일은 그래픽 클라이언트용이며, 사용 가능한 데스크톱 세션이 필요합니다. 명령줄 전용 환경을 위한 서버 프로그램이 아닙니다.
처음 실행한 뒤 구독을 가져오고 일반 프록시 연결을 확인하세요. Linux 데스크톱 환경마다 시스템 프록시를 지원하는 방식이 다를 수 있습니다. 일부 앱은 자체 설정만 사용하고, 일부는 환경 변수를 참조하므로 한 프로그램이 연결된다고 모든 트래픽이 제어된다고 볼 수 없습니다. TUN이 필요하면 클라이언트 안내에 따라 권한을 설정하세요. 편의를 위해 그래픽 환경 전체를 관리자 권한으로 계속 실행하지 마세요.
업데이트할 때는 기존 패키지 관리 방식을 유지하고 이전 클라이언트를 종료한 뒤 새 패키지를 설치하세요. 소프트웨어 제거와 사용자 설정 삭제는 별개의 작업입니다. 조작 전에 패키지 관리자와 클라이언트가 각각 어떤 데이터를 유지하는지 확인하세요. 구독, 라우팅 또는 DNS를 직접 설정했다면 먼저 내보내거나 백업하세요.
Linux 설치 및 권한 안내 보기 →| 확인 항목 | 선택 기준 |
|---|---|
| 패키지 관리 체계 | 배포판에 따라 deb 또는 rpm을 선택하세요. 확장자를 바꿔 형식을 변환하지 마세요. |
| 프로세서 아키텍처 | x64는 amd64·x86_64, arm64는 aarch64에 해당합니다. |
| 데스크톱 환경 | 그래픽 데스크톱 세션과 필요한 시스템 구성 요소가 있어야 합니다. |
| 종속성 호환성 | 패키지 관리자로 시스템 라이브러리와 버전 요구 사항을 확인하세요. |
| 네트워크 권한 | 먼저 일반 프록시를 확인하고, TUN 권한은 안내에 따라 별도로 설정하세요. |
설치를 마치면 그래픽 클라이언트를 사용할 준비가 된 것입니다. 다음으로 신뢰할 수 있는 출처의 구독 주소를 가져와 그룹을 저장하고 구독을 업데이트하세요. 목록이 계속 비어 있다면 주소가 완전한지, 만료되지 않았는지, 그룹 필터가 결과를 숨기고 있지 않은지 확인하세요. 구독 주소에는 접근 자격 정보가 포함될 수 있으므로 공개 게시판에 올리지 마세요. 도움을 요청할 때 올리는 스크린샷에서도 구독 주소, 서버 비밀번호와 개인 식별 정보를 가리세요.
목록이 표시되면 설정 하나를 선택하고 연결을 시작하세요. 데스크톱에서는 먼저 '시스템 프록시 자동 설정'을 시도하고, Android에서는 시스템 VPN 권한을 승인하세요. 시스템 프록시, TUN과 앱별 설정은 트래픽이 클라이언트로 들어오는 범위를 제어하고, 라우팅 규칙은 들어온 트래픽을 어떻게 분할할지 결정합니다. 서로 대체할 수 없습니다. 연결 문제가 생기면 '구독 업데이트 여부 → 서버 선택 여부 → 서비스 실행 여부 → 앱의 프록시 사용 여부' 순서로 확인하세요. 계속 재설치하는 것보다 원인을 찾기 쉽습니다.
VLESS, REALITY 또는 기타 매개변수를 직접 입력해야 한다면 서버 설정을 항목별로 대조하세요. 특히 주소, 포트, 전송 방식, SNI와 관련 키 필드를 확인해야 합니다. 인증서 오류가 발생하면 시스템 시간과 도메인을 먼저 확인하고 검증을 건너뛰지 마세요. 설치 문제와 연결 문제는 별개입니다. 클라이언트는 열리지만 연결되지 않는다면 연결 문제 해결을 참고하세요. 처음 설정하는 경우 구독 가져오기 및 첫 연결 가이드를 따라 진행하세요.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 데스크톱 버전을 권장합니다. 기존 Windows 방식에 익숙하다면 WPF 버전을 선택하세요. 두 설치 파일 모두 x64용입니다. 인터페이스를 바꾸기 전에 설정을 백업하고, 두 클라이언트가 동시에 시스템 프록시를 제어하지 않도록 하세요.
2015년 이후 출시된 대부분의 휴대전화는 arm64를 먼저 선택하면 됩니다. 다만 기기 시스템이 64비트 앱을 지원하는지 확인하세요. 아키텍처를 모르거나 arm64 설치 파일이 아키텍처 불일치로 설치되지 않으면 범용 버전을 시도할 수 있습니다. 범용 패키지라고 해서 모든 구형 시스템을 지원하는 것은 아닙니다.
클라이언트 설치 파일에는 바로 사용할 수 있는 서버 설정이 포함되어 있지 않습니다. 설치 후 직접 준비한 유효한 구독 주소나 개별 설정을 가져오고, 구독을 업데이트한 뒤 서버를 선택하여 프록시 모드를 켜야 합니다. 구독 주소는 민감 정보로 취급하세요.
먼저 제거하지 마세요. 구독 그룹, 라우팅 규칙과 사용자 설정을 백업하고 이전 클라이언트를 완전히 종료한 다음, 같은 클라이언트의 기존 설치 방식에 따라 업데이트하세요. 설치 출처, 서명 또는 클라이언트 종류를 바꾸는 경우 덮어쓰기가 가능하다고 단정할 수 없습니다. 설정을 복구할 수 있는지 확인한 뒤 이전 버전을 처리하세요.
먼저 파일 다운로드가 완료됐는지 확인한 다음 운영체제, 프로세서 아키텍처와 패키지 형식을 점검하세요. Windows용 ZIP은 먼저 압축을 풀어야 하며, macOS는 Apple Silicon과 Intel을 구분해야 합니다. Linux는 deb와 rpm 중 맞는 형식을 선택하세요. 전체 오류 메시지를 기록하고, 시스템 보호를 끄거나 출처가 불분명한 복구 명령을 실행하지 마세요.
클라이언트 버전 표시와 아키텍처별 설치 파일 경로는 별도로 관리되므로 업데이트 중에는 일시적으로 서로 다를 수 있습니다. 클라이언트 이름, 운영체제와 아키텍처를 확인해 선택하고, 표시된 숫자를 보고 다운로드 주소를 직접 수정하지 마세요. 업데이트 호환성이 걱정된다면 기존 설정 백업을 보관하세요.