CLIENT SETUP / 사용법

V2Ray 구독 가져오기 및 연결 안내

‘구독 가져오기 → 프록시 모드 선택 → 연결 → 확인’ 순서로 처음 설정을 진행하세요. 클라이언트를 설치했고 유효한 구독 주소를 준비했다면 약 10분 정도면 전체 과정을 따라 할 수 있습니다. 실제 소요 시간은 네트워크와 설정에 따라 달라질 수 있습니다. 이 페이지에서는 그래픽 인터페이스의 필수 단계만 다룹니다. 설정 항목 전체 설명은 전체 설정 가이드를 참고하세요.

시작 전 준비: 클라이언트와 구독 주소

아직 설치하지 않았다면 클라이언트 다운로드 페이지에서 운영체제에 맞는 설치 파일을 선택하세요. 설치 후 메인 화면을 엽니다. 클라이언트는 설정을 읽고 트래픽을 전달하는 프로그램이며, 설치만으로 사용할 수 있는 노드가 생기지는 않습니다. 구독 주소나 노드 설정은 이용 권한이 있는 서비스의 관리 페이지에서 확인하세요. 이 안내에서는 공개 구독을 제공하지 않으며, 주소를 온라인 변환 페이지에 붙여 넣을 필요도 없습니다.

구독 주소를 준비했다면 먼저 기기의 날짜, 시간, 시간대가 올바른지 확인하세요. 시간이 크게 어긋나면 인증이나 보안 연결에 문제가 생길 수 있습니다. 다른 프록시 프로그램이 실행 중인지도 확인합니다. 데스크톱에서는 여러 프로그램이 동시에 시스템 프록시 설정을 변경하지 않도록 하고, 안드로이드에서는 일반적으로 활성 VPN 연결 하나만 사용할 수 있습니다. 처음 설정할 때는 다른 트래픽 전달 프로그램을 종료해 충돌 가능성을 줄인 다음 아래 단계를 진행하세요.

구독 URL에는 액세스 토큰이 포함되는 경우가 많으므로 계정 정보처럼 안전하게 보관하세요. 전체 주소를 스크린샷이나 공개 채팅, 문의 내용에 올리지 마세요. 도움을 요청할 때는 클라이언트 이름, 작업 위치, 오류 유형만 설명하면 됩니다. ‘구독’과 ‘노드’의 차이를 이해했다면 계속 진행할 수 있습니다. 관련 용어는 용어집에서 확인할 수 있으며, 프로토콜 원리를 먼저 모두 읽을 필요는 없습니다.

STEP 01 / SUBSCRIPTION

구독 가져오기: 주소를 저장한 뒤 노드 업데이트

먼저 가지고 있는 정보가 어떤 종류인지 확인하세요. 보통 https://로 시작하고 노드 목록을 계속 가져오는 주소는 구독 URL입니다. vmess://, vless:// 또는 trojan://으로 시작하는 문자열은 단일 노드 공유 링크인 경우가 많습니다. 두 정보는 가져오는 위치가 다릅니다. 구독 주소는 구독 그룹에 추가하고, 공유 링크는 클립보드에서 가져오기 기능을 사용하세요. 단일 노드 링크를 구독 주소 입력란에 넣으면 저장은 되더라도 업데이트에 실패할 수 있습니다.

v2rayN: 구독 그룹 추가

메인 창에서 ‘구독 그룹’ 메뉴를 열고 ‘구독 그룹 설정’으로 이동한 뒤 추가를 선택합니다. 구분하기 쉬운 그룹 이름을 입력하고 전체 구독 URL을 주소 입력란에 붙여 넣으세요. 앞뒤에 공백이나 줄바꿈, 메신저가 추가한 문장 부호가 들어갔는지 확인합니다. URL의 쿼리 매개변수는 임의로 삭제하거나 수정하지 마세요. 저장 후 메인 창으로 돌아옵니다. 이 단계에서는 주소만 저장된 상태이며 서버 목록은 아직 가져오지 않았습니다.

