V2Ray 구독 형식 비교: Base64 구독, JSON 설정, 공유 링크 변환

1. 구독 주소, 인코딩, 노드 설정은 서로 다른 계층

‘V2Ray 구독’은 하나의 표준 파일 형식을 가리키는 말이 아닙니다. 클라이언트는 먼저 구독 URL에 접속한 뒤 서버가 반환한 본문을 해석합니다. 흔히 여러 줄의 공유 링크가 반환되거나, 각 줄을 합친 텍스트 전체가 Base64로 인코딩되어 있습니다. JSON을 직접 반환하는 서비스도 있습니다. 주소가 HTTPS로 시작한다는 사실은 가져오는 방식만 알려 줄 뿐, 특정 가져오기 도구가 본문을 인식할 수 있다는 뜻은 아닙니다.

JSON은 문법 형식일 뿐, 설정 유형을 뜻하지 않습니다. add, id, net 키가 포함된 VMess 공유 객체도 JSON 문법 검사를 통과할 수 있지만, 완전한 Xray 설정으로 바로 실행할 수는 없습니다. 반대로 완전한 설정을 Base64로 인코딩해도 클라이언트가 지원하는 노드 구독으로 바뀌지는 않습니다.

2. Base64 구독: 먼저 디코딩한 뒤 줄마다 파싱

일반적인 노드 구독은 여러 공유 링크를 줄바꿈으로 연결한 다음, 전체 UTF-8 텍스트를 인코딩합니다. 클라이언트는 본문을 받은 뒤 텍스트를 복원하고 각 줄의 프로토콜을 인식합니다. VMess는 단일 링크 안에 Base64 인코딩이 한 겹 더 들어갈 수 있습니다. 따라서 ‘구독 본문의 디코딩 성공’이 ‘노드 내부 필드의 유효성’을 보장하지는 않습니다.

1. 본문 확인: 로그인 페이지, 액세스 제한 안내, 서버 오류 페이지가 아니라 실제 구독 콘텐츠를 받았는지 확인합니다.
2. 인코딩 여부 확인: 본문이 이미 공유 링크로 시작한다면 일반 텍스트로 처리하고, 무작정 다시 디코딩하지 마세요.
3. 디코딩: 바깥쪽 Base64를 풀어 한 줄에 링크 하나씩 있는 텍스트가 나오는지 확인합니다.
4. 노드 파싱: 각 줄의 프로토콜을 확인한 다음 서버 주소, 포트, 사용자 ID, 전송 매개변수를 점검합니다.

표준 Base64에는 +, /가 흔히 사용되며 끝에 =가 붙을 수 있습니다. 일부 제공처는 URL 안전 변형의 -, _를 사용하거나 끝의 패딩을 생략합니다. 가져오기 도구마다 허용하는 형식이 다르므로, ‘등호가 없다’는 이유만으로 구독이 손상됐다고 단정할 수 없습니다. Base64 전체를 URL 퍼센트 인코딩으로 처리해서도 안 됩니다.

// 로컬 JavaScript 예제: 여러 줄로 된 공유 링크 텍스트를 입력합니다.
// TextEncoder / TextDecoder를 사용하면 한글 노드 이름을 보존할 수 있습니다.
function encodeSubscription(text) {
  const bytes = new TextEncoder().encode(text);
  let binary = "";
  for (const byte of bytes) {
    binary += String.fromCharCode(byte);
  }
  return btoa(binary);
}

function decodeSubscription(encoded) {
  let normalized = encoded.replace(/\s/g, "")
    .replace(/-/g, "+")
    .replace(/_/g, "/");
  normalized += "=".repeat((4 - normalized.length % 4) % 4);
  const binary = atob(normalized);
  const bytes = Uint8Array.from(binary, char => char.charCodeAt(0));
  return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
}

이 코드는 텍스트 형식만 변환하며, 구독을 온라인으로 가져오거나 노드 연결을 확인하지는 않습니다. 디코딩에 실패하면 내용이 잘렸는지, 안내 문구까지 함께 복사했는지 먼저 확인하세요. 디코딩에 성공해도 해당 프로토콜을 지원하는 클라이언트에서 파싱해야 합니다. 브라우저에서 한글을 바로 btoa()에 전달하면 오류가 날 수 있으므로, 예제에서는 먼저 UTF-8 바이트로 변환합니다.

3. VMess·VLESS 공유 링크: 필드별 대응 관계

