v2rayN·v2rayNG 구독 가져오기와 업데이트 방법: 설정 위치 및 Base64·URI 형식

v2rayN과 v2rayNG에서 구독 그룹 설정 위치를 각각 안내하고, 주소 추가와 구독 업데이트 방법 및 일반적인 구독 콘텐츠 형식의 차이를 설명합니다.

이 글의 핵심

먼저 받은 항목이 구독 주소인지 단일 노드 링크인지 확인한 다음 클라이언트의 구독 그룹 설정으로 이동하세요. 주소를 저장하면 그룹만 만들어지며, 노드 목록을 가져오려면 구독을 업데이트해야 합니다. 이 글에서는 PC와 Android에서 설정하는 방법을 각각 살펴보고 URI·Base64 형식과 업데이트 오류도 비교합니다. 처음 구독을 가져오거나 저장했는데 노드가 표시되지 않는 경우에 참고하세요.

구독 주소, 노드 링크, 설정 파일 구분하기

구독 주소는 보통 HTTPS URL입니다. 클라이언트가 주소에 접속해 여러 노드 설정을 가져온 뒤 지정한 그룹에 추가합니다. 주소에 인증 토큰이나 쿼리 매개변수가 포함될 수 있으므로 서비스 제공자의 구독 메뉴에서 전체 주소를 복사하세요. 브라우저의 계정 홈 주소를 복사하거나 물음표 뒤의 내용을 지우면 안 됩니다.

vmess:// 또는 vless://로 시작하는 문자열은 보통 단일 노드 공유 링크입니다. 노드 하나의 설정을 담고 있으며, 노드 목록을 주기적으로 가져오는 HTTPS 주소가 아닙니다. 이를 구독 주소 입력란에 붙여 넣으면 주소가 유효하지 않거나 다운로드에 실패할 수 있습니다. 대신 메인 화면의 클립보드 가져오기 기능을 사용하세요.

구독 주소

권장

구독 그룹의 URL 입력란에 주소를 넣고 업데이트하세요. 이후 노드가 추가·삭제되거나 매개변수가 변경되면 다음 업데이트 때 클라이언트에 반영됩니다.

추천 대상: 처음 설정하거나 노드 그룹을 꾸준히 관리할 때

단일 URI 링크

클립보드에서 가져오기를 선택하거나 노드 QR 코드를 스캔하세요. 가져온 시점의 설정만 추가되며, 일반적으로 구독 소스와 연동되어 업데이트되지는 않습니다.

추천 대상: 노드를 잠시 추가하거나 단일 노드 문제를 확인할 때

전체 설정 파일

인바운드, 아웃바운드, DNS, 라우팅 설정이 포함될 수 있습니다. 전체 설정 파일과 구독 목록은 서로 다른 데이터이므로 구독 URL 입력란에 직접 넣으면 안 됩니다.

추천 대상: 설정 구조와 해당 가져오기 방법을 알고 있는 사용자

v2rayN에 구독 주소를 추가하고 업데이트하기

PC 클라이언트의 메인 화면 상단에서 ‘구독 그룹’을 여세요. UI 프레임워크나 버전에 따라 버튼 위치가 조금 다를 수 있으므로, 아래 단계에서는 ‘구독 그룹 설정’을 기준으로 안내합니다. ‘클립보드에서 공유 링크 가져오기’는 구독 주소를 추가하는 메뉴가 아닙니다.

  1. 그룹 설정 열기

    「구독 그룹」→「구독 그룹 설정」을 클릭하세요. 같은 소스의 그룹이 이미 있는지 먼저 확인하면 비슷한 노드가 중복으로 표시되는 일을 줄일 수 있습니다.

  2. 구독 주소 입력하기

    설정 창에서 추가 버튼을 누르고 알아보기 쉬운 별칭을 입력한 다음, 전체 구독 주소를 「선택적 주소(URL)」 또는 해당 URL 입력란에 붙여 넣으세요. 별칭은 원하는 대로 정해도 되지만 주소는 수정하면 안 됩니다.

  3. 저장하고 그룹 선택하기

    저장한 뒤 메인 화면으로 돌아와 새로 만든 구독 그룹을 선택하세요. 이때 목록이 비어 있어도 오류라고 단정할 수 없습니다. 저장만으로는 서버에서 노드를 가져오지 않습니다.

  4. 구독 업데이트하기

    「구독 그룹」 메뉴에서 현재 구독의 업데이트 명령을 선택하세요. 메뉴에 ‘프록시 사용’과 ‘프록시 사용 안 함’이 구분되어 있다면, 사용할 수 있는 프록시가 없는 첫 업데이트에서는 프록시를 사용하지 않는 방법을 먼저 시도하세요.

  5. 가져온 결과 확인하기

    하단 메시지나 로그에서 업데이트가 완료됐는지 확인한 다음, 현재 그룹의 노드 이름과 프로토콜을 살펴보세요. 노드를 선택한 뒤 필요에 따라 시스템 프록시나 TUN을 설정하세요. 노드를 가져오는 것만으로 모든 프로그램의 트래픽이 프록시를 거치는 것은 아닙니다.