이어서 구독 메뉴에서 업데이트를 실행하고 해당 그룹의 업데이트 항목을 선택합니다. 처음 사용하거나 이용 가능한 연결이 없다면 보통 ‘프록시를 사용하지 않고’ 업데이트하는 방식을 선택합니다. 현재 네트워크에서 구독 주소에 직접 접속할 수 없고 다른 연결을 사용할 수 있는 경우에만 ‘프록시를 통해’ 업데이트하는 방법을 고려하세요. 하단 정보나 로그에서 진행 상황을 확인하고 업데이트가 끝날 때까지 기다립니다. 그런 다음 방금 만든 그룹을 선택해 목록에 노드 이름, 프로토콜, 주소 등의 항목이 표시되는지 확인하세요.

v2rayNG: 그룹을 추가하고 구독 가져오기

사이드 메뉴에서 ‘구독 그룹 설정’을 찾고 추가 버튼으로 그룹을 만듭니다. 그룹 이름과 구독 URL을 입력하고 저장하세요. 노드 메인 화면으로 돌아가 오른쪽 상단 메뉴를 열고 ‘구독 업데이트’ 또는 이에 해당하는 항목을 실행합니다. 그룹 추가와 구독 업데이트는 별개의 작업입니다. 그룹 이름만 보이고 노드 항목이 없다면 앱을 바로 다시 설치하지 말고 먼저 업데이트를 실행했는지 확인하세요.

단일 노드 공유 링크를 받은 경우 전체 내용을 복사한 다음 메인 화면의 추가 메뉴에서 ‘클립보드에서 가져오기’를 선택하세요. 가져온 뒤 노드가 목록에 표시되는지 확인합니다. 단일 노드로 가져온 설정은 일반적으로 구독 그룹처럼 지속적으로 업데이트되지 않습니다. 서비스 설정이 변경되면 다시 가져와야 할 수 있습니다. 공유 링크에도 접속 정보가 포함될 수 있으므로 해당 링크의 QR 코드 스크린샷을 공개된 곳에 계속 올려두지 마세요.

업데이트 오류가 발생하면 먼저 주소가 유효한지, 구독 한도나 유효 기간에 문제가 없는지 확인하세요. 그런 다음 로그에서 네트워크 시간 초과, 인증서 오류, 지원하지 않는 형식 등의 원인을 살펴봅니다. 같은 그룹을 반복해서 추가하지 마세요. 나중에 어떤 그룹을 사용 중인지 파악하기 어려워집니다. 노드가 하나 이상 표시되고 파싱 오류가 없는 것을 확인했다면 목록을 그대로 두고 다음 단계로 진행하세요. 이 시점에 모든 노드의 속도를 측정할 필요는 없습니다.

STEP 02 / TRAFFIC ENTRY

프록시 모드 선택: 진입 방식과 라우팅은 별도로 설정

클라이언트에서 ‘모드’는 서로 다른 두 가지를 가리킬 수 있습니다. 첫째는 데스크톱의 시스템 프록시나 안드로이드의 VPN처럼 앱 트래픽을 클라이언트로 전달하는 방식입니다. 둘째는 트래픽이 들어온 뒤 규칙에 따라 프록시로 전달하거나 직접 연결하는 라우팅 방식입니다. 진입 방식을 켰다고 모든 요청이 프록시를 거치는 것은 아니며, 프록시 라우팅을 선택했다고 다른 앱의 트래픽까지 클라이언트로 들어오는 것도 아닙니다. 처음 설정할 때 이 두 단계를 구분하면 관련 없는 옵션을 반복해서 바꾸지 않고 문제를 점검할 수 있습니다.

v2rayN: 시스템 프록시로 첫 연결 확인

창 하단이나 트레이의 마우스 오른쪽 버튼 메뉴에서 ‘시스템 프록시’ 관련 항목을 찾아 ‘시스템 프록시 자동 설정’과 ‘시스템 프록시 해제’ 같은 작업이 있는지 확인하세요. 처음에는 시스템 프록시를 사용하면 됩니다. TUN까지 동시에 켤 필요는 없습니다. 먼저 진입 방식을 정하고, 세 번째 단계에서 코어가 정상적으로 실행되는 것을 확인한 뒤 ‘시스템 프록시 자동 설정’을 켜세요. 그러면 시스템 프록시 설정을 따르는 앱의 요청이 로컬 리스닝 포트로 전달됩니다.

