플랫폼 및 아키텍처 선택

V2Ray 클라이언트 다운로드

먼저 클라이언트를 설치할 운영체제를 선택한 뒤 프로세서 아키텍처와 패키지 형식에 맞춰 다운로드하세요. 데스크톱에서는 v2rayN을, Android에서는 v2rayNG를 권장합니다. v2fly 코어가 필요하다면 v2flyNG를 선택하세요.

Windows 클라이언트

설치, 업데이트 및 이전

처음 설치한다면 먼저 운영체제와 아키텍처를 확인하세요. 기존 설정을 보존해야 한다면 설치 전에 백업하세요. 이 컴퓨터에서 다른 기기에 사용할 파일을 다운로드한다면 현재 브라우저에 표시된 운영체제가 아니라 파일을 받을 기기의 정보를 기준으로 선택하세요. 가상 머신에 설치할 때도 마찬가지입니다. 호스트 컴퓨터의 브랜드가 아니라 가상 머신 내부의 운영체제와 프로세서 아키텍처를 확인하세요.

클라이언트 업데이트인지 구독 업데이트인지 먼저 확인하세요

클라이언트 업데이트는 앱을 교체하지만, 구독 업데이트는 그룹 주소에 연결된 설정을 다시 불러옵니다. 특정 그룹의 내용이 잘못됐다면 새 클라이언트를 다운로드하기 전에 ‘구독 업데이트’를 시도하세요. 메뉴 위치가 사용 설명서의 화면과 다르다면 클라이언트 이름과 설치된 버전, 인터페이스 유형을 확인한 뒤 해당 버전의 안내를 찾아보세요. 특히 Windows에서는 데스크톱판과 클래식 WPF판의 메뉴 배치가 다릅니다. 한쪽의 설치가 실패했다는 뜻은 아닙니다.

버전을 바꾸기 전에 복구 가능한 설정을 보관하세요

현재 버전에 설정 내보내기 또는 백업 기능이 있다면 클라이언트의 해당 메뉴를 사용해 파일을 저장하고, 백업 파일을 찾을 수 있는지도 확인하세요. 구독 그룹, 직접 작성한 라우팅 규칙, 수동으로 추가한 개별 설정과 로컬 포트가 하나의 구독에 모두 포함되는 것은 아닙니다. 링크 하나만 저장해 두고 전체 백업이라고 생각하지 마세요. 백업에 개인 구독 주소나 연결 자격 증명이 포함될 수 있으므로 직접 관리하는 안전한 위치에 보관하고, 오류 화면과 함께 전송하지 마세요.

설치 방식이나 배포 경로, 기기를 바꿀 때 기존 설치 위에 그대로 덮어쓸 수 있다고 가정하지 마세요. 기존 프로그램의 데이터 폴더 전체를 그대로 재사용할 수 있다고 단정해서도 안 됩니다. 대상 기기에 맞는 패키지를 먼저 설치한 뒤 가져오기 기능으로 인식 가능한 설정을 복원하세요. 기존 기기에서 라우팅 규칙이나 포트를 따로 수정했다면 새 기기에서 항목별로 비교하고 정상 작동을 확인한 다음 기존 설정을 정리하세요.

처음 실행한 뒤 다음 세 가지를 순서대로 확인하세요

  1. 먼저 창이 열리는지 확인하세요. 프로그램이 시작되지 않으면 시스템 안내를 보관하고 패키지 형식, 프로세서 아키텍처와 실행 환경을 다시 확인하세요. 아직 설정을 읽어들이는 단계가 아니므로 구독 링크나 라우팅 규칙부터 바꿀 필요는 없습니다.
  2. 다음으로 설정이 목록에 추가됐는지 확인하세요. 구독 주소 추가와 구독 업데이트는 별개의 작업입니다. 주소를 추가한 뒤 메인 화면으로 돌아가 업데이트하고 해당 그룹을 선택해 확인하세요. 단일 공유 링크를 받은 경우에는 구독 주소로 입력하지 말고 클립보드에서 가져오기 같은 메뉴를 사용하세요.
  3. 마지막으로 앱이 선택한 연결 방식을 사용하는지 확인하세요. 데스크톱에서는 시스템 프록시가 활성화되어 있는지, 대상 앱이 시스템 프록시를 따르는지 확인하세요. 휴대전화에서는 클라이언트에 시스템 연결 권한이 허용됐는지 살펴보세요. 처음 확인할 때는 설정 하나만 바꿔 테스트하세요. 포트와 라우팅, 연결 모드를 동시에 바꾸면 문제의 원인을 찾기 어려워집니다.

