링크 접두사를 확인한 뒤 알맞은 가져오기 메뉴를 선택하세요. vmess://와 vless://는 일반적으로 단일 노드의 연결 정보를 담고, 구독 URL은 업데이트 가능한 노드 목록을 가져오는 데 사용됩니다. v2rayN이나 v2rayNG를 처음 설정한다면 링크 확인, 클립보드 가져오기, 구독 업데이트, 문제 해결 순서로 진행하세요. 변경하면 안 되는 항목도 함께 설명합니다.
공유 링크와 구독 URL: 가져오는 대상이 다릅니다
공유 링크는 연결 설정을 텍스트로 나타낸 것입니다. 흔히 쓰이는 vmess:// 링크는 접두사 뒤에 Base64로 인코딩된 설정을 담으며, 디코딩하면 보통 서버 주소, 포트, 사용자 ID, 전송 방식, 이름이 포함됩니다. vless://는 URI 형식을 사용하는 경우가 많습니다. 본문에 사용자 ID와 주소, 포트를 두고 나머지 옵션은 쿼리 매개변수로 전달합니다. 두 링크 모두 브라우저에서 여는 일반 웹페이지가 아닙니다.
구독 URL은 보통 https://로 시작합니다. 클라이언트가 이 주소로 요청을 보내고 응답으로 받은 노드 목록을 파싱합니다. 응답은 한 줄에 공유 링크 하나씩 나열한 형식일 수도 있고, 해당 텍스트를 Base64로 인코딩한 형식일 수도 있습니다. 구체적인 형식은 제공업체가 결정합니다. 구독 응답에 노드가 하나만 포함될 수도 있으므로 노드 수만으로 구독 여부를 판단할 수는 없습니다.
구독 URL
추천노드 목록을 업데이트할 출처를 등록합니다. 제공업체가 주소를 변경하거나 노드를 추가해도 클라이언트에서 구독 업데이트를 완료해야 변경 사항을 받을 수 있습니다. 주소를 저장했다고 실시간으로 동기화되는 것은 아닙니다.
적합한 경우: 제공업체가 클라이언트용 구독 URL을 제공하고, 노드 목록을 지속적으로 관리해야 할 때
단일 공유 링크
현재 노드 설정을 가져옵니다. 서버에서 포트, 사용자 ID 또는 전송 설정을 변경해도 기존 설정은 자동으로 바뀌지 않으므로 다시 가져오거나 직접 수정해야 합니다.
적합한 경우: 노드 하나를 임시로 테스트하거나 관리자로부터 개별 연결 설정을 받았을 때
판단 기준: 먼저 제공업체가 안내한 용도를 확인하세요
vmess:// 또는 vless:// 링크를 받았다면 공유 링크 가져오기를 사용하세요. HTTPS 주소를 받았다면 로그인 페이지, 구매 페이지, 안내 페이지가 아니라 구독 URL인지 먼저 확인한 뒤 구독 그룹에 추가하세요.
링크 매개변수: 서버 포트와 로컬 포트를 혼동하지 마세요
아래는 구조를 설명하기 위한 VLESS 예시입니다. 도메인과 사용자 ID는 설명용이며 실제로 사용할 수 있는 서비스와 연결되지 않습니다. 실제 링크에는 제공업체가 안내한 전체 매개변수를 사용해야 합니다. 예시를 노드 설정으로 그대로 사용하지 마세요.
vless://[email protected]:443?encryption=none&security=tls&type=ws&host=node.example.com&path=%2Fproxy&sni=node.example.com#demo-ws
| 필드 | 예시 설명 | 가져올 때 확인할 항목 |
|---|---|---|
node.example.com:443 | 서버 주소 및 원격 포트 | 로컬 프록시 수신 포트로 바꾸지 마세요. |
encryption=none | VLESS 프로토콜 매개변수 | 연결 전체가 암호화되지 않는다는 뜻은 아닙니다. 예시에서는 TLS로 전송을 보호합니다. |
security=tls | TLS 전송 보안 사용 | 서버 요구 사항에 맞게 설정하고 인증서 검증을 임의로 끄지 마세요. |
type=ws | WebSocket 전송 사용 | 전송 유형, Host, 경로가 서버 설정과 일치해야 합니다. |
path=%2Fproxy | URL 인코딩된 경로 /proxy | 원본 링크의 인코딩을 유지하고 메신저가 서식을 바꾼 텍스트로 대체하지 마세요. |
sni | TLS 핸드셰이크에 사용하는 서버 이름 | 연결 주소와 다를 수 있으므로 함부로 삭제하지 마세요. |
#demo-ws | 노드 이름 | 목록에서 노드를 구별하기 위한 이름이며 계정 비밀번호가 아닙니다. |
VMess와 VLESS는 프록시 프로토콜이고, WebSocket은 전송 방식, TLS는 전송 보안 계층입니다. 공유 링크를 인식한다고 해서 선택한 코어가 모든 옵션을 지원하는 것은 아닙니다. v2rayNG는 Xray 코어를, v2flyNG는 V2Fly 코어를 사용합니다. 제공업체가 특정 Xray 기능을 요구한다면 링크가 vless://로 시작하는지만 볼 것이 아니라 클라이언트와 코어의 지원 여부를 먼저 확인하세요.
v2rayN에서 가져오기: 클립보드와 구독 그룹은 별도로 관리
데스크톱에서는 전체 텍스트를 복사한 뒤 목적에 맞는 메뉴를 선택하세요. 아래 메뉴 이름은 일반적인 중국어 UI 기준입니다. 버전이나 데스크톱 환경에 따라 문구가 조금 다를 수 있지만, 공유 링크 가져오기와 구독 업데이트는 별개의 작업입니다. 장기간 사용할 목록에 테스트 노드가 섞이지 않도록 작업 전에 현재 그룹 이름을 확인해 두는 것이 좋습니다.
단일 또는 여러 개의 공유 링크
vmess://또는vless://로 시작하는 전체 링크를 복사하세요. 설명, 따옴표, 코드 블록 표시는 포함하지 마세요. 여러 링크는 보통 한 줄에 하나씩 넣어 한꺼번에 복사할 수 있습니다.- v2rayN을 열고 「서버」 메뉴에서 「클립보드에서 공유 링크 가져오기」를 선택하세요. 이 단축키를 지원하는 데스크톱 버전이라면 메인 창에서
Ctrl+V를 눌러도 됩니다. - 추가된 항목의 주소, 포트, 프로토콜, 전송 방식을 확인하세요. 이름이 비어 있어도 가져오기에 실패한 것은 아닐 수 있지만, 주소나 사용자 ID가 누락됐다면 원본 링크를 다시 확인해야 합니다.
- 사용할 노드를 선택해 활성 서버로 지정하세요. 그다음 필요에 따라 시스템 프록시를 설정합니다. 목록에 가져왔다는 것은 설정이 추가됐다는 뜻일 뿐, 앱 트래픽이 프록시를 통과한다는 의미는 아닙니다.
구독을 추가하고 노드 목록 가져오기
- 제공업체가 구독용이라고 명시한 URL을 복사하세요. 「구독 그룹」→「구독 그룹 설정」으로 이동해 그룹을 추가합니다.
- 알아보기 쉬운 그룹 이름을 입력하고 주소 필드에 전체 URL을 붙여 넣은 뒤 저장하세요. 업데이트 옵션이 표시된다면 해당 그룹의 업데이트가 허용되어 있는지 확인합니다.
- 「구독 그룹」으로 돌아가 현재 그룹 또는 모든 구독을 업데이트하세요. 메뉴에서 「프록시 사용 안 함」과 「프록시 사용」을 선택할 수 있다면 구독 URL에 실제로 접속할 수 있는 방식에 맞춰 선택합니다.
- 그룹에 노드가 표시되는지 확인하고 업데이트 결과를 살펴보세요. 그룹 이름만 있고 항목이 없다면 다운로드와 파싱 문제부터 확인하세요. 같은 이름의 그룹을 반복해서 만들지 마세요.
v2rayNG에서 가져오기: 설정을 추가한 뒤 VPN 연결
안드로이드에서 클립보드로 가져오는 작업도 설정을 추가할 뿐입니다. 처음 연결을 시작할 때 시스템에서 VPN 연결 권한을 요청합니다. 이 권한은 클라이언트가 선택한 트래픽을 처리하도록 허용하는 것이며 구독 로그인과는 다릅니다. 먼저 목록을 가져온 다음 라우팅이나 앱별 설정을 조정하면 여러 옵션을 동시에 바꿔 문제를 찾기 어려워지는 일을 줄일 수 있습니다.
- 공유 링크: 전체 링크를 복사해 v2rayNG를 열고 메인 화면 오른쪽 위의 「+」→「클립보드에서 가져오기」를 누르세요. 가져온 뒤 노드 정보를 확인하고 해당 노드를 선택합니다.
- 구독 URL: 사이드 메뉴에서 「구독 설정」을 열고 「+」를 누른 뒤 이름과 URL을 입력해 저장하세요. HTTPS 구독 URL을 단일 노드의 서버 주소 입력란에 붙여 넣지 마세요.
- 목록 업데이트: 설정 메인 화면으로 돌아가 오른쪽 위 메뉴에서 「구독 업데이트」를 선택하세요. 업데이트가 끝날 때까지 기다린 다음 해당 구독 그룹에 항목이 표시되는지 확인합니다.
- 연결 시작: 연결 버튼을 누르고 처음 사용하는 경우 시스템 권한 요청을 승인하세요. 먼저 대상 앱을 테스트한 뒤 필요에 따라 앱별 프록시와 라우팅 규칙을 조정합니다.
두 기기에서 사용하기: 같은 구독을 각각 저장하고 업데이트
데스크톱: v2rayN
- 구독 그룹 설정에서 주소를 저장합니다.
- 업데이트 후 활성 서버를 선택합니다.
- 시스템 프록시를 지원하는 앱에 프록시를 설정합니다.
안드로이드: v2rayNG
- 구독 설정에서 같은 주소를 별도로 추가합니다.
- 설정 목록에서 구독을 업데이트합니다.
- VPN 연결을 시작한 뒤 앱의 접속 상태를 확인합니다.
각 기기는 설정을 따로 관리합니다. 업데이트가 성공해야 각 기기에서 요청한 목록을 가져올 수 있습니다. 또한 제공업체가 여러 기기에서의 사용을 허용하는지 확인하세요.
구독에는 노드 설정만 포함되며 클라이언트의 라우팅 프리셋, DNS 설정, 시스템 프록시 스위치, 앱별 규칙까지 포함되는 것은 아닙니다. 따라서 두 기기에서 같은 구독을 사용해도 로컬 설정이 다르면 동작이 달라질 수 있습니다. 기기를 옮길 때는 노드 출처와 로컬 설정을 따로 기록하세요. 구독을 한 번 업데이트하면 모든 설정이 복사된다고 생각해서는 안 됩니다.
업데이트 실패 및 빈 목록: 요청, 응답 내용, 연결을 차례로 확인
먼저 문제가 어느 단계에서 발생했는지 확인하세요. 요청 시간 초과는 클라이언트가 제때 응답을 받지 못했다는 뜻입니다. 파싱 실패는 응답은 받았지만 지원되는 설정으로 변환하지 못했다는 의미입니다. 노드를 가져왔는데 연결되지 않는다면 서버 매개변수, 코어 지원 여부, 네트워크 경로를 확인해야 합니다. 세 문제는 해결 방법이 각각 다릅니다.
구독 URL을 복사했는데 클립보드에서 가져오면 설정이 없다고 나오는 이유는 무엇인가요?
HTTPS 주소는 구독 설정에 추가한 뒤 업데이트해야 합니다. vmess://, vless:// 등의 공유 링크만 단일 노드 가져오기 메뉴에서 처리할 수 있습니다. 제공업체가 웹페이지 주소를 안내했다면 페이지에서 실제 클라이언트용 구독 URL을 확인해야 합니다.
구독 업데이트가 계속 시간 초과됩니다. 프록시를 사용해야 하나요?
먼저 사용할 수 있는 노드가 있고 프록시 연결이 시작된 상태인지 확인한 뒤 프록시를 통한 업데이트를 시도하세요. 연결할 수 있는 노드가 없다면 직접 연결 상태, 주소 만료 여부, 제공업체 서비스 상태를 확인해야 합니다. 「프록시 사용」을 모든 문제를 해결하는 스위치처럼 여기지 마세요.
업데이트 성공으로 표시되는데 노드 수가 여전히 0이면 어떻게 해야 하나요?
현재 그룹의 필터 조건을 확인한 다음 로그에 파싱 실패가 기록되어 있는지 살펴보세요. 구독 API가 로그인 페이지, 계정 만료 안내 또는 클라이언트가 지원하지 않는 형식으로 응답할 수 있습니다. 제공업체에 v2rayN 또는 v2rayNG에서 사용할 수 있는 구독 형식인지 확인하세요. 먼저 클라이언트를 다시 설치할 필요는 없습니다.
VLESS를 가져왔는데도 연결되지 않는 이유는 무엇인가요?
주소, 원격 포트, 사용자 ID, 전송 유형, SNI, 경로를 확인하세요. 링크가 REALITY를 사용한다면 공개 키, shortId 및 제공업체가 요구하는 관련 매개변수도 점검하고, 사용하는 Xray 코어가 이를 지원하는지 확인해야 합니다. 원본 링크를 보관하고 모르는 필드를 임의로 삭제하지 마세요.
다시 업데이트한 뒤 수동으로 수정한 노드가 원래대로 돌아가는 이유는 무엇인가요?
구독을 업데이트하면 원격 응답을 바탕으로 그룹 내 항목이 다시 만들어질 수 있습니다. 수동 변경 내용을 계속 보관해야 한다면 구독에서 관리하지 않는 별도 그룹에 저장하고 변경 이유를 기록하세요. 구독 그룹에서 임시로 수정한 내용이 계속 유지된다고 기대하지 마세요.
HTTP 상태 코드로 원인을 좁혀 볼 수도 있습니다. 401 또는 403이면 접근 권한, 구독 토큰, 제공업체 제한을 확인해야 하는 경우가 많습니다. 404라면 경로가 여전히 유효한지 확인하세요. 429는 요청 빈도 제한이 적용됐을 가능성을 뜻하므로 연속으로 새로고침하지 마세요. 구체적인 원인은 API 응답과 제공업체 안내를 기준으로 확인해야 하며, 상태 코드만으로 계정이 만료됐다고 단정해서는 안 됩니다.
구독 정보 보호와 관리: 전체 링크는 자격 증명처럼 취급하세요
공유 링크의 사용자 ID와 구독 URL의 토큰은 접근 권한을 부여할 수 있습니다. Base64는 인코딩 방식이지 비밀을 보호하는 암호화가 아닙니다. 전체 링크를 공개 채팅방이나 문의 게시물에 올리거나 온라인 디코더에 입력하면 제3자가 설정을 확인할 수 있습니다. 문제를 문의할 때는 민감한 값을 가린 항목과 오류 정보만 제공하세요.
- 복사 전: 신뢰할 수 있는 출처에서 주소를 가져오고 대소문자, 쿼리 매개변수, URL 인코딩을 그대로 유지하세요. 공백이나 한국어 문장 부호를 추가하지 마세요.
- 업데이트 전: 그룹, 현재 사용할 수 있는 노드, 업데이트 방식을 확인하세요. 실패가 반복되면 먼저 로그를 확인하고 업데이트 버튼을 연속으로 누르지 마세요.
- 문의 시: 전체 사용자 ID, 구독 토큰, QR 코드를 가리세요. 로그에 전체 요청 URL이 표시된다면 먼저 민감한 값을 가려야 합니다.
- 유출된 경우: 제공업체 계정에서 구독 토큰이나 연결 자격 증명을 재설정한 뒤 저장된 주소를 모든 기기에서 업데이트하세요. 채팅 기록만 삭제해도 이미 복사된 자격 증명이 무효화되지는 않습니다.
- 기기 이전 시: 구독, 활성 노드, 시스템 프록시 또는 VPN 연결, 라우팅 설정을 각각 확인하고 실제 앱에서 정상적으로 접속되는지 점검하세요.
작업 순서: 가져오기, 업데이트, 선택, 연결, 확인
단일 공유 링크는 구독 업데이트를 건너뛰면 됩니다. 구독 URL은 먼저 노드 목록을 가져와야 합니다. 한 번에 한 단계씩 진행하고 오류가 나면 해당 단계의 로그를 기록한 뒤 링크 형식, 네트워크 경로, 노드 매개변수 중 무엇을 확인할지 결정하세요.