그다음 라우팅 선택 영역을 확인합니다. 클라이언트의 일반적인 규칙 집합은 프록시, 직접 연결, 차단을 구분하며, 구체적인 이름은 설치된 버전에 따라 다릅니다. 기본 규칙의 의미가 명확하지 않다면 먼저 설명을 읽어보세요. ‘글로벌’이라는 단어만 보고 모든 앱의 트래픽이 제어된다고 판단하지 마세요. 특정 목적지에 선택한 노드를 통한 접속이 가능한지 확인하려면 해당 목적지를 명확히 프록시로 보내는 규칙을 임시로 사용할 수 있습니다. 테스트가 끝나면 평소 사용하는 분할 라우팅 방식으로 되돌리세요.

시스템 프록시는 시스템 설정을 따르는 앱에 주로 적용됩니다. 일부 명령줄 도구, 게임, 자체 네트워크 스택을 사용하는 앱은 시스템 프록시를 따르지 않을 수 있습니다. 따라서 이 안내에서는 먼저 브라우저로 확인하며, 특정 앱에서 변화가 없다는 이유만으로 노드가 작동하지 않는다고 판단하지 않습니다. TUN, 인바운드 포트, 서로 다른 트래픽 진입 방식에 대해 더 알아보려면 inbounds 인바운드 설정을 참고하세요. 처음 연결하기 전에는 여러 진입 방식을 한꺼번에 변경하지 마세요.

v2rayNG: 라우팅과 앱 적용 범위 확인

사이드 메뉴에서 ‘설정’으로 이동해 라우팅 관련 옵션을 확인하세요. 처음 설정할 때는 설치된 버전의 기본 규칙을 유지해도 되지만, 기본 규칙에 따라 일부 목적지는 직접 연결될 수 있다는 점을 알아두세요. 앱별 프록시를 설정한 적이 있다면 테스트할 브라우저가 제외되지 않았는지도 확인합니다. 제외된 앱은 네트워크에 직접 연결될 수 있으므로 상단에 VPN 연결 표시가 있어도 해당 앱의 요청이 프록시를 거친다는 뜻은 아닙니다.

복잡한 사용자 지정 DNS, 앱 제외 목록, 여러 라우팅 규칙을 한꺼번에 적용하지 마세요. 먼저 ‘노드 하나, 이해하기 쉬운 규칙 하나, 테스트 앱 하나’로 변수를 줄입니다. 연결이 정상적으로 확인된 뒤 하나씩 조정하세요. 도메인 매칭, IP 매칭, domainStrategy의 자세한 내용은 용어집의 라우팅 및 DNS 설명과 routing 라우팅 참고 자료를 확인하세요. 모드 확인이 끝나면 노드 목록으로 돌아가 연결을 시작할 준비를 합니다.

STEP 03 / CONNECT

노드 연결: 선택 항목과 시작 로그 확인

목록에 노드가 표시된다고 현재 아웃바운드로 선택된 것은 아니며, 연결 버튼이 실행 중으로 표시된다고 원격 서버에 반드시 접속할 수 있는 것도 아닙니다. 먼저 활성 노드를 확인하고, 로컬 코어가 시작됐는지 확인한 다음 앱 트래픽을 전달합니다. 우선 설정 출처가 명확한 노드 하나만 선택하고, 연결 중에는 그룹을 바꾸거나 설정을 일괄 수정하지 마세요.

v2rayN: 활성 서버 지정 후 진입 방식 켜기

노드 목록에서 사용할 항목을 찾아 마우스 오른쪽 버튼을 클릭한 뒤 ‘활성 서버로 설정’ 또는 비슷한 항목을 선택하세요. 버전에 따라 더블 클릭으로 전환할 수도 있습니다. 작업 후에는 목록에서 마우스로 선택된 행만 보지 말고 현재 서버 표시, 상태 표시줄 정보, 로그를 확인하세요. 클라이언트는 활성 노드를 기준으로 실행 설정을 만들고 필요한 경우 코어를 다시 불러옵니다. 로그가 안정될 때까지 기다린 다음 시작 실패 메시지가 있는지 확인합니다.

로그에 로컬 포트가 이미 사용 중이라고 나오면 다른 프록시 클라이언트를 먼저 종료하고, 다른 v2rayN 인스턴스가 실행 중인지 확인하세요. 오류를 없애려고 모든 포트를 무작정 변경하지 마세요. 리스닝 포트를 변경해야 한다면 시스템 프록시나 해당 포트를 수동으로 사용하는 앱의 설정도 일치시켜야 합니다. 설정을 파싱할 수 없다는 오류가 나오면 시작 버튼을 반복해서 누르지 말고, 가져오기 단계로 돌아가 프로토콜과 클라이언트의 호환성을 확인하세요.

