v2rayN
두 링크 모두 x64용 ZIP 파일입니다. Desktop은 차세대 크로스 플랫폼 인터페이스로, 처음 설치한다면 이 버전부터 시작해도 좋습니다. WPF는 안정적인 클래식 버전으로, 익숙한 화면과 작업 방식을 유지하고 싶은 사용자에게 적합합니다. 둘 중 하나만 선택하세요.
데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 권장합니다. 설정에서 요구하는 경우 v2flyNG를 선택할 수도 있습니다. 먼저 대상 운영체제로 전환한 다음 아키텍처와 패키지 형식을 선택하세요.
패키지 선택 순서운영체제 → 프로세서 아키텍처 → 설치 파일
두 링크 모두 x64용 ZIP 파일입니다. Desktop은 차세대 크로스 플랫폼 인터페이스로, 처음 설치한다면 이 버전부터 시작해도 좋습니다. WPF는 안정적인 클래식 버전으로, 익숙한 화면과 작업 방식을 유지하고 싶은 사용자에게 적합합니다. 둘 중 하나만 선택하세요.
ZIP 파일을 쓰기 권한이 있는 폴더에 완전히 압축 해제한 다음 설치 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하거나 설치 프로그램만 따로 꺼내고 같은 폴더의 파일을 무시하지 마세요. 회사나 기관에서 관리하는 기기에 설치한다면 먼저 기기 관리 정책에 따라 권한을 확인하세요.
프로그램이 열리지 않으면 시스템 안내가 아키텍처 불일치, 실행 환경 필요, 폴더 쓰기 권한 중 무엇을 가리키는지 먼저 확인하세요. 실행 환경이 필요하다는 안내가 나오면 팝업에 표시된 구성 요소와 버전을 확인하세요. 다른 인터페이스 버전으로 바꿔도 시스템 아키텍처 불일치는 해결되지 않습니다.
클래식 버전에서 Desktop 버전으로 전환하기 전에 기존 구독과 사용자 지정 규칙을 저장한 뒤 트레이 메뉴에서 이전 클라이언트를 종료하세요. 새 인터페이스에서 구독 업데이트와 연결이 정상적으로 되는 것을 확인한 후 이전 버전을 정리하세요. 기존 설정을 유지하는 경우 두 프로그램이 현재 사용 중인 동일한 데이터에 접근하도록 함부로 설정하지 마세요.
Apple 메뉴에서 「이 Mac에 관하여」를 여세요. Apple M 시리즈 칩이면 Apple Silicon(arm64), Intel 프로세서면 Intel(x64)을 선택하세요. 컴퓨터를 구매한 연도로 칩 종류를 판단하지 마세요.
DMG 파일을 열고 클라이언트를 「응용 프로그램」 폴더로 드래그한 뒤 해당 폴더에서 실행하세요. 설치가 끝나면 디스크 이미지를 추출해도 됩니다. 이미지 창에서 바로 실행하면 이미지를 추출한 뒤에는 해당 위치에서 프로그램을 열 수 없습니다.
시스템 안내가 표시되면 현재 시스템 버전의 호환성 문제인지, 프로세서 아키텍처 불일치인지, 기기 관리 정책에 따른 제한인지 먼저 구분하세요. 앞의 두 항목은 시스템 정보와 설치 파일을 다시 확인해야 합니다. 관리되는 기기라면 관리자에게 안내된 절차에 따라 설치를 요청하세요. 앱 하나를 설치하려고 시스템 전체의 보안 기능을 끄지 마세요.
이전 버전을 교체하기 전에 클라이언트를 완전히 종료하세요. 주 창만 닫아서는 충분하지 않습니다. 설치 후 「응용 프로그램」 폴더에 있는 새 사본이 열리는지 확인하고 기존 구독이 유지되어 있는지도 살펴보세요. 열리지 않는다면 같은 이미지를 반복해서 마운트하기보다 오류 메시지 원문과 칩 종류를 기록해 두는 것이 문제를 파악하는 데 도움이 됩니다.
Xray 코어를 사용합니다. 2015년 이후 출시된 주류 스마트폰은 대부분 arm64를 우선 선택할 수 있습니다. 시스템에서 arm64-v8a를 지원한다면 이 패키지를 선택하세요. 앱 아키텍처를 확인하기 어렵다면 범용 버전을 먼저 사용해 보세요.
v2fly 코어를 사용합니다. 기존 설정에서 이 코어를 명시적으로 요구하는 경우에 선택하세요. 같은 구독을 다른 클라이언트로 가져오더라도 노드가 목록에 표시되는지만 보지 말고 설정 요구 사항을 확인해야 합니다.
브라우저나 파일 관리자에서 APK를 여세요. 시스템에서 권한을 요청하면 현재 설치 출처를 확인한 뒤 파일을 실제로 여는 앱에만 설치 권한을 부여하세요. 설치가 끝나면 권한을 해제해도 됩니다. 처음 연결할 때 요청하는 VPN 권한은 설치 권한과 다릅니다. 현재 팝업에 표시된 앱 이름을 기준으로 확인하세요.
앱이 이미 설치되어 있어 업데이트할 수 없다는 메시지가 나오면 이전 버전의 설치 경로와 서명이 같은지 먼저 확인하세요. arm64 패키지나 범용 패키지로 바꿔도 이전 버전의 서명은 달라지지 않습니다. 앱을 삭제해야 한다면 구독과 수동 설정을 잃지 않도록 앱에서 제공하는 방법으로 먼저 백업하세요.
Debian과 Ubuntu에서는 보통 deb 패키지를 먼저 확인하세요. RPM 패키지 관리자를 사용하는 배포판에서는 rpm을 확인하면 됩니다. 패키지 형식이 같다고 배포판과 종속성까지 호환되는 것은 아닙니다. 특히 이 사이트의 RPM 패키지 이름에 포함된 el10 빌드 식별자를 확인하세요.
시스템 정보에서 배포판, 시스템 버전, 현재 아키텍처를 먼저 확인하세요. 패키지 이름의 amd64 또는 x86_64는 x64에, arm64 또는 aarch64는 arm64에 해당합니다. 가상 머신에 설치한다면 가상 머신 내부의 시스템 아키텍처를 기준으로 하세요.
해당 형식의 로컬 패키지를 열어 배포판의 소프트웨어 설치 프로그램에서 종속성을 확인하세요. 종속성이 누락되었다는 안내가 나오면 누락된 패키지 이름과 버전을 기록한 다음 현재 소프트웨어 저장소에서 제공하는지 확인하세요. 확장자만 바꿔 형식을 변환하거나 종속성을 무시한 채 강제로 설치하지 마세요.
이 앱은 GUI 클라이언트이므로 설치 전에 기기에서 사용할 수 있는 데스크톱 세션이 있는지 확인하세요. 데스크톱 환경마다 시스템 프록시를 처리하는 방식이 다를 수 있습니다. 설치 후 일부 앱만 프록시를 사용한다면 해당 앱이 데스크톱 프록시 설정을 읽는지 먼저 살펴보세요. 이 현상만으로 설치에 실패했다고 판단하지 마세요.
이번 작업이 신규 설치인지, 기존 버전 업데이트인지, 클라이언트 교체인지 먼저 확인하세요. 신규 설치에서는 기기가 설치 파일을 실행할 수 있는지 확인하면 됩니다. 기존 버전을 업데이트할 때는 이전 설정과 설치 경로를 고려해야 합니다. 클라이언트를 바꾼다면 구독의 프로토콜과 설정을 그대로 사용할 수 있는지 확인하세요. 세 경우를 구분하면 불필요한 재작업을 줄일 수 있습니다.
다른 기기에 설치할 파일을 컴퓨터에서 대신 다운로드하는 경우, 현재 브라우저가 실행 중인 시스템을 기준으로 패키지를 선택하지 마세요. 대상 기기에서 시스템 정보를 열어 운영체제, 버전, 아키텍처를 기록한 뒤 여기서 맞는 패키지를 선택하세요. 특히 한 컴퓨터에서 다른 컴퓨터로 설치 파일을 옮길 때는 같은 운영체제 이름 아래에도 서로 다른 패키지가 있을 수 있습니다.
다운로드를 누른 뒤 브라우저의 다운로드 목록에서 작업이 완료되었는지 확인하세요. 일시 중지 또는 중단 상태라면 다운로드를 계속하거나 다시 받으세요. 완료되지 않은 파일을 바로 열지 마세요. 찾기 쉬운 위치에 저장하고, 같은 폴더에 여러 버전이 있다면 아이콘만 보지 말고 다운로드 시간과 전체 파일 이름으로 구분하세요.
구독 그룹에 저장된 주소와 클라이언트의 로컬 설정은 별개의 데이터입니다. 구독을 업데이트하면 서버에서 제공하는 설정은 다시 가져올 수 있지만, 직접 추가한 설정이나 수정한 라우팅 규칙, 로컬 포트, 앱별 적용 범위는 구독만으로 복원되지 않을 수 있습니다. 업데이트 전에 클라이언트의 내보내기 기능을 우선 사용하세요. 내보내기 기능이 없는 항목은 민감한 내용 없이 설정을 기록해 두었다가 필요한 경우 복원하세요.
구독 주소에는 계정 설정에 접근할 수 있는 매개변수가 포함될 수 있습니다. 주소나 QR 코드, 전체 실행 로그를 공개 댓글에 붙여 넣지 마세요. 처리하지 않은 설정 백업을 공유 드라이브에 올리는 것도 피하세요. 문제 해결을 위해 다른 사람에게 정보를 전달할 때는 보통 시스템 버전, 클라이언트 이름, 문제 발생 단계, 민감한 내용을 삭제한 오류 메시지만으로 충분합니다.
데스크톱의 이전 버전을 덮어쓰려면 연결을 먼저 중지한 다음 백그라운드 프로세스까지 완전히 종료하세요. 모바일 기기에서 패키지를 바꾸려면 기존 앱 위에 설치할지, 새로 설치해야 하는지 먼저 확인하세요. 새 버전에서 문제가 생기면 오류를 기록하고 보관해 둔 설정을 사용해 정상 작동하던 조합으로 되돌리세요. 설치 파일, 구독, 프록시 모드를 한꺼번에 바꾸지 마세요.
클라이언트를 처음 열면 메인 창이 정상적으로 열리고 설정이 저장되는지 먼저 확인하세요. 다음으로 구독 그룹을 추가해 업데이트를 실행하고 테스트할 설정을 선택하세요. 구독 업데이트에 성공했다는 것은 클라이언트가 구독 내용을 가져왔다는 뜻일 뿐입니다. 노드 연결 여부와 앱 트래픽이 클라이언트를 거치는지는 각각 따로 확인해야 합니다.
먼저 시스템 프록시 설정을 사용하는 앱 하나로 테스트하세요. 데스크톱에서는 시스템 프록시부터 확인하고 기본 연결이 되는 것을 확인한 뒤 필요에 따라 TUN을 알아보세요. 모바일 기기에서는 시스템이 VPN 연결 생성을 허용하는지, 다른 VPN이 사용 중인지 먼저 확인하세요. 연결은 되는데 특정 앱만 열리지 않는다면 해당 앱이 시스템 설정, 자체 프록시 설정, 직접 연결 중 무엇을 사용하는지 확인하세요.
문제가 발생하면 어느 단계에서 실패했는지 먼저 기록하세요. 설치 프로그램이 열리지 않는다면 아키텍처와 시스템 요구 사항을 다시 확인하세요. 클라이언트는 열리지만 설정이 없다면 구독 그룹과 업데이트 결과를 확인하세요. 설정이 목록에 있지만 연결되지 않는다면 현재 활성화된 항목과 실행 로그를 살펴보세요. 한 번에 한 항목만 변경하고 다시 테스트해야 설치 문제와 연결 문제를 혼동하지 않습니다.
둘 중 하나만 선택하면 됩니다. 처음 설치한다면 Desktop 버전부터 사용해 보세요. 기존에 WPF 작업 흐름을 사용하고 있다면 클래식 WPF 버전을 계속 이용할 수 있습니다. 같은 설정을 시험하려고 두 버전을 동시에 실행하지 마세요. 로컬 수신 포트나 시스템 프록시 설정이 서로 영향을 줄 수 있습니다.
아닙니다. x64와 arm64는 모두 64비트 아키텍처입니다. 시스템 정보에서 프로세서 아키텍처를 확인하세요. Linux 패키지 이름에서 amd64와 x86_64는 x64에, aarch64는 arm64에 해당합니다.
먼저 시스템 호환성, 저장 공간, 출처를 알 수 없는 앱 설치 권한을 확인하세요. 같은 패키지 이름에 서명이 다른 이전 버전이 설치되어 있는지도 살펴보세요. 범용 버전은 일부 아키텍처 선택 문제를 해결할 수 있지만 서명 충돌은 해결하지 못합니다. 기존 버전을 삭제하기 전에 구독과 설정을 백업하세요.
카드의 버전과 각 설치 파일 링크는 서로 다른 목록에서 제공되므로 일치하지 않을 수 있습니다. 실제 설치된 버전을 확인하려면 설치 프로그램에 표시된 앱 정보를 확인하거나 설치 후 클라이언트의 정보 페이지를 열어 보세요. 카드의 버전만으로 판단하지 마세요.
설치 파일에는 클라이언트만 포함되며 구독 서비스는 제공되지 않습니다. 먼저 사용 권한이 있는 구독 주소를 준비해 가져온 뒤 업데이트를 실행하고, 메인 화면에서 설정을 선택하세요. 이미 설정이 있다면 선택된 그룹이 올바른지 먼저 확인할 수 있습니다.