2026년 7월 28일 · 시작 가이드 · 약 10분

구독 링크 가져오는 방법? v2rayN 및 v2rayNG 구독 추가 단계 총정리

v2rayN 데스크톱과 v2rayNG Android의 구독 메뉴, 업데이트 순서와 그룹 관리법을 설명하고, 링크 추가 후 노드가 없거나 업데이트가 시간 초과되거나 설정을 인식하지 못하는 문제를 점검합니다.

이 글 한눈에 보기

구독 주소는 받았지만 어디에 붙여 넣어야 하는지 모르거나, 가져온 뒤 노드가 보이지 않는 사용자를 위한 안내입니다. 이 글의 단계를 따라 v2rayN과 v2rayNG에서 별도 구독 그룹을 만들고 설정을 직접 업데이트한 뒤, 응답 내용과 네트워크 상태, 코어 지원 범위를 기준으로 흔한 문제를 찾을 수 있습니다.

먼저 구독 링크와 단일 노드 링크를 구분하세요

구독 링크는 클라이언트가 주기적으로 접속하는 설정 제공 주소이며, 보통 HTTPS로 시작하는 긴 URL 형태입니다. 클라이언트가 이 주소를 요청하면 서버는 여러 VMess, VLESS 등의 노드 설정을 반환합니다. 노드 주소, 포트 또는 전송 매개변수가 변경되어도 구독만 업데이트하면 되므로 하나씩 다시 추가할 필요가 없습니다.

단일 노드 링크는 vmess:// 또는 vless://로 바로 시작하며, 일반적으로 하나의 노드만 설명합니다. 단일 노드 링크를 ‘구독 주소’ 입력란에 잘못 넣으면 클라이언트에 업데이트 실패가 표시되거나 빈 목록이 나올 수 있습니다. 이 경우 구독 업데이트를 반복하기보다 ‘클립보드에서 가져오기’와 같은 메뉴를 사용해야 합니다.

구독 주소

일반적인 시작 형식
https://
반환 내용
여러 노드 설정
업데이트 방식
그룹별로 다시 요청
사용 목적
노드 목록을 장기간 관리

주소에 포함된 토큰은 구독 식별에 사용되는 경우가 많으므로 공개 페이지나 스크린샷에 전체 링크를 표시하지 마세요.

단일 노드 URI

일반적인 시작 형식
vmess:// 또는 vless://
설정 수
보통 1개
가져오기 방식
클립보드 또는 스캔
업데이트 방식
새 링크 다시 가져오기

VMess 링크의 v: 2 필드는 링크 형식의 버전을 뜻하며, 클라이언트 버전 번호가 아닙니다.

일부 구독 응답은 Base64로 인코딩된 텍스트이며, 디코딩하면 각 줄에 하나씩 노드 URI가 들어 있습니다. 다른 응답은 클라이언트가 바로 읽을 수 있는 구조화된 형식으로 제공됩니다. 정상적인 경우 직접 디코딩할 필요 없이 v2rayN과 v2rayNG가 업데이트 과정에서 파싱합니다. 브라우저에서 연속된 문자, 숫자, 슬래시와 등호가 보인다고 해서 링크가 손상된 것은 아닙니다.

v2rayN 데스크톱에서 구독 추가

v2rayN은 구독 그룹으로 서로 다른 출처를 관리합니다. 각 그룹에 이름, 구독 주소와 업데이트 옵션을 저장할 수 있습니다. 먼저 그룹을 만든 뒤 업데이트하는 것이 좋습니다. 주소만 저장한다고 해서 노드가 기본 목록에 자동으로 추가되는 것은 아닙니다.

  1. 그룹 열기

    v2rayN을 실행한 뒤 기본 창에서 ‘구독 그룹’ → ‘구독 그룹 설정’을 차례로 엽니다. 현재 화면이 축약 메뉴를 사용하는 경우 창 상단 메뉴를 먼저 펼치세요.

  2. 그룹 만들기

    그룹 설정 창에서 ‘+’를 클릭해 새 구독 기록 행을 만듭니다. 별칭에는 ‘업무 네트워크 백업’ 또는 ‘가정용 회선’처럼 알아보기 쉬운 이름을 입력하세요.

  3. 주소 붙여 넣기

    전체 HTTPS 구독 링크를 주소 입력란에 넣습니다. 붙여 넣은 뒤 시작과 끝, 줄바꿈을 확인하고 안내 문구가 함께 복사되지 않았는지 점검하세요.

  4. 설정 저장

    그룹이 활성화된 상태인지 확인한 뒤 저장합니다. 기본 창으로 돌아가 ‘구독 그룹’을 열고 ‘모든 구독 업데이트’를 실행하거나 방금 만든 그룹만 선택해 업데이트하세요.

  5. 결과 확인

    상태 표시줄에 업데이트 결과가 나타날 때까지 기다린 다음 서버 목록을 확인합니다. 노드를 하나 선택하고 Enter 키를 눌러 활성 서버로 지정한 뒤, 필요하면 시스템 프록시를 켜세요.

