링크 앞부분을 보고 가져오기 메뉴를 선택하세요. vmess://·vless://는 노드 가져오기를, 서비스 제공자가 안내한 HTTPS 구독 주소는 구독 그룹에 입력합니다. v2rayNG나 v2rayN을 처음 사용하는 독자를 위해 링크 확인, 클립보드 가져오기, QR 코드 스캔, 구독 업데이트, 오류 해결 순으로 살펴봅니다. 구독 URL을 노드로 착각하거나, 가져오기에 성공한 것을 연결 성공으로 오해하지 않도록 주의하세요.
1. 단일 노드 공유 링크와 구독 주소의 차이는 업데이트 방식
단일 노드 공유 링크에는 서버 주소, 포트, 사용자 ID, 전송 설정 등이 포함됩니다. 가져온 뒤에는 당시 설정이 클라이언트에 저장되므로, 이후 서비스 제공자가 포트나 인증서 도메인을 바꿔도 독립 노드는 자동으로 바뀌지 않습니다. 공유 링크를 여러 줄 복사해 여러 노드를 가져올 수는 있지만, 구독이 생성되는 것은 아닙니다.
HTTPS 구독 주소
권장클라이언트가 주소에서 설정을 가져온 다음 해당 구독 그룹의 노드 목록을 새로 고칩니다. 서비스 제공자가 구독을 명시적으로 제공하고 노드 목록을 계속 관리해야 할 때 적합합니다.
추천 용도: 장기간 사용, 여러 노드 관리, 서비스 제공자의 정기적인 설정 변경
vmess:// 또는 vless:// 단일 노드 링크
링크 자체에 노드 설정이 담겨 있습니다. 서버 하나를 먼저 테스트하거나 소수의 설정을 직접 관리할 때 적합하며, 구독 그룹을 미리 만들 필요가 없습니다.
추천 용도: 일시적인 테스트, 자체 서버, 노드 설정 하나만 전달받은 경우
HTTPS는 웹 주소의 전송 방식일 뿐, 해당 주소가 반드시 구독 주소라는 뜻은 아닙니다. 계정 관리 페이지, 로그인 페이지, 설치 안내 페이지도 HTTPS로 시작할 수 있습니다. 브라우저 주소창의 관리 페이지 URL이 아니라 서비스 제공자가 '구독 주소'로 안내한 URL을 복사하세요. 구독 응답은 Base64로 인코딩된 공유 링크 목록일 수도 있고 다른 형식일 수도 있습니다. 클라이언트의 실제 지원 여부를 확인하세요.
요점: 계속 업데이트하려면 구독으로 등록하세요
서비스 제공자가 '노드 복사'와 '구독 복사'를 모두 제공한다면, 평소에는 구독 주소를 구독 그룹에 저장해 관리하세요. 노드를 따로 테스트할 때만 독립 노드를 추가로 가져오면 됩니다.
2. vmess://·vless:// 링크의 매개변수 구조 알아보기
일반적인 VMess 공유 형식은 vmess:// 뒤에 Base64로 인코딩된 JSON이 이어집니다. 인코딩은 암호화가 아니므로 디코딩하면 대개 add, port, id, net, tls 등의 필드를 확인할 수 있습니다. 아래는 디코딩된 구조의 예시입니다. 이 JSON을 vmess:// 공유 링크로 가져오거나 완전한 코어 설정으로 실행할 수는 없습니다.
{
"v": "2",
"ps": "VMess-WS-TLS 예시",
"add": "node.example.com",
"port": "443",
"id": "d34db33f-1234-4abc-8def-0123456789ab",
"aid": "0",
"scy": "auto",
"net": "ws",
"type": "none",
"host": "edge.example.com",
"path": "/ws",
"tls": "tls",
"sni": "edge.example.com"
}
여기서 add는 연결 주소, host는 WebSocket 요청에 사용하는 Host, sni는 TLS 핸드셰이크에 사용하는 서버 이름입니다. 값이 서로 다를 수 있지만 서버 설정과 일치해야 합니다. aid는 VMess의 alterId 필드이며 포트가 아닙니다. 예시의 0은 최신 설정에서 흔히 사용하는 값이므로, 서비스 제공자의 설정을 추측으로 바꾸지 마세요.
VLESS 공유 링크는 보통 URI에 매개변수가 직접 포함됩니다. 아래는 TCP와 TLS를 사용하는 구조만 보여 주는 예시입니다. 도메인과 UUID는 설명용이며 실제로 연결할 수 있는 서버 정보가 아닙니다.
vless://[email protected]:443?encryption=none&security=tls&type=tcp&sni=edge.example.com#VLESS-TLS
encryption=none은 VLESS 프로토콜 자체의 암호화 설정을 뜻합니다. 예시에서는security=tls로 TLS를 사용하므로, 이를 근거로 전송 계층 보호가 없다고 판단하면 안 됩니다.type=tcp는 전송 유형이 TCP라는 뜻입니다. 임의로ws로 바꿔도 서버가 WebSocket을 지원하게 되는 것은 아닙니다.#뒤에는 보통 노드 이름이 들어갑니다. 이름은 URL 인코딩할 수 있으며, 공백은 흔히%20으로 표기합니다. 복사할 때 쿼리 매개변수를 빠짐없이 포함하세요.- REALITY를 사용하는 링크에는
pbk,sid,fp등의 매개변수가 포함될 수도 있습니다. 링크 전체를 가져오고 현재 클라이언트와 코어가 해당 기능을 지원하는지 확인하세요.
3. v2rayNG에서 클립보드나 QR 코드로 노드 가져오기
안드로이드에서 v2rayNG를 사용할 때는 링크 전체를 복사한 뒤 메인 화면으로 돌아오세요. 아래는 일반적인 한국어 UI 명칭을 기준으로 설명합니다. 버전에 따라 메뉴 이름이 조금 다를 수 있으므로 '클립보드에서 가져오기', 'QR 코드 스캔' 같은 기능을 찾아 선택하세요.
- 링크 복사:
vmess://또는vless://부터 링크 끝까지 복사하세요. 채팅 메시지의 따옴표나 설명, Markdown 코드 블록은 포함하지 마세요. 긴 링크가 화면에서 자동 줄 바꿈되어도 복사에는 문제가 없지만, 중간에 공백이나 줄 바꿈이 들어가면 링크가 손상될 수 있습니다. - 클립보드에서 가져오기: v2rayNG 메인 화면 오른쪽 위의 「+」→「클립보드에서 가져오기」를 누르세요. 시스템에서 클립보드 접근을 허용한 다음 노드 목록에 새 항목이 나타났는지 확인합니다. 링크가 여러 개라면 보통 한 줄에 하나씩 정리하세요.
- 설정 확인: 노드 편집 화면에서 주소, 포트, 사용자 ID, 전송 방식, TLS 설정을 대조하세요. 먼저 값을 확인하고, 테스트에 성공하도록 임의로 설정을 바꾸지는 마세요.
- QR 코드 스캔: 「+」→「QR 코드 스캔」을 선택하고 카메라 권한을 허용한 뒤 다른 화면에 표시된 QR 코드 전체를 스캔하세요. 테두리의 여백이 잘리지 않게 하고 반사를 줄여 코드 전체가 화면에 들어오도록 하세요.
- 연결 및 확인: 새 노드를 선택하고 메인 화면의 시작 버튼을 누르세요. 처음 실행할 때 안드로이드 VPN 연결 요청을 승인한 다음, 정상적으로 열리는 HTTPS 페이지에 접속해 확인합니다.
QR 코드는 텍스트를 담는 방식일 뿐, 내용의 종류를 결정하지 않습니다. vless://를 스캔하면 보통 노드를 추가할 수 있지만, HTTPS 주소가 나오면 구독인지 일반 웹페이지인지 먼저 확인하세요. '스캔 완료'만으로 사용할 수 있는 노드가 생성됐다고 판단할 수는 없습니다. 같은 휴대전화에 QR 코드가 표시된 경우에는 제공자의 링크 복사 기능을 우선 사용하세요. 스캔 화면에서 이미지 인식을 지원한다면 갤러리에서 이미지를 선택해도 됩니다.
서버 포트와 로컬 수신 포트는 서로 다른 곳에 사용됩니다. 공유 링크의 :443은 원격 서버의 포트이고, 로컬 SOCKS 포트는 기기의 앱이 이용합니다. 링크의 포트를 10808로 바꾸지 마세요. 로컬 포트가 10808이 아니라고 노드가 잘못된 것도 아닙니다.
4. v2rayN에서 가져오기 및 양쪽 클라이언트 설정 확인
데스크톱 v2rayN에서는 「서버」 메뉴에서 「클립보드에서 일괄 URL 가져오기」를 선택할 수 있으며, 일반적인 단축키는 Ctrl+V입니다. 가져오기 전에 메인 창을 활성화하세요. 입력란에 커서가 있으면 단축키가 텍스트 붙여넣기로만 동작할 수 있습니다. 가져온 뒤 서버 목록에서 사용할 노드를 선택해 활성 서버로 지정하세요.
작업 방법: 같은 링크를 양쪽 클라이언트에서 각각 확인
데스크톱 v2rayN
- 「서버」→「클립보드에서 일괄 URL 가져오기」
- 목록에서 주소, 포트, 전송 유형을 확인합니다.
- 브라우저 연결을 확인할 때는 시스템 프록시 메뉴에서 「시스템 프록시 자동 설정」을 선택합니다.
안드로이드 v2rayNG
- 「+」→「클립보드에서 가져오기」
- TLS, SNI, 전송 매개변수가 모두 있는지 확인합니다.
- 연결을 시작하고 안드로이드 VPN 권한 요청을 승인합니다.
같은 노드를 양쪽 클라이언트에 각각 가져올 수 있습니다. 라우팅, 앱별 프록시, 로컬 수신 설정은 공유 링크와 함께 자동으로 동기화되지 않습니다.
가져오기에 성공했다는 것은 클라이언트가 설정을 인식했다는 뜻일 뿐입니다. v2rayN에서 코어만 실행하고 시스템 프록시를 설정하지 않았다면 시스템 프록시를 사용하는 브라우저도 노드를 거치지 않을 수 있습니다. 시스템 프록시를 따르지 않는 앱은 별도로 설정해야 합니다. v2rayNG에서 앱별 프록시를 사용하면 제외한 앱은 예상대로 프록시를 거치지 않습니다. 테스트 전에 대상 앱의 트래픽이 어떤 경로를 사용하는지 확인하세요.
5. 구독 주소를 먼저 저장한 뒤 업데이트하기
구독은 '주소—그룹—노드' 관계를 설정하는 것이 핵심입니다. HTTPS 구독 URL을 단일 노드 가져오기 메뉴에 붙여 넣으면 인식되지 않을 수 있고, 일부 버전에서는 구독 처리로 넘어갈 수도 있습니다. 확인을 쉽게 하려면 구독 설정 메뉴에서 주소를 추가하세요.
- v2rayNG: 사이드 메뉴에서 「구독 그룹 설정」을 열고 추가를 누른 뒤, 알아보기 쉬운 이름과 서비스 제공자가 안내한 구독 URL을 입력해 저장하세요. 메인 화면으로 돌아와 오른쪽 위 메뉴에서 「구독 업데이트」를 실행합니다. 그룹이 여러 개라면 현재 그룹만 업데이트할지 전체 그룹을 업데이트할지 확인하세요.
- v2rayN: 「구독 그룹」→「구독 그룹 설정」을 열고 그룹을 추가한 뒤 구독 주소를 입력하세요. 저장하고 「구독 그룹」 메뉴로 돌아와 해당 그룹의 구독 업데이트를 선택합니다.
- 업데이트 경로 선택: v2rayN 메뉴에는 보통 '프록시 사용 안 함'과 '프록시 사용'이 구분되어 있습니다. 구독 주소에 직접 접속할 수 있다면 먼저 직접 연결을 사용하세요. 직접 연결이 시간 초과되고 사용할 수 있는 노드가 있다면 프록시를 통한 업데이트를 시도해 보세요. v2rayNG의 업데이트 경로는 현재 버전에서 제공하는 설정을 확인하세요.
- 결과 확인: 업데이트 알림, 노드 수, 소속 그룹을 확인한 다음 현재 선택된 노드가 여전히 작동하는지 점검하세요. 서비스 제공자가 노드를 삭제하거나 교체했다면 기존 선택을 다시 지정해야 할 수 있습니다.
업데이트에 실패하면 먼저 오류 유형을 확인하세요. 시간 초과는 요청이 제때 완료되지 않았다는 뜻인 경우가 많습니다. HTTP 401 또는 403이면 토큰, 계정 권한, 접속 제한을 확인하세요. 로그인 페이지가 표시되면 복사한 주소가 관리 페이지가 아니라 구독 API인지 확인해야 합니다. 문제를 확인하는 동안 업데이트를 반복해서 실행하지 말고 서비스 제공자가 요청 횟수를 제한하는지 먼저 살펴보세요.
6. 가져오기 실패 및 인터넷 연결 문제 해결
vless://를 복사했는데 형식 오류가 뜨는 이유는 무엇인가요?
일반 텍스트로 다시 복사한 뒤 시작 부분이 빠지지 않았는지, UUID가 온전한지, 주소 뒤에 올바른 포트가 있는지, 물음표 뒤의 매개변수가 모두 포함됐는지 확인하세요. 메신저가 링크 앞부분만 클릭 가능한 링크로 인식할 때가 있으므로 링크 제목만 복사하지 말고 '전체 복사'를 사용하세요.
QR 코드는 스캔했는데 목록에 새 노드가 없나요?
스캔 결과의 콘텐츠 유형을 확인하세요. 일반 웹 주소는 노드로 사용할 수 없으며, 구독 주소는 구독 그룹에 입력해야 합니다. QR 코드가 너무 촘촘하다면 원본 이미지를 사용하거나 다른 화면에서 표시 크기를 키우세요. 압축된 미리보기 이미지를 반복해서 스캔하지 마세요.
가져오기는 됐는데 연결한 뒤 웹페이지가 열리지 않나요?
먼저 로그에 인증 오류, TLS 핸드셰이크 오류, 연결 시간 초과가 있는지 확인하세요. 사용자 ID, 서버 포트, SNI, WebSocket 경로를 하나씩 점검합니다. VMess에서는 시스템 시간도 확인하세요. v2rayN은 시스템 프록시 설정을 확인하고, v2rayNG는 VPN이 시작됐는지와 대상 앱이 제외되어 있는지 확인합니다.
구독 업데이트 후 수동으로 수정한 노드 설정이 원래대로 돌아간 이유는 무엇인가요?
구독을 새로 고치면 서비스 제공자가 보내는 내용에 따라 노드가 다시 만들어지거나 업데이트됩니다. 직접 설정할 매개변수를 먼저 기록한 다음 독립 노드로 저장하세요. 다음 업데이트 전에 해당 노드가 새로 고침 대상 구독 그룹에 속하지 않는지 확인합니다.
구독 QR 코드를 다른 사람에게 보내 확인을 부탁해도 되나요?
원본 이미지는 보내지 마세요. QR 코드에는 구독 주소 전체가 들어 있는 경우가 많아 접속 토큰까지 함께 노출될 수 있습니다. 도움을 요청할 때는 개인정보를 가린 오류 로그와 클라이언트 버전, 메뉴 조작 경로를 제공하세요. 주소 전체가 이미 유출됐다면 서비스 제공자의 관리 페이지에서 구독 토큰을 재설정하세요.
7. 가져온 뒤 확인할 순서
DNS, 라우팅, 전송 방식, 포트를 한꺼번에 바꾸지 마세요. 한 번에 한 종류씩 확인해야 링크가 손상된 것인지, 구독을 가져오지 못한 것인지, 설정은 가져왔지만 트래픽이 프록시로 전달되지 않는 것인지 구분할 수 있습니다. 아래 순서대로 확인하면 반복해서 삭제하고 재설치하는 것보다 원인을 찾기 쉽습니다.
- 먼저 출처 확인: 받은 것이 완전한 공유 링크나 실제 구독 주소인지 확인하고, 웹페이지 제목을 복사하지 않았는지 살펴봅니다.
- 다음은 내용 확인: 주소, 포트, 사용자 ID, 전송 방식, 보안 매개변수를 확인하고 제공된 원래 값을 유지합니다.
- 그다음 실행 상태 확인: 활성 노드, 코어 실행 상태, 시스템 프록시 또는 안드로이드 VPN 상태를 확인합니다.
- 마지막으로 요청 확인: HTTPS 페이지에 접속하고 해당 로그를 확인합니다. 노드에 연결되더라도 모든 도메인의 트래픽이 같은 경로로 나가는 것은 아닙니다. 필요하면 라우팅과 DNS도 따로 점검하세요.
클라이언트 설치 및 첫 가져오기
클라이언트가 아직 설치되지 않았다면 운영체제에 맞는 v2rayN 또는 v2rayNG를 선택하세요. 단계별 사용법은 입문 가이드에서 확인할 수 있습니다.