구독 URL은 구독 그룹에, 노드 공유 링크는 클립보드 가져오기에 입력합니다. 주소 확인부터 PC·Android에서 추가하고 업데이트 결과를 확인하는 순서로 안내하며, 다운로드 실패와 콘텐츠 파싱 실패를 구분합니다. 구독을 처음 가져오거나 링크를 복사한 뒤 메뉴를 찾지 못한 경우, 업데이트는 성공했지만 노드가 표시되지 않는 경우에 참고하세요.
먼저 구독 URL과 노드 공유 링크를 구분하세요
구독은 반복해서 요청할 수 있는 설정 소스입니다. 클라이언트가 주소에 접속해 응답을 노드 목록으로 파싱합니다. 노드 공유 링크는 연결 설정 하나를 직접 담습니다. 둘 다 텍스트로 복사할 수 있지만, 클립보드에서 복사했다는 이유만으로 같은 메뉴에 넣어야 하는 것은 아닙니다.
구독 URL
권장일반적으로 https://로 시작하며, 서비스 제공업체의 구독 페이지에서 생성됩니다. 구독 그룹에 추가하면 나중에 다시 업데이트해 해당 소스의 노드 변경 사항을 받을 수 있습니다. 일반 웹사이트의 홈이나 로그인 페이지는 구독 URL이 아닙니다.
적합한 경우: 하나의 소스에서 제공하는 여러 노드를 계속 관리할 때
단일 공유 링크
일반적인 접두사는 vmess://, vless://, trojan://입니다. 클라이언트의 클립보드 가져오기 기능을 사용하면 로컬 노드 하나가 생성되며, 구독 업데이트와 자동으로 연결되지는 않습니다.
적합한 경우: 노드 하나를 임시로 테스트하거나 관리자로부터 설정 하나를 전달받았을 때
Base64 형식의 구독 본문
구독 API가 반환할 수 있는 콘텐츠이며, 고정된 주소 접두사가 아닙니다. 디코딩하면 보통 줄마다 공유 링크가 들어 있습니다. 인코딩된 텍스트 전체를 직접 붙여넣을 수 있는지는 클라이언트 버전과 가져오기 메뉴에 따라 다릅니다.
적합한 경우: 콘텐츠 형식을 확인하거나 제공업체가 전달한 오프라인 설정 텍스트를 처리할 때
Base64는 인코딩 방식일 뿐 기밀성을 제공하지 않습니다. 구독 URL에 접근 자격 정보가 포함될 수도 있으며, URL 전체를 가진 사람은 해당 구독을 요청할 수 있는 경우가 많습니다. 공개 채팅이나 온라인 디코딩 사이트에 주소를 올리거나 화면을 캡처해 공유하지 마세요.
v2rayN: 구독 그룹 설정에서 주소 추가하기
PC에서는 먼저 그룹을 만든 다음 업데이트를 실행해야 합니다. 버전에 따라 버튼 아이콘이나 괄호 표기가 조금 다를 수 있습니다. 아래에서는 중국어 UI의 「订阅分组」(구독 그룹), 「订阅分组设置」(구독 그룹 설정)을 기준으로 설명합니다. 메인 화면에서 「从剪贴板导入分享链接」(클립보드에서 공유 링크 가져오기)만 실행했다면, 업데이트 가능한 구독 그룹이 만들어진 것은 아닙니다.
-
구독 URL 복사하기
제공업체의 구독 페이지에서 URL 전체를 복사합니다. 「링크 복사」와 같은 안내 문구까지 함께 선택하지 않았는지, 물음표 뒤의 매개변수가 빠지지 않았는지 확인하세요. 메신저에서 줄이 바뀌면서 URL 중간에 공백이 들어가면 안 됩니다.
-
그룹 설정 열기
v2rayN 메인 창에서 「订阅分组」(구독 그룹) → 「订阅分组设置」(구독 그룹 설정)을 선택한 다음 「添加」(추가)를 클릭해 새 그룹 편집 화면으로 이동합니다.
-
별칭과 주소 입력하기
「别名」(별칭)에는 알아보기 쉬운 소스 이름을, 「地址」(주소)에는 구독 링크를 입력합니다. 내용을 확인한 뒤 저장하세요. 별칭은 로컬에서 구분하기 위한 이름이며 실제 구독 URL을 대신하지 않습니다.
-
구독 업데이트 실행하기
메인 창으로 돌아가 「订阅分组」(구독 그룹)을 열고 「更新全部订阅(不通过代理)」(모든 구독 업데이트(프록시 사용 안 함))를 선택합니다. 프록시 없이 해당 URL에 접속할 때 시간 초과가 발생하고 사용할 수 있는 프록시 노드가 이미 있다면 「更新全部订阅(通过代理)」(모든 구독 업데이트(프록시 사용))를 시도하세요.
-
노드 목록 확인하기
방금 추가한 그룹으로 전환해 노드가 생성됐는지 확인하고, 하단 로그에서 업데이트 결과를 살펴보세요. 그룹을 저장하기만 하고 업데이트를 실행하지 않았다면 목록이 비어 있어도 구독이 만료됐다고 볼 수 없습니다.
v2rayNG: 사이드 메뉴에서 구독 그룹 설정 열기
Android용 v2rayNG는 Xray 코어를 사용합니다. 구독 관리와 연결 시작은 별개의 단계입니다. 구독 관리에서는 설정을 내려받아 파싱하고, 연결 시작에서는 선택한 노드를 실행합니다. 처음 연결할 때 시스템 VPN 연결 요청이 표시되는 것은 연결 시작 과정이며, 구독 업데이트 성공을 뜻하지는 않습니다.
-
구독 설정 열기
v2rayNG를 열고 왼쪽 위 메뉴를 눌러 「订阅分组设置」(구독 그룹 설정)을 선택합니다. 메인 화면의 노드 추가용 「+」와 구독 그룹 화면의 「+」를 혼동하지 마세요.
-
구독 그룹 추가하기
「订阅分组设置」(구독 그룹 설정) 화면 오른쪽 위의 「+」를 누르고 「备注」(메모)와 「可选地址(Url)」(선택 주소(URL))를 입력합니다. 이 주소란은 구독 URL 입력용이며, 버전에 따라 「地址」(주소)로 표시되기도 합니다.
-
전체 URL 저장하기
복사한 구독 URL을 붙여넣고 앞뒤가 잘리지 않았는지 확인합니다. 오른쪽 위의 체크 표시를 눌러 저장한 뒤 메인 화면으로 돌아가세요. 주소란에 서비스 계정 비밀번호를 넣거나 URL에 포함된 접근 매개변수를 삭제하지 마세요.
-
구독 내용 업데이트하기
메인 화면 오른쪽 위의 점 세 개 메뉴를 열고 「更新订阅」(구독 업데이트)을 선택합니다. 버전에 따라 전체 구독, 현재 그룹 또는 프록시 업데이트를 구분한다면, 방금 저장한 그룹이 대상에 포함되는지 먼저 확인하세요.
-
노드 선택 및 연결 시작
업데이트가 끝나면 노드를 하나 선택하고 메인 화면의 연결 버튼을 누릅니다. 처음 실행할 때는 시스템 안내에 따라 VPN 연결을 허용하세요. 이후 실제 연결 테스트나 웹 접속으로 사용 가능 여부를 확인합니다.
Android 시스템에서 클립보드 접근을 알리는 것은 앱이 클립보드를 읽었다는 뜻일 뿐, 유효한 설정을 인식했다는 뜻은 아닙니다. 가져온 뒤 항목이 없다면 연결 버튼을 반복해서 누르지 말고 구독 그룹 화면에서 저장된 URL을 확인한 다음 업데이트 안내를 살펴보세요.
Base64와 클립보드 가져오기: 복사 방식이 아니라 콘텐츠에 맞는 메뉴 선택
일반적인 텍스트 구독은 여러 공유 링크를 줄마다 나열한 뒤 전체를 Base64로 인코딩합니다. 클라이언트가 구독 URL에 요청하면 디코딩과 파싱이 자동으로 진행되므로 보통 직접 디코딩할 필요가 없습니다. 인코딩 문자열 끝에 =가 붙을 수도 있고, 인코딩 방식이 다르거나 패딩을 생략해 붙지 않을 수도 있습니다. 이 문자 하나만으로 콘텐츠가 온전한지 판단할 수는 없습니다.
- 복사한 것이 구독 URL이라면: 구독 그룹의 주소란에 입력하고 저장한 뒤 업데이트하세요. 로그인한 계정 페이지의 URL을 구독 API 주소로 착각하지 마세요.
- 복사한 것이 공유 링크 하나라면: v2rayN에서는 「服务器」(서버) → 「从剪贴板导入分享链接」(클립보드에서 공유 링크 가져오기)를 선택합니다. v2rayNG에서는 메인 화면의 「+」 → 「从剪贴板导入」(클립보드에서 가져오기)를 누릅니다. 메뉴 이름은 버전에 따라 조금 다를 수 있습니다.
- 복사한 것이 여러 줄의 공유 링크라면: 클립보드 가져오기를 시도할 수 있지만, 실제로 추가된 항목 수를 확인하세요. 한 줄의 형식이 잘못됐다고 해서 나머지 줄도 모두 가져왔다고 단정할 수는 없습니다.
- 복사한 것이 인코딩된 텍스트 전체라면: 우선 제공업체에 원본 구독 URL을 요청하세요. 인코딩 텍스트 앞에
https://를 붙여 URL처럼 만들거나 서버 도메인 입력란에 넣지 마세요.
정리: 계속 업데이트하려면 구독 그룹을 만드세요
클립보드에서 노드를 가져오면 현재 설정을 복사한 것에 그칩니다. 소스의 변경 사항을 계속 받으려면 구독 URL을 별도로 저장하고 구독 업데이트를 실행하세요. 노드를 반복해서 붙여넣는 방식으로 구독 관리를 대신하지 마세요.
모두 HTTPS URL이어도 응답 내용은 다를 수 있습니다. 일부 API는 클라이언트가 지원하는 텍스트 구독을 반환하지만, 웹 페이지·JSON·기타 설정 형식을 반환하는 곳도 있습니다. 제공업체가 v2rayN·v2rayNG용으로 안내한 구독 메뉴를 선택해야 합니다. 브라우저에서 URL이 열린다고 해서 클라이언트가 응답을 파싱할 수 있는 것은 아닙니다.
업데이트 실패: HTTP 상태 코드와 파싱 결과 확인하기
문제를 진단할 때는 연결 가능 여부, 서버의 접근 허용 여부, 응답을 파싱할 수 있는지를 나눠서 확인하세요. 아래는 일반적인 HTTP 상태 코드의 의미이며 속도 테스트 결과가 아닙니다. 로그에 HTTP 응답이 없다면 시간 초과, 도메인 조회 또는 연결 문제부터 확인해야 합니다.
- 연결 시간 초과: 먼저 기기가 인터넷에 정상적으로 연결되는지, 시스템 시간이 맞는지 확인합니다. 그런 다음 프록시 없이 업데이트하는 방법과 사용 가능한 프록시를 통한 업데이트를 각각 시도하세요. 원인을 구분할 수 있도록 한 번에 한 가지 방법만 바꾸세요.
- 401 또는 403: 제공업체의 구독 페이지로 돌아가 URL을 다시 복사하고 계정 상태와 접근 권한을 확인하세요. 구체적인 원인은 서버 안내를 기준으로 판단해야 합니다. 상태 코드만 보고 계정이 만료됐다고 단정하지 마세요.
- 200이지만 파싱 실패: 응답이 로그인 페이지, 접근 확인 페이지 또는 오류 안내인지 확인하세요. 페이지 텍스트를 성공적으로 내려받았더라도 유효한 노드로 변환할 수는 없습니다.
- 업데이트 성공 후 노드가 0개: 현재 그룹 필터, 제공업체가 실제로 노드를 반환했는지, 사용 중인 구독 형식이 맞는지 확인하세요. 필요하면 새 그룹을 만들어 테스트하되, 비교할 수 있도록 기존 그룹은 유지하세요.
자주 묻는 질문: 가져온 뒤 확인할 사항
구독을 추가했는데 메인 화면이 비어 있는 이유는 무엇인가요?
구독 업데이트를 한 번 실행한 뒤 해당 그룹으로 전환하세요. 그룹 추가는 URL을 저장하는 단계일 뿐, 모든 버전에서 노드를 자동으로 내려받지는 않습니다. 로그에 업데이트 완료가 표시되는데도 목록이 비어 있다면 그룹을 잘못 선택하지 않았는지, 응답에 파싱 가능한 노드가 실제로 포함돼 있는지 확인하세요.
같은 URL인데 휴대폰에서는 업데이트되고 PC에서는 안 되는 이유가 무엇인가요?
두 기기의 URL이 완전히 같은지 확인한 다음, 업데이트할 때 프록시를 사용했는지 비교하세요. DNS, 시스템 시간, 네트워크 출구, 구독 요청 방식이 기기마다 다를 수 있습니다. 먼저 네트워크와 업데이트 방식을 동일하게 맞춰 보세요. 노드의 전송 매개변수부터 바꾸지는 마세요.
노드를 가져왔다면 인터넷에 정상적으로 접속할 수 있나요?
가져오기에 성공했다는 것은 설정을 파싱할 수 있었다는 뜻일 뿐입니다. v2rayN에서는 사용할 서버를 선택하고 필요한 경우 「시스템 프록시」를 설정해야 합니다. v2rayNG에서는 노드를 선택한 뒤 연결을 시작해야 합니다. 연결에 실패하면 코어 로그, 노드 유효성, 기기 네트워크를 확인하세요.
직접 수정한 노드는 구독 업데이트 후에도 유지되나요?
구독을 업데이트하면 그룹의 노드가 다시 만들어지거나 교체될 수 있으므로 로컬 수정 사항이 계속 유지된다고 기대하지 마세요. 비교 테스트가 필요하다면 설정을 별도의 수동 노드로 저장한 다음 원래 구독 그룹을 업데이트하세요. 로컬 테스트 설정과 구독 소스 설정이 섞이지 않도록 할 수 있습니다.
구독 URL을 실수로 공유했다면 어떻게 해야 하나요?
제공업체 계정 페이지에서 구독 자격 정보를 재설정하거나 새로 발급한 다음, 각 기기의 구독 그룹 URL을 바꾸고 업데이트하세요. 채팅 메시지만 삭제해도 이미 복사된 링크는 회수할 수 없습니다. 노드 자격 정보도 재설정해야 하는지는 제공업체의 처리 방식에 따라 판단하세요.