업데이트가 성공하면 기본 목록에 여러 설정 행이 추가되고 프로토콜, 주소, 포트와 별칭이 각각 표시됩니다. 행을 더블클릭하면 전송 방식, TLS, SNI, 경로 등의 필드를 확인할 수 있습니다. 다만 다음 업데이트에서 서버 내용으로 로컬 변경 사항이 덮어써질 수 있으므로 구독 관리 설정은 함부로 직접 수정하지 않는 것이 좋습니다.

구독에 VLESS, XTLS Vision 또는 Reality 매개변수가 포함되어 있는데 가져온 결과에 해당 필드가 없다면 먼저 코어 설정을 확인하세요. 일반적인 경로는 ‘설정’ → ‘매개변수 설정’ → ‘Core 유형’이며, 이러한 설정은 Xray 코어를 우선 사용하는 것이 좋습니다. VMess, WebSocket 등의 기본 설정도 Xray 코어에서 읽을 수 있습니다.

v2rayNG Android에서 구독 추가

v2rayNG의 구독 그룹과 현재 설정 목록은 서로 다른 계층입니다. 그룹 화면에는 구독 출처를 저장하고, 기본 화면에는 업데이트 후 파싱된 노드가 표시됩니다. ‘그룹 추가’만 하고 ‘구독 업데이트’를 실행하지 않으면 기본 화면으로 돌아온 뒤에도 새 설정이 보이지 않을 수 있습니다.

  1. 설정으로 이동

    v2rayNG을 열고 기본 화면 왼쪽 상단의 메뉴를 펼친 뒤 ‘구독 그룹 설정’으로 이동합니다. 화면 너비에 따라 메뉴 위치가 조금 다를 수 있지만 이름에는 여전히 ‘구독 그룹’이 포함됩니다.

  2. 기록 추가

    오른쪽 상단의 ‘+’를 클릭하고 메모 또는 별칭 입력란에 그룹 이름을 입력합니다. URL 입력란에는 전체 구독 주소를 붙여 넣고 해당 기록을 활성화된 상태로 유지하세요.

  3. 저장하고 돌아가기

    확인 또는 저장을 클릭해 기본 화면으로 돌아갑니다. 이 단계에서는 구독 출처만 저장된 것이므로 네트워크 업데이트를 한 번 더 실행해야 합니다.

  4. 구독 업데이트

    기본 메뉴를 다시 펼치고 ‘구독 업데이트’를 클릭합니다. 하단에 완료 안내가 표시될 때까지 기다리고, 업데이트 중에는 네트워크를 바로 전환하거나 앱을 종료하지 마세요.

  5. 설정 선택

    기본 목록에서 사용할 노드를 클릭해 현재 설정으로 지정한 다음 연결 버튼을 누릅니다. 처음 연결할 때는 시스템 안내에 따라 로컬 연결 권한을 승인하세요.

휴대폰 클립보드에 vmess:// 또는 vless://로 시작하는 단일 노드 링크가 있다면 기본 화면 오른쪽 상단의 ‘+’ 안에 있는 ‘클립보드에서 가져오기’를 사용하세요. 가져오기가 완료되면 설정 하나가 바로 추가되므로 구독 그룹을 만들 필요가 없습니다.

v2rayNG은 기본적으로 기기에 로컬 프록시 진입점을 만들며, SOCKS 포트는 보통 10808입니다. 이 포트는 로컬 앱과 코어 간 통신에 사용되며 구독 주소에 있는 서버 포트가 아닙니다. 설정을 직접 변경했다면 ‘설정’에 실제로 표시된 로컬 포트를 기준으로 확인하세요.

출처에 맞는 가져오기 방식 선택

같은 설정도 구독, 단일 노드 URI 또는 QR 코드로 전달할 수 있지만 세 방식의 관리 부담은 다릅니다. 장기간 사용하고 노드가 변경될 때는 구독 그룹이 동기화에 유리하며, 설정 하나를 임시로 테스트할 때는 클립보드 가져오기가 더 간단합니다.

구독 그룹

권장

출처 주소를 한 번 저장한 뒤 업데이트로 노드 추가·삭제와 매개변수 변경을 동기화하므로 여러 설정을 함께 관리하기 좋습니다.

적합한 경우: 고정된 출처, 장기간 사용, 여러 노드

클립보드 가져오기

VMess 또는 VLESS URI 하나를 바로 파싱할 수 있어 단계가 짧지만, 출처 내용이 바뀌면 링크를 다시 받아 가져와야 합니다.