v2rayNG에서 구독 그룹 만들기

v2rayNG는 Xray 코어를 사용하는 Android 클라이언트입니다. 구독 관리는 사이드 메뉴에 있으며, 메인 화면 오른쪽 위의 ‘+’는 공유 링크 가져오기, QR 코드 스캔 또는 설정 직접 추가에 주로 사용합니다. 두 메뉴 모두 노드를 추가할 수 있지만 관리 방식은 다릅니다.

  1. 구독 설정 열기

    메인 화면 왼쪽 위의 메뉴를 누르고 「구독 그룹 설정」으로 이동하세요. 현재 버전에 「구독 그룹」이라고 표시된다면, 해당 화면에 그룹 이름과 구독 URL을 편집하는 항목이 있는지 확인하세요.

  2. 구독 그룹 추가하기

    오른쪽 위의 「+」를 누르고 메모와 구독 URL을 입력하세요. 붙여 넣은 뒤 주소의 앞뒤를 확인하고, 복사 과정에서 들어간 공백이나 줄바꿈, 메신저가 덧붙인 안내 문구를 제거한 다음 저장하세요.

  3. 돌아가서 업데이트하기

    메인 화면으로 돌아온 다음 오른쪽 위 더보기 메뉴에서 구독 업데이트를 실행하세요. 「현재 그룹 구독 업데이트」가 있다면 먼저 대상 그룹으로 전환한 뒤 실행하세요. 모든 그룹을 업데이트하려면 전체 업데이트 명령을 사용하면 됩니다.

  4. 노드 선택 후 연결하기

    노드 목록이 표시되는지 확인하고 사용할 설정을 선택한 다음 연결 버튼을 누르세요. 처음 연결할 때는 Android 안내에 따라 VPN 연결을 허용해야 합니다. 이 권한 요청은 트래픽을 처리할 때 나타나며 구독을 저장할 때 발생하지 않습니다.

노드를 가져왔지만 앱에서 인터넷에 연결되지 않는다면 ‘구독 업데이트 성공’과 ‘노드 연결 성공’을 별도로 확인하세요. 전자는 구독 응답을 파싱했다는 뜻일 뿐이며, 후자는 서버 상태, 프로토콜 매개변수, 기기 시간, 로컬 네트워크에도 영향을 받습니다. 연결 문제를 해결하려고 구독을 계속 삭제하고 다시 만들지 마세요.

URI와 Base64 구독 콘텐츠 이해하기

구독 주소는 콘텐츠를 가져오는 경로이고, 구독 형식은 그 경로가 반환하는 콘텐츠의 형태입니다. 일반적으로 한 줄에 하나씩 공유 URI가 나열되거나, URI 목록 전체를 Base64로 인코딩한 문자열이 반환됩니다. 클라이언트는 지원하는 형식을 인식해 처리합니다. 브라우저에서 응답 내용을 확인할 수 있다고 해서 유효한 구독이라는 뜻은 아닙니다.

줄 단위 URI 목록

외부 형식
여러 줄의 일반 텍스트
일반적인 접두사
vmess://、vless://
노드 구분 방식
대개 줄바꿈으로 구분
파싱 시 확인할 항목
각 링크의 프로토콜과 매개변수

VMess 공유 링크는 프로토콜 접두사 뒤에 JSON이 인코딩된 형태일 수 있습니다. 링크 내부의 인코딩과 구독 전체의 인코딩을 혼동하지 마세요.

Base64로 인코딩된 목록

외부 형식
인코딩된 문자열
디코딩 결과
대개 줄 단위 URI 목록
일반적인 변형
표준 및 URL 안전 문자 집합
개인정보 보호 특성
되돌릴 수 있는 인코딩이며 암호화가 아닙니다

‘형식 수정’을 위해 구독 주소를 직접 인코딩하지 마세요. 클라이언트에 입력할 것은 원래의 가져오기 주소이지, 그 주소를 Base64로 인코딩한 문자열이 아닙니다.

64
패딩 문자를 제외한 Base64 기본 문자 집합의 문자 수
3 → 4
표준 Base64는 3바이트를 4개 문자로 인코딩합니다
443
HTTPS 구독 주소에 포트가 지정되지 않은 경우 사용하는 기본 포트

이 숫자는 형식과 요청 경로를 이해하는 데 참고하는 값이며, 노드 포트나 연결 속도를 뜻하지 않습니다. 구독을 다운로드하는 HTTPS 포트와 가져온 각 노드의 서버 포트는 서로 다를 수 있습니다. 표준 Base64 문자열 끝에 = 패딩 문자가 붙을 수 있지만, 이 문자가 있는지만으로 콘텐츠의 유효성을 판단할 수는 없습니다.

