Windows
v2rayN을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 익숙한 데스크톱 구성을 유지합니다. 처음 사용하는 경우 다운로드 페이지 안내에 따라 데스크톱 버전을 설치하면 됩니다. 기존 설정이 있다면 먼저 내보내 백업한 뒤 인터페이스 버전을 바꿀지 결정하세요.
다운로드로 이동 →플랫폼에 맞는 클라이언트를 선택하고 한국어 설정 가이드에 따라 구독을 가져온 뒤 라우팅과 연결 상태를 확인하세요.
운영체제와 프로세서 아키텍처를 확인한 뒤 설치 파일을 선택하세요. 클라이언트는 설정을 읽어 실행하며, 연결에 필요한 구독이나 서버 정보는 별도로 준비해야 합니다.
v2rayN을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 익숙한 데스크톱 구성을 유지합니다. 처음 사용하는 경우 다운로드 페이지 안내에 따라 데스크톱 버전을 설치하면 됩니다. 기존 설정이 있다면 먼저 내보내 백업한 뒤 인터페이스 버전을 바꿀지 결정하세요.
다운로드로 이동 →v2rayN을 선택하고 ‘이 Mac에 관하여’에서 칩 정보를 확인해 Apple Silicon과 Intel용 설치 파일을 구분하세요. 처음 실행할 때 보안 경고가 표시되면 앱 출처를 확인한 뒤 ‘개인정보 보호 및 보안’ 안내에 따라 실행 허용과 네트워크 권한을 설정하세요.
다운로드로 이동 →먼저 Xray 코어를 사용하는 v2rayNG를 확인하고, V2Fly 설정을 사용한다면 v2flyNG도 살펴보세요. 대부분의 기기에서는 arm64를 선택하면 됩니다. 아키텍처를 모른다면 범용 버전 안내를 확인하세요. 처음 연결할 때는 시스템의 VPN 연결 요청을 허용해야 합니다.
다운로드로 이동 →v2rayN을 선택하고 배포판의 패키지 관리 방식에 따라 deb 또는 rpm을 고른 다음, 기기가 x64인지 arm64인지 확인하세요. 데스크톱 환경의 시스템 프록시 설정은 앱마다 다르게 작동할 수 있으므로 설치 후 브라우저와 사용할 앱에서 각각 연결을 확인하세요.
다운로드로 이동 →설치 파일 유형은 실행 환경에 맞추기 위한 것이며, 프로토콜 사용 가능 여부는 코어의 기능과 서버 설정에도 달려 있습니다. 클라이언트를 바꾸기 전에 기존 구독의 프로토콜, 전송 방식, 필수 매개변수를 확인해 이름만 옮기고 연결 조건을 빠뜨리지 않도록 하세요.
전체 클라이언트 보기 →구독, 라우팅, DNS를 나눠 확인하세요. 한 번에 한 종류의 설정만 변경하고 원래 설정으로 되돌릴 수 있도록 보관하세요.
구독 주소는 서버 설정을 가져오는 데 사용하며 서버 주소 입력란에 직접 넣는 값이 아닙니다. v2rayN의 ‘구독 그룹’에서 소스를 추가하고 알아보기 쉬운 메모를 입력해 저장한 뒤 ‘구독 업데이트’를 실행하세요. 목록이 비어 있으면 먼저 ‘전체’로 전환해 필터를 확인하고 업데이트 로그도 살펴보세요. 소스마다 그룹을 따로 만들면 나중에 업데이트하거나 비활성화·삭제할 때 편리합니다. 서버 정보를 하나씩 입력하는 대신 구독으로 한꺼번에 갱신할 수 있지만, 유효 기간과 내용은 제공 업체가 결정합니다. 구독 주소는 자격 증명처럼 안전하게 보관하세요.
설정 자세히 보기 →라우팅 규칙은 요청을 어떤 아웃바운드로 보낼지 결정하며 구독이나 서버 문제를 해결하지는 않습니다. 먼저 클라이언트의 기본 라우팅으로 정상 작동하는 상태를 만든 다음, 명확한 도메인이나 주소 예외를 조금씩 추가하세요. 규칙은 보통 순서대로 적용되므로 더 구체적인 조건을 넓은 조건보다 앞에 두어야 합니다. GeoSite와 GeoIP 분류를 사용할 때는 데이터베이스가 최신인지, 해당 분류 이름이 실제로 있는지도 확인하세요. 전역 모드를 계속 바꾸기보다 예외 규칙을 명확하게 관리하면 앱의 동작을 파악하기 쉽습니다. 설정을 바꾼 뒤에는 같은 대상으로 다시 테스트하고 로그에서 어떤 규칙이 적용됐는지 확인하세요.
설정 자세히 보기 →일부 앱은 시스템 프록시 설정을 따르지 않습니다. 기본 연결이 정상인지 확인한 뒤 TUN 모드를 시도해 볼 수 있습니다. 데스크톱에서는 먼저 실행 권한을 확인하고 ‘TUN 모드’를 켠 다음 가상 네트워크 어댑터, 라우팅, DNS가 제대로 설정됐는지 확인하세요. TUN은 시스템 프록시와 다른 계층에서 작동하며 더 빠른 기능도 아니고 올바른 라우팅 규칙을 대신하지도 않습니다. 기기에 다른 가상 네트워크 도구가 있다면 같은 트래픽을 동시에 처리하지 않도록 하세요. TUN을 켠 뒤 기기 전체에서 인터넷이 끊기면 먼저 TUN을 끄고 기본 연결을 복구한 다음 권한, 네트워크 어댑터, DNS 경로를 차례로 점검하세요. 확인되지 않은 설정을 계속 추가하지 마세요.
설정 자세히 보기 →DNS 설정은 도메인 이름을 어떻게 해석할지, 라우팅 설정은 연결을 어디로 보낼지 결정하므로 함께 살펴봐야 합니다. 도메인은 열리지 않지만 알고 있는 IP 주소로는 접속되는 경우 먼저 DNS 로그를 확인하고 원격 DNS에 연결하는 경로도 점검하세요. 브라우저 자체의 암호화 DNS가 별도의 조회 경로를 만들 수도 있으므로 클라이언트 설정만 확인해서는 부족합니다. 공용 DNS 주소를 바로 바꾸기보다 로컬 DNS, 프록시 DNS, 앱 자체 DNS를 구분하면 원인을 찾기 쉽습니다. FakeDNS를 켜기 전에는 코어와 트래픽 처리 방식이 호환되는지 확인하고, 필요하면 되돌릴 수 있도록 기존 설정을 보관하세요.
설정 자세히 보기 →클라이언트 인터페이스는 설정을 관리하고 실제 프로토콜 처리는 코어가 담당합니다. 사용 전에 구독의 프로토콜, 전송 계층, 보안 매개변수를 확인한 뒤 현재 코어의 지원 여부를 살펴보세요. 이름이 비슷해도 확장 매개변수를 모두 서로 바꿔 쓸 수 있는 것은 아닙니다. v2rayN은 사용 중인 빌드와 설정에 맞춰 코어를 선택할 수 있으며, v2rayNG와 v2flyNG는 서로 다른 코어를 사용합니다. 설치 파일을 계속 바꾸기보다 시작 오류와 필드 안내를 먼저 읽으면 원인을 찾기 쉽습니다. 코어를 바꾸기 전에 설정을 백업하고, 바꾼 뒤에는 라우팅, DNS, UDP 동작을 다시 확인하세요. 인터페이스가 열린다는 것만으로 정상 작동을 판단하지 마세요.
설정 자세히 보기 →여기서 4개 플랫폼 간 이전은 구독과 필요한 설정을 수동으로 옮기는 것을 뜻하며, 클라이언트의 자동 클라우드 동기화를 의미하지 않습니다. 새 기기에서는 기존 구독을 다시 가져온 뒤 대상 플랫폼에 맞춰 시스템 프록시, VPN 권한 또는 TUN 권한을 설정하세요. 파일 경로, 네트워크 어댑터 이름, 시스템 옵션이 다를 수 있으므로 데스크톱 설정 폴더 전체를 그대로 덮어쓰지 마세요. 실행 환경 전체를 복사하기보다 단계별로 옮기면 호환성 문제를 찾기 쉽습니다. 연결 하나를 먼저 확인하고 라우팅과 DNS를 옮긴 다음 앱별 설정을 조정하세요. 내보낸 설정 파일이나 QR 코드에 접근 정보가 포함될 수 있으니 전달 후 임시 사본을 삭제하세요.
설정 자세히 보기 →화면 예시는 설정 간 관계를 설명하기 위한 것이며, 메뉴 위치는 클라이언트 빌드에 따라 다를 수 있습니다. 라우팅 예시는 전체 설정에 병합해 사용해야 합니다. 수정하기 전에 현재 사용 중인 코어와 설정 형식을 확인하세요.
최소한의 설정으로 연결을 먼저 구성한 뒤 라우팅과 트래픽 처리 기능을 차례로 켜세요. 문제가 생기면 이전 단계로 돌아가 결과를 확인하세요.
클라이언트를 설치한 뒤 구독 주소, 공유 링크, 전체 설정 파일 중 무엇을 가지고 있는지 확인하세요. 구독 주소는 구독 그룹에 저장하고 공유 링크는 클라이언트의 클립보드 가져오기 메뉴로 처리하세요. 웹페이지 안내 주소를 구독 주소로 착각하지 말고, 공개 화면에 전체 링크가 보이지 않도록 주의하세요.
v2rayN에서 그룹을 저장한 뒤 ‘구독 업데이트’를 실행하고 서버 목록에 항목이 표시되는지 확인하세요. Android에서는 v2rayNG의 추가 또는 가져오기 메뉴로 기존 설정을 불러올 수 있습니다. 가져오기에 실패하면 먼저 로그의 요청 오류를 확인해 링크 만료, 응답 형식 불일치, 네트워크 요청 실패를 구분한 뒤 대응하세요.
가져온 목록에서 서버를 선택하고 v2rayN에서 ‘활성 서버로 설정’을 누르세요. 브라우저가 시스템 프록시를 사용해야 한다면 데스크톱에서 ‘시스템 프록시 자동 설정’을 선택하세요. Android에서는 연결을 시작한 뒤 시스템 안내에 따라 VPN 요청을 허용하세요. 먼저 클라이언트의 기본 라우팅을 사용하고 사용자 지정 규칙을 서둘러 추가하지 마세요.
시스템 프록시를 모든 앱이 따르는 것은 아닙니다. 브라우저는 연결되지만 특정 앱이 연결되지 않는다면 먼저 해당 앱의 프록시 설정을 확인하세요. 이런 트래픽을 직접 처리해야 할 때만 TUN 설정 안내를 살펴보세요. 그래야 권한 문제와 서버 문제를 혼동하지 않습니다.
‘실제 연결 지연 시간 테스트’를 실행한 뒤 실제 사용하는 웹사이트나 앱도 열어 확인해야 합니다. 목록의 테스트 결과는 지정된 테스트 대상의 연결 상태만 보여 주며 모든 도메인, 전송 프로토콜, 앱의 사용 가능 여부를 보장하지 않습니다. 가능한 한 같은 대상을 사용하고 프록시 모드와 라우팅 설정을 기록하세요.
연결이 정상인 뒤 설정을 백업하고 라우팅 예외, DNS, TUN 설정을 하나씩 추가하세요. 항목을 바꿀 때마다 다시 테스트하고 문제가 생기면 직전의 정상 상태로 되돌리세요. 문제 해결 기록에는 오류 유형과 발생 시간을 남기되 구독 주소, 사용자 식별 정보 및 기타 접근 자격 증명은 삭제하세요.
인터페이스, 코어, 서비스 설정을 구분하면 같은 구독이 환경에 따라 다르게 작동하는 이유를 이해할 수 있습니다.
Project V는 네트워크 프록시 기술을 중심으로 형성된 오픈 소스 프로젝트 생태계이며 V2Ray는 그 주요 구성 요소 중 하나입니다. V2Fly 커뮤니티는 관련 코어를 이어서 유지 관리하고, Xray는 관련 기술 기반에서 발전한 별도의 코어 계열입니다. 일부 프로토콜 개념과 설정 방식은 공유하지만 기능 발전, 확장 필드, 지원 범위가 완전히 같지는 않습니다. 따라서 ‘V2Ray 설정’이라는 표현만 보고 호환성을 판단하지 말고 실제 사용 중인 코어를 확인해야 합니다.
프로토콜 이름은 연결 조건의 일부일 뿐입니다. 같은 VLESS 또는 VMess 설정도 전송 방식, 보안 계층, 라우팅 설정에 따라 달라질 수 있습니다. REALITY 같은 특정 기능을 사용할 때는 코어 지원 여부와 서버 측 요구 사항을 확인하세요. 매개변수를 추측으로 채우면 안 됩니다. 로그에 인식할 수 없는 필드가 표시되면 모든 네트워크 설정을 기본값으로 되돌리기보다 호환성과 설정 출처부터 확인하세요.
v2rayN은 데스크톱 환경에서 서버 목록, 구독 그룹, 라우팅, 시스템 프록시 등을 GUI로 관리할 수 있게 해 여러 구독 소스를 정리하려는 사용자에게 적합합니다. 클라이언트는 인터페이스 설정을 코어 실행에 필요한 설정으로 변환하며 실제 연결은 선택한 코어가 처리합니다. 인터페이스에서 설정을 저장할 수 있다고 해서 서버가 해당 매개변수를 반드시 받아들이는 것은 아닙니다. 시작 로그와 실제 접속 결과를 함께 확인해야 합니다.
v2rayNG는 Android 기기를 대상으로 하며 Xray 코어를 사용하고 시스템 VPN 인터페이스를 통해 프록시 연결을 처리합니다. 구독 관리와 앱별 설정도 제공합니다. v2flyNG 역시 Android용으로 V2Fly 코어를 사용하며 이에 맞는 설정을 위한 대안이 될 수 있습니다. 구독 요구 사항과 필요한 기능을 먼저 확인하고 인터페이스 사용 편의성을 살펴보세요. 이름이 비슷하다고 확장 매개변수, 설정 내보내기 형식, 작동 방식까지 모두 같다고 가정하지 마세요.
세 클라이언트 모두 공개된 오픈 소스 코드가 있으며, 클라이언트와 통합된 코어는 각각 별도의 오픈 소스 라이선스를 따릅니다. 라이선스는 코드의 사용, 수정, 배포 조건을 설명할 뿐 외부 구독 내용이나 네트워크 서비스 품질을 보장하지 않습니다. 관련 정보를 확인할 때는 클라이언트 프로젝트, 코어 프로젝트, 구독 제공 업체를 구분해서 살펴보세요. 인터페이스가 같아도 전혀 다른 서비스 환경에 연결될 수 있습니다.
구독 링크, 공유 링크, 내보낸 설정 파일에는 계정 식별 정보, 액세스 토큰, 키 자료가 포함될 수 있습니다. 도움을 요청할 때는 오류 문구, 작업 단계, 모드 이름만으로 충분한 경우가 많으므로 전체 설정을 공개하지 마세요. 이 사이트의 문서는 클라이언트 설정과 기술 개념을 다루며 서비스 유효 기간, 서버 권한, 구독 내용은 해당 제공 업체에 확인해야 합니다.
클라이언트 업데이트는 주로 관리 인터페이스와 통합 기능에 영향을 줍니다. 코어 업데이트는 프로토콜 지원과 작동 방식에 영향을 줄 수 있고 GeoIP·GeoSite 데이터베이스 업데이트는 분류 규칙의 적용 범위를 바꿉니다. 이 세 가지를 한 번에 처리하지 마세요. 일부 도메인의 라우팅만 잘못된다면 먼저 규칙 순서와 데이터베이스를 확인하고, 코어가 시작되지 않는다면 설정 필드와 코어 지원 여부를 점검하세요.
업데이트 전에 정상 작동하는 설정을 내보내고 현재 프록시 방식과 라우팅 프리셋을 기록하세요. 업데이트 후에는 기본 연결을 먼저 확인한 다음 사용자 지정 아웃바운드, DNS, TUN을 점검하세요. 여러 설정을 한꺼번에 새로 추가하지 마세요. 구독을 업데이트하면 서버 목록도 바뀔 수 있으므로 중요한 수동 수정 사항을 따로 기록해 다음 새로고침 후에도 복원할 수 있게 하세요. 이처럼 점검 순서를 정해 두면 업데이트 횟수에만 집중하는 것보다 설정을 파악하고 관리하기 쉽습니다.
증상에 맞는 글을 읽어 구독, DNS, 프로토콜 차이 중 원인을 먼저 좁힌 뒤 관련 설정을 확인하세요. 아래는 최근 게시한 글 세 편입니다.
지속적인 네트워크 활동과 잦은 연결 끊김·재연결을 구분한 뒤 백그라운드 실행 제한을 확인하세요. 배터리 최적화 예외의 역할과 앱별 프록시로 처리 범위를 줄이는 방법을 설명하며, 배터리 소모의 모든 원인을 코어 탓으로 돌리지 않도록 돕습니다.
글 읽기 →DNS 요청이 예상한 경로로 전송되는지 확인하고 클라이언트, 시스템, 브라우저의 DNS 설정을 각각 점검하세요. 원격 DNS, 도메인 정책, TUN의 작동 방식을 바탕으로 테스트 결과가 예상과 다를 수 있는 이유를 살펴봅니다.
글 읽기 →VMess의 기본 암호화와 시간 검증 방식, VLESS가 TLS 또는 REALITY와 조합되는 일반적인 방식을 비교합니다. 속도나 안정성을 프로토콜 이름만 보고 판단하지 말고 서버 지원 여부와 전체 연결 매개변수를 기준으로 선택하세요.
글 읽기 →첫 연결을 아직 완료하지 않았다면 먼저 가이드에 따라 기본 연결을 구성한 뒤 관련 글을 참고해 설정을 하나씩 조정하세요. 여러 설정 예시를 한꺼번에 시도하기보다 구체적인 오류 메시지와 재현 절차를 확인하는 편이 원인을 찾기 쉽습니다.
전체 글 보기 →