인터페이스 선택: Desktop은 차세대 크로스 플랫폼 인터페이스를 사용합니다. 처음 설치한다면 이 버전을 권장합니다. WPF는 안정적인 클래식 버전으로, 기존 메뉴와 트레이 구성이 익숙한 사용자에게 적합합니다. 두 설치 파일 중 하나만 선택하세요. 이전 가이드를 따라 할 때는 스크린샷이 어떤 인터페이스를 기준으로 하는지 먼저 확인하세요.
ZIP 파일 열기: ‘다운로드’ 폴더에서 압축 파일을 마우스 오른쪽 버튼으로 클릭하고 ‘모두 압축 풀기’를 선택하세요. 압축을 푼 폴더로 이동해 그 안의 설치 프로그램을 실행합니다. 압축 파일 미리보기 창에서 바로 실행하지 말고, 파일 하나만 바탕 화면으로 끌어다 놓고 실행하지도 마세요.
실행에 실패하면 오류 내용을 기록하세요: 팝업에 데스크톱 런타임이 없다고 명시되어 있다면 런타임 이름, 버전, 아키텍처를 적어 두고 안내에 따라 설치하세요. 창을 닫았는데도 알림 영역에 아이콘이 남아 있다면 클라이언트가 계속 실행 중일 수 있습니다. 설치 버전을 바꾸기 전에 트레이 메뉴에서 이전 버전을 완전히 종료하세요.
‘이 Mac에 관하여’에서 확인: 시스템 메뉴에서 ‘이 Mac에 관하여’를 여세요. ‘칩’에 Apple M 시리즈가 표시되면 Apple Silicon 패키지를, ‘프로세서’에 Intel이 표시되면 Intel 패키지를 선택하세요. 파일 이름의 macos-64는 여기서 Intel 패키지를 뜻하며, 두 아키텍처에서 모두 사용할 수 있는 파일이 아닙니다.
‘응용 프로그램’에서 실행: 다운로드한 DMG를 열고 v2rayN을 ‘응용 프로그램’ 폴더로 끌어다 놓은 다음 복사가 끝날 때까지 기다리세요. 디스크 이미지를 추출한 뒤 ‘응용 프로그램’에서 실행하면 됩니다. 업데이트할 때는 ‘종료’를 선택해 이전 버전을 완전히 종료하세요. 주 창만 닫아서는 안 됩니다. 메뉴 막대에 이전 버전 아이콘이 남아 있다면 프로세스가 종료되었는지 확인한 후 교체하세요.
시스템 안내를 구분하세요: 시스템 버전이 호환되지 않는다는 안내가 표시되면 설치된 macOS 버전을 먼저 확인하세요. 앱을 열 수 없다는 안내가 표시되면 시스템에 나온 원문을 기록하고 패키지 아키텍처와 다운로드 완료 여부를 확인하세요. 조직의 제한이나 시스템 보안 정책으로 설치가 차단된 경우 기기 관리 규정에 따라 처리하세요. 다른 아키텍처를 선택해 안내를 없애려 하지 마세요.
아키텍처부터 확인: 2015년 이후 출시된 대부분의 Android 스마트폰은 보통 arm64를 선택할 수 있습니다. 기준은 출시 연도가 아니라 시스템이 arm64-v8a를 지원하는지 여부입니다. 일부 스마트폰은 64비트 프로세서를 탑재했어도 32비트 시스템을 실행합니다. 시스템이 지원하는 아키텍처를 확인할 수 없다면 우선 범용 버전을 선택하세요.
arm64 다운로드 파일: v2rayNG_2.3.11_arm64-v8a.apk. 카드 헤더에는 목록에 등록된 버전이 표시되며, 다운로드 파일 이름의 번호와 다를 수 있습니다. 업데이트하기 전에 실제 설치 파일과 시스템 설치 화면을 확인하세요.
대안은 이런 경우에 선택하세요: V2Fly 코어를 사용해야 한다는 요구 사항이 명확한 설정이 있다면 v2flyNG를 선택할 수 있습니다. 이 앱은 v2rayNG 업데이트 파일이 아니며, 다른 클라이언트의 구독, 노드, 앱 설정을 이어받지 않습니다. 전환하기 전에 백업한 뒤 사용할 클라이언트가 지원하는 방식으로 다시 가져오세요.
먼저 배포판을 확인하세요: Debian 및 Ubuntu 계열 배포판은 보통 DEB를 사용합니다. RPM을 사용하는 배포판이라면 RPM을 선택하세요. RPM 파일 이름의 el10은 Enterprise Linux 10 계열용으로 빌드된 패키지라는 뜻입니다. 확장자만 보고 모든 RPM 기반 시스템에 적합하다고 판단하면 안 됩니다.
그다음 실행 아키텍처를 확인하세요: 시스템의 ‘정보’에서 아키텍처를 확인하거나 터미널에서 uname -m을 실행하세요. 결과가 x86_64이면 x64 항목을 선택하세요. 결과가 aarch64이면 배포판에 맞는 아래 ARM 64비트 패키지를 선택하세요. 가상 머신에서 실행 중이라면 호스트 컴퓨터가 아니라 가상 머신 안의 시스템을 기준으로 선택하세요.
의존성 오류를 기록하세요: 배포판에 기본 포함된 소프트웨어 설치 도구로 패키지를 여세요. 의존성을 충족할 수 없다는 안내가 나오면 누락된 구성 요소와 버전을 먼저 기록한 뒤 배포판 릴리스 버전과 패키지의 빌드 대상을 비교하세요. 아키텍처가 일치해도 의존성이 맞는 것은 아닙니다. 이런 오류를 건너뛰려고 강제 설치 옵션을 사용하지 마세요.
설치 및 업데이트 안내
처음 설치할 때는 클라이언트가 정상적으로 실행되는지 먼저 확인하세요. 이전 버전을 업데이트할 때는 설정이 유지되었는지도 확인하고, 실행 문제와 연결 문제를 구분하세요.
최초 설치: 먼저 실행한 뒤 설정
다운로드 기록에서 완료된 파일을 여세요. 다운로드가 아직 진행 중이거나 파일에 임시 확장자가 붙어 있다면 완료될 때까지 기다리세요. 다운로드가 중단되었다면 해당 플랫폼으로 돌아가 동일한 아키텍처와 형식을 선택해 다시 받으세요. 파일 확장자를 바꿔서 열려고 하지 마세요.
먼저 기본 화면이 열리는지 확인하세요. 데스크톱에서는 시스템 프록시를 변경하지 마세요. 이전 클라이언트가 실행 중이라면 먼저 종료하세요. Android에서는 앱이 열리는 것과 VPN 연결이 설정되는 것은 별개의 단계입니다. 처음 연결을 테스트할 때 시스템에 표시되는 연결 요청을 처리하세요.
가져온 다음 연결을 테스트하세요. 노드가 목록에 표시되는지 먼저 확인한 뒤, 사용 가능한 것으로 알고 있는 노드를 선택해 테스트하세요. 설정은 한 번에 하나씩만 변경하고 결과를 기록한 다음 다음 단계로 넘어가세요. 구독 주소와 단일 노드 링크는 가져오기 메뉴가 다릅니다. 클라이언트 설정 가이드를 참고하세요.
기존 버전 위에 설치: 먼저 백업한 뒤 교체
현재 설정을 기록하세요. 구독 주소가 포함되지 않도록 설정 화면을 캡처하고 현재 프록시 모드와 포트를 적어 두세요. 먼저 이전 클라이언트의 내보내기 또는 백업 기능을 사용하고, 백업 파일이 있는지 확인한 다음 이전 버전을 종료하세요. 백업에는 연결 자격 증명이 포함될 수 있으므로 본인만 접근할 수 있는 곳에 보관하세요.
대상 클라이언트를 확인하세요. Windows 인터페이스 버전을 바꾸거나 다른 Android 클라이언트로 전환할 때 데이터가 자동으로 이전된다고 가정하지 마세요. Android에서 서명 충돌이 발생하면 이전 버전과 백업을 보관하세요. 앱을 삭제하면 일반적으로 해당 앱의 로컬 데이터도 삭제됩니다.
업데이트 결과를 항목별로 확인하세요. 먼저 버전과 그룹을 확인하고, 이어서 로컬 포트와 시스템 프록시 상태를 확인하세요. 실행에 실패하면 오류 내용과 이전 버전 백업을 보관하고 같은 디렉터리에 연달아 덮어쓰지 마세요. 이전 상태로 되돌리려면 업데이트 전 백업을 사용하세요. 이전 버전에서 새 버전이 수정한 데이터를 직접 읽게 하지 마세요.
다운로드 관련 자주 묻는 질문
Windows 버전 두 가지를 모두 설치해야 하나요?
아니요. 처음 설치한다면 Desktop 버전을 선택하세요. 클래식 인터페이스가 익숙하다면 WPF 버전을 선택할 수 있습니다. 두 버전은 서로 의존하지 않습니다. 기존 버전이 설치되어 있다면 클라이언트를 종료하고 백업한 뒤 원하는 버전을 설치하세요.
macOS에서 어떤 DMG를 다운로드해야 하는지 어떻게 확인하나요?
‘이 Mac에 관하여’를 여세요. ‘칩’ 항목에 Apple M 시리즈가 표시되면 Apple Silicon(arm64)을, ‘프로세서’ 항목에 Intel이 표시되면 Intel(x64)을 선택하세요. 구매 연도가 아니라 시스템에 표시된 하드웨어 정보를 기준으로 선택하면 됩니다.
Android 범용 버전은 언제 사용하면 되나요?
시스템이 arm64-v8a를 지원하면 arm64를 우선 선택하세요. 지원 ABI를 모르거나 설치 프로그램에서 아키텍처가 맞지 않는다고 명확히 안내할 때는 범용 버전을 시도할 수 있습니다. 범용 버전으로 Android 버전이 너무 낮거나 앱 서명이 충돌하는 문제를 해결할 수는 없습니다.
Linux의 amd64와 x86_64는 모두 x64를 뜻하나요?
네. 이 페이지의 DEB 파일은 amd64, RPM 파일은 x86_64로 표시하며 둘 다 x64입니다. ARM 64비트는 DEB에서 arm64, RPM에서 aarch64로 표기하는 경우가 많습니다. 먼저 패키지 형식을 선택한 다음 아키텍처를 확인하세요.
설치 파일을 다운로드했는데 실행해도 노드가 표시되지 않는 이유는 무엇인가요?
설치 파일에는 클라이언트만 포함되어 있습니다. 구독 주소가 있다면 클라이언트의 구독 그룹에 주소를 추가하고 업데이트하세요. 단일 노드 공유 링크가 있다면 클라이언트의 가져오기 기능으로 추가하면 됩니다. 목록에 설정이 표시되는지 확인한 뒤 노드를 선택해 연결하세요.