설치 파일 및 시스템 요구 사항

V2Ray 클라이언트 다운로드

먼저 운영체제를 선택한 다음 프로세서 아키텍처를 확인하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 우선 권장합니다. v2fly 코어 설정을 이미 사용 중이라면 v2flyNG를 고려해 보세요.

Windows 설치 파일

Windows 시스템 요구 사항

확인 항목선택 기준
시스템 종류「설정 → 시스템 → 정보」에서 시스템 종류를 확인하세요. 이 페이지에서는 x64 설치 파일을 제공합니다.
실행 환경.NET 데스크톱 런타임이 없다는 메시지가 표시되면 안내에 따라 필요한 버전과 아키텍처를 확인하세요.
설치 권한압축을 푼 다음 설치 프로그램을 실행하세요. 관리 대상 기기에서는 조직의 소프트웨어 설치 정책을 따라야 합니다.

압축 파일의 미리 보기 창에서 프로그램을 바로 실행하지 마세요. 쓰기 권한이 있는 폴더에 압축을 푼 뒤 설치 프로그램을 실행하세요. 이렇게 하면 문제가 발생했을 때 압축 해제 오류, 런타임 누락, 설치 권한 부족을 구분하기도 쉽습니다.

데스크톱 버전과 WPF 버전 비교 →

설치 파일 선택 및 업데이트

플랫폼, 아키텍처, 패키지 형식에 따라 설치 가능 여부가 달라집니다. 기존 설정을 계속 사용할 수 있는지는 별도로 확인해야 합니다.

시스템 종류에 맞는 아키텍처 확인

기기 모델이나 구입 연도만 보고 판단하지 마세요. 데스크톱과 노트북은 시스템 정보에서 아키텍처를 확인할 수 있습니다. Android 기기는 현재 시스템이 지원하는 앱 아키텍처를 확인하세요. 같은 기기도 운영체제를 바꾸면 설치할 수 있는 패키지가 달라질 수 있습니다. 다른 사람을 위해 다운로드한다면 다운로드에 사용한 기기가 아니라 설치 대상 기기의 정보를 기준으로 선택하세요.

amd64와 x86_64는 모두 일반적인 x86 64비트 아키텍처를 뜻하며, amd64는 특정 프로세서 브랜드에 한정되지 않습니다. arm64와 aarch64는 ARM 64비트 아키텍처를 가리킵니다. 이름의 차이를 확인한 다음 페이지에서 선택한 플랫폼도 점검해 아키텍처만 같고 운영체제가 다른 설치 파일을 혼용하지 마세요.

클라이언트를 바꾸기 전에 설정 백업

백업할 때는 구독, 수동 설정, 클라이언트 자체 설정을 구분하세요. 구독을 다시 가져오면 구독에 포함된 항목은 대개 복원되지만, 직접 추가한 항목이나 라우팅 규칙, 수신 대기 포트까지 자동으로 복원되지는 않습니다. 기존 클라이언트에서 내보내기를 지원한다면 필요한 정보를 먼저 내보내고 현재 프록시 모드와 활성 설정도 기록해 두세요.

구독 주소에는 접속 인증 정보가 포함될 수 있으므로 안전하게 관리하고 스크린샷에 그대로 담아 공개하지 마세요. 인터페이스나 빌드만 바꾸는 경우에는 기존 클라이언트를 종료한 뒤 새 클라이언트를 실행하세요. 두 클라이언트가 같은 포트를 사용하거나 시스템 프록시 설정을 반복해서 변경하는 일을 방지할 수 있습니다. 기본 연결과 필요한 규칙이 정상인지 확인한 다음 이전 프로그램과 백업을 정리하세요.

설치 및 실행 오류 구분하기

설치 프로그램이 열리지 않는 문제, 설치 후 앱이 종료되는 문제, 앱은 열리지만 연결되지 않는 문제는 각각 발생 단계가 다릅니다. 첫 번째 문제라면 파일 다운로드가 완료됐는지, 패키지 형식이 맞는지, 시스템 권한 안내가 있는지 확인하세요. 두 번째 문제라면 런타임, 폴더 권한, 프로그램 시작 로그부터 확인하세요. 이 단계에서 구독을 다시 가져올 필요는 없습니다.

오래된 시스템에서는 프로세서 아키텍처가 맞아도 시스템 인터페이스나 의존성 버전이 호환되지 않을 수 있습니다. 패키지를 계속 바꾸기보다 운영체제 버전, 선택한 빌드, 오류 메시지 원문을 함께 확인하는 편이 효과적입니다. Android에서 「앱이 설치되지 않았습니다」라는 메시지가 표시되면 서명 불일치, 시스템 요구 사항 미충족, 저장 공간 부족을 구분하세요.

시작 직후 종료되는 문제 해결 →

업데이트할 때 한 번에 하나만 변경

사용 중인 설정이 있다면 업그레이드 전에 현재 클라이언트, 프록시 모드, 로컬 포트를 기록하세요. 업그레이드 후에는 기존 설정으로 먼저 테스트하세요. 코어, 구독, 라우팅을 한꺼번에 바꾸면 문제가 생겨도 원인을 찾기 어렵습니다.

