V2Ray 구독 형식 비교: Base64 구독, 네이티브 JSON, vmess:// 공유 링크 변환 가이드

세 가지 형식부터 구분하기: 구독 주소는 노드 설정이 아닙니다

결론: 먼저 받은 내용을 확인한 뒤 가져오기 방법을 선택하세요. https://로 시작하는 구독 주소는 노드 목록을 가져오는 경로일 뿐입니다. 클라이언트가 받는 형식은 응답 본문에 따라 Base64로 인코딩된 노드 목록, 일반 텍스트 공유 링크 또는 다른 구조일 수 있습니다. 주소 자체를 Base64로 디코딩해도 서버 설정은 나오지 않습니다.

Base64는 정보를 보호하지 않습니다. 구독 주소의 액세스 토큰, 노드 UUID, 공유 QR 코드에는 연결 권한을 부여하는 정보가 들어 있을 수 있습니다. 문제를 확인할 때는 로컬 편집기를 사용하고 실제 내용을 온라인 디코딩 사이트에 붙여 넣지 마세요. 다른 사람에게 로그를 전달하기 전에도 이러한 식별 정보를 제거해야 합니다.

Base64 구독 디코딩: 바깥쪽 목록과 안쪽 노드를 따로 처리하기

흔히 사용하는 2단계 구조에서는 바깥쪽 Base64를 디코딩해 여러 vmess:// 링크를 얻습니다. 그중 하나를 골라 접두사를 제거하고 다시 디코딩해야 노드 JSON이 나옵니다. 입력에 무조건 두 번 디코딩을 적용해서는 안 됩니다. 구독 본문이 이미 공유 링크로 시작한다면 바깥쪽 디코딩은 필요하지 않습니다.

1. 응답 본문 확인

   로컬 도구로 구독 응답 내용을 확인하세요. 로그인 페이지, CAPTCHA 또는 오류 페이지가 표시된다면 먼저 접근 문제를 해결해야 합니다. HTML 페이지는 노드 목록이 아니므로 요청이 성공했더라도 구독을 사용할 수 있다는 뜻은 아닙니다.

2. 바깥쪽 형식 확인

   본문에 vmess:// 또는 vless://가 바로 보이면 줄 단위로 읽습니다. 연속된 인코딩 문자열이라면 Base64 디코딩을 시도하고, { 또는 [로 시작하는 내용은 먼저 JSON인지 확인합니다.

3. 노드별 줄 분리

   디코딩한 결과를 줄바꿈 기준으로 나누고 각 줄 앞뒤의 공백을 제거한 뒤 빈 줄을 걸러냅니다. 여러 링크를 하나로 합치거나 링크 안의 문자를 바꾸지 마세요.

4. 개별 링크 파싱

   여기서 설명하는 VMess v2 형식은 vmess://를 제거한 뒤 디코딩해 JSON으로 파싱합니다. 내용이 이 구조와 다르면 필드를 억지로 맞추지 말고 공유 형식의 출처를 확인하세요.

아래 함수는 로컬 브라우저 콘솔에서 사용할 수 있습니다. 표준 Base64와 흔히 사용하는 URL 안전 문자를 지원하고, 생략된 끝부분 패딩을 보완하며, UTF-8을 기준으로 한글 메모를 복원합니다. 실행하기 전에 코드를 먼저 읽어 보세요. 네트워크 요청을 보내거나 클립보드를 자동으로 읽지 않습니다.

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

  if (!/^[A-Za-z0-9+/]*={0,2}$/.test(value)) {
    throw new Error("Base64가 아닌 문자가 포함되어 있습니다");
  }

  value = value.replace(/=+$/, "");
  if (value.length % 4 === 1) {
    throw new Error("Base64 길이가 올바르지 않습니다");
  }

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

function readSubscription(body) {
  const text = body.trim();
  const decoded = /^(vmess|vless):\/\//i.test(text)
    ? text
    : decodeBase64Utf8(text);

  return decoded.split(/\r?\n/)
    .map(line => line.trim())
    .filter(Boolean);
}

function readVmess(link) {
  const value = link.trim();
  if (!value.startsWith("vmess://")) {
    throw new Error("vmess:// 링크가 필요합니다");
  }
  return JSON.parse(decodeBase64Utf8(value.slice(8)));
}

