v2rayN과 v2rayNG 구독 주소 가져오기 및 Base64·공유 링크 형식

v2rayN과 v2rayNG에서 구독을 추가하고 업데이트하는 방법을 안내합니다. Base64 구독과 vmess://·vless:// 공유 링크 형식, 가져오기 실패 원인도 확인하세요.

이 글의 핵심

처음 가져올 때는 받은 내용이 구독 주소인지, 구독 본문인지, 단일 노드 공유 링크인지 먼저 확인하세요. 구독 주소는 그룹에 저장한 뒤 업데이트하고, 노드 링크는 클립보드에서 바로 가져옵니다. 업데이트 후에도 목록이 비어 있다면 클라이언트를 재설치하기 전에 다운로드·파싱·연결 단계별로 점검하세요.

구독 주소·구독 본문·노드 링크 구분하기

구독 주소는 클라이언트가 설정을 가져올 위치를 알려 주고, 구독 본문은 다운로드한 뒤 받은 내용이며, 공유 링크는 보통 노드 하나의 정보를 담습니다. 같은 페이지에서 제공되더라도 세 가지를 같은 입력란에 붙여 넣을 수는 없습니다.

받은 내용구분하는 방법사용할 메뉴
구독 주소일반적으로 https://로 시작하며 제공업체가 지원 클라이언트를 안내합니다구독 그룹 설정에 저장한 뒤 업데이트
구독 본문Base64 문자열 하나일 수도 있고, 여러 노드 링크가 줄별로 나열되어 있을 수도 있습니다가능하면 원래 구독 주소를 사용하세요. 본문만 있다면 형식을 확인한 뒤 노드 가져오기를 이용하세요
노드 공유 링크예: vmess:// 또는 vless://로 시작클립보드에서 노드 가져오기

HTTPS로 시작한다고 해서 모두 구독 주소인 것은 아닙니다. 계정 로그인 페이지나 QR 코드 페이지도 HTTPS를 사용하지만, 이런 페이지는 클라이언트가 파싱할 수 있는 노드 목록을 반환하지 않습니다. 제공업체가 구독 주소로 명확히 표시한 전체 URL을 사용하세요. 복사할 때는 ? 뒤의 쿼리 매개변수도 포함해야 합니다. 도메인만 복사하지 마세요. 매개변수에 접근 토큰이 있거나 출력 형식을 지정할 수 있습니다.

v2rayN 구독 주소 가져오기 및 업데이트

데스크톱에서는 그룹 저장과 노드 다운로드가 별개의 작업입니다. 아래 메뉴명은 중국어 간체 인터페이스에서 흔히 볼 수 있는 표기를 기준으로 합니다. 버전에 따라 괄호나 버튼 위치, 문구가 다를 수 있으니 같은 기능의 메뉴를 선택하세요.

  1. 그룹 설정 열기

    메인 화면에서 「구독 그룹」→「구독 그룹 설정」을 선택하세요. 같은 제공업체의 그룹이 이미 있다면 기존 항목을 수정해 중복 구독이 여러 그룹에 저장되지 않도록 하세요.

  2. 구독 추가

    「추가」를 누르세요. 「별칭」에 알아보기 쉬운 이름을 입력하고 「URL(선택 사항)」에 구독 주소 전체를 붙여 넣은 뒤 확인하고 저장하세요. 별칭은 로컬에서 구분하기 위한 이름이며 로그인 계정이 아닙니다. 주소의 매개변수는 그대로 유지해야 합니다.

  3. 현재 그룹 업데이트

    메인 화면으로 돌아가 방금 저장한 그룹을 선택한 다음 「구독 그룹」→「현재 구독 업데이트(프록시 사용 안 함)」을 선택하세요. 처음 설정할 때는 직접 연결로 업데이트하고, 어느 구독에서 알림이 발생했는지 확인하기 쉽도록 한 번에 하나씩 업데이트하세요.

  4. 가져온 결과 확인

    현재 그룹에 노드가 표시되는지 확인한 뒤 목록에서 사용할 노드를 선택하세요. 공유 링크 하나만 받은 경우에는 링크 전체를 복사하고 「서버」→「클립보드에서 URL 일괄 가져오기」를 이용하세요. 클립보드에서 가져온 항목은 원격 구독 업데이트에 포함되지 않습니다.

