이 가이드는 클라이언트가 설치되어 있고 유효한 구독 주소를 준비한 상태에서 시작합니다. 순서대로 진행하면 기본 설정에 약 10분이 걸리지만 구독 서비스와 네트워크 상태에 따라 달라질 수 있습니다. 클라이언트는 노드 정보를 불러와 연결을 설정하며, 구독 주소와 사용 가능한 노드는 별도로 준비해야 합니다. 앱만 설치해서는 구독이나 노드 정보 없이 연결할 수 없습니다.
시작하기 전에 네트워크 트래픽을 처리 중인 다른 프록시 도구를 종료하고 현재 사용할 수 있는 네트워크 연결은 유지하세요. 문제 원인을 쉽게 찾을 수 있도록 DNS, 코어, 사용자 지정 라우팅은 동시에 변경하지 않는 것이 좋습니다. 클라이언트를 아직 설치하지 않았다면 다운로드 페이지에서 운영체제에 맞는 버전을 선택하세요. 설치 권한과 시스템 요구 사항, 여러 기기 설정에 관한 자세한 내용은 전체 플랫폼 설치 및 설정 가이드를 참고하세요.
1. 구독을 가져와 노드 업데이트
먼저 구독 제공업체에서 전체 구독 주소를 복사합니다. 보통 https://로 시작하며 계정 식별용 경로나 쿼리 매개변수가 포함될 수 있습니다. 복사할 때 공백이나 줄바꿈, 메신저가 덧붙인 문장 부호가 포함되지 않도록 하고 링크 텍스트만 복사하지 마세요. 구독 주소로 계정의 노드에 접근할 수 있으므로 공개 게시판에 올리지 말고, 문제 해결용 스크린샷에도 전체 주소가 보이지 않게 하세요.
v2rayN을 열고 구독 메뉴에서 ‘구독 그룹 설정’으로 이동한 다음 그룹 추가를 선택합니다. 알아보기 쉬운 이름을 메모에 입력하고 구독 주소 입력란에 주소를 붙여 넣습니다. 메모는 그룹을 구분하는 용도이며 연결에는 영향을 주지 않습니다. 노드를 가져올 위치를 결정하는 것은 주소입니다. 그룹이 활성화되어 있는지 확인하고 저장한 뒤 메인 창으로 돌아갑니다. 버전에 따라 메뉴 위치는 조금 다를 수 있지만, 먼저 그룹을 만든 다음 해당 그룹의 내용을 가져오는 순서는 같습니다.
저장하면 그룹은 생성되지만 노드가 목록에 바로 나타나지 않을 수 있습니다. 구독 메뉴를 열고 현재 구독 그룹 업데이트를 실행하세요. 전체 구독 업데이트만 표시되는 경우에는 해당 항목을 사용해도 됩니다. 하단 상태 표시나 로그에서 업데이트가 완료될 때까지 기다립니다. 처음 설정할 때 업데이트 방식으로 프록시 사용 여부를 선택할 수 있다면 현재 네트워크에서 가능한 방법을 사용하세요. 연결할 수 없는 상태에서 아직 시작하지 않은 프록시에 업데이트를 의존하지 마세요.
업데이트가 완료되면 방금 만든 그룹으로 전환해 메인 목록에 서버 이름, 주소, 프로토콜 유형 등이 표시되는지 확인합니다. 그룹 이름이 보이는 것만으로 구독 업데이트가 성공한 것은 아닙니다. 노드 목록이 나타나야 클라이언트가 내용을 가져와 인식한 것입니다. 지금은 노드별 매개변수를 수정하거나 TUN을 켜지 마세요. 다음 단계에서 목록의 노드 하나를 선택해 확인 가능한 기본 연결을 설정하면 됩니다.
v2rayNG를 사용하는 경우 메인 화면 오른쪽 위 메뉴를 열고 ‘구독 그룹 설정’으로 이동한 뒤 추가를 누릅니다. 메모와 구독 주소를 입력하고 저장하세요. 메인 화면으로 돌아와 메뉴에서 구독 업데이트를 실행한 다음 노드 목록이 새로 고쳐질 때까지 기다립니다. 그룹 설정에서 주소만 저장하고 업데이트하지 않으면 메인 화면에 아무것도 표시되지 않을 수 있습니다. 구독이 여러 개라면 새로 추가한 그룹으로 먼저 전환해 이전 노드를 새 주소에서 가져온 결과로 착각하지 않도록 하세요.
vless:// 또는 vmess://로 시작하는 단일 공유 링크를 받았다면 원격 구독 주소 입력란이 아니라 클립보드에서 설정을 가져오는 기능을 사용하세요. 공유 링크는 보통 노드 하나의 정보만 담지만, 원격 구독은 여러 노드를 가져와 나중에 일괄 업데이트하는 데 사용됩니다. 웹페이지의 안내 문구, 로그인 페이지 주소, 일반 JSON 설정은 구독으로 가져올 수 없을 수도 있습니다. 링크가 열린다는 이유만으로 형식이 올바르다고 판단하지 마세요.
목록이 계속 비어 있다면 먼저 주소가 완전한지, 구독이 유효한지 확인한 뒤 업데이트 로그에서 네트워크 요청이나 파싱 관련 메시지를 살펴보세요. 다시 시도하려고 클라이언트 설정을 통째로 반복해서 삭제하지 마세요. 업데이트 실패와 노드 연결 실패는 서로 다른 단계의 문제입니다. 전자는 설정을 가져오지 못한 상태이고, 후자는 설정을 가져왔지만 연결을 만들지 못한 상태입니다. 형식 인식과 빈 목록 문제는 자주 묻는 질문에서 자세히 확인할 수 있습니다. 노드가 하나 이상 표시되면 다음 단계로 넘어가 트래픽 모드를 선택하세요.
2. 시스템 프록시와 라우팅 모드 선택
v2rayN에서는 두 설정을 구분해서 이해해야 합니다. 시스템 프록시는 어떤 앱이 요청을 클라이언트로 전달할지 정하고, 라우팅 모드는 클라이언트가 받은 요청을 직접 연결할지 프록시로 보낼지 결정합니다. 두 설정은 같은 스위치가 아닙니다. ‘시스템 프록시 자동 설정’을 켜도 모든 대상이 프록시를 이용하는 것은 아니며, 라우팅을 ‘전역’으로 설정해도 시스템 프록시를 사용하지 않는 앱까지 자동으로 트래픽을 전달하는 것은 아닙니다. 먼저 진입 경로를 확인하고, 그다음 연결 목적지를 확인해야 이후 테스트 결과를 해석할 수 있습니다.
Mac에서 처음 설정할 때는 TUN을 끄고 시스템 프록시로 브라우저를 테스트하는 것이 좋습니다. 클라이언트의 시스템 프록시 메뉴에서 ‘시스템 프록시 자동 설정’을 찾은 뒤, 다음 단계에서 코어가 실행 중인지 확인하고 켭니다. 이 설정은 로컬 프록시 정보를 시스템 네트워크 설정에 기록하며, 해당 설정을 따르는 앱에서 사용됩니다. 처음 설정할 때 시스템 권한 안내가 표시되면 요청한 앱과 내용을 확인한 뒤 시스템 화면의 안내에 따라 허용하세요.
같은 메뉴의 ‘시스템 프록시 변경 안 함’은 클라이언트가 현재 설정을 직접 바꾸지 않는다는 뜻이지, 남아 있는 프록시 주소를 삭제한다는 뜻은 아닙니다. 시스템 프록시를 이전에 켰다면 이 항목으로 전환한 뒤에도 기존 주소가 남아 있을 수 있습니다. 해당 시스템 프록시 설정을 되돌리려면 ‘시스템 프록시 지우기’를 사용하세요. 사용을 마칠 때도 이 차이를 기억해야 합니다. 코어는 중지됐는데 브라우저가 여전히 로컬 포트로 요청을 보내는 상황을 피할 수 있습니다.
이어서 라우팅 설정이나 메인 화면의 라우팅 프리셋을 찾습니다. 일반적인 테스트에는 ‘중국 본토 우회’를 선택할 수 있습니다. 해당 직접 연결 규칙에 일치하는 대상은 직접 연결되고 나머지 트래픽은 프리셋에 따라 처리됩니다. 실제 동작은 규칙 데이터베이스와 규칙 순서에 따라 달라지며 웹페이지 표시 언어로 결정되는 것은 아닙니다. 전역 프록시를 선택하면 클라이언트로 들어온 트래픽은 대체로 해당 프리셋에 따라 프록시를 통해 나갑니다. 비교 테스트에는 유용하지만 반드시 더 빠르다는 뜻은 아닙니다.
처음 설정할 때는 분기 규칙을 직접 여러 개 추가하지 마세요. 클라이언트 기본 프리셋을 유지하고 현재 선택한 모드를 기록한 뒤, 다음 단계에서 서로 다른 대상으로 테스트합니다. 규칙을 많이 추가하면 특정 대상에 연결할 수 없을 때 원인이 노드인지 DNS인지 사용자 지정 규칙인지 구분하기 어렵습니다. 우선순위, GeoIP, GeoSite 규칙을 자세히 설정하려면 기본 연결이 확인된 뒤 전체 문서를 참고하세요.
Android에서는 v2rayNG 설정이나 라우팅 관련 메뉴에서 현재 모드를 확인합니다. 처음 테스트할 때는 복잡한 앱별 제외 규칙을 사용하지 마세요. 테스트할 브라우저가 제외 대상에 들어갈 수 있습니다. v2rayNG는 연결을 시작할 때 시스템 VPN 인터페이스를 통해 설정에 해당하는 트래픽을 전달합니다. 여기서 허용하는 시스템 VPN 권한은 구독 제공업체 계정에 로그인하는 것과 다르며, 구독 주소를 Android의 VPN 설정 화면에 입력할 필요도 없습니다.
TUN은 시스템 프록시를 따르지 않는 앱의 트래픽까지 더 폭넓게 전달하는 기능이지만 가상 네트워크 인터페이스, 라우팅, DNS 설정도 함께 고려해야 합니다. 연결에 실패했을 때 켜 보는 임시 해결책으로 사용하지 마세요. 먼저 시스템 프록시 방식으로 연결을 확인한 뒤, 특정 앱이 시스템 프록시를 사용하지 않고 해당 앱의 트래픽을 반드시 전달해야 하는 경우에만 TUN을 별도로 설정하세요. 현재 선택한 라우팅 모드를 유지하고 다음 단계에서 노드를 선택해 연결을 시작합니다.
3. 노드를 선택하고 연결 시작
v2rayN 메인 목록으로 돌아가 구독 업데이트로 가져온 노드를 찾습니다. 해당 행을 선택한 뒤 마우스 오른쪽 버튼 메뉴나 화면의 기능을 사용해 활성 서버로 지정합니다. 일부 버전에서는 노드를 두 번 클릭해 선택할 수도 있습니다. 행이 선택된 색으로 바뀌었다고 전환이 완료된 것은 아닐 수 있으므로 활성 표시나 현재 서버 안내를 확인하세요. 목록에 노드가 여러 개 있어도 클라이언트가 동시에 모두 사용하는 것은 아닙니다.
처음 연결할 때는 구독 제공업체가 사용 가능하다고 안내한, 설정 정보가 완전한 노드를 선택하세요. 처음부터 전체 목록의 속도를 측정할 필요는 없습니다. 클라이언트의 지연 시간 테스트와 실제 웹 요청은 서로 다른 테스트입니다. 지연 시간 결과가 나와도 모든 사이트에 접속할 수 있다는 뜻은 아닙니다. 노드 하나로 전체 절차를 먼저 진행하면 불필요한 테스트 요청을 줄이고 이후 로그를 비교하기도 쉽습니다.
활성 서버를 확인한 다음 코어 상태나 로그를 살펴봅니다. v2rayN은 설정을 적용할 때 코어를 시작하거나 다시 불러옵니다. 시작 메뉴와 상태 표시 방식은 버전에 따라 다를 수 있습니다. 로그에 설정 파싱 오류, 코어 종료, 로컬 수신 포트 사용 중 등의 메시지가 있으면 먼저 해결하세요. 라우팅 모드를 계속 바꾸는 것은 도움이 되지 않습니다. 코어가 정상적으로 실행되어야 로컬 프록시가 요청에 응답할 수 있습니다.
이어서 시스템 프록시 메뉴에서 ‘시스템 프록시 자동 설정’을 선택합니다. Mac의 시스템 설정에서 네트워크 서비스를 열어 프록시 항목을 확인하고, 사용 중인 네트워크 서비스에 로컬 프록시 주소가 기록되었는지 살펴볼 수 있습니다. 확인을 위해 포트를 직접 변경할 필요는 없습니다. 클라이언트에 설정된 실제 수신 포트를 기준으로 하며 다른 가이드의 포트 번호를 그대로 따라 하지 마세요. Wi-Fi를 바꾸거나 유선 네트워크를 사용하거나 다른 네트워크 서비스에 연결했다면 어떤 설정이 현재 적용 중인지도 확인하세요.
v2rayNG에서는 먼저 노드를 눌러 현재 설정으로 지정한 다음 메인 화면의 연결 버튼을 누릅니다. 처음 연결을 시작하면 시스템 VPN 연결 요청이 표시됩니다. 승인한 뒤 클라이언트로 돌아가 연결 상태와 시스템 상태 표시줄의 알림을 확인하세요. 이미 다른 VPN에 연결되어 있다면 새 연결이 기존 연결을 대체할 수 있습니다. 계속하기 전에 기존 업무용 네트워크를 유지해야 하는지 확인하세요. 시스템 권한을 허용하지 않으면 노드를 선택하기만 해서는 트래픽이 전달되지 않습니다.
연결을 시작한 뒤에는 클라이언트를 계속 실행해 둡니다. 데스크톱에서는 메인 창을 닫아도 트레이로 최소화될 수 있고, 종료 설정에 따라 동작이 달라질 수 있습니다. Android에서는 앱을 백그라운드로 전환했을 때 배터리 설정이나 백그라운드 제한이 연결 유지에 영향을 줄 수 있습니다. 처음 연결을 확인할 때는 백그라운드 앱을 정리하거나 앱을 강제 종료하지 마세요. 연결 직후 끊어진다면 먼저 시스템이 앱을 중지했는지 확인해 백그라운드 제한을 서버 문제로 오인하지 않도록 합니다.
로그에 핸드셰이크, 인증, 시간 초과 오류가 표시되면 먼저 기기의 날짜와 시간이 정확한지 확인한 뒤 같은 구독의 다른 노드를 시도하세요. UUID, 전송 방식, REALITY 매개변수, 서버 이름을 임의로 변경하지 마세요. 이 값은 서버 설정과 일치해야 합니다. 오류가 계속되면 오류 유형과 발생 단계를 기록하고 문제 해결 안내에서 해당 상황의 해결 방법을 확인하세요. 로그를 공유하기 전에는 구독 주소와 계정 관련 매개변수를 삭제해야 합니다.
4. 브라우저와 앱에서 연결 확인
클라이언트에 실행 중이라고 표시되어도 로컬 서비스나 트래픽 전달이 시작되었다는 뜻일 뿐, 대상 앱이 실제로 이를 사용한다는 보장은 없습니다. 평소 사용하는 브라우저를 열고 새 탭에서 원래 접속할 수 있던 페이지를 방문해 기본 네트워크가 정상인지 확인하세요. 이어서 이번에 프록시로 접속하려는 페이지를 열고 새로고침합니다. 연결 전에 이미 열려 있던 페이지만 확인하지 마세요. 캐시 때문에 연결에 실패했는데도 정상처럼 보일 수 있습니다.
브라우저에서의 동작과 클라이언트 로그를 함께 확인하세요. 클라이언트에서 액세스 로그를 제공한다면 요청을 보낼 때 대상 도메인이나 해당 연결, 사용된 아웃바운드가 표시되는지 살펴봅니다. 로그 상세도는 설정에 따라 다르므로 도메인이 표시되지 않는다는 이유만으로 요청이 클라이언트를 통과하지 않았다고 단정할 수는 없습니다. 노드 지연 시간, 코어 실행 표시, 사이트에 표시되는 출구 IP도 서로 다른 단서일 뿐입니다. 대상에 실제로 접속할 수 있는지를 가장 중요한 결과로 판단하세요.
‘중국 본토 우회’를 선택했다면 직접 연결되어야 하는 대상과 프록시를 사용해야 하는 대상을 각각 테스트합니다. 직접 연결 페이지가 정상이라고 해서 프록시 연결까지 정상이라는 뜻은 아닙니다. 프록시를 사용하는 페이지 하나가 정상이라고 해서 모든 규칙이 올바르다는 뜻도 아닙니다. 필요한 경우 잠시 전역 프록시로 바꿔 같은 대상을 다시 테스트한 다음 기존 라우팅 프리셋으로 되돌립니다. 특정 라우팅 모드에서만 실패한다면 클라이언트를 바로 재설치하지 말고 일치하는 규칙부터 확인하세요.
출구 IP를 확인하려면 테스트할 브라우저에서 신뢰할 수 있는 IP 확인 페이지를 열고 라우팅 설정과 함께 결과를 판단하세요. 분기 모드에서는 확인 페이지 자체가 직접 연결될 수 있으므로 로컬 IP가 표시되어도 프록시가 작동하지 않는다고 단정할 수 없습니다. 원하는 주소가 표시될 때까지 노드를 계속 바꾸지 마세요. 확인해야 할 것은 대상 앱의 요청이 예상대로 클라이언트에 들어와 올바른 아웃바운드로 전송되는지입니다.
브라우저는 되는데 다른 앱에서 연결되지 않으면 먼저 해당 앱이 시스템 프록시를 사용하는지, 별도의 프록시가 설정되어 있는지, 이전 주소나 포트가 남아 있는지 확인하세요. 일부 명령줄 프로그램과 개발 도구는 데스크톱 시스템 프록시를 자동으로 사용하지 않습니다. 이 경우 바로 노드 문제라고 판단하거나 목적 없이 코어를 바꾸지 마세요. 먼저 앱 내부에 호환되는 프록시 주소를 설정할 수 있습니다. 더 폭넓은 트래픽 전달이 필요하다면 전체 문서의 TUN 설정 안내를 참고하세요.
모든 대상에 접속할 수 없다면 먼저 시스템 프록시를 지우거나 Android 연결을 중지해 기본 네트워크가 복구되는지 확인합니다. 기본 네트워크가 정상이면 구독 업데이트 여부, 활성 노드, 코어 실행 상태, 시스템 프록시 적용 여부를 차례로 확인하세요. 한 번에 한 가지 조건만 바꾸고 같은 페이지를 다시 테스트합니다. 이렇게 하면 진입 경로, 노드, 라우팅 중 어떤 부분이 문제인지 구분하기 쉽습니다. TUN을 켜고 DNS를 바꾸고 프로토콜까지 변경하는 것보다 원인을 찾기 좋습니다.
연결이 정상임을 확인한 뒤에는 현재 사용할 수 있는 노드와 라우팅 설정을 유지하고, 구독 자동 업데이트나 다른 옵션은 나중에 검토하세요. 사용을 마칠 때 데스크톱에서는 먼저 시스템 프록시를 지운 다음 필요에 따라 코어를 중지하거나 클라이언트를 종료합니다. TUN을 사용했다면 트래픽 전달도 먼저 중지하세요. Android에서는 연결 중지를 누르고 시스템 VPN이 종료되었는지 확인합니다. 마지막으로 일반 웹페이지를 새로고침해 종료 후에도 네트워크가 정상인지 확인하면 설정과 복구 절차가 모두 완료됩니다.