코어가 즉시 종료되지 않는 것을 확인한 뒤 이전 단계에서 준비한 ‘시스템 프록시 자동 설정’을 실행하세요. 일반적으로 v2rayN 창을 최소화해도 백그라운드에서 계속 실행되지만, ‘종료’를 선택하면 관련 서비스가 중지됩니다. 확인이 끝날 때까지 클라이언트를 실행 상태로 유지하고, 프로그램을 닫으면서 브라우저를 테스트하지 마세요. 설치된 버전에서 추가 권한이나 실행 구성 요소가 필요하다면 화면 안내에 따라 설정을 완료한 뒤 다시 시작하고 현재 노드부터 이어서 진행하세요.

v2rayNG: 노드를 선택하고 시스템 권한 승인

메인 화면에서 사용할 노드를 눌러 선택한 다음 하단의 시작 버튼을 누르세요. 처음 실행하면 안드로이드에서 VPN 연결 권한을 요청합니다. 앱 이름이 올바른지 확인한 뒤 연결을 허용하세요. 권한 요청을 취소하면 노드 설정이 정확하더라도 이 안내에 나온 방식으로 앱이 트래픽을 전달할 수 없습니다. 메인 화면으로 돌아가 다시 시작하고 권한을 승인하면 됩니다.

시작한 뒤 버튼 상태와 시스템 VPN 표시를 확인하고 클라이언트 로그에서 즉시 발생하는 오류나 반복 재시작이 있는지 살펴보세요. 시스템 표시는 로컬 트래픽 전달이 설정됐다는 뜻일 뿐, 노드 인증이 성공했다는 의미는 아닙니다. 다른 VPN 앱이 계속 실행 중이라면 먼저 연결을 끊고 v2rayNG를 시작하세요. 처음 확인할 때는 클라이언트를 화면에 띄워두고 연결이 정상인지 확인한 다음, 기기의 배터리 관리 설정에 따라 백그라운드 실행 문제를 조정하세요.

지연 시간 테스트에 숫자가 표시됐다는 이유만으로 모든 설정이 끝났다고 판단하지 마세요. 일부 테스트는 서버 포트까지만 확인하고, 다른 테스트는 현재 프록시를 통해 요청을 보낼 수 있어 결과의 의미가 다릅니다. 로컬 실행이 정상이라면 다음 단계로 넘어가 실제 접속으로 전체 경로를 확인하세요. 테스트 방식의 차이를 비교하려면 TCPing, 실제 연결 지연 시간, 다운로드 속도 측정의 차이를 참고하세요.

STEP 04 / VERIFY

작동 여부 확인: 실제 요청과 로그 비교

테스트에 사용할 브라우저를 열고 새 탭에서 정상 작동하며 접속 권한이 있는 HTTPS 페이지를 방문하세요. 이전에 열어보지 않은 페이지를 선택하거나 강력 새로고침을 해 캐시로 인한 오판을 줄입니다. 기존 탭에 내용이 계속 표시된다는 점만으로 판단하지 말고, 동영상 버퍼가 재생되는 것도 새 요청이 성공했다는 증거로 보지 마세요. 프록시를 시작한 뒤 새로 발생한 연결을 확인해야 합니다.

이어서 클라이언트로 돌아와 같은 시간대의 로그나 연결 기록을 확인하세요. 현재 로그 수준에서 요청이 기록된다면 대상 도메인이나 주소가 표시되는지 확인하고, 라우팅 기록을 함께 살펴 프록시와 직접 연결 중 어느 경로를 거쳤는지 판단합니다. 일부 버전은 모든 요청 기록을 기본으로 표시하지 않으므로 대상이 보이지 않는다고 곧바로 실패로 판단하지 마세요. 확인을 위해 클라이언트의 액세스 로그를 임시로 켤 수 있습니다. 점검 후에는 접속 대상 정보가 장기간 쌓이지 않도록 원래 설정으로 되돌리세요.

