vmess:// 또는 vless://로 시작하는 단일 링크는 클립보드나 QR 코드로 노드를 가져옵니다. 구독 주소라고 명시된 https:// 링크는 먼저 구독 그룹에 추가한 뒤 업데이트하세요. v2rayN이나 v2rayNG를 처음 설정한다면 아래 메뉴 경로를 따라 진행하고, 필드 대조표를 참고해 가져오기 실패인지 가져온 뒤 연결 실패인지 확인할 수 있습니다.
공유 링크와 구독 링크: 어떤 메뉴로 가져올까
공유 링크에는 노드 설정 하나가 링크 자체에 담겨 있어, 전체 내용을 복사하면 가져올 수 있습니다. 구독 링크는 설정을 가져올 주소이며, 노드 목록을 받으려면 클라이언트가 해당 주소에 요청해야 합니다. 구독에 노드가 하나만 있을 수도 있으므로 목록의 길이로 링크 종류를 판단할 수는 없습니다.
구독 링크: 그룹 전체 업데이트
추천안내에 따라 구독 주소를 그룹에 저장한 다음 업데이트하세요. 이후 노드가 추가·삭제되거나 설정이 바뀌면 보통 해당 그룹을 다시 업데이트하면 됩니다. 구독 주소 자체가 만료됐다면 새 주소로 바꿔야 합니다.
적합한 경우: 같은 출처의 노드 목록을 장기간 사용하며 목록 변경 사항을 반영하고 싶을 때
공유 링크: 현재 설정 하나 가져오기
링크 하나마다 설정 하나가 연결됩니다. 가져온 설정은 보낸 사람의 변경 사항을 자동으로 반영하지 않습니다. 포트나 인증 정보가 바뀌면 새 링크를 받아 다시 가져오거나, 상대방이 제공한 값에 맞춰 기존 항목을 수정하세요.
적합한 경우: 노드 하나를 테스트하거나 다른 기기에 설정 하나만 추가할 때
헷갈린다면 링크 용도부터 확인하세요
https:// 주소가 일반 웹페이지일 수도 있습니다. 보낸 사람이 용도를 표시하지 않았다면 구독 주소인지 웹페이지 주소인지 먼저 확인한 뒤 구독 그룹에 입력하세요. QR 코드도 마찬가지입니다. QR 코드는 텍스트를 담을 뿐이며, 스캔한 결과에 따라 다음 단계가 달라집니다.
v2rayN·v2rayNG에서 클립보드와 QR 코드로 가져오기
vmess:// 또는 vless://부터 시작하는 링크 전체를 먼저 복사하세요. 메시지 제목이나 따옴표, 문장 끝의 문장 부호는 함께 복사하지 마세요. QR 코드로 가져오려면 PC 화면에 QR 코드를 띄우고, 휴대폰 카메라로 스캔할 때는 다른 화면에 QR 코드를 표시하면 됩니다.
같은 공유 링크를 PC와 Android에서 가져오는 방법
PC(v2rayN)
- 메인 화면에서 「서버」를 열고 「클립보드에서 일괄 URL 가져오기」를 선택하세요. 메뉴에 ‘일괄’이라고 표시되어도 링크 하나만 가져올 수 있습니다. 메인 창에서 Ctrl + V 단축키를 지원한다면 목록에 포커스를 둔 상태에서 사용할 수도 있습니다.
- QR 코드로 가져오려면 QR 코드 전체가 화면에 보이도록 한 다음 「서버」→「화면의 QR 코드 스캔」을 선택하세요. 인식되지 않으면 QR 코드를 확대하고 주변 여백을 확보하거나 원본 텍스트 링크를 사용하세요.
Android(v2rayNG)
- 링크를 복사한 뒤 메인 화면으로 돌아가 오른쪽 위의 「+」→「클립보드에서 가져오기」를 누르세요. 앱에서 클립보드 읽기를 요청하면 시스템 안내에 따라 허용하세요.
- 오른쪽 위의 「+」→「QR 코드 스캔」을 누르고 카메라 접근을 허용한 다음, QR 코드 전체를 화면 안에 맞추세요. QR 코드가 휴대폰에만 있다면 다른 기기 화면에 표시하거나 원본 링크를 복사해 가져오세요.
버전에 따라 메뉴의 마지막 문구가 조금 다를 수 있습니다. 가져오기에 성공했다는 안내가 나오면 목록에서 새 항목의 메모와 프로토콜을 확인한 뒤 선택해 테스트하세요. 목록에 표시된다는 것은 설정을 읽었다는 뜻일 뿐입니다.
구독 주소 추가·업데이트·확인 방법
그룹 추가는 주소를 저장하는 작업이고, 그룹 업데이트는 노드를 가져오는 작업입니다. 처음 가져올 때 두 작업을 나눠 진행하면 주소 저장 문제인지 요청 또는 파싱 문제인지 더 쉽게 구분할 수 있습니다.
- v2rayN:「구독 그룹」→「구독 그룹 설정」을 열고 「추가」를 누르세요. 알아보기 쉬운 메모와 구독 주소를 입력해 저장합니다. 메인 화면으로 돌아와 해당 그룹을 선택한 뒤 「구독 그룹」 메뉴에서 「현재 구독 업데이트」를 실행하세요. 네트워크 환경에 따라 프록시 사용 또는 미사용 방식을 선택합니다.
- v2rayNG:왼쪽 위 메뉴에서 「구독 그룹 설정」을 열고 오른쪽 위의 「+」를 누르세요. 메모와 구독 주소를 입력해 저장합니다. 설정 목록으로 돌아와 오른쪽 위의 「⋮」→「구독 업데이트」를 선택하세요. 화면에 그룹 필터가 있다면 해당 그룹으로 전환해 결과를 확인합니다.
- 업데이트 결과 확인:새 항목이 표시되면 출처 안내와 그룹, 메모, 프로토콜이 일치하는지 확인하세요. 메모가 같다는 이유만으로 같은 노드라고 판단하지 마세요. 이름이 같은 항목이라도 서버 주소나 포트가 다를 수 있습니다. 수동으로 추가한 설정과 구독 설정은 따로 관리하는 편이 좋습니다. 수동 변경 사항이 구독 업데이트 후에도 유지된다고 오해하지 않도록 주의하세요.
일부 구독은 여러 줄의 공유 링크를 반환하고, 일부는 여러 줄을 통째로 Base64로 인코딩해 반환합니다. Base64는 인코딩 방식이지 암호화가 아닙니다. 반환된 텍스트를 현재 클라이언트가 모두 파싱할 수 있는 것도 아닙니다. 업데이트 후 유효한 노드가 없다는 안내가 나오면 해당 주소가 로그인 페이지나 다른 형식의 설정이 아니라 클라이언트가 지원하는 구독 형식을 제공하는지 출처에 확인하세요.
VMess·VLESS 공유 링크의 주요 필드
일반적인 VMess 공유 형식은 vmess:// 뒤에 Base64로 인코딩된 JSON이 이어집니다. 흔히 사용하는 VLESS 형식은 주소와 포트를 바로 확인할 수 있으며, 전송 방식과 보안 등의 매개변수는 물음표 뒤의 쿼리 부분에 들어갑니다. 아래는 필드를 확인하기 위한 VLESS 예시입니다. example.com은 예시 도메인이며, 링크 전체는 연결에 사용할 수 없습니다.
vless://[email protected]:443?encryption=none&security=tls&type=ws&path=%2Fdemo#WebSocket
| 용도 | VMess에서 자주 쓰는 JSON 필드 | VLESS에서 자주 쓰는 위치 또는 매개변수 |
|---|---|---|
| 연결 주소와 포트 | add、port | @ 뒤에 오는 서버 주소와 포트 |
| 사용자 식별자 | id(일반적으로 UUID) | 프로토콜 접두사 뒤, @ 앞에 오는 사용자 식별자(일반적으로 UUID) |
| 노드 메모 | ps | # 뒤의 문자열로, 목록에서 노드를 구분할 때 사용 |
| 전송 방식 및 추가 설정 | net. WebSocket을 사용할 때는 host와 path가 포함될 수도 있습니다. | type. 예를 들어 type=ws는 WebSocket을 의미하며, 필요에 따라 host와 path를 함께 설정합니다. |
| 전송 보안 | tls 및 설정에 따라 제공되는 sni | security 및 설정에 따라 제공되는 sni 등의 필드 |
예시의 path=%2Fdemo는 노드 편집 화면에서 보통 /demo로 표시됩니다. 경로가 바뀐 것은 아닙니다. 혼동하기 쉬운 또 다른 부분은 VLESS의 encryption=none과 security=tls가 서로 다른 설정이라는 점입니다. 앞의 값은 VLESS 프로토콜의 암호화 매개변수이고, 뒤의 값은 전송에 TLS를 사용할지 지정합니다. 문제를 확인할 때 두 설정을 하나의 옵션으로 취급하지 말고, 공유 링크의 원격 포트를 클라이언트의 로컬 프록시 포트에 입력하지도 마세요.
가져오기 실패·빈 구독 목록·가져온 뒤 연결 실패 구분하기
링크를 복사했는데 왜 유효한 설정이 없다고 나오나요?
먼저 링크 시작 부분을 확인하세요. 단일 공유 링크라면 채팅창에서 접혀 잘린 텍스트가 아닌 원문 전체를 복사했는지 확인한 뒤 클립보드에서 다시 가져오세요. 구독 주소라고 명시된 링크라면 단일 링크 가져오기를 반복하지 말고 「구독 그룹 설정」에 저장하세요.
QR 코드를 스캔했더니 웹 주소가 나옵니다. 노드를 추가할 수 있나요?
먼저 보낸 사람에게 QR 코드에 구독 주소가 들어 있는지 일반 웹페이지 주소가 들어 있는지 확인하세요. 구독 주소라면 스캔 결과를 복사해 그룹에 직접 추가한 뒤 업데이트하세요. 웹페이지 주소라면 신뢰할 수 있는 출처에서 실제 공유 링크나 구독 주소를 받아야 합니다.
구독을 저장했는데 그룹이 비어 있는 이유는 무엇인가요?
먼저 해당 그룹을 업데이트한 다음 오류 안내를 확인하세요. 시간 초과가 표시되면 현재 네트워크에서 구독 주소에 접근할 수 있는지 확인하세요. 유효한 노드가 없다고 나오면 구독 형식과 링크 만료 여부를 확인합니다. 클라이언트에서 인증되지 않았다고 표시되면 구독이 아직 유효한지 출처에 문의한 뒤 주소를 바꿔 다시 시도하세요.
목록에 노드가 보이는데 테스트가 실패하는 이유는 무엇인가요?
해당 항목의 편집 화면을 열고 주소와 포트부터 확인한 다음 전송 방식, 보안 옵션, 관련 경로 또는 서버 이름을 점검하세요. 같은 출처의 다른 노드는 작동한다면 제공자에게 해당 설정이 변경됐는지 먼저 확인하세요. 클라이언트가 특정 매개변수를 지원하지 않는다고 알리면 현재 버전과 코어가 해당 전송 방식 또는 보안 설정을 지원하는지 확인하세요.