readSubscription은 일반 텍스트 링크 목록 또는 그 Base64 인코딩이라는 한 가지 구독 형식만 보여 주는 예시이며, 모든 형식을 처리하는 파서는 아닙니다. 다른 구조라면 작업을 중단하고 서비스 제공자가 안내한 형식을 확인하세요. Base64 디코딩에 성공해도 인코딩된 내용을 읽을 수 있다는 뜻일 뿐, 노드가 유효하거나 계정에 여전히 권한이 있다는 뜻은 아닙니다.

vmess:// 링크 분석: 공유 필드를 네이티브 설정에 매핑하기

다음은 구조를 설명하기 위한 VMess v2 노드 객체입니다. example.com은 문서 예시용 도메인이며 UUID도 예시일 뿐이므로 프록시 서버 연결에 사용할 수 없습니다. 필드 v의 값 "2"는 공유 형식의 버전이지 클라이언트나 코어 버전이 아닙니다.

{
  "v": "2",
  "ps": "문서 예시",
  "add": "example.com",
  "port": "443",
  "id": "00000000-0000-4000-8000-000000000001",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "example.com",
  "path": "/ws",
  "tls": "tls",
  "sni": "example.com"
}

VMess와 VLESS는 서로 다른 프로토콜입니다. 일반적인 vless:// 링크는 사용자 정보, 호스트, 포트, 쿼리 매개변수가 포함된 URI 구조이므로, 접두사를 제거한 뒤 Base64로 디코딩해 JSON을 얻는 절차를 그대로 적용할 수 없습니다. VMess 링크의 접두사만 VLESS로 바꿔도 프로토콜이 변환되지는 않습니다. 서버가 해당 프로토콜과 인증 설정을 지원해야 합니다.

네이티브 JSON으로 변환하기: 노드 외에 인바운드도 설정해야 합니다

