V2Ray 구독 링크 형식 가이드: Base64, 네이티브 JSON, 공유 링크 변환 방법

1. 구독 주소, 응답 내용, 노드 프로토콜 구분하기

일반적으로 구독 링크는 HTTPS로 콘텐츠를 가져오는 주소를 말합니다. 클라이언트가 주소에 요청을 보내면 서버 목록이나 설정 텍스트를 받아 해석합니다. 주소에 액세스 토큰이 포함될 수 있지만, 그 자체가 VMess나 VLESS 프로토콜인 것은 아닙니다. URL의 확장자만으로 응답 형식을 판단할 수도 없습니다. 같은 주소라도 요청 매개변수나 클라이언트 식별 정보에 따라 다른 콘텐츠를 반환할 수 있습니다.

일반적인 목록의 기본 단위는 공유 링크입니다. 예를 들어 vmess:// 또는 vless://로 시작하는 텍스트가 이에 해당합니다. 링크 여러 개를 줄바꿈으로 나열해 그대로 반환하거나, 전체를 한 번에 Base64로 인코딩할 수 있습니다. JSON을 반환하는 경우도 있지만, JSON 파서로 읽을 수 있다는 사실은 문법이 유효하다는 뜻일 뿐입니다. 클라이언트가 이를 서버 목록으로 처리할지, 전체 설정으로 처리할지는 별개의 문제입니다.

2. Base64는 표현 방식만 바꾸며 프로토콜 기능은 바꾸지 않습니다

Base64는 바이트를 전달하기 편한 텍스트로 나타내는 방식이며, 기밀성을 제공하지 않습니다. 중국어 메모는 먼저 UTF-8 바이트로 변환한 다음 Base64로 인코딩해야 합니다. 반대로 디코딩할 때는 바이트를 복원한 뒤 UTF-8로 해석합니다. 중국어가 포함된 문자열에 브라우저의 btoa()를 바로 사용하면 오류가 발생하거나 결과가 잘못될 수 있습니다.

표준 Base64에는 +, / 문자가 자주 사용되며 끝에 =가 붙을 수 있습니다. URL 안전 변형에서는 앞의 두 문자를 -, _로 바꾸고 패딩을 생략하기도 합니다. 일부 클라이언트는 이런 차이를 지원하지만, 모든 가져오기 기능이 공백이나 잘린 텍스트, 불필요한 따옴표를 자동으로 수정한다고 가정해서는 안 됩니다.

• 바깥쪽 디코딩: 구독 응답 전체를 디코딩하면 보통 여러 줄의 공유 링크가 나옵니다.
• 안쪽 디코딩: 클래식 VMess 공유 형식은 vmess:// 뒤에도 Base64 데이터가 있습니다. 이를 디코딩해야 단일 노드의 JSON을 확인할 수 있습니다.
• 중단 기준: 완전한 URI 목록이나 구조가 분명한 JSON이 나오면 내용을 먼저 판별하세요. 디코딩을 반복하지 마세요.
• 실패 징후: 응답이 HTML 로그인 페이지, 오류 메시지 또는 CAPTCHA 페이지로 시작한다면 변환을 계속하지 말고 구독 액세스 문제부터 확인하세요.

3. VMess 공유 JSON과 네이티브 설정은 구조가 다릅니다

클래식 VMess 공유 링크는 일반적으로 ‘vmess:// + Base64로 인코딩한 JSON’ 형식입니다. 아래는 공유 객체 형식을 설명하기 위한 예시이며, 실제로 연결할 수 있는 서버가 아니고 코어에서 실행할 설정 파일도 아닙니다. 도메인은 예시용으로 예약된 도메인을 사용하며, 포트 443은 TLS 환경을 설명하기 위한 값입니다.

{
  "v": "2",
  "ps": "형식 예시",
  "add": "example.invalid",
  "port": "443",
  "id": "123e4567-e89b-42d3-a456-426614174000",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "example.invalid",
  "path": "/edge",
  "tls": "tls",
  "sni": "example.invalid"
}