페이지가 열리더라도 라우팅 기록에 direct가 표시된다면 직접 연결이 정상이라는 뜻일 뿐, 선택한 프록시 노드가 작동한다고 확인된 것은 아닙니다. 프록시 아웃바운드를 확인하려면 프록시로 전달되도록 지정한 테스트 대상이나 임시 규칙을 사용한 뒤 새 요청을 보내세요. 반대로 프록시 대상에는 접속할 수 있지만 로컬 네트워크 기기에 연결할 수 없다면 노드를 바로 바꾸기보다 로컬 네트워크 직접 연결 규칙을 먼저 확인하세요.

문제가 발생하면 세 단계로 범위 좁히기

먼저 진입 방식을 확인합니다. 브라우저 요청이 클라이언트로 들어오지 않는다면 데스크톱에서는 시스템 프록시가 켜져 있는지, 브라우저에 별도 프록시 설정이 있는지 다시 확인하세요. 안드로이드에서는 VPN이 계속 연결되어 있는지, 브라우저가 앱별 프록시 제외 목록에 포함되어 있는지 살펴봅니다. 요청이 아직 원격 연결 단계에 도달하지 않았으므로 이때 원격 TLS 설정을 바꿔도 보통 문제가 해결되지 않습니다.

다음으로 라우팅을 확인합니다. 요청이 클라이언트로 들어왔지만 예상과 다른 아웃바운드 경로를 거친다면 현재 선택한 규칙 집합과 대상 매칭 조건을 확인하세요. 규칙을 수정한 뒤 저장하고 설정을 다시 불러온 다음 새 요청으로 확인합니다. 기존 연결은 이전 경로를 계속 사용할 수 있습니다. 원인을 파악하기 어려워지지 않도록 노드, DNS, 프록시 모드를 동시에 바꾸지 말고 해당 대상과 관련된 규칙 하나만 조정한 뒤 변경 사항을 기록하세요.

마지막으로 원격 연결을 확인합니다. 요청이 프록시 아웃바운드로 전달됐는데 실패한다면 연결 시간 초과, 인증 실패, TLS 핸드셰이크 오류 중 어떤 문제인지 살펴보세요. 시간 초과는 주소, 포트, 네트워크 연결 가능성과 관련될 수 있습니다. 인증에 실패하면 구독 유효성과 계정 설정을 확인하세요. 핸드셰이크 오류는 서비스에서 요구하는 서버 이름, 시간, 전송 설정을 확인해야 합니다. 오류를 감추려고 인증서 검증을 끄지 말고 올바른 설정을 다시 받아 사용하세요. 구체적인 항목은 전체 설정 가이드에서 프로토콜별로 확인할 수 있습니다.

확인이 끝난 뒤 설정 저장 및 종료

요청이 예상한 프록시 경로를 거치는 것을 확인했다면 유효한 구독 그룹, 노드 이름, 규칙 집합 이름만 기록해 두세요. 전체 인증 정보를 기록할 필요는 없습니다. 다음에 사용할 때는 보통 구독 업데이트, 노드 선택, 연결 시작만 하면 됩니다. 서비스 설정이나 사용 목적이 달라진 경우에만 앞의 모드 설정을 다시 확인하세요. 구독을 업데이트하면 노드 이름이 바뀔 수 있으므로 활성 노드를 다시 확인하고, 이전 선택이 그대로 유지된다고 가정하지 마세요.

사용을 마치면 v2rayN 데스크톱에서는 먼저 시스템 프록시를 해제한 다음 클라이언트를 종료하세요. 정상 종료 시 관련 상태가 정리되는 경우가 많지만, 비정상 종료 후 시스템 프록시 설정이 남아 있는지 확인해야 합니다. v2rayNG 안드로이드에서는 중지 버튼을 눌러 VPN 연결을 종료하세요. 종료 후 브라우저 접속이 갑자기 안 된다면 네트워크 전체를 바로 초기화하지 말고, 이미 중지된 로컬 프록시 포트를 계속 가리키고 있는지 먼저 확인하세요.

용어가 궁금하면 용어집을 참고하세요. JSON의 inbounds, outbounds, routing, dns가 어떻게 연결되는지 알아보려면 전체 설정 파일 참고 자료를 읽어보세요. 처음 연결할 때 JSON 전체를 직접 작성할 필요는 없습니다. 먼저 그래픽 클라이언트의 기본 설정 과정을 안정적으로 완료하세요.