데스크톱 클라이언트 / Android 클라이언트
먼저 운영체제를 선택한 다음 기기 아키텍처를 선택하세요.
데스크톱에는 v2rayN, Android에는 v2rayNG를 추천합니다. 클라이언트는 무료이며 오픈소스입니다. 설치한 뒤 사용할 권한이 있는 구독 또는 설정을 직접 가져와야 합니다.
DESKTOP / X64
같은 클라이언트의 두 가지 인터페이스입니다. 처음 설치할 때 하나만 선택하면 됩니다.
Desktop 데스크톱 버전
데스크톱 버전 다운로드 · x64차세대 크로스 플랫폼 UI입니다. 처음 설치하거나 데스크톱 운영체제가 달라도 비슷한 방식으로 사용하고 싶은 분에게 적합합니다.
클래식 WPF 버전
클래식 WPF 버전 다운로드 · x64기존 Windows WPF 인터페이스를 유지하는 안정 버전입니다. 이전 메뉴 구성에 익숙하고 기존 사용 방식을 이어가고 싶은 분에게 적합합니다.
두 다운로드 항목 모두 ZIP 파일입니다. 다운로드가 끝나면 압축을 완전히 푼 뒤 폴더 안의 설치 프로그램을 실행하세요. 압축 프로그램의 미리보기 창에서 바로 실행하지 마세요. 인터페이스 버전에 따라 서버 연결 품질이 달라지지는 않습니다. 사용 방식과 현재 환경의 호환성을 기준으로 선택하세요.
v2rayN을 처음 실행했을 때 서버 목록이 비어 있는 것은 정상입니다. ‘구독 그룹’에서 구독 주소를 추가한 뒤 ‘모든 구독 업데이트(프록시 사용 안 함)’를 실행하세요. 사용할 수 있는 프록시가 이미 있고 구독 주소에 접속할 때 프록시가 필요한 경우에는 현재 네트워크 환경에 맞는 업데이트 방식을 선택하세요. 구독 업데이트가 완료되면 사용할 서버를 선택하고 ‘시스템 프록시’를 ‘시스템 프록시 자동 구성’으로 설정하세요.
브라우저에서 사이트에 접속할 수 없다면 먼저 브라우저가 시스템 프록시를 따르는지 확인한 뒤 클라이언트 로그를 살펴보세요. 시스템 프록시는 해당 설정을 읽는 앱에만 적용되므로 모든 프로그램의 트래픽이 클라이언트를 거치는 것은 아닙니다. 클라이언트를 종료하거나 바꾸기 전에 기존 시스템 프록시 설정을 해제하세요. 종료된 로컬 포트를 계속 가리킬 수 있습니다.
DESKTOP / APPLE SILICON & INTEL
‘이 Mac에 관하여’에서 칩을 확인하세요. 컴퓨터를 구입한 연도만으로 아키텍처를 추측하지 마세요.
Apple Silicon
Apple Silicon 다운로드 · arm64‘이 Mac에 관하여’에 Apple 칩이 표시되는 기기에서 선택하세요. M 시리즈 칩 모델이 여기에 포함됩니다.
DMG를 연 뒤 v2rayN을 ‘응용 프로그램’ 폴더로 드래그하고 해당 폴더에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하지 마세요. 복사가 끝나면 디스크 이미지를 추출해도 됩니다. 앱 경로를 유지하면 이후 업데이트와 권한 설정도 일관되게 관리할 수 있습니다.
다운로드한 앱을 처음 열 때 시스템 보안 경고가 표시될 수 있습니다. 먼저 출처와 파일 다운로드가 완료됐는지 확인한 다음 안내에 따라 ‘시스템 설정 → 개인정보 보호 및 보안’에서 차단된 앱 열기 요청을 처리하세요. 문제를 우회하려고 시스템 보안 기능을 통째로 끄지 마세요. 앱이 손상되었다는 메시지가 분명히 표시되면 설치 파일을 다시 다운로드하고 호환성을 확인하는 것이 좋습니다.
구독을 가져오고 서버를 선택한 다음 시스템 프록시를 활성화하세요. 요청이 클라이언트에 전달되지 않으면 ‘시스템 설정 → 네트워크’에서 현재 네트워크 서비스의 프록시 설정을 확인하고 다른 프록시 도구가 설정을 동시에 변경하고 있지 않은지 살펴보세요. 처음 문제를 확인할 때는 클라이언트 하나만 실행하고 시스템 프록시와 TUN을 따로 테스트하세요. 두 가지 연결 방식이 동시에 적용되면 원인을 찾기 어려워집니다. 플랫폼별 전체 절차는 macOS 설치 및 설정 가이드를 참고하세요.
ANDROID / ARM64 & UNIVERSAL
먼저 v2rayNG를 확인하세요. 기존 V2Fly 설정을 사용해야 한다면 v2flyNG를 고려하세요.
범용 버전
v2rayNG 다운로드 · 범용 버전아키텍처를 모르거나 arm64 파일을 설치할 수 없을 때 선택할 수 있는 대안입니다. 여러 아키텍처 구성 요소를 포함하므로 파일 크기가 더 클 수 있습니다.
v2rayNG는 Xray 코어를 사용하며 대부분의 Android 초보 설정에 적합합니다. 설치한 뒤 구독 그룹을 추가하고 구독을 업데이트한 다음 서버를 선택해 연결을 시작하세요. 처음 실행할 때 시스템 VPN 연결 요청이 표시됩니다. 기기의 트래픽을 처리하기 위해 필요한 권한이므로 앱을 확인한 후 허용하세요.
현재 목록에 표시된 버전과 파일 이름이 일치하지 않습니다. 위에는 릴리스 목록의 값이 표시되며 APK 파일 이름은 2.3.11입니다. 실제 설치 버전은 클라이언트의 ‘정보’에서 확인하세요.
범용 버전
v2flyNG 다운로드 · 범용 버전아키텍처를 잘 모를 때 선택할 수 있습니다. 범용 패키지는 코어 기능을 바꾸지 않으며 시스템 자체의 호환성 문제를 해결해 주지도 않습니다.
v2flyNG는 v2fly 코어를 사용하며 기존 V2Fly 설정을 유지해야 하는 사용자에게 적합합니다. 두 Android 클라이언트의 코어 기능은 완전히 같지 않으므로 구독 주소가 같다는 이유만으로 모든 설정을 서로 바꿔 쓸 수 있다고 단정하지 마세요. 전환하기 전에 필요한 프로토콜과 전송 방식을 확인하고 다른 클라이언트의 VPN 연결을 먼저 종료하세요.
APK를 설치해도 연결이 자동으로 설정되지는 않습니다. 구독을 가져오고 서버 목록을 업데이트한 뒤 서버를 선택해야 연결할 수 있습니다. 연결이 설정되면 Android 상태 표시줄에서 VPN 표시를 확인할 수 있지만, 이 표시는 로컬 VPN 서비스가 시작되었다는 뜻일 뿐 원격 서버가 정상이라는 뜻은 아닙니다. 대상 사이트에 접속하고 실행 로그를 확인해 요청이 성공했는지 검증하세요.
화면을 잠근 뒤 연결이 자주 끊기면 클라이언트의 배터리 최적화와 백그라운드 활동 제한을 확인하세요. 제조사마다 메뉴 이름이 다를 수 있으므로 클라이언트 관련 항목만 조정하면 됩니다. 전체 절전 관리를 끌 필요는 없습니다. 다른 클라이언트를 테스트하려면 현재 연결을 먼저 끊어 시스템 VPN을 새로 실행한 앱이 대체하지 않도록 하세요. 자세한 절차는 Android 설치 및 설정 안내를 참고하세요.
DESKTOP / DEB & RPM
먼저 배포판의 패키지 형식을 확인한 뒤 x64 또는 arm64 아키텍처를 확인하세요.
ARM 기기용 설치 파일
배포판의 소프트웨어 설치 프로그램으로 다운로드한 파일을 열고 의존성 확인 결과를 살펴보세요. deb와 rpm은 서로 다른 패키지 형식이므로 확장자만 바꿔서 호환할 수 없습니다. arm64와 aarch64는 일반적으로 같은 64비트 ARM 아키텍처를 가리키는 이름이며, amd64와 x86_64는 일반적인 x64 데스크톱 프로세서에 해당합니다.
Linux 데스크톱 환경마다 프록시 설정 방식이 다를 수 있습니다. 구독을 가져오고 서버를 시작한 뒤 데스크톱 프록시 설정을 따르는 브라우저로 먼저 테스트하세요. 다른 앱은 HTTP 또는 SOCKS 프록시를 따로 설정해야 할 수 있습니다. 클라이언트에 현재 표시된 수신 주소와 포트를 기준으로 설정하고 다른 운영체제 안내에 나온 포트를 그대로 사용하지 마세요.
처음 설치할 때는 일반 프록시 경로가 작동하는지 먼저 확인한 뒤 TUN을 고려하세요. TUN은 네트워크 장치, 라우팅, DNS에 영향을 주므로 권한이나 배포판 차이에 따라 결과가 달라질 수 있습니다. 활성화한 뒤 네트워크 문제가 생기면 TUN을 끄고 재현 가능한 기본 설정으로 되돌린 다음 항목별로 확인하세요. 전체 절차는 Linux 설치 및 설정 가이드를 참고하세요.
다운로드 및 설정
설치 파일, 구독 설정, 로컬 프록시는 서로 다른 세 단계입니다. 순서대로 확인하면 반복해서 재설치하는 것보다 문제를 쉽게 찾을 수 있습니다.
기기의 시스템 정보에서 프로세서 종류를 확인한 뒤 맞는 설치 파일을 선택하세요. 운영체제 이름이 같아도 아키텍처는 다를 수 있습니다. 노트북, 데스크톱, ARM 기기도 겉모습만으로 판단할 수 없습니다. 아키텍처가 맞지 않으면 설치 또는 실행이 되지 않을 수 있으며, 이는 구독 내용과 무관합니다.
파일을 열기 전에 브라우저의 다운로드 목록을 유지하고 다운로드가 완료됐는지 확인하세요. 저장된 파일이 예상한 ZIP, DMG, APK, deb 또는 rpm이 아니라 웹페이지라면 확장자만 바꿔 설치를 진행하지 말고 다운로드 상태와 네트워크를 확인하세요.
구독 그룹, 현재 라우팅 모드, 직접 변경한 수신 설정을 기록하세요. 설정 내보내기 기능이 있으면 클라이언트에서 내보내는 것이 좋습니다. 설정에 구독 주소나 접근 인증 정보가 포함될 수 있으므로 본인이 관리하는 위치에 저장하고 문제 확인용 스크린샷으로 공개하지 마세요.
기존 클라이언트를 종료한 뒤 새 패키지를 설치하세요. 업데이트가 끝나면 구독이 유지됐는지 확인한 다음 라우팅과 프록시 상태를 점검하세요. 다른 플랫폼으로 옮길 때는 구독을 다시 가져온 뒤 설정을 하나씩 복구하세요. 기존 데이터 디렉터리 전체를 다른 시스템에 그대로 덮어쓰는 것은 권장하지 않습니다.
먼저 서버를 선택한 다음 필요한 트래픽 처리 방식을 활성화하세요. 데스크톱에서는 보통 시스템 프록시를 먼저 테스트하고, Android에서는 시스템 VPN 요청을 확인합니다. 연결 버튼이 실행 상태를 표시하거나 상태 표시줄에 아이콘이 나타나는 것만으로는 로컬 서비스 상태만 확인할 수 있습니다. 원격 연결은 실제 요청으로 검증해야 합니다.
브라우저에서 접속할 수 없으면 구독 업데이트 성공 여부, 앱의 프록시 사용 여부, 실행 로그의 오류를 각각 확인하세요. 포트 충돌, 인증 실패, 연결 시간 초과는 서로 다른 문제입니다. 로그를 바탕으로 원인을 좁힌 뒤 설정을 변경할지 구성 제공자에게 문의할지 결정하세요.
처음 설치한다면 차세대 크로스 플랫폼 인터페이스를 사용하는 Desktop 버전을 선택할 수 있습니다. 기존 Windows 인터페이스에 익숙하거나 이전 작업 방식을 유지하려면 클래식 WPF 안정 버전을 선택하세요. 둘 다 v2rayN이므로 처음에는 한 가지만 설치하면 됩니다. 버전을 바꾸기 전 설정을 백업하세요.
2015년 이후 출시된 대부분의 스마트폰은 arm64를 선택하면 되지만, 실제 기기 아키텍처와 시스템 지원 여부를 확인하세요. 아키텍처를 모르거나 arm64 설치 시 호환성 오류가 표시되면 범용 버전을 시도할 수 있습니다. 범용 버전은 여러 아키텍처 구성 요소를 포함해 파일 크기가 더 클 수 있지만 연결 속도가 더 빠른 것은 아닙니다.
설치 파일에는 클라이언트 프로그램만 포함되며 구독이나 서버 설정은 제공되지 않습니다. 사용할 권한이 있는 구독 주소나 설정 파일을 준비해 가져온 다음 서버를 선택하고, 플랫폼에 따라 시스템 프록시 또는 VPN 연결을 활성화해야 합니다. 연결에 실패하면 구독 내용, 로컬 프록시 설정, 실행 로그를 각각 확인하세요.
먼저 다운로드 파일이 칩에 맞는지 확인하고 앱을 ‘응용 프로그램’ 폴더로 옮기세요. 다운로드 출처를 확인한 뒤 시스템 안내에 따라 ‘시스템 설정 → 개인정보 보호 및 보안’에서 차단된 앱 열기 요청을 처리할 수 있습니다. 앱이 손상되었다는 메시지가 표시되면 설치 파일을 다시 다운로드하고 시스템 호환성을 확인하세요. 시스템의 보안 기능을 통째로 끄지는 마세요.
설정 유지 여부는 설치 방식, 데이터 디렉터리, 버전 간 차이에 따라 달라집니다. 업데이트 전에 클라이언트 설정을 백업하고 구독 그룹과 라우팅 설정을 기록한 뒤 기존 프로그램을 종료하세요. 인터페이스 버전을 바꾸거나 다른 운영체제로 이전할 때 설정 디렉터리 전체를 그대로 덮어써도 된다고 가정하지 마세요.
페이지의 버전 표시와 아키텍처별 파일의 릴리스 정보가 서로 다를 수 있습니다. 실제 설치 버전은 설치 후 클라이언트의 ‘정보’에서 확인하고, 파일 이름은 다운로드 패키지를 구분하는 데 사용하세요. 기존 설정이 특정 버전에 의존한다면 먼저 백업한 뒤 새 파일의 실제 버전과 설정 호환성을 확인하고 교체하세요.