v2rayNG에서 구독 가져오기 및 노드 선택

Android에서는 왼쪽 위 메뉴에서 구독을 관리하고 업데이트할 수 있으며, 오른쪽 위 「+」로 클립보드의 노드를 가져올 수 있습니다. 먼저 받은 내용의 종류를 확인한 뒤 알맞은 메뉴를 선택하세요.

  1. 구독 관리 열기

    메인 화면 왼쪽 위 메뉴를 열고 「구독 그룹 설정」을 누른 다음 페이지의 「+」를 누르세요. 만료된 구독 주소를 바꾸려면 기존 그룹을 열어 수정하면 됩니다. 모든 설정을 먼저 지울 필요는 없습니다.

  2. 그룹 주소 입력

    메모와 구독 주소를 입력한 뒤 오른쪽 위의 확인 버튼을 눌러 저장하세요. 채팅에서 주소를 복사했다면 끝에 마침표나 따옴표까지 함께 복사하지 않았는지, 마지막 쿼리 매개변수가 온전한지 확인하세요.

  3. 돌아가서 업데이트

    메인 화면으로 돌아가 왼쪽 위 메뉴에서 「구독 업데이트」를 누르세요. 업데이트가 끝나면 해당 그룹으로 전환해 노드를 확인합니다. 그룹 이름이 표시되는 것은 설정이 저장되었다는 뜻일 뿐, 노드 다운로드 성공을 의미하지는 않습니다.

  4. 노드 선택 후 연결

    목록에서 노드를 선택하고 연결 버튼을 누르세요. 처음 연결할 때는 Android 시스템 안내에 따라 VPN 권한을 허용해야 합니다. 공유 링크 하나만 가져올 때는 먼저 전체 링크를 복사한 다음 메인 화면 오른쪽 위의 「+」→「클립보드에서 가져오기」를 누르세요.

Base64 구독 본문과 VMess·VLESS 공유 링크 구조

일반적인 Base64 구독은 여러 줄의 노드 링크를 텍스트 하나로 묶어 인코딩하며, 디코딩하면 보통 한 줄에 하나씩 표시됩니다. vmess:// 뒤의 Base64는 대개 노드 하나의 JSON만 인코딩합니다. 어느 부분을 디코딩할지는 프로토콜 접두사가 있는지 먼저 확인하세요. 접두사까지 포함해 디코더에 넣지 마세요. Base64는 암호화가 아닌 인코딩입니다. 원문을 확보할 수 있는 사람은 보통 인증 정보도 복원할 수 있습니다.

VMess 공유 링크

접두사
vmess://
일반적인 페이로드
Base64로 인코딩된 JSON 객체
서버 주소와 포트
add、port
인증 및 전송
id는 사용자 식별자, net은 전송 방식을 나타냅니다
노드 이름
ps는 표시용 메모입니다

흔히 사용되는 공유 링크 형식입니다. 필드를 확인할 때는 접두사 뒤의 페이로드만 로컬에서 디코딩하고, 실제 가져오기에는 전체 링크를 사용하세요.

VLESS 공유 링크

접두사
vless://
인증 식별자
일반적으로 @ 앞에 UUID가 있습니다
서버 주소와 포트
@와 쿼리 부분 사이에 있습니다
쿼리 매개변수
type은 전송 방식을, security는 보안 계층을 지정합니다
노드 이름
일반적으로 # 뒤에 표시용 메모가 있습니다

이 형식의 링크는 노드 설정 전체를 Base64로 묶는 대신 URI에 필드를 직접 표현합니다.

3 → 4
Base64는 온전한 바이트 3개를 문자 4개로 인코딩합니다
443
HTTPS 구독 주소에 포트를 명시하지 않았을 때 사용하는 기본 포트
10808
v2rayN 로컬 수신 포트 예시. 실제 설정을 확인하세요

