설치 파일 / 아키텍처 선택 / 초기 설정
V2Ray 클라이언트 다운로드
v2rayN 데스크톱 클라이언트, v2rayNG 및 v2flyNG Android 클라이언트입니다.
운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요. 설치 후에는 가이드를 따라 구독을 추가하고 구성을 선택한 뒤 프록시 모드를 설정하세요.
무료 오픈 소스 클라이언트
그래픽 인터페이스 설정
구독 및 라우팅 관리
Windows 설치 파일
x64 Windows용입니다. Desktop과 WPF 중 하나만 선택하면 됩니다.
시스템 요구 사항 및 패키지 유형
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 시스템 아키텍처 | 이 페이지의 두 설치 파일은 모두 x64입니다. | 시스템 설정의 ‘시스템 종류’에서 확인하세요. 32비트 시스템에서는 이 패키지를 선택하지 마세요. |
| 시스템 및 종속성 | 시스템 업데이트가 계속 제공되는 Windows를 사용하세요. 자세한 호환 범위는 설치 프로그램 안내를 따르세요. | 실행 구성 요소가 없다는 알림이 표시되면 구성 요소 이름에 맞는 아키텍처의 종속성을 설치하세요. |
| 파일 및 권한 | ZIP 압축을 푼 뒤 설치 프로그램 실행 | 설치 폴더에 쓰기 권한이 있는지 확인하세요. TUN 기능에는 관리자 권한이 필요할 수 있습니다. |
Windows 설치 순서
- 먼저 시스템 아키텍처를 확인한 뒤 버전 하나를 다운로드하세요. ZIP 파일을 별도 폴더에 완전히 압축 해제하세요. 압축 파일 미리보기에서 실행하거나 프로그램 파일 하나만 따로 꺼내지 마세요.
- 압축을 푼 폴더에서 설치 프로그램을 실행하고 안내를 확인해 설치를 완료하세요. 시스템 보안 알림이 표시되면 파일 출처와 이름, 알림 내용을 먼저 확인한 뒤 진행 여부를 결정하세요. 설치를 위해 보안 기능을 바로 끄지 마세요.
- v2rayN을 실행하고 구독 그룹과 구독 주소를 추가한 뒤 저장하고 ‘모든 구독 업데이트’를 실행하세요. 구성 목록이 나타나면 하나를 선택하고 사용 환경에 맞춰 시스템 프록시를 설정하세요.
WPF에서 Desktop으로 이전할 때는 기존 설정을 먼저 백업한 뒤 새 인터페이스에서 구독 그룹, 라우팅, DNS를 확인하세요. 두 버전의 설정 폴더나 가져오기 방식이 완전히 같다고 가정하지 마세요. 테스트할 때는 다른 버전을 종료해 로컬 수신 포트 충돌을 방지하세요. 클라이언트를 종료하기 전에 시스템 프록시를 해제하면 이후 앱이 이전 포트를 계속 사용하는 문제를 줄일 수 있습니다.
macOS 설치 파일
‘이 Mac에 관하여’에서 칩 정보를 확인한 뒤 맞는 DMG 파일을 선택하세요.
v2rayN
데스크톱 클라이언트시스템 요구 사항 및 패키지 유형
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 프로세서 | Apple Silicon은 arm64, Intel은 x64 선택 | ‘이 Mac에 관하여’를 열어 칩 또는 프로세서 항목을 확인하세요. |
| 시스템 호환성 | 현재 설치 파일에 명시된 정보와 시스템 시작 시 안내를 따르세요. | 현재 macOS 버전을 기록하고 호환성 문제가 생기면 시스템 요구 사항을 먼저 확인하세요. |
| 설치 및 권한 | DMG 디스크 이미지입니다. 일부 네트워크 기능에는 시스템 권한이 필요합니다. | 앱을 ‘응용 프로그램’ 폴더에 복사하고 처음 실행할 때 권한 안내를 확인하세요. |
macOS 설치 순서
- 다운로드한 DMG를 열고 v2rayN을 ‘응용 프로그램’ 폴더에 복사하세요. 복사가 끝나면 마운트된 디스크 이미지에서 계속 실행하지 말고 응용 프로그램 폴더에서 실행하세요.
- 시스템에서 실행을 차단하면 출처와 시스템 안내를 먼저 확인한 뒤 시스템 설정의 ‘개인정보 보호 및 보안’에서 관련 설명을 살펴보세요. 일반적인 설치 문제를 해결하기 위해 시스템 보안 기능을 끄지 마세요.
- 구독을 가져와 구성을 업데이트하세요. 먼저 시스템 프록시로 브라우저 접속을 확인한 다음 필요에 따라 TUN을 설정하세요. 권한 요청이 표시되면 현재 실행 중인 클라이언트에서 보낸 요청인지 확인하세요.
설치 파일 아키텍처는 앱 실행 방식에 영향을 주고, 라우팅 규칙은 트래픽 전달 방식을 결정합니다. 서로 다른 문제이므로 앱이 시작되지 않으면 시스템 버전, 프로세서, 권한을 먼저 확인하고, 앱은 실행되지만 접속이 안 되면 구성, 구독, 프록시 모드를 확인하세요. 업데이트 전에 이전 프로세스를 종료하고 설정을 백업하세요. 업데이트 후에는 로컬 포트를 확인해 브라우저가 이전 수동 프록시 설정을 계속 사용하지 않도록 하세요.
Android 설치 파일
먼저 v2rayNG를 선택하세요. v2fly 코어가 필요할 때는 v2flyNG를 고려하세요.
v2rayNG
추천v2flyNG
대안시스템 요구 사항 및 패키지 유형
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 기기 아키텍처 | 일반적인 스마트폰은 arm64 권장, 아키텍처를 모르면 범용 버전 선택 | 기기 정보를 확인해 선택하세요. 범용 버전도 앱의 시스템 요구 사항을 충족해야 합니다. |
| 설치 형식 | APK, 시스템 설치 프로그램으로 실행 | 이번 설치에 사용할 브라우저나 파일 관리자에만 앱 설치 권한을 허용하세요. |
| 네트워크 권한 | 연결할 때 Android VPN 권한이 필요합니다. | 다른 VPN 앱이 연결을 사용 중인지 확인하세요. |
| 백그라운드 실행 | 지속적인 연결은 시스템 절전 정책의 영향을 받을 수 있습니다. | 연결이 자주 끊길 때 배터리 최적화와 백그라운드 제한을 확인하세요. |
Android 설치 및 첫 연결
다운로드한 APK를 파일 관리자에서 열고 설치 프로그램 안내를 확인하세요. ‘앱이 설치되지 않았습니다’가 표시되면 아키텍처, 저장 공간, 시스템 호환성, 서명이 다른 이전 설치가 있는지 먼저 확인하세요. 설정이 저장된 앱을 바로 삭제하지 마세요. 사용할 수 있는 설정을 내보내고 백업을 찾을 수 있는지 확인한 뒤 설치 충돌을 처리하세요.
클라이언트를 열고 구독 주소를 추가해 업데이트한 다음 구성을 선택하고 연결을 누르세요. 처음 연결할 때 시스템에 VPN 권한 대화상자가 표시됩니다. 앱 이름을 확인한 뒤 허용하세요. Android는 시스템 VPN 인터페이스를 사용하므로 데스크톱의 ‘시스템 프록시 자동 설정’과는 다릅니다. 데스크톱 메뉴 경로를 그대로 따라 하지 마세요.
v2rayNG와 v2flyNG는 서로 다른 방식으로 비교해 사용할 수 있지만, 한 번에 하나의 앱만 VPN 연결을 설정해야 합니다. 클라이언트를 바꾼 뒤에는 선택한 구성과 라우팅 모드를 다시 확인하세요. 화면을 잠근 뒤 연결이 끊기면 백그라운드 제한을 먼저 확인하고 로그를 살펴보세요. 절전 정책으로 인한 연결 끊김을 구독 오류로 오해하지 않도록 하세요.
Linux 설치 파일
Linux 데스크톱 환경용입니다. 배포판의 패키지 형식과 시스템 아키텍처에 맞춰 선택하세요.
v2rayN
데스크톱 클라이언트시스템 요구 사항 및 패키지 유형
| 확인 항목 | 선택 기준 | 설치 전 확인 |
|---|---|---|
| 데스크톱 환경 | 그래픽 데스크톱 세션이 필요합니다. | 이 페이지는 그래픽 클라이언트 설치를 안내하며 명령줄만 사용하는 배포 환경에는 해당하지 않습니다. |
| 패키지 관리 형식 | deb 또는 rpm | 시스템 정보와 소프트웨어 관리자를 통해 배포판 종류와 버전을 확인하세요. |
| 프로세서 아키텍처 | x64는 amd64 또는 x86_64, arm64는 aarch64에 해당합니다. | 설치된 시스템의 아키텍처에 맞춰 선택하세요. 프로세서 제품명만 보고 판단하면 안 됩니다. |
| 종속성 및 권한 | 소프트웨어 설치 프로그램에서 종속성을 확인합니다. 네트워크 트래픽을 처리하는 기능에는 추가 권한이 필요할 수 있습니다. | 명시된 종속성 문제를 먼저 해결한 뒤 클라이언트를 실행하세요. |
Linux 그래픽 환경 설치 순서
- 배포판, 버전, 시스템 아키텍처를 확인하고 알맞은 패키지를 선택하세요. 다운로드한 파일을 두 번 클릭해 시스템 소프트웨어 설치 프로그램에서 패키지 정보와 종속성 안내를 확인하세요.
- 소프트웨어 설치 프로그램으로 설치와 종속성 처리를 완료한 뒤 앱 메뉴에서 v2rayN을 실행하세요. 실행 항목이 보이지 않으면 설치가 완료됐는지 먼저 확인한 다음 데스크톱 세션을 새로고침하거나 다시 로그인하세요.
- 구독을 추가하고 업데이트한 뒤 구성을 선택해 프록시를 설정하세요. 데스크톱 환경마다 시스템 프록시를 읽는 방식이 다를 수 있으므로 시스템 프록시를 따르는 브라우저로 먼저 확인하세요.
종속성을 충족할 수 없으면 소프트웨어 설치 프로그램에 표시된 구성 요소 이름과 필요한 버전을 기록한 뒤 배포판 호환성을 확인하세요. 설치를 강행하려고 종속성 문제를 무시하지 마세요. TUN, 시스템 프록시, 앱 자체 프록시 설정은 서로 다른 계층이므로 하나씩 테스트하세요. 터미널 도구가 데스크톱 시스템 프록시를 자동으로 따르지 않을 수도 있습니다.
로그인 후 자동으로 시작하려면 먼저 수동 실행과 연결이 정상인지 확인한 뒤 데스크톱 환경의 ‘시작 애플리케이션’에 클라이언트 항목을 추가하세요. 설치 및 자동 시작에 대한 자세한 내용은 Linux 데스크톱 설치 가이드를 참고하세요.
다운로드 후 설정 순서
설치, 구독, 프록시 모드
설치 파일은 프로그램 실행 여부를 결정하고 구독과 라우팅은 연결 방식을 결정합니다. 순서대로 확인하면 불필요한 작업을 줄일 수 있습니다.
먼저 프로그램을 실행한 뒤 구성을 가져오세요.
설치가 완료돼도 연결이 설정된 것은 아닙니다. 먼저 클라이언트 창이 열리는지, 로그에 시작 오류가 계속 표시되지 않는지 확인한 뒤 구독 주소나 기존 공유 링크를 준비하세요. 구독 주소는 사용자가 직접 준비해야 하며 이 페이지의 설치 파일에는 사용할 수 있는 연결 설정이 포함되지 않습니다.
데스크톱에서는 구독 그룹을 추가한 뒤 주소를 입력하고 저장한 다음 ‘모든 구독 업데이트’를 실행하세요. Android에서도 구독 설정에 주소를 추가하고 업데이트해야 합니다. 구성 목록에 항목이 표시되고 유효한 구성을 선택한 뒤에 트래픽 연결 방식을 설정하세요. 업데이트에 실패하면 주소가 완전한지, 만료되지 않았는지, 기본 네트워크로 구독 서버에 접속할 수 있는지 먼저 확인하세요.
시스템 프록시와 TUN을 따로 확인하세요.
데스크톱의 시스템 프록시는 주로 시스템 프록시 설정을 따르는 앱에서 사용합니다. TUN은 가상 네트워크 인터페이스를 통해 트래픽을 처리하며 추가 권한이 필요할 수 있습니다. 처음 설정할 때는 한 가지 모드부터 테스트하고 연결과 라우팅이 정상인지 확인한 뒤 다른 모드가 필요한지 판단하세요. DNS, 라우팅, 연결 모드를 동시에 바꾸면 어떤 변경이 결과에 영향을 줬는지 파악하기 어렵습니다.
Android에서는 연결 전에 VPN 권한을 확인하고, 연결한 뒤 브라우저 접속과 클라이언트 로그를 살펴보세요. 연결 아이콘은 네트워크 인터페이스가 설정됐다는 뜻일 뿐 모든 대상에 접속할 수 있다는 의미는 아닙니다. 문제가 생기면 오류 메시지 원문과 발생 단계를 기록한 뒤 증상에 따라 문제 해결을 확인하세요.
다운로드 및 설치 FAQ
설치 파일 선택 FAQ
버전, 아키텍처, 업데이트, 첫 연결 순서로 해당 항목을 확인하세요.
Windows 데스크톱 버전과 클래식 WPF 버전, 어떤 것을 선택할까요?
처음 설치한다면 차세대 크로스 플랫폼 UI를 사용하는 Desktop 버전을 먼저 선택할 수 있습니다. 클래식 WPF 버전은 익숙한 Windows 화면과 작업 흐름을 유지합니다. 두 버전 모두 설정과 구독을 관리합니다. 전환하기 전에 설정을 백업하고, 테스트할 때는 한 번에 하나만 실행하세요.
arm64, x64, 범용 버전은 어떻게 선택하나요?
기기의 시스템 정보에서 프로세서와 운영체제 아키텍처를 확인하세요. Mac의 Apple Silicon은 arm64, Intel은 x64를 선택하고, Linux는 시스템 아키텍처에 맞는 패키지를 선택합니다. 2015년 이후 출시된 일반적인 Android 휴대폰은 arm64를 먼저 시도하세요. 설치가 호환되지 않거나 아키텍처를 알기 어렵다면 범용 버전을 선택할 수 있지만, 일부 기기는 실제 시스템 지원 여부를 확인해야 합니다.
ZIP 파일을 다운로드한 뒤 바로 설정할 수 없는 이유는 무엇인가요?
Windows 다운로드 파일은 ZIP 압축 파일입니다. 먼저 압축을 완전히 푼 다음 폴더 안의 설치 프로그램을 실행하고 안내에 따라 설치하세요. 압축 파일 미리보기에서 바로 실행하지 마세요. 압축을 푼 뒤 파일이 없으면 압축 해제 결과와 시스템 보안 알림을 확인하고, 보안 기능을 바로 끄지 마세요.
클라이언트를 설치하면 구독도 포함되나요?
설치 파일에는 클라이언트 프로그램만 포함되며 사용할 수 있는 구독이나 연결 설정은 제공되지 않습니다. 구독 주소는 사용자가 직접 준비해야 합니다. 데스크톱에서 구독 주소를 추가하고 저장한 뒤에는 ‘모든 구독 업데이트’를 실행하고 사용할 구성을 선택하세요. 구독 링크에 접속 정보가 포함될 수 있으므로 공개하지 마세요.
설치를 업데이트하기 전에 무엇을 보관해야 하나요?
구독 그룹, 수동 설정, 라우팅 규칙, DNS 등 사용자 지정 설정을 먼저 백업한 뒤 실행 중인 클라이언트를 종료하세요. 클라이언트의 내보내기 또는 백업 기능을 우선 사용하고 백업 위치를 기록해 두세요. 업데이트 후 설정을 확인한 다음 시스템 프록시나 TUN을 활성화해 사용자 지정 설정이 덮어써지지 않도록 하세요.
설치는 완료됐지만 연결되지 않을 때 어디부터 확인해야 하나요?
기본 네트워크 연결과 기기 시간이 정상인지, 구독 업데이트가 완료됐고 구성이 선택됐는지 확인한 뒤 클라이언트 로그를 살펴보세요. 데스크톱에서는 시스템 프록시와 TUN을 따로 테스트하고, Android에서는 VPN 권한과 다른 VPN 앱의 연결 사용 여부를 확인하세요. 증상별로 하나씩 점검하고 여러 설정을 한꺼번에 바꾸지 마세요.