입문 가이드 예상 읽기 시간 12분

V2Ray 구독 링크 가져오기: v2rayN과 v2rayNG의 메뉴 위치 및 형식 안내

v2rayN 데스크톱과 v2rayNG Android에서 구독을 추가하고 업데이트하는 방법, Base64·vmess://·vless:// 형식의 차이와 호환성을 안내합니다.

구독 링크는 원격 설정 주소입니다. 클라이언트가 이 주소에 접속하면 노드 정보 묶음을 가져와 프로토콜, 서버 주소, 포트, 사용자 식별자, 전송 방식과 보안 매개변수를 로컬 목록에 기록합니다. 구독 링크 자체는 노드가 아니며, 브라우저 주소창에 입력해 사용하는 일반 웹페이지 주소도 아닙니다.

가져오기는 보통 두 단계로 진행됩니다. 먼저 구독 주소를 저장한 다음 업데이트를 한 번 실행합니다. 첫 단계만 완료하면 그룹은 표시되더라도 노드 목록은 비어 있을 수 있습니다. v2rayN과 v2rayNG는 메뉴 위치가 다르지만 처리 방식은 기본적으로 같습니다.

이 글 한눈에 보기

완전한 구독 주소를 받았지만 어느 메뉴에 붙여넣어야 할지 모르는 사용자를 위한 안내입니다. v2rayN 7.x와 v2rayNG 1.10.x의 추가 경로와 업데이트 방법, Base64 구독과 단일 공유 링크의 차이, 가져오기 결과가 비어 있거나 시간 초과 또는 중복 노드가 발생하는 경우를 다룹니다. 끝까지 읽으면 데스크톱과 Android에서 구독 설정을 직접 완료할 수 있습니다.

구독 링크와 단일 노드 링크부터 구분하기

구독 링크는 대개 https://로 시작합니다. 접속 결과는 Base64 텍스트일 수도 있고, 클라이언트가 바로 해석할 수 있는 구조화된 데이터일 수도 있습니다. 하나의 구독에는 여러 VMess 및 VLESS 노드가 포함될 수 있으며, 서버에서 내용을 업데이트하면 클라이언트가 다시 가져와 변경 사항을 동기화합니다.

단일 노드 공유 링크는 보통 vmess:// 또는 vless://로 시작합니다. 하나의 노드만 설명하므로 “클립보드에서 공유 링크 가져오기”로 로컬 설정에 추가하는 데 적합합니다. 단일 노드 링크를 구독 주소 입력란에 잘못 넣으면 일부 버전에서는 저장이 거부되고, 다른 버전에서는 저장되지만 업데이트 결과가 비어 있을 수 있습니다.

구독 주소

일반적인 시작 형식
https://
노드 수
하나 또는 여러 개
업데이트 방식
원격 콘텐츠 다시 가져오기
저장 위치
구독 그룹 설정

장기간 사용하기 적합하며, 같은 그룹의 노드를 한 번에 새로 고칠 수 있습니다.

단일 노드 링크

일반적인 시작 형식
vmess:// 또는 vless://
노드 수
보통 하나
업데이트 방식
새 링크 다시 가져오기
저장 위치
로컬 노드 목록

임시 추가에 적합하며 원격 노드 목록의 변경 사항을 자동으로 따라가지 않습니다.

v2rayN 데스크톱에서 구독 추가

다음 경로는 v2rayN 7.x 한국어 인터페이스를 기준으로 설명합니다. 메인 창 상단의 “구독 그룹”은 원격 구독을 관리하고, “서버” 메뉴의 “클립보드에서 공유 링크 가져오기”는 VMess 및 VLESS 단일 노드에 사용합니다. 두 입구를 혼용하지 마세요.

  1. 주소 복사

    https://로 시작하는 구독 주소를 처음부터 끝까지 복사합니다. 일반 텍스트 입력란에 붙여넣어 앞뒤를 확인하고, 줄바꿈·따옴표·설명 문구가 섞이지 않도록 하세요.

  2. 그룹 열기

    v2rayN을 실행한 뒤 「구독 그룹」→「구독 그룹 설정」을 차례로 열고 추가 버튼을 눌러 새 그룹을 만듭니다.

  3. 링크 입력

    “별칭”에 알아보기 쉬운 이름을 입력하고, “선택적 주소” 또는 구독 주소란에 전체 링크를 붙여넣습니다. 활성화 상태를 켠 채로 저장합니다.

  4. 구독 업데이트

    메인 창으로 돌아가 「구독 그룹」→「모든 구독 업데이트(프록시 사용 안 함)」을 엽니다. 사용 가능한 프록시가 있고 직접 연결이 시간 초과되면 프록시를 통한 업데이트로 변경할 수 있습니다.

  5. 노드 활성화

    노드가 표시되면 한 항목을 선택하고 Enter 키를 누르거나 오른쪽 클릭 메뉴에서 활성 서버로 지정합니다. 그런 다음 시스템 트레이 메뉴에서 “시스템 프록시 자동 설정”을 선택합니다.