네이티브 설정은 디코딩한 노드 JSON의 파일 이름만 바꾸는 것이 아닙니다. 다음은 Xray에서 흔히 사용하는 VMess, WebSocket, TLS 구성을 담은 완전한 예시입니다. 로컬에는 SOCKS 인바운드를 열고, 아웃바운드에는 위의 예시 노드를 사용합니다. 구체적인 필드는 실제로 설치한 코어 버전을 기준으로 확인해야 합니다. 모든 V2Fly 버전에서 사용할 수 있는 공통 설정으로 간주해서는 안 됩니다.

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ],
  "outbounds": [
    {
      "tag": "proxy",
      "protocol": "vmess",
      "settings": {
        "vnext": [
          {
            "address": "example.com",
            "port": 443,
            "users": [
              {
                "id": "00000000-0000-4000-8000-000000000001",
                "alterId": 0,
                "security": "auto"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "tlsSettings": {
          "serverName": "example.com",
          "allowInsecure": false
        },
        "wsSettings": {
          "path": "/ws",
          "headers": {
            "Host": "example.com"
          }
        }
      }
    }
  ]
}

이 예시에는 분할 라우팅 규칙이 없으므로 기본적으로 첫 번째 아웃바운드에 트래픽을 보냅니다. 시스템 프록시도 자동으로 설정하지 않습니다. 앱에서 127.0.0.1:10808 SOCKS 서비스를 명시적으로 사용해야 합니다. 127.0.0.1은 로컬 컴퓨터에서만 연결을 허용하므로 문제 해결을 위해 모든 네트워크 인터페이스에 공개되는 주소로 바꾸지 마세요.

• 먼저 포트를 확인하세요. 사용 중인 클라이언트가 이미 10808을 사용한다면 두 번째 코어가 시작되지 않을 수 있습니다. 중복 실행 중인 인스턴스를 종료하거나 로컬 인바운드와 앱의 프록시 포트를 함께 변경하세요.
• 인증서 검증을 유지하세요. 예시에서는 allowInsecure: false를 그대로 사용합니다. 인증서 오류가 발생하면 검증을 끄는 대신 시스템 시간, 서버 이름, 인증서 체인을 확인하세요.
• 설정 적용 범위를 구분하세요. 클라이언트에서 사용자 지정 설정을 가져오면 시스템 프록시, TUN, 내장 라우팅의 작동 여부는 가져오기 모드에 따라 달라집니다. 일반 노드 모드와 똑같이 작동한다고 가정하지 마세요.

역변환: 공유 링크에는 설정 일부만 담을 수 있습니다

VMess 아웃바운드 하나에서 공유 링크를 만들려면 네이티브 설정에서 서버, 사용자, 전송 필드를 추출해 앞서 소개한 v2 공유 객체를 구성한 다음 UTF-8로 인코딩해 Base64로 변환하고 마지막에 vmess:// 접두사를 붙여야 합니다. 네이티브 설정 전체를 바로 인코딩해 이 접두사를 붙이면 일반적인 노드 가져오기 규약에 맞지 않습니다.

function encodeBase64Utf8(text) {
  const bytes = new TextEncoder().encode(text);
  let binary = "";
  for (const byte of bytes) {
    binary += String.fromCharCode(byte);
  }
  return btoa(binary);
}

function createVmessLink(share) {
  return "vmess://" + encodeBase64Utf8(JSON.stringify(share));
}

function createBase64Subscription(links) {
  return encodeBase64Utf8(links.join("\n"));
}

createVmessLink는 필드 표에 맞춰 정리한 공유 객체를 받으며, 복잡한 설정을 자동으로 추출하거나 노드 매개변수를 검증하지 않습니다. createBase64Subscription은 공유 링크 배열을 받아 일반적인 구독 본문을 생성합니다. 업데이트 가능한 구독 주소를 만들어 주는 함수는 아니며, 구독 주소를 제공하려면 관리되는 서비스에서 응답을 제공해야 합니다.

• 네이티브 설정에 서버나 사용자가 여러 개라면 어느 조합을 사용할지 명확히 선택해야 합니다. 배열에 포함된 모든 항목이 하나의 링크에 해당한다고 가정하지 마세요.
• 로컬 인바운드, DNS, 라우팅, 로그 수준, 다중 아웃바운드 정책은 VMess 공유 링크 하나에 온전히 보존되지 않는 경우가 많습니다.
• 고급 전송 필드는 대응하는 공유 형식 규약이 없으면 가져오는 과정에서 누락될 수 있습니다. 설정을 완전히 이전하려면 백업을 사용하고 대상 코어와의 호환성을 확인하세요.

클라이언트에 가져오기: 구독, 클립보드, 사용자 지정 설정은 따로 사용하기

클라이언트가 바깥쪽 형식을 인식한다고 해서 내부의 모든 프로토콜과 전송 방식을 코어가 지원하는 것은 아닙니다. v2rayN은 데스크톱 클라이언트이고, v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 사용합니다. 먼저 연결 매개변수와 코어 기능이 맞는지 확인한 뒤 가져오기 방법을 선택하세요. 아래 메뉴는 일반적인 중국어 인터페이스를 기준으로 하며, 버전에 따라 이름과 위치가 다를 수 있습니다.

v2rayN에서 흔히 구독을 업데이트하는 메뉴는 「구독 그룹」→「현재 구독 업데이트(프록시 사용 안 함)」입니다. 이 항목은 구독을 가져올 때 프록시를 사용할지 정하며 노드 연결을 직접 연결로 바꾸지는 않습니다. 구독 사이트에 프록시를 통해 접속해야 한다면 프록시를 사용해 업데이트하는 항목을 선택하고 기존 프록시 연결이 작동하는지 먼저 확인하세요.

1. 업데이트에 실패하면 응답부터 확인하세요. 주소가 만료되었거나 액세스 토큰이 유효하지 않거나 웹페이지가 반환되었다면 노드 형식을 변환하지 마세요. 업데이트 로그와 구독 권한을 먼저 확인하세요.
2. 가져오기에 실패하면 구조부터 확인하세요. 따옴표를 불필요하게 함께 복사했는지, 접두사가 빠졌는지, 전체 JSON을 공유 링크로 잘못 처리했는지 확인하세요. 한글 메모가 깨지면 UTF-8 인코딩과 디코딩을 확인하세요.
3. 연결에 실패하면 매개변수를 확인하세요. 노드가 목록에 표시되는데 연결되지 않는다면 Base64 인코딩을 반복하는 대신 UUID, 포트, WebSocket 경로, Host, TLS, SNI를 확인하세요.
4. 수동 수정은 별도로 저장하세요. 구독을 업데이트하면 노드 항목이 다시 생성될 수 있습니다. 임시로 수정한 노드는 별도 그룹에 복사하고 구독 원본 값과 달라진 부분을 기록해 두세요.

자주 묻는 질문: 디코딩에 성공했는데 왜 사용할 수 없나요?