구독 다운로드 포트, 노드 서버 포트, 클라이언트 로컬 수신 포트는 서로 다른 값입니다. 구독이 HTTPS라고 해서 노드 포트를 443으로 바꾸면 안 됩니다. 로컬 포트 예시인 10808을 노드 설정에 넣어서도 안 됩니다. VLESS 링크의 %2F 같은 퍼센트 인코딩은 그대로 유지하세요. 미리 디코딩하면 필드 경계가 달라질 수 있습니다.

구독 가져오기 실패: 다운로드·파싱·연결 단계 구분하기

  1. 다운로드 단계: 업데이트 중 시간 초과, 도메인 이름 확인 실패 또는 HTTP 오류가 발생하면 먼저 구독 요청이 성공했는지 확인하세요. 현재 네트워크와 주소, 상태 코드를 점검하세요. 이 단계에서는 노드 전송 매개변수를 바꿔도 대개 해결되지 않습니다.
  2. 파싱 단계: 업데이트가 끝났는데도 가져온 항목이 0개이거나 일부만 표시된다면 응답 형식과 클라이언트의 프로토콜·전송 방식 지원 여부를 확인하세요. 제공업체가 여러 내보내기 옵션을 제공한다면 v2rayN 또는 v2rayNG용이라고 명시된 구독 형식을 선택하세요.
  3. 연결 단계: 노드 목록은 표시되지만 선택 후 사용할 수 없다면 적어도 하나의 노드는 파싱된 것입니다. 실제로 선택한 노드가 무엇인지 확인한 뒤 다시 연결을 시도하고 연결 로그를 확인하세요. 연결 실패를 구독 업데이트 실패와 혼동하지 마세요.

업데이트가 계속 시간 초과되는데 프록시를 사용해야 하나요?

먼저 프록시를 사용하지 않고 업데이트해 현재 네트워크에서 구독 서버에 접속할 수 있는지 확인하세요. 데스크톱에서 이미 연결 가능한 노드가 있고 구독 서버에 직접 접속할 때 시간 초과가 발생한다면 「현재 구독 업데이트(프록시 사용)」를 선택해 비교해 볼 수 있습니다. 처음 설정하는 중이라 사용할 노드가 없다면 프록시 업데이트로 바꿔도 연결 의존성 문제는 해결되지 않습니다.

401 또는 403 오류가 뜨면 Base64 형식이 잘못된 건가요?

이 오류는 HTTP 응답 상태입니다. 디코딩보다 먼저 접근 권한을 확인하세요. 제공업체 페이지에서 현재 구독 주소를 다시 복사하고 토큰이 만료되었는지, 쿼리 매개변수가 잘리지 않았는지 살펴보세요. 새 주소도 거부된다면 계정 상태나 해당 주소의 접근 제한을 확인하세요.

브라우저에서는 구독이 열리는데 왜 노드가 0개인가요?

브라우저에 페이지가 표시된다고 해서 클라이언트가 노드 목록을 받은 것은 아닙니다. 응답이 로그인 페이지나 안내 페이지일 수도 있고 다른 형식의 설정 파일일 수도 있습니다. 브라우저에 기존 로그인 상태가 적용되었을 가능성도 있습니다. 제공업체가 안내한 클라이언트 전용 주소인지 확인하고, 웹 로그인 후 표시되는 내용을 구독 본문으로 사용하지 마세요.

데스크톱보다 Android에 표시되는 노드가 적다면 어떻게 하나요?

먼저 두 클라이언트에서 같은 구독 출처와 해당 그룹을 선택했는지 확인하고 각각 업데이트하세요. 그래도 차이가 있다면 표시되지 않는 노드의 프로토콜과 전송 매개변수를 비교한 뒤 Android 업데이트 메시지를 확인하세요. 서버가 요청에 따라 서로 다른 내용을 반환할 수도 있으므로 노드 개수만으로 어느 한쪽의 가져오기가 실패했다고 판단할 수는 없습니다.

클라이언트 다운로드