기기에 맞는 클라이언트를 선택하고 구독 가져오기, 라우팅 설정, 연결 확인 순서로 진행하세요.
구독 링크를 별도의 그룹에 저장한 다음 구독을 업데이트하세요. 구독은 여러 연결 설정을 가져오는 주소입니다. 업데이트하면 목록에 항목이 추가되거나 삭제되거나 변경될 수 있습니다. 공유 링크를 하나씩 붙여 넣는 것보다 그룹으로 관리하면 편리하고, 각 설정의 출처도 확인하기 쉽습니다. 업데이트 후에는 사용할 설정을 직접 선택하고 연결을 시작해야 합니다. 목록이 새로고침되어도 설정이 자동으로 전환되는 것은 아닙니다. 가져오기에 실패하면 링크가 완전한지, 만료되지는 않았는지 확인한 다음 로그를 살펴보세요. 바로 클라이언트를 다시 설치할 필요는 없습니다. 구독 주소에는 접근 정보가 포함될 수 있으니 공개 스크린샷에 노출하지 마세요.
구독 그룹 추가 · 구독 주소 저장
설정 목록을 새로고침한 다음 사용할 설정을 선택하세요.
사용 목적에 맞는 라우팅 프리셋을 먼저 선택하고 필요한 규칙만 추가하세요. 라우팅은 도메인, 주소, 앱의 특성에 따라 연결을 직접 연결하거나 프록시로 보내거나 차단하는 규칙 모음입니다. 일상적인 사용에는 LAN 우회 프리셋부터 적용하고 프린터나 공유 폴더 같은 로컬 리소스에 계속 접근할 수 있는지 확인하세요. 라우팅은 프록시 주소 하나를 지정하는 것과 달리 트래픽 처리 범위도 정합니다. 변경 후에는 로컬 서비스와 대상 웹사이트를 각각 테스트하세요. 특정 접속에 문제가 생기면 DNS를 바꾸기 전에 규칙 순서와 일치 조건부터 확인하세요. 여러 설정을 한꺼번에 바꾸면 원인을 찾기 어렵습니다.
LAN 및 중국 본토 주소 우회
domainStrategy: IPIfNonMatch클라이언트 설정에서 실제 수신 포트를 확인한 뒤, 프록시를 수동으로 설정해야 하는 앱에 같은 주소를 입력하세요. 인바운드는 코어가 연결을 받는 진입점이고, 아웃바운드는 연결을 대상이나 원격 서비스로 전달합니다. 아래 JSON은 로컬 SOCKS 인바운드 예시일 뿐, 바로 실행할 수 있는 완전한 설정이 아니며 현재 기기의 포트를 나타내지도 않습니다. LAN 수신을 허용하는 대신 로컬 루프백 주소에 바인딩하면 현재 기기에서만 연결을 받을 수 있습니다. 포트가 사용 중이라는 메시지가 표시되면 사용 가능한 포트로 바꾸고 앱 설정도 함께 수정하세요. 한쪽만 변경하지 마세요.
{
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
}
]
}Android에서 VPN 모드를 사용하는지 먼저 확인한 다음 앱별 프록시 목록이 어떤 방식으로 작동하는지 살펴보세요. 목록은 선택한 앱에만 프록시를 적용할 수도 있고, 선택한 앱을 프록시에서 제외할 수도 있습니다. 체크 표시만 보고 판단하지 마세요. 시스템 전체의 트래픽 규칙을 바꾸는 대신 앱별 설정을 사용하면 일부 앱의 기존 연결 방식을 유지할 수 있습니다. 설정을 저장한 뒤 연결을 다시 시작하고 대상 앱에서 작동을 확인하세요. 이미 연결된 세션에는 새 규칙이 즉시 적용되지 않을 수 있습니다. 특정 앱 하나만 접속되지 않는다면 먼저 해당 앱이 제외되어 있는지 확인한 다음 앱 자체의 네트워크 설정을 살펴보세요. 메뉴 이름은 클라이언트 업데이트에 따라 다를 수 있습니다.
활성화한 뒤 선택한 앱의 처리 방식을 확인하세요.
다른 기기에서 연결해야 하는 경우에만 활성화하세요.
시스템 프록시는 운영체제 설정에 프록시 주소를 지정하는 방식으로, 해당 설정을 따르는 브라우저와 데스크톱 앱에 적합합니다. 모든 프로그램의 트래픽을 강제로 처리하지는 않습니다. 명령줄 도구, 게임, 자체적으로 연결을 관리하는 앱은 기존 경로를 계속 사용할 수 있습니다. 먼저 브라우저에서 연결을 확인한 다음 다른 앱이 프록시를 수동으로 지정할 수 있는지 살펴보세요. 브라우저에서는 접속되지만 특정 프로그램에서 실패한다면 노드가 작동하지 않는다고 단정하지 말고 해당 프로그램의 프록시 설정부터 확인하세요.
Android의 VPN 모드는 시스템이 제공하는 가상 네트워크 인터페이스로 트래픽을 처리합니다. 데스크톱 TUN 모드는 가상 네트워크 어댑터를 통해 규칙에 맞는 연결을 받습니다. 두 방식 모두 라우팅과 DNS 설정이 필요하므로 스위치를 켰다고 모든 요청이 성공하는 것은 아닙니다. 먼저 시스템 권한을 확인한 다음 트래픽 처리 범위를 살펴보세요. 데스크톱에서는 관리자 권한이 필요하거나 관련 구성 요소를 설치해야 할 수 있습니다. 다른 네트워크 트래픽 처리 도구를 사용 중이라면 충돌 여부를 확인하고 하나씩 테스트하세요.
운영체제와 프로세서 아키텍처를 먼저 확인하세요. 설치 파일 링크와 요구 사항은 다운로드 페이지에서 확인할 수 있습니다.
v2rayN을 선택하세요. 다운로드 페이지에는 데스크톱 버전과 클래식 WPF 버전이 있습니다. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, WPF 버전은 익숙한 데스크톱 사용 방식을 이어갑니다. 원하는 버전의 실행 환경 안내를 먼저 읽고 한 가지 버전을 선택하세요. 두 버전을 모두 설치할 필요는 없습니다.
설치하거나 압축을 푼 뒤 프로그램 디렉터리 구조를 그대로 유지하세요. 실행 오류가 발생하면 메시지를 기록하고 실행 환경과 디렉터리 권한을 확인하세요. 업데이트 전에 구독 그룹, 라우팅, 사용자 설정을 저장해 두면 덮어쓴 뒤에도 복구하기 쉽습니다.
다운로드v2rayN을 선택하고 Apple Silicon과 Intel에 맞는 설치 파일을 구분하세요. 시스템의 ‘이 Mac에 관하여’에서 칩 또는 프로세서 정보를 확인한 뒤 해당 다운로드 링크를 선택하세요. 컴퓨터 외관이나 구입 연도만으로 아키텍처를 판단하면 안 됩니다.
처음 실행할 때 시스템 안내에 따라 권한을 설정하세요. 연결 후 브라우저에서만 작동한다면 다른 앱이 시스템 프록시를 사용하는지 확인하세요. 더 넓은 범위의 트래픽을 처리해야 한다면 TUN 권한 요건과 다른 네트워크 도구와의 호환성을 살펴보세요.
다운로드Xray 코어를 사용하는 v2rayNG를 우선 선택하세요. V2Fly 코어가 필요하면 대안인 v2flyNG를 확인할 수 있습니다. 일반적인 기기에는 arm64 패키지가 적합한 경우가 많지만, 기기에서 지원하는 아키텍처를 기준으로 선택하세요. 확실하지 않다면 범용 버전 안내를 읽어보세요.
설치한 뒤 설정을 가져오고 VPN 연결 권한을 허용하세요. 백그라운드에서 연결이 자주 끊기면 배터리 최적화와 백그라운드 활동 제한을 확인하세요. 클라이언트를 바꿀 때는 지원 프로토콜을 다시 확인하세요. 두 코어가 모든 설정 항목을 똑같이 처리한다고 가정하면 안 됩니다.
다운로드v2rayN을 선택하고 배포판의 패키지 형식에 따라 deb 또는 rpm을 고른 다음 x64 또는 arm64 아키텍처를 확인하세요. 패키지 형식과 프로세서 아키텍처는 서로 별개의 조건입니다. 확장자가 맞더라도 현재 기기에 적합하다는 뜻은 아닙니다.
설치 후 데스크톱 환경의 프록시 설정이 적용되는지 확인하세요. 앱마다 프록시 설정을 읽는 방식이 다를 수 있으며, 터미널 도구는 특히 별도로 확인해야 합니다. 처음 연결할 때는 일반 프록시 방식으로 작동을 확인하고 가상 네트워크 어댑터를 통한 트래픽 처리 방식은 이후에 검토하세요.
다운로드클라이언트는 연결을 관리할 뿐, 사용할 수 있는 서비스를 만들어 내지는 않습니다. 시작하기 전에 사용할 권한이 있는 구독 주소나 연결 설정을 준비하세요.
구독 그룹 설정을 열고 알아보기 쉬운 그룹 이름을 입력하세요. 전체 주소를 붙여 넣어 저장한 다음 구독을 업데이트합니다. 공유 링크가 하나뿐이라면 클립보드 가져오기 기능을 사용하세요. 가져온 뒤 프로토콜, 주소, 전송 설정이 올바르게 인식되었는지 확인하고 설정 하나를 선택하세요. 먼저 여러 항목을 한꺼번에 수정하지 마세요. 문제가 원래 설정에서 생겼는지 이후 변경에서 생겼는지 구분하기 어렵습니다.
업데이트 결과가 비어 있다면 주소의 유효 기간과 접근 권한을 확인한 다음 클라이언트 로그에서 오류를 찾아보세요. 구독 주소를 일반 웹 링크처럼 아무에게나 전달하지 말고, 전체 설정 파일을 공개 게시판에 올리지 마세요.
데스크톱에서는 시스템 프록시와 라우팅 프리셋을 먼저 확인하세요. Android에서는 VPN 모드를 선택하고 시스템 권한을 허용한 다음 앱별 프록시 목록을 살펴보세요. 처음에는 단순하고 명확한 규칙을 유지하고 연결이 정상인지 확인한 뒤 하나씩 추가하세요. LAN 서비스에 접속해야 한다면 로컬 주소가 예상대로 직접 연결되는지 테스트하세요. 특정 앱의 트래픽을 처리하려면 해당 앱이 처리 범위에 포함되어 있는지 확인하세요.
‘전역’ 모드라고 해서 모든 전제 조건이 사라지는 것은 아닙니다. 앱이 프록시를 사용하는지, DNS가 어떻게 조회되는지, 규칙이 어떻게 적용되는지에 따라 결과가 달라집니다. 한 번에 설정 하나만 바꾸고 변경 전 상태를 기록해 두면 쉽게 되돌릴 수 있습니다.
시작을 누른 뒤 클라이언트에 오류가 표시되는지 확인하세요. 그런 다음 접속 가능한 것으로 확인된 웹사이트를 열고 실제로 사용할 앱도 테스트하세요. 연결 상태, 지연 시간 테스트, 웹사이트 접속은 서로 다른 근거입니다. 포트에 연결할 수 있어도 프로토콜 핸드셰이크가 성공했다는 뜻은 아니며, 핸드셰이크가 성공해도 대상 웹사이트가 반드시 열리는 것은 아닙니다. 테스트 결과가 서로 다르면 오류가 발생한 시간과 로그의 키워드를 기록하고 순서대로 점검하세요.
사용을 마치면 연결을 끄고 시스템 프록시가 원래대로 복원되었는지 확인하세요. 클라이언트를 종료한 뒤에도 브라우저가 로컬 프록시 포트를 가리키면 일반 웹사이트에도 접속하지 못할 수 있습니다. 이때는 설정을 계속 바꾸기보다 시스템 프록시 설정부터 확인하세요.
클라이언트, 코어, 원격 서비스를 구분한 뒤 기능이 필요한 상황인지 판단하세요.
Project V는 프록시 통신 도구를 중심으로 형성된 오픈소스 생태계이며, V2Ray는 그 안에서 널리 사용되는 프로젝트 이름입니다. 일상적으로 말하는 ‘V2Ray 설치’는 실제로는 그래픽 인터페이스가 있는 클라이언트를 설치하는 경우가 많습니다. 클라이언트는 구독 관리, 설정 선택, 시스템 프록시, 로그 표시를 담당하고 코어는 설정을 읽어 연결을 처리합니다. 두 요소는 함께 작동하지만 같은 프로그램은 아니며 업데이트 일정도 다를 수 있습니다.
V2Fly는 V2Ray의 커뮤니티 유지보수 흐름을 이어가고, Xray는 별도의 발전 방향을 가진 관련 코어 프로젝트입니다. 공통된 기술적 배경은 있지만 프로토콜 구현, 전송 기능, 지원 필드가 완전히 같지는 않습니다. 가져오기는 성공했는데 시작되지 않는다면 공유 링크의 이름만 볼 것이 아니라 클라이언트에서 현재 사용하는 코어와 설정의 요구 사항을 확인하세요.
v2rayN은 데스크톱용으로 그래픽 인터페이스에서 설정을 관리하고 지원되는 코어와 함께 사용할 수 있습니다. v2rayNG는 Android용이며 Xray 코어를 사용합니다. v2flyNG는 V2Fly 코어를 기반으로 하는 대안을 제공합니다. 세 클라이언트 모두 오픈소스 프로젝트를 기반으로 하며 구체적인 기능, 의존성, 라이선스는 각 프로젝트의 릴리스 안내를 확인하세요. 데스크톱과 Android의 설정 메뉴는 서로 다르므로 사용법에 나온 메뉴 이름은 현재 화면과 비교해 이해해야 합니다.
오픈소스란 해당 라이선스에 따라 코드 사용 및 협업 조건이 제공된다는 뜻입니다. 클라이언트에 원격 서비스가 포함되어 있다는 뜻도, 출처를 알 수 없는 설정을 신뢰해도 된다는 뜻도 아닙니다. 클라이언트, 코어, 서드파티 의존성에는 각각 다른 라이선스가 적용될 수 있으므로 배포하거나 수정해 개발하기 전에 요구 사항을 따로 확인하세요. 일반 사용자도 설정의 출처와 구독 권한, 민감 정보의 보관 방식에 주의를 기울여야 합니다. ‘오픈소스’라는 이유만으로 이러한 사용상 주의 사항을 간과하지 마세요.
클라이언트 업데이트는 인터페이스, 설정 생성 방식, 코어 호환 범위를 변경할 수 있고 코어 업데이트는 프로토콜 작동 방식과 필드 제한에 영향을 줄 수 있습니다. 관련 변경 사항을 먼저 읽고 구독 그룹, 라우팅 규칙, 사용자 설정을 저장하세요. 업데이트가 끝나면 기존에 작동을 확인한 설정으로 자주 사용하는 앱을 테스트하고 LAN 접속, 분기 규칙, 백그라운드 연결이 예상대로 유지되는지 확인하세요. 업데이트와 동시에 라우팅을 크게 변경하지 마세요.
이 사이트는 다운로드 링크, 시작 방법, 설정 항목 설명을 나누어 정리했습니다. 다운로드 페이지에서는 플랫폼과 설치 파일 종류를 확인하고, 시작 가이드에서는 검증 가능한 첫 연결을 설정하며, 설정 항목 페이지에서는 JSON의 인바운드, 아웃바운드, 라우팅, DNS를 알아볼 수 있습니다. 기술 노트에서는 구체적인 문제 상황을 다룹니다. 도움이 필요하면 문제 단계에 맞는 내용을 먼저 확인하세요. 반복해서 삭제하고 다시 설치하는 것보다 유용한 단서를 보존하기 쉽습니다.
로그, 속도 측정, 트래픽 처리 방식을 바탕으로 설정 문제와 앱 동작 문제를 구분하세요.
로그 수준을 조정하고 로그 위치를 확인하세요. 연결 거부, 연결 시간 초과, 사용자 인증 실패를 구분한 다음 오류가 발생한 단계부터 점검합니다. 로그를 공유하기 전에 구독 주소와 접근 정보를 삭제하세요.
기술 노트 보기포트 연결, 프록시 핸드셰이크, 지속적인 데이터 전송이 각각 어떤 범위를 테스트하는지 구분하세요. 먼저 테스트가 어느 구간을 측정했는지 파악하면 지연 시간은 낮은데 웹페이지가 열리지 않는 이유와 설정 선택 시 참고할 항목을 알 수 있습니다.
기술 노트 보기시스템 프록시와 가상 네트워크 어댑터가 작동하는 계층을 비교하고, 시스템 프록시를 사용하지 않는 앱에 별도의 트래픽 처리 방식이 필요한 이유를 알아보세요. 권한, 라우팅, DNS 순서로 TUN 설정을 확인할 수 있습니다.
기술 노트 보기