여기서 v는 공유 형식의 버전 표시이며 클라이언트 버전이 아닙니다. ps는 메모이고, add, port, id는 각각 주소, 포트, 사용자 식별 정보에 해당합니다. net은 전송 방식을 나타냅니다. 이 예시에서 host와 path는 WebSocket에 사용되고, sni는 TLS 서버 이름에 해당합니다. 각 항목의 역할은 서로 다르므로 값이 같다고 같은 필드로 취급하면 안 됩니다.

네이티브 JSON은 여러 아웃바운드를 동시에 정의하고 라우팅 규칙으로 출구를 선택할 수 있습니다. 그중 노드 하나를 내보내도 DNS, 분할 라우팅 규칙, 인바운드 수신 주소, 아웃바운드 체인이 함께 저장되지 않는 경우가 많습니다. 따라서 ‘네이티브 JSON을 공유 링크로 변환’하는 작업은 보통 연결 정보를 추출하는 것이며, 전체 설정을 되돌릴 수 있는 형태로 압축하는 것이 아닙니다.

4. 로컬에서 형식 변환하기: 텍스트를 처리한 뒤 설정의 의미를 변환하세요

‘공유 링크 목록을 Base64로 변환하기’와 ‘Base64를 목록으로 복원하기’는 인코딩 작업이므로 로컬에서 처리할 수 있습니다. 아래 JavaScript는 텍스트 처리 함수만 정의하며 네트워크 요청을 보내지 않습니다. 직접 만든 로컬 빈 페이지의 개발자 도구에서 실행할 수 있습니다. 낯선 웹사이트의 콘솔에 실제 구독 내용을 붙여 넣거나, 출처를 알 수 없는 변환 스크립트를 실행하지 마세요.

function encodeUtf8Base64(text) {
  const bytes = new TextEncoder().encode(text);
  const binary = Array.from(bytes, byte =>
    String.fromCharCode(byte)
  ).join("");
  return btoa(binary);
}

function decodeUtf8Base64(input) {
  let text = input.trim()
    .replace(/\s+/g, "")
    .replace(/-/g, "+")
    .replace(/_/g, "/");

  if (!/^[A-Za-z0-9+/]*={0,2}$/.test(text)) {
    throw new Error("예상한 Base64 텍스트가 아닙니다");
  }

  if (text.length % 4 === 1) {
    throw new Error("길이가 올바르지 않습니다. 복사한 내용이 온전한지 확인하세요");
  }

  text += "=".repeat((4 - text.length % 4) % 4);
  const binary = atob(text);
  const bytes = Uint8Array.from(binary, char =>
    char.charCodeAt(0)
  );
  return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
}

function packShareList(links) {
  return encodeUtf8Base64(links.join("\n"));
}

function makeClassicVmessLink(shareObject) {
  return "vmess://" + encodeUtf8Base64(JSON.stringify(shareObject));
}

// UTF-8 왕복만 확인하며 실제 구독 인증 정보는 사용하지 않습니다.
const sample = "중국어 메모\n두 번째 줄";
console.assert(
  decodeUtf8Base64(encodeUtf8Base64(sample)) === sample
);

1. 목록 복원: 응답 텍스트에 decodeUtf8Base64()를 적용한 뒤, 출력이 실제로 줄마다 공유 링크로 구성되어 있는지 확인하세요. 이 함수는 프로토콜을 자동으로 판별하거나 손상된 내용을 수정하지 않습니다.
2. 목록 인코딩: 완전한 URI를 각각 배열에 넣고 packShareList()에 전달하세요. 줄바꿈은 항목 구분자이므로 여러 URI를 구분 없이 이어 붙이면 안 됩니다.
3. VMess 링크 생성: 입력 객체가 클래식 VMess 공유 필드에 이미 맞는 경우에만 makeClassicVmessLink()를 사용하세요. 임의의 네이티브 설정을 올바른 노드 링크로 자동 변환하는 함수가 아닙니다.
4. 결과 확인: 먼저 클라이언트에 테스트 항목으로 가져온 뒤 주소, 포트, UUID, 전송 방식, TLS, 서버 이름을 하나씩 대조하고 연결을 테스트하세요.