적합한 경우: 단일 노드 테스트, 임시 설정

QR 코드 스캔

QR 코드에는 보통 단일 노드 URI가 들어 있으며, 기존 설정을 v2rayNG으로 옮길 때 유용합니다. 스캔하기 전에 QR 코드가 신뢰할 수 있는 출처에서 제공되었는지 확인하세요.

적합한 경우: Android에서 단일 설정을 빠르게 입력

링크 길이만으로 종류를 판단하지 마세요. VLESS URI는 SNI, 지문, Public Key, Short ID와 Flow 매개변수가 포함되면 길어질 수 있습니다. 반대로 구독 주소는 도메인, 경로와 짧은 토큰만 포함할 수도 있습니다. 가장 확실한 판단 기준은 링크의 시작 형식과 제공자가 설명한 용도입니다.

구독 주소:
https://sub.example.com/client/token-demo

단일 노드 주소:
vless://[email protected]:443?security=reality&type=tcp&flow=xtls-rprx-vision#demo

예시의 도메인, 사용자 식별자와 매개변수는 구조 설명을 위한 것입니다. 실제로 가져올 때는 VLESS의 사용자 식별자, 서버 주소, 포트, SNI, Reality 공개 키와 Short ID가 서로 일치해야 합니다. 어느 한 필드라도 빠지면 설정은 표시되지만 연결이 완료되지 않을 수 있습니다.

가져온 후 노드 목록이 비어 있을 때 점검 방법

‘업데이트 성공 후 목록이 비어 있음’과 ‘구독 요청 실패’는 서로 다른 문제입니다. 전자는 클라이언트가 응답을 받았지만 지원되는 노드로 파싱하지 못했을 가능성을 뜻합니다. 후자는 대개 연결 수립, 도메인 확인, TLS 핸드셰이크 또는 서버 응답 단계에서 발생합니다. 먼저 안내 문구를 확인한 뒤 점검 방향을 정하세요.

  1. 전체 주소 다시 복사: 그룹의 기존 주소를 삭제하고 원본 페이지에서 다시 복사하세요. 주소 앞뒤에 공백, 한글 문장 부호 또는 줄바꿈이 없는지 확인하고, 생략 표시된 일부만 복사하지 않았는지 점검합니다.
  2. 링크가 아직 유효한지 확인: 정상적으로 인터넷에 연결된 환경에서 구독 주소에 접속하세요. 만료, 권한 없음 또는 접근 횟수 제한 안내가 명확히 반환된다면 구독 출처에서 권한을 처리해야 하며, 클라이언트의 로컬 설정으로 만료된 토큰을 복구할 수는 없습니다.
  3. 업데이트 경로 전환: 현재 네트워크에서 구독 도메인에 직접 접속할 수 없다면 먼저 사용 가능한 설정에 연결한 뒤 ‘프록시를 통해 구독 업데이트’와 같은 옵션을 활성화하고 다시 시도하세요. 사용할 수 있는 설정이 전혀 없다면 프록시에 의존하는 업데이트 방식을 켜지 마세요.
  4. 응답 형식 확인: 접속 후 웹 로그인 페이지, 인증 페이지 또는 오류 설명만 표시된다면 클라이언트는 해당 내용을 노드로 파싱하지 못합니다. 구독 엔드포인트는 설정 데이터를 직접 반환해야 합니다.
  5. 프로토콜 지원 확인: VLESS, Reality 또는 Vision 매개변수가 포함된 구독은 Xray 코어를 사용해야 합니다. v2rayNG은 기본적으로 Xray 코어를 사용하며, v2rayN에서는 ‘설정’ → ‘매개변수 설정’ → ‘Core 유형’에서 확인할 수 있습니다.
  6. 업데이트 로그 확인: 시간 초과, 도메인 확인 실패, 인증서 오류, 비정상 HTTP 상태와 파싱된 항목 수가 0인 경우를 구분해 확인하세요. 오류마다 처리 방법이 다르므로 로그 근거 없이 클라이언트 데이터를 반복해서 삭제하지 마세요.

업데이트 결과에 추가된 항목 수가 0으로 표시되지만 기존 노드가 남아 있다면 서버 내용이 바뀌지 않았을 수 있습니다. 일부 클라이언트는 기존 그룹 설정을 유지하지만, 일부 업데이트 방식은 먼저 삭제한 뒤 다시 기록할 수 있습니다. 따라서 업데이트 전에 여러 출처의 같은 이름 노드를 수동으로 섞어 사용하지 않는 것이 좋습니다.

필터 조건이 노드를 숨기고 있는 경우도 흔합니다. 기본 목록이 그룹, 메모 또는 프로토콜 기준으로 필터링 중이면 새로 가져온 설정이 현재 조건에 맞지 않아 목록이 빈 것처럼 보일 수 있습니다. 먼저 검색창과 필터 상태를 초기화한 뒤 전체 기록 수를 확인하세요.