실패 단계별로 빈 목록과 업데이트 오류 해결하기

기존에 작동하는 노드는 그대로 둔 채 대상 그룹을 업데이트하세요. ‘노드가 없음’이 표시되면 그룹 필터, 요청 결과, 응답 형식을 차례로 확인하세요. 원인을 바로 Base64로 단정하거나 기본 점검 대신 구독 변환을 사용하지 마세요.

증상먼저 확인할 항목다음 조치
저장 후 목록이 비어 있음업데이트를 실제로 실행했는지, 잘못된 그룹을 선택하지 않았는지대상 그룹을 선택해 한 번 업데이트한 다음 불필요한 검색 필터를 해제하세요.
연결 시간 초과 또는 도메인 이름 확인 실패구독 도메인 접속 가능 여부, 현재 네트워크, 업데이트 방식직접 연결과 사용 가능한 프록시 경로를 각각 확인하세요. 먼저 노드의 프로토콜 매개변수를 바꾸지는 마세요.
HTTP 401 또는 403토큰 만료 여부, 계정 권한 또는 서버의 접속 제한서비스 제공자 페이지에서 구독 상태를 확인하고 주소를 다시 복사하세요. 403 오류가 반드시 계정 만료 때문인 것은 아닙니다.
HTTP 404주소 경로가 잘렸는지, 기존 주소가 변경됐는지전체 링크를 다시 가져오세요. 경로를 추측하거나 쿼리 매개변수를 삭제하지 마세요.
요청은 성공했지만 파싱에 실패로그인 페이지, 오류 페이지 또는 호환되지 않는 설정 형식이 반환됐는지로그 메시지를 확인하고 v2rayN 또는 v2rayNG용 구독 콘텐츠를 제공하도록 요청하세요.
일부 노드만 표시됨프로토콜 지원 여부, 구독 필터 조건, 클라이언트 호환성먼저 그룹 필터를 해제하고, 누락된 노드의 프로토콜과 매개변수를 확인하세요. 필요하면 클라이언트를 업데이트하세요.

서버가 HTTP 200을 반환하면서도 응답 본문에 로그인 페이지나 접속 차단 페이지를 넣는 경우가 있습니다. 이때 네트워크 요청은 완료됐지만 클라이언트가 인식할 수 있는 URI를 찾지 못합니다. 페이지 내용을 계속 Base64로 인코딩하지 말고 구독 주소를 수정하거나 제공처에 문의하세요.

제공처가 특정 전체 설정 형식만 제공한다면 호환되는 공유 URI 구독을 요청하는 편이 더 간단합니다. 형식 변환에는 프로토콜 필드 매핑도 필요하므로 텍스트 포장 방식만 바꾸면 클라이언트에서 지원하지 않는 매개변수까지 보완된다고 볼 수 없습니다.

PC와 Android에서 같은 구독을 사용하면서 설정은 따로 관리하기

같은 구독을 v2rayN과 v2rayNG에 각각 추가할 수 있지만, 먼저 서비스 제공자가 허용하는 기기 수와 동시 접속 수를 확인하세요. 두 클라이언트는 같은 주소에 각각 접속할 뿐 설정을 서로 전달하지 않습니다. 한쪽에서 업데이트해도 다른 쪽은 직접 업데이트해야 합니다.

구독 소스는 공유하고 로컬 설정은 별도로 관리

PC 클라이언트: v2rayN
  • 「구독 그룹 설정」에 유효한 동일 주소를 저장합니다.
  • 업데이트 후 사용할 노드를 별도로 선택합니다.
  • 시스템 프록시, TUN, DNS, 라우팅을 각각 설정합니다.
Android 클라이언트: v2rayNG
  • 「구독 그룹 설정」에서 별도의 그룹을 만듭니다.
  • 메인 화면으로 돌아가 구독을 업데이트합니다.
  • VPN 연결과 앱별 프록시 적용 범위를 별도로 관리합니다.

공유되는 것은 노드 소스이지 기기의 모든 설정이 아닙니다. 요청 매개변수나 클라이언트의 인식 방식에 따라 반환 내용이 달라질 수도 있습니다.

일반적인 노드 구독은 로컬 수신 포트, 라우팅 규칙, DNS 정책, 앱별 목록을 동기화하지 않으며 전체 백업을 대신할 수도 없습니다. 구독 노드를 직접 수정한 뒤 다시 업데이트하면 변경 사항이 덮어써질 수 있습니다. 사용자 지정 설정을 계속 보관해야 한다면 별도의 수동 설정을 만들고 용도를 알아보기 쉽게 표시하세요.

v2rayN 다운로드플랫폼에 맞는 클라이언트를 선택하세요