v2rayN을 처음 실행한 뒤 구독 URL을 등록하고, 구독 그룹에서 노드를 불러오며, 필요한 서버를 선택하는 전체 과정을 설명합니다. 2026년 기준 v2rayN 7.x 계열에서 자주 보이는 메뉴 흐름을 중심으로 주소 복사 방법, 구독 업데이트 옵션, 그룹별 관리 기준, 연결 실패와 갱신 오류를 확인하는 순서를 함께 정리했습니다.
구독 그룹과 노드의 차이부터 이해하기
v2rayN에서 구독 그룹은 여러 노드의 원본 주소와 업데이트 방식을 저장하는 관리 단위입니다. 구독 URL을 등록하면 v2rayN이 해당 주소에 접속해 VMess, VLESS, Shadowsocks 등 서버 정보를 읽고, 읽어 온 각각의 항목을 노드 목록으로 표시합니다. 따라서 구독 그룹 자체가 곧 연결할 서버를 의미하는 것은 아니며, 그룹 안에 여러 개의 노드가 들어갈 수 있습니다.
반대로 수동으로 추가한 노드는 특정 서버 한 개의 설정만 저장합니다. 서버 주소, 포트, 사용자 ID 또는 UUID, 전송 방식, TLS 및 기타 보안 매개변수를 직접 입력해야 하므로 초보자에게는 구독 방식이 더 간단합니다. 다만 구독 제공자가 서버 주소나 인증 정보를 변경하면 기존에 저장된 노드가 자동으로 바뀌지 않을 수 있습니다. 정기적으로 구독을 업데이트해야 최신 목록과 변경된 설정을 받을 수 있습니다.
- 구독 URL: 여러 서버 설정을 내려받는 원격 주소입니다.
- 구독 그룹: URL, 별칭, 업데이트 방식과 관련 옵션을 저장하는 목록입니다.
- 노드: 실제로 선택하고 지연 시간을 측정하며 연결에 사용하는 서버 항목입니다.
- 현재 서버: v2rayN이 코어 실행에 사용하는 선택된 노드 한 개입니다.
v2rayN에 구독 URL 등록하기
먼저 서비스 제공자가 안내한 구독 URL을 클립보드에 복사합니다. 주소는 보통 https://로 시작하지만 제공 방식에 따라 다른 형식일 수도 있으므로 임의로 앞부분을 바꾸지 마세요. 복사한 뒤 메모장에 한 번 붙여 넣어 앞뒤 공백, 줄바꿈, 닫는 괄호와 한국어 문장부호가 섞이지 않았는지 확인하면 좋습니다. URL에 만료 시간이 포함되어 있다면 새 링크를 발급받아야 하며, v2rayN 설정을 반복해서 바꾸는 것만으로는 해결되지 않습니다.
주소 복사
서비스 관리 화면에서 구독 URL 전체를 복사하세요. 일부만 선택하면 도메인, 경로 또는 인증용 쿼리 값이 빠질 수 있습니다.
그룹 설정 열기
v2rayN 메인 화면에서 「구독」 또는 「구독 그룹」 메뉴를 열고 「구독 그룹 설정」 항목으로 이동하세요. 7.x의 마이너 버전에 따라 메뉴 표기가 조금 다를 수 있습니다.
새 그룹 추가
「추가」를 누른 뒤 별칭에는 알아보기 쉬운 이름을 입력하고, 구독 URL 또는 구독 주소 칸에 복사한 링크를 붙여 넣으세요.
설정 저장
확인 또는 저장을 눌러 그룹 목록에 주소가 표시되는지 확인하세요. URL이 비어 있거나 공백만 있으면 그룹이 저장되어도 노드는 내려받을 수 없습니다.
모든 그룹 업데이트
메인 메뉴의 「구독」→「모든 구독 업데이트」를 실행하고 완료 알림 또는 로그를 확인하세요. 업데이트 중에는 v2rayN을 강제로 종료하지 마세요.
그룹을 추가한 직후 노드가 자동으로 나타나지 않는다면 업데이트 작업을 별도로 실행해야 합니다. 일부 버전에서는 그룹 이름을 마우스 오른쪽 버튼으로 클릭한 뒤 「현재 구독 업데이트」를 선택할 수 있습니다. 여러 제공자의 링크를 사용한다면 전체 업데이트보다 필요한 그룹 하나만 먼저 갱신하는 편이 원인을 확인하기 쉽습니다. 실패한 그룹을 반복해서 클릭하면 같은 오류가 로그에 쌓일 뿐 주소가 복구되지는 않습니다.
구독 그룹 기본값
- 그룹 이름
- 서비스 또는 용도별 별칭
- 주소
- 제공자가 발급한 전체 URL
- 업데이트
- 수동 업데이트로 먼저 검증
- 정렬
- 이름 또는 지연 시간 기준
처음에는 한 그룹만 등록해 정상적으로 노드가 표시되는지 확인하세요.
로컬 연결 설정
- SOCKS 포트
- 10808 예시
- HTTP 포트
- 10809 예시
- 시스템 프록시
- 필요할 때만 켜기
- 코어
- 클라이언트 기본값 우선
포트는 다른 프로그램과 겹치지 않아야 하며 실제 화면의 값을 확인해야 합니다.
노드 업데이트와 현재 서버 선택
구독 업데이트가 끝나면 메인 화면의 서버 목록에서 새로 추가된 노드를 확인할 수 있습니다. 목록에 보이는 이름은 제공자가 정한 별칭이며, 이름만으로 속도나 안정성을 판단할 수는 없습니다. 먼저 그룹 필터가 올바른지 확인하고, 업데이트 시각 이후에 새 노드가 추가되었는지 살펴보세요. 같은 이름의 노드가 여러 개 있으면 주소와 포트가 서로 다를 수 있으므로 무작정 기존 항목을 삭제하지 않는 것이 좋습니다.
사용할 노드를 한 번 클릭해 선택한 다음 지연 시간 테스트를 실행할 수 있습니다. 지연 시간이 낮아도 실제 웹페이지 로딩 속도나 장시간 안정성이 항상 좋은 것은 아닙니다. 예를 들어 80ms로 표시되는 서버라도 혼잡 시간에 패킷 손실이 많으면 220ms 서버보다 불안정할 수 있습니다. 처음에는 2~3개의 노드만 비교하고, 동일한 네트워크와 동일한 시간대에서 테스트해야 결과를 해석하기 쉽습니다.
- 그룹 확인: 왼쪽 또는 상단의 그룹 선택 영역에서 방금 업데이트한 구독 그룹을 선택합니다.
- 노드 필터 해제: 검색어, 국가 필터 또는 정렬 조건 때문에 노드가 숨겨지지 않았는지 확인합니다.
- 지연 시간 측정: 후보 노드 하나를 선택하고 지연 시간 테스트를 실행합니다.
- 현재 서버 지정: 정상 응답한 노드를 선택한 뒤 「시스템 프록시」 또는 필요한 연결 모드를 켭니다.
- 실제 접속 확인: 브라우저에서 테스트 페이지를 열고, 문제가 있으면 코어 로그와 시스템 프록시 상태를 함께 확인합니다.
업데이트 후 같은 노드가 여러 개 보이나요?
구독 제공자가 이름만 같고 주소나 포트가 다른 항목을 보낼 수 있습니다. 이름과 지연 시간만 보고 삭제하지 말고, 한 번에 하나씩 테스트한 뒤 사용하지 않는 항목만 정리하세요.
노드 목록은 있는데 연결할 서버가 없나요?
목록에서 노드를 한 개 선택한 뒤 시스템 프록시 또는 해당 애플리케이션의 프록시 사용 여부를 확인하세요. 노드 목록 표시와 실제 연결 시작은 별도의 단계입니다.
지연 시간 테스트가 실패하면 바로 삭제해야 하나요?
삭제하지 말고 같은 노드로 실제 연결을 한 번 확인하세요. ICMP 응답을 제한하는 서버는 지연 테스트만 실패하고 일반 TCP 또는 TLS 연결은 정상일 수 있습니다.
업데이트할 때마다 수동 선택해야 하나요?
제공자가 새 노드를 추가하거나 기존 항목을 교체하면 선택 상태가 달라질 수 있습니다. 업데이트 후 현재 선택된 서버 이름과 연결 상태를 다시 확인하는 습관이 안전합니다.
여러 구독 그룹을 깔끔하게 관리하기
구독 제공자가 하나라면 처음부터 여러 그룹을 만들 필요가 없습니다. 같은 URL을 여러 번 등록하면 동일한 노드가 중복으로 표시되고, 업데이트 요청도 중복으로 발생할 수 있습니다. 업무용, 개인용, 테스트용처럼 실제 목적이 다를 때만 그룹을 나누는 것이 좋습니다. 그룹 이름에는 날짜보다 용도를 포함하세요. 예를 들어 「주 사용」, 「백업」, 「테스트」처럼 작성하면 2026년 이후 링크를 교체할 때도 어떤 그룹인지 쉽게 알 수 있습니다.
| 관리 상황 | 권장 방법 | 주의할 점 |
|---|---|---|
| 제공자 1곳 사용 | 그룹 1개와 수동 업데이트 | 같은 URL을 중복 등록하지 않기 |
| 주 사용·백업 분리 | 그룹 이름에 용도 표시 | 업데이트 후 현재 서버를 다시 확인하기 |
| 테스트 링크 사용 | 별도 테스트 그룹으로 분리 | 자동 업데이트를 자주 실행하지 않기 |
| 만료된 링크 교체 | 새 URL을 기존 그룹에 수정 입력 | 이전 URL을 메모나 공개 문서에 남기지 않기 |
자동 업데이트 주기는 서비스 정책과 사용 빈도에 맞추세요. 하루에 여러 번 갱신해도 서버 목록이 더 안정적으로 바뀌는 것은 아닙니다. 제공자가 하루 한 번 갱신을 권장한다면 v2rayN에서도 그 정도로 맞추고, 장기간 사용하지 않는 그룹은 자동 업데이트를 끄는 편이 불필요한 요청과 오류 로그를 줄입니다. 업데이트를 위해 프록시를 사용해야 하는 환경에서는 「프록시를 통해 구독 업데이트」와 비슷한 옵션을 켤 수 있지만, 최초 연결 전에는 사용할 수 없으므로 직접 연결로 먼저 테스트해야 합니다.
구독 갱신 실패와 노드 미표시 해결
구독 업데이트 실패는 URL 오류, 원격 서버 접근 불가, 인증 만료, TLS 검증 문제, 응답 형식 문제로 나뉩니다. 먼저 v2rayN의 인터페이스 로그에서 실패한 그룹 이름과 오류 시각을 확인하세요. 브라우저에서 URL을 열어 보았을 때 일반 안내 페이지나 로그인 화면이 표시된다면, 클라이언트가 기대하는 구독 데이터가 아닐 수 있습니다. 구독 링크를 브라우저로 확인하는 것만으로는 v2rayN에서 정상 파싱된다는 보장이 없습니다.
오류: context deadline exceeded
원인과 해결: 구독 서버 응답이 제한 시간 안에 도착하지 않은 상태입니다. 네트워크를 바꾸고, URL의 도메인 접근성을 확인한 뒤 「현재 구독 업데이트」를 다시 실행하세요.
오류: 401 Unauthorized
원인과 해결: 링크 인증이 만료되었거나 토큰이 잘못되었습니다. 이전 URL을 수정하기보다 서비스 관리 화면에서 새 구독 주소를 발급받아 등록하세요.
오류: failed to parse subscription
원인과 해결: 응답이 비어 있거나 지원되지 않는 형식일 수 있습니다. URL 전체를 다시 복사하고, 제공자가 v2rayN용 형식을 지원하는지 확인하세요.
오류: no nodes found
원인과 해결: 그룹은 저장되었지만 변환 결과에 노드가 없다는 뜻입니다. 만료 여부, 필터 조건, 응답 내용과 제공자의 서버 상태를 차례로 점검하세요.
- 도메인 자체에 접근되지 않음: DNS 또는 현재 네트워크 문제일 수 있으므로 다른 네트워크에서 다시 시도합니다.
- 401 또는 403 응답: 계정, 토큰, 만료 기간 또는 제공자 측 접근 정책을 확인합니다.
- 업데이트는 성공했지만 목록이 비어 있음: 필터와 그룹 선택 상태를 확인하고 구독 형식 지원 여부를 문의합니다.
- 목록은 갱신되지만 모든 서버가 실패함: 노드 설정 변경, 서버 점검, 시스템 시간, 코어 호환성을 확인합니다.
- 시스템 프록시를 켜도 웹페이지가 열리지 않음: 로컬 포트 충돌, 브라우저 프록시 설정, 라우팅 규칙을 확인합니다.
문제를 재현할 때는 한 번에 하나의 조건만 바꾸세요. 먼저 같은 URL을 다른 네트워크에서 업데이트하고, 다음으로 새 URL을 발급받아 비교한 뒤, 마지막으로 코어 로그와 시스템 프록시를 확인하는 순서가 좋습니다. 구독을 삭제하고 다시 만드는 작업은 URL 자체가 잘못되었는지 확인한 뒤에 진행해야 합니다. 삭제 전에 그룹 별칭과 업데이트 옵션을 기록해 두면 정상 설정을 잃어버리는 일을 줄일 수 있습니다.
모든 노드가 업데이트 후 사라졌다면 이전 목록을 즉시 지우지 말고, 제공자 측 공지와 만료 시간을 확인하세요. 새 노드가 표시되어도 연결 전에 해당 노드의 프로토콜, 전송 방식, TLS 또는 REALITY 매개변수가 클라이언트와 코어에서 지원되는지 확인해야 합니다. VMess를 VLESS로 임의 변경하거나 주소와 포트만 남겨 두는 방식은 구독 문제를 해결하지 못하며 연결 실패를 새로 만들 수 있습니다.