업데이트가 완료되면 메인 목록에 보통 주소, 포트, 프로토콜, 전송 방식과 구독 그룹 이름이 표시됩니다. 먼저 그룹에서 실제 연결 테스트를 한 번 실행해 보세요. 테스트 결과는 서버의 네트워크 응답만 보는 것보다 실제 프록시 연결에 필요한 시간을 더 잘 보여 줍니다. 예를 들어 같은 네트워크에서 세 노드의 실제 연결 결과가 각각 184ms, 326ms, 시간 초과라면 웹페이지 접속 테스트에는 먼저 184ms 노드를 선택하는 것이 좋습니다.

노드는 표시되지만 코어를 시작할 수 없다면 「설정」→「매개변수 설정」→「Core 유형」을 확인하세요. VLESS, REALITY, XTLS Vision 등의 설정은 해당 필드를 지원하는 Xray 코어로 처리해야 하는 경우가 많습니다. Core 유형을 바꿔도 설정을 실행하는 코어만 변경되며 구독 주소 자체에는 영향을 주지 않습니다.

v2rayNG Android에서 구독 추가

v2rayNG는 Xray 코어를 사용하며 구독 메뉴는 사이드 메뉴에 있습니다. 주소를 저장한 뒤에도 메인 화면으로 돌아가 업데이트를 실행해야 합니다. 구독 그룹 이름만 보인다고 해서 노드 정보까지 다운로드된 것은 아닙니다.

  1. 설정으로 이동

    v2rayNG 1.10.x를 열고 왼쪽 상단 메뉴 버튼을 눌러 「구독 그룹 설정」으로 이동합니다. 세부 버전에 따라 “구독 설정”으로 표시될 수 있지만 기능은 같습니다.

  2. 그룹 새로 만들기

    오른쪽 상단의 추가 버튼을 누르고 메모 이름을 입력한 뒤 구독 주소를 붙여넣습니다. “활성화” 스위치가 켜져 있는지 확인하고 저장합니다.

  3. 노드 가져오기

    노드 목록으로 돌아가 오른쪽 상단 메뉴를 열고 「구독 업데이트」를 선택합니다. 하단에 업데이트 완료 메시지가 표시될 때까지 기다리고, 가져오는 동안 계속 누르지 마세요.

  4. 노드 선택

    노드 이름을 눌러 현재 설정으로 지정합니다. 먼저 “모든 설정 실제 연결 테스트”를 실행한 뒤 지연 시간이 낮고 시간 초과가 없는 항목을 남기는 것이 좋습니다.

  5. 연결 시작

    메인 화면의 원형 연결 버튼을 누르고 시스템 연결 요청을 승인합니다. 상태 영역에 업로드 및 다운로드 트래픽이 표시되기 시작한 뒤 웹페이지 접속 테스트를 진행하세요.

v2rayNG의 로컬 SOCKS 포트는 일반적으로 10808입니다. 휴대전화의 일반 앱은 이 포트를 직접 입력할 필요가 없으며, 클라이언트가 시스템 연결 인터페이스를 통해 트래픽을 처리합니다. 브라우저를 디버깅하거나 기기를 LAN 프록시로 사용할 때만 수신 주소와 포트를 확인하면 됩니다.

일부 앱만 프록시를 사용하게 하려면 「설정」→「앱별 프록시」로 이동해 기능을 켠 다음 해당 앱을 선택합니다. 이 설정은 코어로 들어가는 트래픽 범위를 제어하며, 노드의 도메인·포트·전송 계층·보안 매개변수는 여전히 구독에서 제공합니다.

Base64, VMess 및 VLESS 형식 안내

Base64는 콘텐츠 인코딩 방식이며 프록시 프로토콜이 아닙니다. 일반적인 구독 응답은 여러 줄의 공유 링크를 하나로 합친 뒤 Base64로 인코딩합니다. 클라이언트는 먼저 디코딩한 다음 각 줄에서 vmess://, vless:// 등의 형식을 인식합니다. 따라서 “Base64 구독” 하나에 여러 프로토콜의 노드가 함께 포함될 수 있습니다.

