vmess:// 또는 vless:// 링크를 받았다면 보통 ‘클립보드에서 가져오기’를 사용합니다. 서비스 제공자가 안내한 구독 주소라면 구독 그룹에 추가한 뒤 업데이트하세요. 이 글은 v2rayN·v2rayNG를 처음 설정하는 사용자를 위해 링크 구조와 가져오기 메뉴, 업데이트 범위, 실패 시 점검 순서를 설명합니다. 먼저 링크 종류를 확인한 다음 알맞은 방법을 선택해 구독 페이지를 노드로, 단일 노드 링크를 구독으로 착각하지 않도록 하세요.
먼저 구분하기: 공유 링크는 설정 스냅샷, 구독 주소는 업데이트 경로
단일 노드 공유 링크는 서버 주소, 포트, 인증 정보, 전송 매개변수를 하나의 텍스트로 묶은 것입니다. 클라이언트가 이를 해석하면 로컬에 노드 항목이 생성됩니다. 링크에는 내보낼 당시의 설정이 담기므로 서버에서 도메인이나 포트, 인증 정보가 바뀌어도 이미 가져온 항목이 자동으로 갱신되지는 않습니다.
구독 주소는 클라이언트가 설정 목록을 요청하는 경로이며, 보통 HTTPS로 시작합니다. 업데이트를 실행하면 클라이언트가 응답을 받아 지원되는 형식으로 노드를 구성합니다. 구독에는 노드가 하나만 있을 수도, 여러 개 있을 수도 있습니다. 노드 수가 많다는 점이 아니라 설정을 다시 가져올 수 있다는 점이 두 방식의 핵심 차이입니다.
구독 그룹: 설정을 계속 가져오기
권장서비스 제공자가 구독을 명시적으로 제공한다면 별도의 그룹으로 저장하는 편이 좋습니다. 이후 해당 그룹에서 업데이트하면 노드를 하나씩 다시 복사할 필요가 없습니다. 장기간 관리하는 경우에 권장하는 방식이며, 구독이 단일 노드보다 본질적으로 더 안전하다는 뜻은 아닙니다.
적합한 경우: 장기간 사용, 여러 노드, 서버 설정이 자주 변경되는 경우
단일 노드 링크: 설정 하나를 빠르게 가져오기
링크 전체를 복사해 가져오면 임시 테스트나 특정 설정의 문제를 확인할 때 편리합니다. 매개변수가 바뀌면 다시 가져오거나 서버 정보를 기준으로 직접 수정해야 합니다.
적합한 경우: 임시 테스트, 직접 구축한 단일 노드, 특정 노드만 공유할 때
판별 방법: 제공자가 안내한 용도부터 확인하기
HTTPS로 시작한다는 이유만으로 구독이라고 판단하지 마세요. 로그인 페이지나 구매 페이지, 구독 API도 HTTPS를 사용할 수 있습니다. ‘구독 주소’로 명확히 표시되어 있고 현재 클라이언트가 지원하는 형식인지 확인한 뒤 복사하세요.
vmess:// 구조: Base64 인코딩은 암호화가 아닙니다
일반적인 VMess 공유 형식은 vmess:// 뒤에 Base64로 인코딩한 JSON을 붙입니다. 아래는 디코딩한 구조를 보여주는 예시이며, 바로 가져올 수 있는 공유 링크도 완전한 코어 실행 설정도 아닙니다. 내보내기 도구에 따라 규칙이 다를 수 있으므로 서비스 제공자가 생성한 호환 링크를 우선 사용하세요.
{
"v": "2",
"ps": "예시 노드",
"add": "node.example.com",
"port": "443",
"id": "7d9d2f80-52a1-4c8e-9c76-5c0d52dd7441",
"aid": "0",
"scy": "auto",
"net": "ws",
"type": "none",
"host": "node.example.com",
"path": "/proxy",
"tls": "tls",
"sni": "node.example.com"
}v의2는 일반적인 공유 형식에서 사용하는 버전 표기입니다. 클라이언트 버전 번호나 VMess 프로토콜 버전을 뜻하지 않습니다.add,port,id는 각각 연결 주소, 서버 포트, 사용자 ID를 나타냅니다. 세 값 모두 서버 설정과 일치해야 합니다.net,host,path는 전송 방식 관련 항목입니다. 이 예시에서는 WebSocket을 사용하며, Host와 경로는 전송 설정을 맞추는 데 쓰이므로 임의로 삭제하거나 수정하면 안 됩니다.tls,sni는 TLS와 서버 이름을 나타냅니다. WebSocket Host와 TLS SNI는 서로 다른 항목입니다. 값이 같더라도 하나의 설정으로 취급하면 안 됩니다.aid예시는 최신 VMess AEAD에서 흔히 사용하는0입니다. 오래된 안내를 따라 이 값을 임의로 높이지 마세요.
vless:// 구조: 쿼리 매개변수도 설정의 일부
VLESS 공유 링크는 보통 URI 구조를 따릅니다. 사용자 ID는 @ 앞에 있고, 그 뒤에 서버, 포트, 쿼리 매개변수, 노드 메모가 차례로 이어집니다. 아래 링크는 항목을 설명하기 위한 예시로 도메인과 인증 정보는 실제 연결에 사용할 수 없습니다.
vless://[email protected]:443?encryption=none&security=tls&type=ws&host=node.example.com&path=%2Fproxy&sni=node.example.com#Example-WSencryption=none은 연결 전체에 전송 보호가 없다는 뜻이 아닙니다. VLESS 자체의 해당 설정을 나타내며, 예시에서는 security=tls도 별도로 지정했습니다. type=ws는 WebSocket을, path=%2Fproxy는 디코딩하면 /proxy가 됩니다. 해시 기호 뒤의 Example-WS는 메모이며 서버 주소에는 영향을 주지 않습니다.
- 복사할 때는 쿼리 매개변수를 모두 유지하세요. 특히
security,type,sni와 전송 경로를 빠뜨리지 마세요. - 메신저에 표시된
&를 정상적인 매개변수 구분자로 사용하지 마세요. 원본 URI에서는 일반&를 사용해야 합니다. flow또는 REALITY 관련 매개변수가 있다면 제공자가 지정한 값을 그대로 유지하세요. 이 글의 WebSocket 예시를 그대로 적용하면 안 됩니다.- UUID 길이가 올바르다는 것은 일반적인 형식에 맞아 보인다는 뜻일 뿐, 인증 정보가 유효하거나 서버에 연결할 수 있다는 증거는 아닙니다.
클립보드에서 가져오기: 데스크톱과 Android에서 사용하는 방법
가져오기 전에 링크 한 줄 전체를 복사하세요. 설명 문구나 따옴표, 메신저에서 생략 표시로 사용한 말줄임표까지 함께 복사하지 마세요. 버전에 따라 메뉴 이름은 다를 수 있습니다. 버튼 이름이 다르면 ‘클립보드’와 ‘가져오기’가 포함된 기능을 찾으세요.
- v2rayN 데스크톱: 링크를 복사하고 메인 창으로 돌아와 ‘서버’ → ‘클립보드에서 일괄 URL 가져오기’를 선택합니다. 일부 버전에서는 ‘클립보드에서 가져오기’로 표시됩니다. 지원되는 버전에서는
Ctrl+V를 사용할 수도 있습니다. 가져온 항목 수를 확인하고 목록에 새 항목이 나타났는지 살펴보세요. - v2rayNG Android: 링크를 복사한 뒤 메인 화면 오른쪽 위의 ‘+’ → ‘클립보드에서 가져오기’를 누릅니다. 시스템에서 클립보드 접근을 허용할지 묻는 경우 출처를 확인하고 이번 작업을 허용하세요.
- 노드 설정 확인: 새 항목의 편집 화면을 열어 서버, 포트, 전송 방식, TLS 설정을 확인하세요. 먼저 매개변수를 점검한 뒤 연결을 테스트해야 가져오기가 성공한 것을 연결 성공으로 오해하지 않습니다.
- 프록시 시작: 노드를 선택하고 시작하세요. v2rayN에서는 사용 환경에 맞게 시스템 프록시나 해당 트래픽 처리 방식을 설정해야 합니다. v2rayNG를 처음 시작할 때는 보통 시스템 VPN 권한을 확인해야 합니다.
VMess와 VLESS는 프로토콜 이름이고 v2rayN과 v2rayNG는 클라이언트 이름이므로 서로 혼동하면 안 됩니다. v2rayNG는 Xray 코어를 사용하고 v2flyNG는 v2fly 코어를 사용합니다. 클라이언트 이름이 비슷하다고 해서 모든 프로토콜과 전송 방식 조합을 서로 바꿔 쓸 수 있는 것은 아닙니다. 특히 서버에 필요한 기능이 현재 코어에서 지원되는지 확인하세요.
구독 추가: 주소를 저장한 뒤 업데이트도 실행하기
구독 관리는 보통 주소 저장과 내용 가져오기의 두 단계로 이루어집니다. 구독 URL만 저장하고 업데이트하지 않으면 그룹이 비어 있을 수 있습니다. 구독 링크에는 토큰이 포함되는 경우가 많고 쿼리 문자열도 인증 정보의 일부입니다. ‘주소를 간단히 정리’하려고 물음표 뒤의 내용을 삭제하지 마세요.
- v2rayN: ‘구독 그룹’ → ‘구독 그룹 설정’으로 이동해 그룹을 추가하고 메모와 구독 주소를 입력한 뒤 저장하세요. 그런 다음 ‘구독 그룹’ 메뉴로 돌아와 해당 구독 업데이트를 선택합니다. 현재 네트워크 환경에 따라 프록시를 통해 가져올지 결정하세요.
- v2rayNG: 오른쪽 위 메뉴에서 ‘구독 그룹 설정’을 열고 구독을 추가해 저장한 다음 메인 화면으로 돌아와 ‘구독 업데이트’를 실행하세요. 버전에 따라 메뉴 위치가 달라질 수 있지만, 설정을 편집하는 메뉴와 실제 업데이트 작업을 구분하는 것이 중요합니다.
- 결과 확인: 업데이트 알림과 소속 그룹, 추가된 노드 수를 확인하세요. 주소가 브라우저에서 열린다고 해서 응답 내용이 클라이언트에서 해석 가능한 구독이라고 단정할 수는 없습니다.
- 업데이트 범위 관리: 출처가 다른 구독은 각각 별도의 그룹으로 만드세요. 업데이트 전 중요한 수동 설정을 백업하고, 로컬에서 변경한 이름이나 포트 등이 다음 업데이트 후에도 유지된다고 가정하지 마세요.
| 확인 항목 | 단일 노드 공유 링크 | 구독 주소 |
|---|---|---|
| 일반적인 시작 부분 | vmess://、vless:// | https://로 시작하지만 용도 확인이 필요합니다 |
| 주요 작업 | 클립보드에서 가져오기 | 구독 그룹을 저장한 다음 업데이트 |
| 원본 설정이 변경된 경우 | 다시 가져오거나 직접 수정 | 다시 가져오며, 실제 변경 내용은 구독 응답에 따라 달라집니다 |
| 자주 발생하는 실패 원인 | 링크 잘림, 인코딩 손상, 지원되지 않는 매개변수 | 네트워크 시간 초과, 토큰 만료, 호환되지 않는 응답 형식 |
여러 기기에서 사용하기: 구독 공유가 모든 설정 동기화를 뜻하지는 않습니다
서비스 약관에서 허용하는 기기 범위 내라면 같은 구독 주소를 각 기기에 추가할 수 있지만, 클라이언트마다 설정을 별도로 저장하고 업데이트합니다. Windows에서 업데이트해도 Android에서 업데이트가 실행되지는 않습니다. 라우팅 규칙, 시스템 프록시, 앱별 프록시, 현재 선택한 노드도 구독 주소가 같다는 이유만으로 자동으로 일치하지 않습니다.
설정 방법: 노드 출처는 공유하고 트래픽 설정은 별도로 관리하기
데스크톱: v2rayN
- 같은 서비스 제공자의 구독을 별도 그룹으로 만드세요.
- 업데이트 후 현재 선택한 노드가 여전히 있는지 확인하세요.
- 시스템 프록시와 라우팅 분기는 각각 설정하세요.
Android: v2rayNG
- 제공자가 허용한 동일한 구독 주소를 추가하세요.
- 기기에서 업데이트를 실행하고 VPN 권한을 확인하세요.
- 앱별 프록시와 백그라운드 실행 제한을 별도로 확인하세요.
구독은 노드 설정을 제공할 뿐, 두 기기의 라우팅과 권한, 실행 상태를 동기화하지 않습니다. 노드 목록이 같은지는 업데이트 시점과 클라이언트 호환성에도 달려 있습니다.
임시 노드 하나를 다른 기기에 보내려는 경우 노드 공유 링크나 QR 코드를 내보내면 됩니다. 전체 구독을 노출할 필요는 없습니다. QR 코드는 텍스트를 전달하는 또 다른 방식일 뿐입니다. 스캔한 결과가 단일 노드 링크라면 단일 노드 가져오기를, 구독 주소라면 구독 관리 절차를 이용하세요.
자주 묻는 질문: 안내 메시지로 파싱 오류와 네트워크 오류 구분하기
링크를 복사했는데 유효한 설정이 없다고 표시되는 이유는 무엇인가요?
링크가 vmess:// 또는 vless://로 완전히 시작하는지 먼저 확인하고, 말줄임표나 전각 문장 부호, 불필요한 따옴표가 들어갔는지 살펴보세요. 원본을 얻으려면 제공자 페이지의 복사 버튼을 다시 사용하세요. HTTPS 구독 주소를 복사한 경우에는 구독 그룹에 추가해야 합니다. 단일 노드 가져오기를 반복해서 시도하지 마세요.
구독 업데이트는 성공했는데 노드가 하나도 없는 이유는 무엇인가요?
로그인 페이지나 만료 안내가 반환되지는 않았는지, 현재 클라이언트가 지원하지 않는 설정 형식은 아닌지 확인하세요. 제공자에게 사용할 구독 출력 형식을 확인한 다음 그룹 필터에서 노드가 숨겨졌는지도 살펴보세요. 요청 완료는 가져오기 과정이 끝났다는 뜻일 뿐, 응답에 유효한 노드 목록이 들어 있다는 보장은 아닙니다.
구독 업데이트가 시간 초과되면 ‘프록시를 통해 업데이트’를 켜야 하나요?
현재 네트워크에서 구독 API에 직접 연결할 수 없지만 사용할 수 있는 프록시가 있다면 프록시를 통한 업데이트를 켜고 다시 시도할 수 있습니다. 기존 노드가 모두 작동하지 않는다면 해당 노드로 구독을 요청해도 시간 초과가 날 수 있습니다. 이때는 같은 옵션만 반복해서 바꾸기보다 직접 연결을 다시 테스트하거나 사용할 수 있는 네트워크로 전환하세요.
노드는 가져와지는데 연결할 때 TLS 또는 인증 오류가 표시되는 이유는 무엇인가요?
서버 주소, 포트, 사용자 ID, 전송 방식, SNI 순서로 확인하고 기기 시간이 정확한지도 점검하세요. 예시 포트는 443이지만 실제로는 서버에서 안내한 포트를 사용해야 합니다. 인증서 검증을 끄는 방법을 일반적인 해결책으로 삼지 마세요. 먼저 도메인과 인증서, 서버 설정이 서로 일치하는지 확인하세요.
구독 링크를 실수로 공개 채팅방에 올렸다면 메시지만 삭제하면 되나요?
메시지를 삭제해도 이미 복사된 토큰을 무효화할 수는 없습니다. 제공자의 관리 페이지에서 구독 주소를 재설정하고, 필요하다면 노드 인증 정보도 변경한 뒤 각 기기에 저장된 주소를 업데이트하세요. 문제 해결용 스크린샷에는 오류 메시지와 민감하지 않은 항목만 남기고 전체 URL, 사용자 ID, QR 코드는 노출하지 마세요.
최종 점검 순서는 간단합니다. 먼저 받은 것이 노드인지 구독인지 확인하고, 가져오기나 업데이트가 성공했는지 살펴본 다음, 연결과 트래픽이 프록시를 통과하는지 확인하세요. 단계를 나눠 점검해야 복사 오류를 해결하려고 프로토콜을 바꾸거나 시스템 프록시가 꺼진 문제를 해결하려고 가져오기를 반복하는 일을 피할 수 있습니다.