구독 링크 형식 정리: Base64 구독, Xray JSON, 공유 링크 차이와 변환

1. 구독 주소, 응답 본문, 노드 설정 구분하기

클립보드에 복사한 내용이 반드시 노드인 것은 아닙니다. https://로 시작하는 구독 주소는 리소스를 가리킵니다. 클라이언트가 이 주소에 요청을 보내야 실제 본문을 가져올 수 있습니다. 본문은 줄마다 공유 링크가 나열된 형식일 수도 있고, 해당 줄들을 Base64로 인코딩한 결과일 수도 있으며, 다른 형식의 설정 문서일 수도 있습니다. 주소의 확장자만으로 형식을 판단할 수는 없습니다.

Base64는 암호화 기능을 제공하지 않습니다. 본문을 입수한 사람은 보통 노드 주소와 인증 정보를 복원할 수 있으며, 구독 URL의 토큰도 같은 수준의 액세스 권한을 가질 수 있습니다. 문제 해결을 위해 전체 구독 주소, QR 코드 또는 노드 내보내기 내용을 공개 게시판에 올리지 마세요. 스크린샷을 공유할 때는 경로, 쿼리 매개변수, 노드 인증 정보를 모두 가리세요.

2. Base64 구독과 VMess의 인코딩 단계

기존 구독 형식에서는 여러 공유 링크를 줄바꿈으로 연결한 뒤, 전체 UTF-8 텍스트를 Base64로 인코딩하는 경우가 많습니다. 한 번 디코딩하면 노드가 한 줄씩 표시되어야 합니다. 줄 끝에는 LF나 CRLF가 사용될 수 있습니다. 가져오기 기능은 대개 빈 줄을 무시하지만, 모든 버전이 불필요한 공백이나 바이트 순서 표시를 처리한다고 장담할 수는 없습니다.

1. 바깥 단계: 구독 본문 전체가 Base64로 인코딩되어 있으며, 디코딩하면 여러 줄의 URI가 나옵니다.
2. 노드 단계: 흔히 쓰이는 vmess:// 형식은 뒷부분도 Base64로 인코딩되어 있으며, 디코딩하면 노드 설명 JSON이 나옵니다.
3. 필드 단계: VLESS 등의 URI에서 이름, 경로, 쿼리 매개변수는 퍼센트 인코딩될 수 있습니다. 예를 들어 %20은 공백을 뜻합니다.

따라서 VMess 노드에는 Base64 디코딩이 두 번 필요할 수 있지만, 각 단계에서 다루는 데이터는 서로 다릅니다. 긴 문자열이라는 이유만으로 ‘읽을 수 있는 문자가 나올 때까지’ 반복해서 디코딩하지 마세요. vless://가 보이면 본문은 보통 URI로 파싱해야 하며, 뒷부분 전체를 다시 Base64로 취급해서는 안 됩니다.

일반적인 VMess 공유 JSON에는 v, ps, add, port, id, net, tls 등의 필드가 있습니다. 이 중 v의 흔한 값인 "2"는 이 공유 형식의 버전을 나타내며, 클라이언트나 커널 버전이 아닙니다. 또한 Xray에서 바로 실행할 수 있는 기본 설정도 아닙니다.

• 표준 Base64는 +와 /를 사용하며, URL 안전 변형은 -와 _를 사용할 수 있습니다.
• 끝에 붙는 =는 패딩 문자입니다. 이 문자가 있거나 생략되었다는 사실만으로 본문의 유효성을 판단할 수는 없습니다.
• 노드 이름에 한글이 포함된 경우 UTF-8로 디코딩해야 합니다. atob()의 반환값을 Unicode 텍스트로 바로 취급하면 문자가 깨질 수 있습니다.

3. 공유 링크에서 복원할 수 있는 필드

아래 예시는 예약된 도메인과 전부 0인 UUID를 사용한 VLESS URI입니다. 구조 설명용이므로 실제 연결에는 사용할 수 없습니다. 포트 443은 원격 서버의 예시 포트이며, 클라이언트의 로컬 수신 포트와는 다릅니다.

vless://[email protected]:443?encryption=none&security=tls&type=tcp&sni=node.example.invalid#TLS%20example

복잡한 전송 설정을 변환할 때는 flow, alpn, 전송 경로, HTTP Host 및 관련 보안 매개변수도 확인해야 합니다. 공유 형식과 클라이언트 버전에 따라 매개변수 이름 규칙이 다를 수 있습니다. 주소, 포트, UUID가 같다고 해서 두 설정이 동일하다고 볼 수는 없습니다.

4. Xray JSON은 노드 목록이 아닙니다

Xray JSON은 실행 환경을 정의합니다. inbounds는 로컬에서 트래픽을 받는 방식을, outbounds는 원격에 연결하는 방식을 정의하며, routing은 요청에 따라 서로 다른 아웃바운드로 트래픽을 보낼 수 있습니다. 아래의 최소 예시는 앞 절의 VLESS 노드에 대응하며, 로컬 SOCKS 수신 주소를 127.0.0.1:10808로 설정합니다. 원격 관련 값은 모두 연결할 수 없는 예시입니다.