오류가 발생하면 문제가 생긴 단계와 클라이언트 이름, 시스템 버전, 선택한 패키지의 아키텍처, 오류 메시지 원문을 기록하세요. 브라우저에서 다운로드 오류만 발생했다면 다운로드를 확인하고, 시스템 설치 프로그램이 패키지를 거부했다면 호환성을 살펴보세요. 프로그램은 열렸지만 업데이트에 실패한 경우에는 구독과 네트워크를 확인하세요. 단계를 나누어 살펴보면 같은 설치 파일을 반복해서 다운로드하는 것보다 원인을 찾기 쉽습니다.

다운로드 및 설치 자주 묻는 질문

잘못된 설치 파일을 선택했거나 브라우저 다운로드가 중단된 경우, 설치 후 목록이 비어 있는 경우까지 실제로 표시된 안내에 따라 확인해 보세요.

Windows 데스크톱판과 클래식 WPF판을 함께 설치해야 하나요?

둘 중 하나만 설치하면 됩니다. 처음 사용한다면 데스크톱판을 선택하세요. 클래식 인터페이스가 익숙하거나 WPF판 화면을 기준으로 메뉴를 찾고 있다면 클래식 WPF판을 선택하면 됩니다. 전환하기 전에 기존 클라이언트를 종료하고 설정을 백업하세요. 두 프로그램의 설치 파일을 모두 보관할 수는 있지만 동시에 실행하지 않는 편이 좋습니다. 같은 로컬 포트를 사용하려 하면 나중에 실행한 프로그램이 제대로 작동하지 않을 수 있고, 시스템 프록시를 어느 쪽에서 제어하는지 헷갈릴 수도 있습니다.

페이지에 표시된 버전과 다운로드 파일명의 숫자가 다르면 무엇을 기준으로 봐야 하나요?

카드에 표시된 버전은 앱 목록을 기준으로 하고, 파일명은 실제로 선택한 다운로드 항목을 반영하므로 두 숫자가 다를 수 있습니다. 설치된 버전은 클라이언트의 ‘정보’ 메뉴나 시스템의 앱 세부 정보에서 확인하세요. 특정 버전이 필요하다면 실제로 받은 파일과 설치 프로그램 또는 시스템에 표시된 정보를 먼저 확인하세요. 그래도 알 수 없다면 페이지의 버전 번호를 해당 파일의 버전으로 간주하지 말고, 기존 설치 위에 서둘러 덮어쓰지 마세요.

Android에서 ‘앱이 설치되지 않았습니다’라고 표시되면 범용판으로 바꿔야 하나요?

아키텍처가 호환되지 않는다는 안내가 나오면 시스템에서 지원하는 아키텍처를 확인한 뒤 범용 패키지를 시도해 볼 수 있습니다. 기존 패키지와 충돌한다는 안내라면 범용판으로 바꿔도 대개 해결되지 않습니다. 저장 공간과 시스템 버전, 자세한 오류 내용을 확인한 다음 기기에 같은 클라이언트가 이미 설치되어 있는지, 새 패키지와 기존 패키지의 배포 경로가 같은지 살펴보세요. 앱을 삭제하면 구독과 설정도 함께 지워질 수 있으니 먼저 백업하고 재설치 여부를 결정하세요.

다운로드가 중단되거나 파일이 열리지 않으면 무엇부터 확인해야 하나요?

먼저 브라우저 다운로드 목록에서 완료 여부를 확인한 다음 파일 확장자와 선택한 운영체제가 맞는지 살펴보세요. Windows ZIP은 압축을 모두 풀고, macOS DMG는 Finder에서 열고, Android APK는 시스템 설치 프로그램으로 설치하며, Linux deb 또는 rpm은 해당 패키지 관리자로 설치하세요. 다운로드가 끝나지 않았다면 브라우저에서 다시 시도할 수 있습니다. 오류 페이지가 계속 내려받아진다면 선택한 다운로드 항목과 브라우저 안내를 기록하세요. 확장자만 바꿔 오류 페이지를 설치 파일처럼 취급하지 마세요.

설치했는데 구독 내용이 보이지 않는 이유는 무엇인가요?

설치 파일은 클라이언트만 설치하며 구독을 자동으로 추가하지 않습니다. v2rayN에서는 ‘구독 그룹’에 주소를 추가한 뒤 업데이트하세요. v2rayNG에서는 ‘구독 그룹 설정’을 열고 주소를 저장한 다음 메인 화면으로 돌아가 구독을 업데이트하세요. 업데이트 후에도 목록이 비어 있다면 선택한 그룹과 링크가 온전한지, 구독이 유효한지 확인한 뒤 연결 설정을 살펴보세요. 개인 구독 주소 전체를 공개 게시판에 올리지 마세요.