일반적인 vmess:// 공유 링크는 프로토콜 접두사 뒤에 Base64로 인코딩된 JSON 객체를 붙입니다. 아래는 인코딩 전 객체로, 흔히 쓰이는 공유 규칙의 한 예이며 완전한 코어 설정은 아닙니다. 도메인과 UUID는 구조를 설명하기 위한 값으로, 실제 노드에 사용할 수 없습니다.

{
  "v": "2",
  "ps": "VMess WebSocket 예시",
  "add": "node.example.org",
  "port": "443",
  "id": "2d1e7e18-49f4-4ab7-8b63-c929d11c5e29",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "node.example.org",
  "path": "/proxy",
  "tls": "tls",
  "sni": "node.example.org"
}

v는 공유 객체의 형식 표시이며 클라이언트 버전이 아닙니다. ps는 설명이고, add와 port는 연결 대상입니다. net, host, path는 전송 계층을 나타냅니다. 여기서 aid는 0이며, 이를 근거로 VLESS에도 같은 이름의 매개변수가 있다고 추정해서는 안 됩니다. 공유 형식에 따라 일부 필드는 생략될 수 있으므로 가져온 뒤 노드 편집 화면에서 확인하세요.

VLESS 공유 링크는 보통 URI 구조를 따릅니다. 사용자 ID는 @ 앞에, 서버 주소와 포트는 뒤에 놓이고, 쿼리 매개변수에는 전송 방식과 보안 설정이 담깁니다. # 뒤에는 설명이 붙습니다. 아래 예시는 뒤의 JSON과 같은 매개변수를 사용합니다.

vless://[email protected]:443?encryption=none&security=tls&type=ws&host=node.example.org&path=%2Fproxy&sni=node.example.org#Example-WS

• security=tls는 전송 보안 계층에 TLS를 사용한다는 뜻입니다. encryption=none은 VLESS 매개변수이므로 두 설정은 서로 모순되지 않습니다.
• type=ws는 WebSocket을 뜻하고, path=%2Fproxy를 디코딩하면 /proxy가 됩니다.
• host는 WebSocket 요청 헤더에 포함되는 호스트 정보이고, sni는 TLS 서버 이름입니다. 두 값이 같을 수는 있지만 서로를 임의로 대체해서는 안 됩니다.
• IPv6 주소는 URI에서 대괄호로 감싸야 합니다. 설명에 공백, 한글, 특수 문자가 있다면 URI 규칙에 따라 인코딩하세요.

4. 네이티브 JSON: 노드 매개변수 외에 실행 환경도 설정

네이티브 Xray 설정은 프로세스 전체의 동작 방식을 정의합니다. 인바운드는 로컬 앱이 연결되는 지점을, 아웃바운드는 요청을 서버로 보내는 방식을 결정하며, 라우팅과 DNS는 트래픽 분기 및 이름 해석 방식을 정합니다. 아래는 필드 비교용 최소 설정으로, VLESS·WebSocket·TLS를 사용합니다. 예시 주소는 실제 서비스를 제공하지 않습니다.

{
  "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.org",
            "port": 443,
            "users": [
              {
                "id": "2d1e7e18-49f4-4ab7-8b63-c929d11c5e29",
                "encryption": "none"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "tlsSettings": {
          "serverName": "node.example.org"
        },
        "wsSettings": {
          "path": "/proxy",
          "headers": {
            "Host": "node.example.org"
          }
        }
      }
    }
  ]
}

두 포트의 역할은 서로 다릅니다. 10808은 로컬 루프백 주소에 바인딩되며 예시용 값일 뿐, 모든 기기의 실제 설정을 뜻하지는 않습니다. 443은 원격 서버가 수신하는 포트이므로 서버 설정과 일치해야 합니다. 로컬에서 같은 주소와 포트를 이미 사용 중인 프로세스가 있으면 설정을 추가로 실행하지 못할 수 있습니다.

• 링크를 JSON으로 변환: 노드 매개변수를 아웃바운드에 매핑하고 인바운드, DNS, 라우팅을 별도로 설정합니다. 공유 링크에는 보통 이러한 로컬 설정이 포함되지 않습니다.
• JSON을 링크로 변환: 링크로 표현할 수 있는 노드 아웃바운드에서 매개변수를 추출합니다. 아웃바운드가 여러 개라면 각각 처리해야 하며, 기본적으로 하나의 노드로 합칠 수는 없습니다.
• 정책 유지: routing, dns, 인바운드 수신 설정, 로그 설정은 보통 단일 노드 공유 링크로 옮겨지지 않습니다.
• 코어 호환성: Xray와 V2Fly는 지원하는 필드와 프로토콜이 다릅니다. v2rayNG는 Xray를, v2flyNG는 V2Fly를 사용하므로 둘 다 JSON을 받아들인다는 이유만으로 설정이 호환된다고 볼 수 없습니다.