네이티브 설정을 공유 링크로 제대로 변환하려면 의미를 이해하는 변환기가 필요합니다. 내보낼 아웃바운드를 정하고 프로토콜과 전송 방식을 판별한 다음 필드를 매핑하고, 대상 공유 형식이 모든 매개변수를 표현할 수 있는지 확인해야 합니다. 표현할 수 없는 필드가 있다면 변환을 중단하거나 누락 항목을 기록하세요. 일부 설정을 조용히 버린 뒤 변환에 성공했다고 표시해서는 안 됩니다.

5. 클라이언트 3종별 가져오기 메뉴 선택하기

먼저 용도에 따라 선택하세요. 계속 업데이트할 서버 목록에는 구독을, 노드 하나를 임시로 옮길 때는 공유 링크를 사용합니다. DNS, 라우팅, 아웃바운드를 직접 제어해야 한다면 네이티브 JSON을 고려하세요. 가져오기와 관리는 클라이언트 인터페이스가 담당하고 프로토콜 실행은 코어가 담당하므로, 두 구성 요소의 호환 범위를 각각 확인해야 합니다.

v2rayN은 데스크톱용입니다. v2rayNG는 Xray 코어를 사용하는 안드로이드 클라이언트이고, v2flyNG는 v2fly 코어를 사용하는 안드로이드 클라이언트입니다. VMess 공유 링크는 흔히 사용하는 교환 방식이지만, 지원되는 전송 방식과 확장 매개변수는 버전에 따라 달라집니다. 특히 Xray용 확장 설정을 v2fly 코어가 바로 실행할 수 있다고 가정하면 안 됩니다.

1. 기존 설정 보존

   현재 정상적으로 작동하는 항목과 원본 응답을 먼저 보관하세요. 문제 해결은 별도의 구독 그룹에서 진행하고, 서버 목록을 먼저 전부 지우지 마세요.

2. 데스크톱에서 구독 추가

   v2rayN의 일반적인 경로는 ‘구독 그룹’ → ‘구독 그룹 설정’ → ‘추가’입니다. 메모와 주소를 입력해 저장한 뒤 ‘구독 그룹’ 메뉴에서 업데이트하세요. 플랫폼과 버전에 따라 버튼 이름이 조금 다를 수 있습니다.

3. 안드로이드에서 구독 추가

   v2rayNG의 일반적인 경로는 오른쪽 위 메뉴 ‘⋮’ → ‘구독 그룹 설정’ → ‘+’입니다. 저장한 뒤 메인 화면으로 돌아가 ‘⋮’ → ‘구독 업데이트’를 눌러 항목을 가져오세요. 구독 URL을 서버 주소 입력란에 넣지 마세요.

4. 링크 하나로 비교하기

   v2rayN의 ‘서버’ 메뉴에서 클립보드 가져오기를 선택하세요. v2rayNG에서는 보통 메인 화면의 ‘+’ → ‘클립보드에서 가져오기’를 사용합니다. 같은 공유 링크로 테스트하면 구독 가져오기 문제와 노드 파싱 문제를 구분할 수 있습니다.

5. 코어 확인

   v2flyNG에서는 구독 설정이나 클립보드 가져오기 메뉴를 사용하고, 해당 매개변수를 v2fly가 지원하는지 확인하세요. 네이티브 JSON은 구독 주소 입력란에 붙여 넣지 말고, 해당 버전에서 제공하는 사용자 지정 설정 메뉴로 불러와야 합니다.

6. 가져오기 실패 시 요청·파싱·실행 단계별로 확인하기

업데이트 완료 메시지는 어떤 업데이트 절차가 끝났다는 의미일 뿐, 모든 항목이 정상적으로 파싱됐다는 뜻은 아닙니다. 반대로 항목이 목록에 표시되어도 전송 및 TLS 매개변수가 올바르다고 볼 수는 없습니다. 인코딩을 계속 바꾸기보다 오류가 발생한 단계를 먼저 파악하세요.