VMess 공유 링크는 노드 매개변수를 텍스트 한 덩어리로 인코딩하는 경우가 많습니다. 디코딩하면 주소, 포트, 사용자 식별자, 전송 방식, TLS 상태, WebSocket 경로 등의 필드를 확인할 수 있습니다. VLESS 공유 링크는 표준 URI에 더 가깝습니다. 사용자 식별자는 연결 정보에 들어가고 전송·보안 계층·SNI·Flow·지문 등의 매개변수는 쿼리 부분에 위치합니다.

구독 응답
  ├─ Base64로 인코딩된 여러 줄 텍스트
  │   ├─ vmess://단일 노드
  │   └─ vless://단일 노드
  └─ 클라이언트 전용 구조화 응답
      ├─ 노드 필드
      ├─ 그룹 정보
      └─ 업데이트 알림

VMess + WS + TLS

프로토콜
VMess
전송
WebSocket
보안 계층
TLS
핵심 필드
host、path、SNI

가져온 후 경로가 슬래시로 시작하는지, 서버 이름이 온전히 표시되는지 확인하세요.

VLESS + REALITY

프로토콜
VLESS
전송
TCP
Flow
xtls-rprx-vision
핵심 필드
publicKey、shortId、SNI

관련 필드는 구독이 자동으로 입력해야 하며, 경험에 의존해 직접 추가해서는 안 됩니다.

VLESS + WS + TLS

프로토콜
VLESS
전송
WebSocket
보안 계층
TLS
핵심 필드
host、path、encryption

VLESS의 encryption은 보통 none이지만, 그렇다고 외부 TLS가 꺼진 것은 아닙니다.

Base64 노드 모음

유형
텍스트 인코딩
내용
여러 줄 공유 링크
줄바꿈
한 줄에 노드 하나
해석 방식
디코딩 후 항목별로 가져오기

디코딩 결과가 비어 있다면 노드 프로토콜 필드를 수정하기보다 먼저 구독 응답을 확인하세요.

호환성은 클라이언트 버전과 코어 버전에 따라 달라집니다. 클라이언트는 구독을 해석해 설정을 생성하고, 코어는 그 설정을 실행합니다. “가져오기는 되지만 시작되지 않는” 경우 구독 해석은 완료되었을 가능성이 높으며, 코어가 새 필드를 인식하지 못하거나 매개변수 조합이 불완전하거나 전송 설정이 맞지 않는 것이 원인일 수 있습니다.

v2flyNG는 v2fly 코어를 사용하므로 해당 코어가 지원하는 VMess, VLESS 및 일반적인 전송 조합을 처리하는 데 적합합니다. 구독에 Xray 확장 필드에 의존하는 설정이 포함되어 있다면 v2rayNG를 사용하고, 클라이언트와 코어를 서로 호환되는 버전 조합으로 유지하세요.

데스크톱과 Android에서 하나의 구독 함께 사용하기

같은 구독 주소를 v2rayN과 v2rayNG에 각각 저장할 수 있습니다. 두 클라이언트는 설정을 독립적으로 가져오며 노드 선택, 라우팅 모드와 로컬 설정도 각각 저장합니다. 데스크톱에서 활성 노드를 바꿔도 Android에서 현재 선택한 노드가 자동으로 변경되지는 않습니다.

권장 방식: 양쪽 클라이언트에 같은 구독 저장

데스크톱(v2rayN)
  • 「구독 그룹 설정」에 주소 저장
  • 필요에 따라 직접 연결 또는 프록시를 통한 업데이트 선택
  • 시스템 프록시와 라우팅 규칙으로 트래픽 제어
  • 일반적인 로컬 SOCKS 포트는 10808
Android(v2rayNG)
  • 「구독 그룹 설정」에 같은 주소 저장
  • 메인 화면 메뉴에서 구독 업데이트 실행
  • 필요한 앱에만 앱별 프록시 활성화
  • 실제 연결 테스트로 노드 선별

양쪽의 노드 출처는 같지만 활성 노드, 업데이트 시각, 로컬 포트와 라우팅 설정은 각각 관리됩니다.

한 클라이언트에서 이미 해석된 노드 목록을 다른 클라이언트로 복사해 장기간 사용하는 방법은 권장하지 않습니다. 수동 복사본은 특정 시점의 정적 설정이므로 원격 노드 주소·포트·사용자 식별자가 바뀌어도 동기화되지 않습니다. 양쪽에 원래 구독 주소를 직접 저장하는 편이 관리 단계가 적습니다.