5. v2rayN·v2rayNG: 올바른 가져오기 메뉴 선택

클라이언트 메뉴 이름은 버전과 인터페이스 언어에 따라 달라질 수 있습니다. 아래는 일반적인 중국어 간체 메뉴를 기준으로 설명합니다. 작업 전에 클립보드 내용이 구독 URL인지, 단일 노드 링크인지, 완전한 JSON인지 확인하세요. 특히 HTTPS 구독 주소를 일반 노드 링크로 가져오지 마세요.

v2rayN: 구독 그룹과 단일 노드는 각각 가져오기

1. 구독 그룹 추가

   메인 화면에서 ‘구독 그룹’ → ‘구독 그룹 설정’으로 이동한 뒤 목록에서 ‘추가’를 선택합니다. 설명과 구독 주소를 입력하고 저장하세요. 주소에 포함된 쿼리 매개변수는 모두 유지해야 합니다.

2. 구독 업데이트

   ‘구독 그룹’ 메뉴로 돌아가 현재 구독 또는 전체 구독을 업데이트합니다. 프록시 사용 여부를 선택하는 메뉴가 있다면 현재 네트워크에서 실제로 접속 가능한 방식을 고른 뒤 업데이트 로그를 확인하세요.

3. 단일 노드 가져오기

   vmess:// 또는 vless:// 전체 링크를 복사한 다음, 메인 창에서 ‘서버’ → ‘클립보드에서 일괄 URL 가져오기’를 선택합니다. 일반적인 단축키는 Ctrl+V입니다.

4. 연결 설정 확인

   노드 편집 창을 열어 주소, 포트, UUID, 전송 유형, 경로, TLS 서버 이름을 확인합니다. 가져오기에 성공했다는 것은 파싱이 끝났다는 뜻일 뿐, 서버에 연결할 수 있다는 의미는 아닙니다.

v2rayNG: 구독 그룹 및 클립보드에서 가져오기

• 구독 주소: 오른쪽 위 메뉴에서 ‘구독 그룹 설정’ → ‘+’를 선택하고 설명과 URL을 입력합니다. 저장한 뒤 메인 화면으로 돌아와 메뉴에서 ‘구독 업데이트’를 실행하세요.
• 공유 링크: 단일 링크나 여러 줄 링크를 복사하고, 메인 화면에서 ‘+’ → ‘클립보드에서 가져오기’를 선택합니다. 그런 다음 노드 수와 설명을 확인하세요.
• 전체 JSON: 현재 버전에서 제공하는 사용자 지정 설정 가져오기 메뉴를 사용하세요. 일반 노드 편집 양식으로 대신할 수 없습니다. Android의 실행 방식은 데스크톱의 로컬 SOCKS 환경과 다르므로, 데스크톱 인바운드 설정을 그대로 적용하면 앱 트래픽이 자동으로 프록시를 통과한다고 가정해서는 안 됩니다.

6. 형식 변환: 유지해야 할 항목에 따라 선택

‘변환 성공’은 최소한 세 가지 기준으로 나눠 봐야 합니다. 텍스트 디코딩, 클라이언트 가져오기, 예상한 연결 동작입니다. 앞의 두 단계가 성공해도 라우팅, DNS, 지문, 전송 확장 매개변수가 누락될 수 있습니다. 먼저 무엇을 옮길지 정하면 변환 버튼부터 찾는 것보다 문제를 빠르게 해결할 수 있습니다.

이전 후 먼저 로그에서 설정 파싱 오류나 수신 오류가 있는지 확인한 다음 노드 하나를 선택해 연결을 테스트하세요. 데스크톱에서는 시스템 프록시나 앱 내 프록시가 실제 인바운드를 가리키는지 확인합니다. Android에서는 연결 서비스가 시작됐는지 확인하고, 시스템 안내에 따라 VPN 인터페이스 권한을 허용하세요. 속도 측정 결과가 나오는 것과 브라우저 트래픽이 프록시를 통과하는 것은 서로 다른 테스트입니다.

7. 가져오기 및 변환 관련 자주 묻는 질문