클라이언트가 실행됨
처음 실행했을 때 오류가 계속 발생하지 않고 메인 화면, 설정 화면, 로그 메뉴에 모두 접근할 수 있습니다.
설정 / 약 10분
사용 가능한 구독 주소에서 시작해 서버 목록 업데이트, 프록시 모드 선택, 클라이언트 연결, 결과 확인을 차례로 진행합니다. 이 글에서는 처음 사용할 때 필요한 작업만 다루며, 복잡한 라우팅과 JSON 필드는 설정 문서에서 이어서 확인할 수 있습니다.
시작 전 확인
작업을 시작하기 전에 클라이언트가 설치되어 정상적으로 실행되는지 확인하세요. 데스크톱에서는 v2rayN, Android에서는 v2rayNG를 사용합니다. 아직 설치하지 않았다면 설치 파일 페이지에서 플랫폼에 맞는 버전을 선택하세요. 구독 주소는 보통 https://로 시작하는 완전한 링크이며, 클라이언트에 서버 설정을 제공합니다. 복사할 때는 첫 문자부터 마지막 문자까지 선택하고, 메신저가 자동으로 넣은 공백·줄바꿈·설명 문구는 포함하지 마세요.
구독 주소와 개별 서버 공유 링크는 서로 다른 진입 방식입니다. 구독은 클라이언트에서 업데이트할 수 있으며, 업데이트 후 여러 서버 기록이 추가되는 경우가 많습니다. 개별 공유 링크는 보통 설정 하나만 가져옵니다. 내용이 vmess://, vless:// 또는 trojan://으로 시작한다면 구독 주소 입력란이 아니라 클라이언트의 ‘클립보드에서 가져오기’ 기능을 사용하세요. 관련 프로토콜 이름은 용어집에서 확인할 수 있으며, 여기서는 가장 일반적인 구독 절차를 계속 진행합니다.
처음 실행했을 때 오류가 계속 발생하지 않고 메인 화면, 설정 화면, 로그 메뉴에 모두 접근할 수 있습니다.
링크 앞뒤에 공백이 없고 복사 과정에서 잘리지 않았으며, 불필요한 설명 문구가 섞이지 않았습니다.
날짜, 시간대, 자동 시간 설정이 정상이어야 TLS 핸드셰이크가 시간 오차로 실패하는 것을 막을 수 있습니다.
Subscription
v2rayN에서 ‘구독 그룹’ 또는 ‘구독 설정’ 메뉴를 열고 새 구독 그룹을 만듭니다. 이름은 용도나 출처를 구분하기 쉬운 짧은 문구로 입력하면 됩니다. 주소 입력란에는 앞에서 준비한 전체 구독 링크를 붙여 넣으세요. 저장한 뒤 메인 창으로 돌아가 ‘구독 업데이트’를 실행합니다. 버전에 따라 메뉴 문구가 조금 다를 수 있지만 구독, 그룹, 업데이트라는 키워드는 공통으로 포함됩니다. 업데이트 중에는 버튼을 연속으로 클릭하지 말고 클라이언트가 요청과 분석을 완료할 때까지 기다리세요.
v2rayNG에서 사이드 메뉴를 열고 구독 그룹 관리로 이동합니다. 추가 버튼을 누른 뒤 이름과 주소를 입력하고 저장하세요. 구독 목록으로 돌아와 방금 만든 그룹을 선택한 다음 업데이트합니다. 업데이트가 끝나면 메인 화면으로 돌아가 서버 목록에 하나 이상의 항목이 나타나는지 확인하세요. 목록이 비어 있다면 구독 관리에서 해당 그룹이 활성화되었는지 다시 확인하고 주소 앞뒤의 공백도 점검하세요. 주소는 직접 입력하기보다 시스템 클립보드에서 붙여 넣는 편이 일반적으로 더 정확합니다.
서버 목록이 표시된 뒤에는 현재 사용할 서버를 명확히 선택해야 합니다. v2rayN에서는 보통 목록의 대상 행을 두 번 클릭하거나 오른쪽 클릭 메뉴에서 활성 서버로 지정합니다. v2rayNG에서는 메인 화면의 서버 항목을 눌러 현재 설정으로 선택합니다. 선택되면 화면에 해당 이름이나 선택 상태가 표시됩니다. 목록에 나타났다는 이유만으로 다음 단계로 넘어가지 마세요. 클라이언트가 이번 연결에 불러올 설정을 알아야 합니다.
업데이트 중 시간 초과, 형식 오류, 인식할 수 없는 응답이 표시되더라도 클라이언트를 반복해서 삭제하고 재설치하지 마세요. 먼저 구독 주소를 다시 붙여 넣고 로그에서 처음으로 명확하게 나타난 오류를 확인하세요. 시간 초과는 현재 주소에 접근할 수 없다는 뜻인 경우가 많고, 형식 오류는 응답 내용이 클라이언트가 기대하는 구독 데이터가 아니라는 의미일 수 있습니다. 업데이트는 성공했지만 서버가 없다면 그룹이 비활성화되었거나 응답 목록이 비어 있을 가능성이 있습니다. 구독, 노드, 서버 항목의 차이는 용어집에서 이어서 확인하세요.
Routing mode
프록시 모드는 어떤 네트워크 요청을 현재 서버로 처리하고 어떤 요청을 직접 연결할지 결정합니다. 처음 설정할 때는 ‘규칙 모드’부터 시작하는 것이 좋습니다. 규칙 모드는 클라이언트에 내장되었거나 구독에서 제공한 라우팅 규칙으로 요청을 판단하므로 일상적인 사용에 적합합니다. ‘전역 모드’는 더 많은 요청을 일괄적으로 현재 서버를 거치게 하며, 규칙 매칭 문제를 일시적으로 확인할 때 유용합니다. 두 모드는 서버 품질을 고르는 옵션이 아니며 구독 자체를 바꾸지도 않습니다. 트래픽이 서로 다른 아웃바운드 경로로 들어가는 방식만 바꿉니다.
v2rayN 데스크톱에서는 트레이 메뉴나 메인 창의 시스템 프록시 영역에서 모드 옵션을 찾을 수 있습니다. 일반적으로 ‘시스템 프록시 해제’, ‘시스템 프록시 자동 설정’, ‘시스템 프록시 변경 안 함’과 같은 항목이 함께 표시됩니다. 처음 사용할 때는 시스템 프록시를 활성화하는 항목을 선택하고 라우팅 모드는 규칙 모드로 설정하세요. 시스템 프록시는 브라우저와 시스템 설정을 따르는 프로그램의 요청을 v2rayN으로 보내며, 라우팅 모드는 코어가 해당 요청을 직접 연결할지 현재 서버로 보낼지 판단합니다.
v2rayNG Android에서는 설정 또는 메인 화면의 라우팅 설정 메뉴를 열고 규칙 모드에 해당하는 설정을 선택합니다. 버전에 따라 모드가 미리 정의된 규칙 이름으로 표시되거나 더 세분화된 도메인 정책으로 나타날 수 있습니다. 처음에는 도메인 매칭, IP 매칭, DNS 정책을 하나씩 수정하지 말고 기본값을 유지하는 편이 문제가 구독에 있는지 사용자 지정 규칙에 있는지 판단하기 쉽습니다. routing, domainStrategy, 규칙 순서를 자세히 이해하려면 설정 전체 가이드에서 설명을 확인하세요.
라우팅 규칙에 따라 직접 연결과 프록시를 분배하며, 기본 확인을 마친 뒤 일상적으로 사용하기에 적합합니다. 특정 페이지에서 이상이 나타나면 로그와 함께 적용된 규칙을 확인하세요.
더 넓은 범위의 요청을 현재 서버를 통해 처리합니다. 전역 모드는 정상인데 규칙 모드에서 문제가 발생한다면 라우팅 규칙이나 DNS 정책부터 점검해야 합니다.
처음 설정할 때 라우팅, DNS, 로컬 수신 포트, 코어 매개변수를 동시에 변경하지 마세요. 여러 항목을 한꺼번에 바꾸면 연결에 실패해도 원인을 특정하기 어렵습니다. 기본 포트와 DNS 설정은 그대로 두고 서버와 규칙 모드만 선택하는 것이 안전합니다. 연결을 확인한 뒤 실제 필요에 따라 분할 라우팅을 조정하세요. 이렇게 하면 단계별 상태 변화가 분명해지고 로그도 읽기 쉬워집니다.
시스템 프록시를 따르지 않는 프로그램은 데스크톱에서 시스템 프록시를 활성화해도 요청이 클라이언트로 들어오지 않을 수 있습니다. 이때는 먼저 일반 브라우저로 이 글의 확인 절차를 완료하고, 고급 투명 프록시 기능을 바로 조정하지 마세요. 기본 절차가 통과된 뒤 프로그램 자체의 프록시 설정이나 설정 전체 가이드의 인바운드 및 라우팅 장을 확인하세요. 이 가이드의 목표는 모든 네트워크 프로그램을 한 번에 다루는 것이 아니라, 작동 여부를 확인할 수 있는 기본 경로를 먼저 만드는 것입니다.
Connect
시작하기 전에 현재 서버 이름을 다시 확인해 실수로 방금 가져왔지만 선택하지 않은 항목을 사용하지 않도록 하세요. v2rayN 데스크톱은 실행 후 보통 시스템 트레이에 상주합니다. 활성 서버를 선택하고 시스템 프록시를 활성화하면 클라이언트가 코어 프로세스를 시작하고 현재 설정을 불러옵니다. 메인 창의 로그 영역이나 별도 로그 창에 설정 로드, 수신 포트, 실행 상태와 관련된 정보가 차례로 표시됩니다. 오류가 계속 반복되지 않는다면 단일 안내 문구만 보고 바로 중단하지 말고 시작이 완료될 때까지 기다리세요.
v2rayNG Android에서는 메인 화면에서 서버를 선택한 뒤 하단의 연결 버튼을 누릅니다. 시스템이 처음 이러한 연결을 처리할 때 권한 창이 표시되며, 승인한 뒤 클라이언트로 돌아옵니다. 연결 버튼의 모양이 바뀌고 시스템 상태 표시줄에도 연결 상태 아이콘이 나타납니다. 누른 직후 다시 연결 해제 상태로 돌아간다면 코어 시작 단계에서 실패한 것이므로 연결 버튼을 연속해서 누르지 말고 로그에서 원인을 확인하세요.
데스크톱에서 가장 자주 빠뜨리는 부분은 코어는 실행 중이지만 시스템 프록시가 활성화되지 않은 경우입니다. 이때 v2rayN 로그는 정상처럼 보여도 브라우저는 여전히 기존 네트워크 경로를 사용할 수 있습니다. 트레이 메뉴로 돌아가 시스템 프록시 상태를 확인하고 현재 항목이 ‘시스템 프록시 해제’나 ‘시스템 프록시 변경 안 함’이 아닌지 확인하세요. 회사 프로그램, 브라우저 확장 기능, 다른 네트워크 도구가 시스템 프록시를 함께 변경하고 있다면 먼저 해당 도구를 중지해 여러 프로그램이 같은 시스템 설정을 덮어쓰지 않게 하세요.
또 다른 흔한 문제는 로컬 포트를 다른 프로그램이 사용 중인 경우입니다. 로그에 address already in use, bind failed 또는 포트 사용 중이라는 의미의 메시지가 명확히 나타나면 중복 실행된 클라이언트 인스턴스를 종료한 뒤 다시 연결하세요. 관련 구조를 모르는 상태에서 포트 번호를 임의로 입력하지 마세요. 시스템 프록시, HTTP 인바운드, SOCKS 인바운드는 현재 클라이언트 설정과 일치해야 합니다. 포트를 조정해야 한다면 먼저 설정 전체 가이드에서 인바운드 수신 구조를 확인한 뒤 관련 설정을 함께 변경하세요.
로그에 인증서 시간, 핸드셰이크, serverName 관련 오류가 표시되면 먼저 시스템 날짜·시간·시간대가 정확한지 확인한 다음 구독을 업데이트하고 서버를 다시 선택하세요. 시스템 시간 오차는 TLS 연결 판정에 직접 영향을 줍니다. 구독의 서버 이름과 전송 매개변수가 일치하지 않아도 핸드셰이크가 중단될 수 있습니다. 기본 사용자가 이러한 필드를 추측해 직접 수정할 필요는 없습니다. 로그를 보존하고 구독을 업데이트한 뒤 같은 구독의 다른 서버로 바꿔 비교하는 순서가 더 적절합니다.
Verification
확인할 때 클라이언트 버튼 색상만 보지 마세요. 버튼은 코어가 실행을 시도했다는 뜻일 뿐, 구독 서버·라우팅 규칙·대상 페이지 사이의 전체 경로가 정상이라는 증거는 아닙니다. 먼저 평소 직접 접속할 수 있는 일반 페이지를 열어 클라이언트를 활성화한 뒤 기본 네트워크가 끊기지 않았는지 확인하세요. 그다음 현재 설정으로 처리해야 하는 대상 페이지를 열어 정상적으로 로드되는지 살펴봅니다. 두 가지 테스트를 함께 진행해야 직접 연결과 프록시 경로가 모두 작동하는지 대략 판단할 수 있습니다.
일반 페이지는 열리지만 대상 페이지가 로드되지 않는다면 모든 설정을 한꺼번에 바꾸지 마세요. 클라이언트로 돌아가 서버가 계속 선택되어 있는지 확인한 다음 최신 로그를 살펴보세요. 로그에 대상 요청 기록이 없다면 요청이 클라이언트로 들어오지 않았을 수 있으므로 시스템 프록시, 브라우저의 별도 프록시 설정, 해당 프로그램의 시스템 설정 준수 여부를 확인해야 합니다. 대상 요청은 기록되었지만 이후 오류가 발생했다면 서버 연결, TLS 매개변수, 라우팅 매칭을 계속 점검하세요.
모든 페이지가 열리지 않는다면 먼저 연결을 일시 중지하고 기본 네트워크가 복구되는지 확인하세요. 기본 네트워크가 정상이라면 클라이언트를 다시 시작하고 시스템 프록시 모드를 잘못 선택했는지, 로컬 수신 포트가 시작되지 않았는지 점검합니다. 데스크톱에서는 브라우저를 완전히 종료한 뒤 다시 열어 시스템 프록시 상태를 새로 읽게 할 수도 있습니다. Android에서는 현재 연결을 먼저 끊고 중복 실행 중인 네트워크 연결 도구가 없는지 확인한 다음 v2rayNG에서 다시 시작하세요.
규칙 모드에서 특정 대상이 예상대로 작동하지 않으면 일시적으로 전역 모드로 전환해 비교해 보세요. 전역 모드는 정상인데 규칙 모드가 이상하다면 서버와 연결 경로는 대체로 사용할 수 있으므로 라우팅 규칙, 도메인 매칭, DNS 설정을 중점적으로 확인해야 합니다. 두 모드 모두 이상하면 구독 서버, 시스템 시간, 로그의 연결 오류부터 점검하세요. 비교가 끝나면 원래 사용할 모드로 되돌리고, 임시 문제 해결 상태를 최종 설정으로 착각하지 마세요.
연결을 활성화해도 이 기기의 일반 네트워크가 잘못 차단되지 않았다는 뜻입니다.
현재 서버와 해당 라우팅 경로로 요청을 처리할 수 있다는 뜻입니다.
코어가 계속 실행 중이며 현재 설정이 짧은 시간 안에 반복해서 실패하지 않는다는 뜻입니다.
확인이 끝나면 현재 기본 설정으로 한동안 사용한 뒤 사용자 지정 라우팅, DNS 또는 코어 옵션을 조정하는 것이 좋습니다. 고급 설정을 변경하기 전 현재 모드와 포트를 기록해 두면 문제가 생겼을 때 되돌리기 쉽습니다. 서버 목록은 ‘구독 업데이트’로 관리하고, 업데이트를 위해 같은 그룹을 반복해서 만들지 마세요. 메인 화면에 이름이 비슷한 중복 기록이 생겨 실제 사용 중인 항목을 구분하기 어려워집니다.
Quick fixes
문제 해결에서는 여러 설정을 한꺼번에 시도하기보다 순서를 지키는 것이 중요합니다. 아래 여섯 항목을 입력 내용, 클라이언트 선택, 시스템 상태 순으로 확인하고 각 항목을 마친 뒤 한 번씩 테스트하면 원인 범위를 빠르게 좁힐 수 있습니다.