구독 주소는 계정 자격 증명처럼 취급하세요. 공개 페이지에 게시하거나 전체 주소가 보이는 스크린샷을 공유하지 마세요. 주소가 유출되었다고 의심되면 구독 제공 측에서 링크를 재설정한 다음 클라이언트의 기존 그룹을 삭제하고 새 주소를 추가하세요.

가져오기 실패 및 업데이트 결과가 비어 있을 때의 점검 순서

문제를 확인할 때는 먼저 메뉴 위치를 확인하고, 다음으로 네트워크를 살펴본 뒤 마지막에 형식을 점검하세요. 처음부터 프로토콜 매개변수를 하나씩 바꾸지 마세요. 구독에서 생성된 필드는 서로 연관되어 있으므로 SNI, 경로, Flow 또는 공개 키를 임의로 수정하면 원래의 가져오기 문제가 새로운 연결 문제로 바뀔 수 있습니다.

붙여넣은 뒤 구독 주소가 잘못되었다고 표시되나요?

먼저 링크를 일반 텍스트 입력란에 붙여넣고 앞뒤 공백·줄바꿈·따옴표를 삭제합니다. 시작 부분이 https://인지 확인하고, 메신저가 복사 과정에서 링크를 잘라내지 않았는지도 살펴보세요. vmess:// 또는 vless://를 받았다면 “클립보드에서 공유 링크 가져오기”를 사용해야 합니다.

업데이트는 완료됐지만 목록에 노드가 없나요?

v2rayN에서는 구독 업데이트 알림과 로그를 확인하고, v2rayNG에서는 하단에 표시되는 반환 정보를 확인하세요. 응답이 비어 있거나 해석되지 않는다면 구독 출력 형식을 다시 확인합니다. 그룹이 비활성화되어 있다면 구독 그룹 설정에서 활성화 스위치를 켠 뒤 다시 업데이트하세요.

구독 업데이트가 계속 시간 초과되나요?

먼저 기기 시간과 네트워크 접속이 정상인지 확인하세요. v2rayN은 사용 가능한 노드가 있을 때 「구독 그룹」→「모든 구독 업데이트(프록시 사용)」을 선택할 수 있습니다. v2rayNG는 먼저 사용 가능한 설정으로 연결한 다음 구독 설정에서 프록시를 통한 업데이트를 활성화하고 다시 시도하세요.

노드를 가져온 뒤 모두 연결되지 않나요?

먼저 아무 노드나 하나 선택해 실제 연결 테스트를 실행한 뒤 코어 로그를 확인하세요. 서버 포트, 사용자 식별자, 전송 방식, TLS 또는 REALITY 필드를 중점적으로 점검합니다. v2rayN에서는 「설정」→「매개변수 설정」→「Core 유형」도 확인하고, 로컬 10808 등의 수신 포트를 다른 프로그램이 사용 중이지 않은지 살펴보세요.

업데이트할 때마다 중복 노드가 생기나요?

구독 그룹 설정에서 같은 주소가 두 번 저장되어 있는지 확인하세요. 이어서 중복 기록이 수동으로 가져온 노드인지 살펴봅니다. 수동 노드는 구독 그룹 업데이트로 관리되지 않으므로 내용을 확인한 뒤 별도로 삭제해야 합니다.

  1. 복사한 것이 단일 공유 링크나 설명 페이지 주소가 아니라 구독 주소인지 확인하세요.
  2. 주소가 완전한지, 앞뒤에 공백·줄바꿈·따옴표·불필요한 문장 부호가 없는지 확인하세요.
  3. 구독 그룹이 활성화 상태인지 확인하고 업데이트를 한 번 직접 실행하세요.
  4. 직접 연결로 가져오기가 시간 초과되면 기존 프록시를 통한 업데이트도 시도하세요.
  5. 노드는 표시되지만 연결되지 않는다면 코어 로그와 실제 연결 테스트 결과를 확인하세요.
  6. 마지막으로 프로토콜·전송 계층·보안 계층과 클라이언트 코어의 호환성을 점검하세요.

가져오기가 완료되었다고 판단하는 기준은 “그룹이 저장됨”이 아닙니다. 노드 목록이 표시되고, 하나 이상의 노드가 실제 연결 테스트를 통과하며, 연결 후 업로드 및 다운로드 트래픽이 발생하고, 시스템 프록시 또는 앱별 프록시가 예상대로 적용되어야 합니다. 이 순서대로 확인하면 구독 가져오기, 노드 실행, 트래픽 처리의 세 단계를 분리해 원인을 찾을 수 있습니다.

v2rayN 다운로드 클라이언트 다운로드 센터로 이동