그룹 이름과 업데이트 순서 설정

그룹 이름은 로컬에만 저장되며 서버의 내용은 바꾸지 않습니다. 이름은 출처와 용도를 구분하는 데 도움이 되어야 하며 ‘구독 1’, ‘구독 2’처럼만 작성하는 것은 권장하지 않습니다. 설정 수가 늘어나면 명확한 이름이 잘못된 삭제, 업데이트와 노드 선택을 줄여 줍니다.

이름 지정 기준 예시 용도
사용 환경 가정용 네트워크 네트워크 환경별로 사용하는 설정 출처를 구분
용도 일상 주 사용 기본으로 선택할 그룹을 빠르게 식별
유효 기간 분기별 백업 출처를 계속 유지할 필요가 있는지 확인하도록 알림
프로토콜 범위 VLESS Reality 코어와 전송 매개변수가 일치하는지 확인하기 쉬움

처음 추가한 뒤에는 주소에 접속할 수 있고 노드를 파싱할 수 있는지 확인하기 위해 한 번 수동 업데이트하세요. 자동 업데이트 간격은 일상적인 변경을 처리하는 데 적합하지만 너무 짧게 설정해서는 안 됩니다. 잦은 요청은 서버의 접근 제한을 유발할 수 있고 모바일 네트워크 배터리도 더 소모합니다. 구체적인 간격은 구독 출처에서 안내하는 업데이트 주기를 따르세요.

여러 그룹을 업데이트할 때는 백업 출처를 먼저 업데이트한 뒤 현재 주 사용 출처를 업데이트할 수 있습니다. 이렇게 하면 특정 주소가 일시적으로 시간 초과되어도 목록에 인터넷 연결과 추가 점검에 사용할 설정이 남습니다. 그룹을 삭제하기 전에는 그 안의 노드가 현재 연결에 사용 중인지 먼저 확인하세요.

구독 가져오기 FAQ

아래 내용은 구독 추가 단계에서 가장 흔한 조작 실수를 다룹니다. 문제를 점검할 때는 그룹과 오류 안내를 보존하고, 네트워크 요청, 콘텐츠 파싱, 노드 연결 순서로 확인하는 편이 삭제 후 재설치보다 원인을 찾기 쉽습니다.

구독을 저장했는데 왜 노드가 없나요?

저장 작업은 주소만 기록합니다. v2rayN에서는 ‘구독 그룹’ → ‘모든 구독 업데이트’를 실행해야 하며, v2rayNG에서는 기본 메뉴에서 ‘구독 업데이트’를 눌러야 합니다. 완료 후 목록 필터도 초기화하세요.

업데이트할 때 계속 시간 초과가 표시되면 어떻게 하나요?

먼저 현재 네트워크에서 구독 도메인을 확인할 수 있는지 점검하세요. 이미 사용 가능한 노드가 있다면 해당 노드에 연결한 뒤 프록시를 통한 업데이트를 활성화할 수 있습니다. 사용 가능한 노드가 없다면 구독 주소에 직접 접속할 수 있는 네트워크로 먼저 전환하세요.

브라우저에서 링크가 긴 문자열로 표시되는데요?

대개 Base64로 인코딩된 구독 본문입니다. 클라이언트가 업데이트 과정에서 노드를 파싱할 수 있다면 직접 디코딩하거나 문자를 수정할 필요가 없습니다. 브라우저의 표시 방식만으로 구독 유효 여부를 판단할 수는 없습니다.

가져온 노드 이름이 같은 이유는 무엇인가요?

먼저 같은 주소를 여러 그룹에 추가했는지 확인하세요. 중복 그룹을 삭제한 뒤 다시 업데이트하고, 그룹 이름에는 출처, 용도 또는 프로토콜을 사용해 노드 메모에만 의존하지 않도록 하세요.

노드는 나타났지만 연결되지 않나요?

구독 가져오기 단계는 완료되었다는 뜻입니다. 다음으로 현재 노드가 선택되어 있는지, 시스템 시간이 정확한지, 코어 유형이 해당 프로토콜을 지원하는지 확인하고 연결 로그에서 포트, TLS, SNI 또는 Reality 매개변수 오류를 살펴보세요.

구독은 설정을 일괄적으로 가져와 관리하는 기능이며, 각 노드가 현재 네트워크에서 사용 가능한지 자동으로 판단하지는 않습니다. 가져오기가 성공한 뒤에도 구체적인 노드를 선택하고 연결을 시작한 다음, 실제 용도에 맞게 시스템 프록시와 라우팅 모드를 설정해야 합니다.

클라이언트 다운로드 4개 플랫폼의 설치 메뉴 보기