이전 클라이언트로 돌아가야 한다면 새 버전이 설정 형식을 변경했는지 먼저 확인한 뒤 업그레이드 전 백업을 사용하세요. 새 프로그램과 이전 프로그램을 같은 폴더에 임의로 압축 해제하지 마세요. 패키지 관리자로 설치한 프로그램은 프로그램 제거와 사용자 설정 삭제를 구분해, 이전 패키지를 정리할 때 계속 사용할 규칙까지 지우지 않도록 주의하세요.

설치 후 첫 설정

먼저 앱이 실행되는지 확인한 다음 설정을 가져오고 연결을 점검하세요. 다운로드, 설치, 트래픽 전달은 각각 별도의 단계입니다.

구독을 가져오고 활성 설정 확인

클라이언트를 열면 먼저 기존 구독을 그룹에 추가한 뒤 수동 업데이트를 한 번 실행하세요. 항목이 표시되어도 연결이 완료된 것은 아닙니다. 활성 설정을 선택하고 클라이언트 로그에서 코어 프로세스가 정상적으로 시작됐는지 확인하세요. 수동 설정이 있다면 구독 항목과 분리해 관리해야 구독 업데이트 후에도 헷갈리지 않습니다.

구독 업데이트에 실패하면 먼저 주소에 접속할 수 없는 문제인지 콘텐츠를 인식하지 못하는 문제인지 구분하세요. 테스트를 위해 클라이언트를 여러 개 실행할 필요는 없습니다. 동시에 켜면 시스템 프록시나 VPN 상태가 바뀌어 오류를 재현하기 어려워질 수 있습니다. 도움을 요청할 때는 실패 단계와 민감 정보를 가린 오류 메시지만 기록해도 충분하며, 전체 구독 주소를 공유할 필요는 없습니다.

구독 가져오기 방법 보기 →

앱이 프록시를 사용하는지 확인

데스크톱에서는 먼저 시스템 프록시 설정을 따르는 브라우저로 확인하세요. 터미널 도구와 일부 데스크톱 앱은 시스템 프록시를 사용하지 않을 수 있으므로, 각 앱에서 사용하는 프록시 주소를 따로 확인해야 합니다. 업데이트 후 로컬 포트가 바뀌었다면 프록시 주소를 직접 입력한 앱도 함께 수정하세요. 클라이언트 창에 연결됨으로 표시되는지만 확인해서는 안 됩니다.

Android에서는 처음 연결할 때 시스템 VPN 권한 안내를 확인하세요. 기기에서 다른 VPN 연결을 사용 중이라면 클라이언트를 바꾸기 전에 어떤 연결을 유지할지 결정하세요. 앱이 필요한 트래픽을 처리하지 못하는 경우에만 가이드의 TUN 및 라우팅 항목을 확인하면 됩니다. 첫 연결을 확인할 때는 트래픽 처리 방식과 분할 라우팅 규칙을 동시에 바꾸지 않아도 됩니다.

라우팅 및 분할 터널링 안내 보기 →

다운로드 자주 묻는 질문

설치 파일 선택, 덮어쓰기 업데이트 및 버전 확인

Windows 데스크톱 버전과 WPF 버전을 모두 설치해야 하나요?

아니요. 처음 설치한다면 데스크톱 버전을 선택하세요. 기존 클래식 인터페이스에 익숙하다면 WPF 버전을 사용할 수 있습니다. 버전을 바꾸기 전에 기존 클라이언트를 종료하고 설정을 백업하세요.

Android 범용 버전으로 모든 설치 오류를 해결할 수 있나요?

아니요. 범용 버전은 아키텍처를 잘못 선택할 가능성을 줄여 주지만, 최소 시스템 요구 사항은 달라지지 않습니다. 서명 충돌이나 기기 관리 정책으로 인한 제한도 해결하지 못합니다.

새 버전을 설치하기 전에 이전 버전을 삭제해야 하나요?

먼저 덮어쓰기가 지원되는지 확인하고 설정을 백업하세요. Android에서 서명이 일치하지 않는다는 메시지가 표시되면 바로 삭제하지 마세요. 앱을 삭제하면 데이터가 지워질 수 있습니다.

설치 파일에 구독이 포함되어 있나요?

설치 파일에는 클라이언트 프로그램이 들어 있습니다. 설치 후 기존 구독이나 설정을 별도로 가져와야 합니다. 클라이언트 설치가 완료되어도 프록시 연결이 자동으로 설정되는 것은 아닙니다.

카드에 표시된 버전과 다운로드 파일 이름의 버전이 다르면 어떻게 하나요?

카드에는 앱 버전이, 다운로드 항목에는 개별 빌드 버전이 표시됩니다. 버전이 다르면 실제 파일 이름을 기록해 두고, 설치 후 클라이언트의 정보 페이지에서 실행 중인 버전을 확인하세요.