{
  "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": "vless",
      "settings": {
        "vnext": [
          {
            "address": "node.example.invalid",
            "port": 443,
            "users": [
              {
                "id": "00000000-0000-0000-0000-000000000000",
                "encryption": "none"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "tcp",
        "security": "tls",
        "tlsSettings": {
          "serverName": "node.example.invalid"
        }
      }
    }
  ]
}

이 예시에는 routing과 dns가 명시적으로 설정되어 있지 않으며, 단일 인바운드와 단일 아웃바운드의 구조만 보여 줍니다. 수신 주소는 루프백으로 제한되어 있어 LAN에는 공개되지 않습니다. udp: true는 해당 SOCKS 인바운드가 관련 요청을 처리하도록 허용할 뿐, 애플리케이션과 원격 서버, 네트워크 경로에서 UDP 통신이 모두 가능하다는 뜻은 아닙니다.

5. v2rayN, v2rayNG, v2flyNG 가져오기 방법

형식을 파싱할 수 있는지와 사용 중인 커널이 해당 프로토콜을 실행할 수 있는지는 별개의 조건입니다. v2rayN은 데스크톱 클라이언트이고, v2rayNG는 Xray 커널을, v2flyNG는 v2fly 커널을 사용합니다. 가져오기 전에 클라이언트의 메뉴, 커널 종류, 필요한 전송 기능을 모두 확인하세요. 한 클라이언트에서 저장할 수 있는 설정이 다른 클라이언트에서도 실행된다고 단정하면 안 됩니다.

구독 내용을 디코딩한 뒤 수동으로 가져오면 대개 노드의 현재 상태만 저장되며, 원래 구독의 업데이트 연결은 유지되지 않습니다. 사용자 지정 JSON도 인터페이스에서 관리하는 일반 노드와 다릅니다. 시스템 프록시가 사용하는 포트는 실제 인바운드 설정과 일치해야 합니다. 위 예시는 SOCKS 10808만 수신하므로 HTTP 10809도 사용할 수 있다고 가정해서는 안 됩니다.

6. 오프라인 디코딩 및 재인코딩 방법

인코딩 형식만 확인하려면 구독 내용을 온라인 변환 서비스에 제출하지 말고, 로컬의 빈 페이지에서 브라우저 개발자 도구 콘솔을 사용할 수 있습니다. 아래 방법은 브라우저 내장 API만 사용하며 네트워크 요청을 보내지 않습니다. 먼저 고정된 텍스트로 TextEncoder와 TextDecoder가 작동하는지 확인한 다음, 신뢰할 수 있는 로컬 환경에서 이미 가져온 본문을 처리하세요. 익숙하지 않은 웹페이지의 콘솔에는 실제 구독 내용을 붙여 넣지 마세요.

function decodeBase64Text(input) {
  const normalized = input.trim()
    .replace(/\s+/g, "")
    .replace(/-/g, "+")
    .replace(/_/g, "/");
  if (normalized.length % 4 === 1) {
    throw new Error("Base64 길이가 올바르지 않습니다");
  }
  const padded = normalized
    + "=".repeat((4 - normalized.length % 4) % 4);
  const bytes = Uint8Array.from(
    atob(padded),
    character => character.charCodeAt(0)
  );
  return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
}

function encodeBase64Text(text) {
  const bytes = new TextEncoder().encode(text);
  const parts = [];
  for (const byte of bytes) {
    parts.push(String.fromCharCode(byte));
  }
  return btoa(parts.join(""));
}

decodeBase64Text("5rWL6K+V"); // 테스트
encodeBase64Text("테스트");     // 5rWL6K+V

1. 먼저 형식을 확인하세요: 본문이 이미 줄마다 URI로 되어 있다면 바깥쪽 디코딩은 필요하지 않습니다. JSON 객체로 시작한다면 먼저 필드 구조를 확인하세요.
2. 한 번만 디코딩하세요: Base64 형식이 맞는 본문에 디코딩 함수를 사용하고, 결과가 오류 페이지가 아니라 노드 목록인지 확인하세요.
3. 노드 원문을 유지하세요: URI 전체에 퍼센트 디코딩을 반복 적용하지 마세요. 경로에 포함된 예약 문자의 의미가 달라질 수 있습니다.
4. 줄 단위로 정리하세요: 내용이 없는 줄만 제거하고 각 공유 링크 내부의 문자는 그대로 유지하세요. 재인코딩할 때는 각 노드를 줄바꿈으로 연결합니다.
5. 가져오기를 확인하세요: 전체 목록을 처리하기 전에 노드 하나로 테스트하세요. 인코딩 오류에 해당하는 경우에만 재인코딩으로 문제를 해결할 수 있습니다.

위 함수는 인코딩과 디코딩만 수행합니다. VMess를 VLESS로 변환하거나 Xray JSON을 구독으로 자동 변환하지는 않습니다. 프로토콜 변환에는 서버에서 해당 연결 방식을 제공하는지가 중요하며, 문자열 접두사만 바꿔서는 처리할 수 없습니다. 마찬가지로 Xray JSON을 Base64로 감싸도 일반적인 ‘줄마다 노드 URI가 나열된’ 구독 형식이 되는 것은 아닙니다.

7. 가져오기 실패 및 변환 후 필드 누락 해결

최종 점검은 세 단계로 나눠 진행하세요. 구독을 정상적으로 가져왔는지, 노드 매개변수가 빠짐없이 파싱되었는지, 트래픽이 예상한 아웃바운드로 전달되는지 확인합니다. 형식을 바꾸기 전에는 원본을 백업하세요. 사용자 지정 JSON은 특히 수신 주소와 포트가 바뀌지 않았는지 확인한 뒤 애플리케이션의 프록시 설정도 점검해야 합니다.

• 자동 업데이트가 필요하면: 구독 URL을 유지하고 구독 그룹에서 관리하세요.
• 노드만 옮길 때: 대상 클라이언트가 지원하는 원본 공유 링크를 우선 사용하세요.
• 전체 동작을 유지하려면: Xray JSON을 옮겨 라우팅과 DNS를 항목별로 확인하세요. 노드 개수만 비교해서는 안 됩니다.