vmess://, vless:// 또는 구독 주소를 받았지만 가져오기 방법을 모르는 사용자에게 적합합니다. 단일 노드 링크와 구독 주소를 구분하고, 주요 필드를 이해한 뒤 v2rayN과 v2rayNG에서 올바른 가져오기 메뉴를 선택하며 업데이트 주기에 맞는 저장 방식을 정할 수 있습니다.
먼저 단일 노드 링크와 구독 주소를 구분하세요
vmess:// 또는 vless://로 시작하는 텍스트는 일반적으로 하나의 노드 공유 링크입니다. 서버에 필요한 주소, 포트, 사용자 식별자, 전송 방식과 보안 설정을 담습니다. 클라이언트에서 가져오면 설정 항목 하나가 생성되며, 이후 서버 설정이 바뀌어도 기존 항목이 자동으로 업데이트되지는 않습니다.
구독 주소는 보통 https://로 시작하며, 요청할 수 있는 원격 리소스입니다. 클라이언트가 해당 주소에 접속하면 하나 이상의 노드 정보를 받아 구독 그룹으로 저장합니다. 서버에서 노드를 추가·삭제하거나 도메인과 포트를 변경하면 구독 업데이트를 실행해 원격 목록을 로컬에 다시 동기화할 수 있습니다.
단일 노드 공유 링크
한 번에 명확한 설정 하나를 가져오며, 링크 안에 매개변수가 고정되어 테스트·이전·임시 노드 추가에 편리합니다.
적합한 경우: 노드 하나만 사용하거나 매개변수를 항목별로 확인해야 할 때
구독 주소
추천클라이언트가 원격 목록을 주기적으로 요청하므로 노드 이름, 서버 주소, 포트와 전송 설정을 한곳에서 관리할 수 있습니다.
적합한 경우: 장기간 사용하거나 여러 기기에서 동기화하고 여러 노드를 전환할 때
설정 수동 입력
프로토콜, 주소, 포트와 전송 계층 필드를 항목별로 입력하는 방식으로, 공유 링크가 올바르게 해석되었는지 확인할 때 적합합니다.
적합한 경우: 필드를 디버깅하거나 일부 매개변수만 수정할 때
| 판단 기준 | 공유 링크 | 구독 주소 |
|---|---|---|
| 일반적인 시작 부분 | vmess://、vless:// | https:// |
| 담고 있는 내용 | 노드 하나의 연결 설정 | 원격 노드 목록을 가리키는 주소 |
| 업데이트 방식 | 다시 가져와 재등록 | 구독 그룹에서 업데이트 실행 |
| 가져오기 결과 | 서버 항목 하나 생성 | 서버 항목 묶음 생성 또는 갱신 |
결론: 프로토콜 접두사를 먼저 확인하고 가져오기 메뉴를 선택하세요
텍스트가 vmess:// 또는 vless://로 바로 시작하면 ‘클립보드에서 가져오기’를 사용하세요. https://로 시작하고 제공자가 구독 주소라고 명시했다면 구독 그룹에 추가해야 합니다. 두 종류의 주소를 같은 입력란에 넣고 반복해서 시도하지 마세요.
vmess://와 vless://에는 각각 무엇이 저장되나요?
일반적인 VMess 공유 링크는 JSON 설정을 인코딩한 뒤 vmess:// 뒤에 붙입니다. 인코딩은 여러 필드를 복사하기 쉽게 만들 뿐, 매개변수를 숨기는 기능은 아닙니다. 클라이언트는 디코딩 후에도 서버 주소, 포트, 사용자 ID, 전송 네트워크, 경로, TLS와 서버 이름 등의 필드를 읽어야 합니다.
다음은 구조를 설명하기 위한 VMess 디코딩 예시입니다. 예시 도메인과 사용자 ID는 문서용일 뿐 실제 연결에는 사용할 수 없습니다. add는 서버 주소, port는 원격 포트입니다. net과 path는 WebSocket 전송을 함께 설명하며, tls와 sni는 TLS 연결에 사용됩니다.
{
"v": "2",
"ps": "문서 예시 노드",
"add": "edge.example.com",
"port": "443",
"id": "00000000-0000-4000-8000-000000000000",
"aid": "0",
"scy": "auto",
"net": "ws",
"type": "none",
"host": "edge.example.com",
"path": "/ray",
"tls": "tls",
"sni": "edge.example.com"
}
VLESS 공유 링크는 표준 URI에 더 가깝습니다. 사용자 ID는 @ 앞에, 서버 주소와 포트는 그 뒤에 오며 전송 및 보안 매개변수는 쿼리 문자열에 기록됩니다. 해시 뒤의 텍스트는 노드 이름으로 사용됩니다. 필드가 그대로 표시되므로 포트, 전송 유형과 경로를 점검할 때 보통 더 직관적입니다.
vless://[email protected]:443?encryption=none&security=tls&type=ws&host=edge.example.com&path=%2Fray&sni=edge.example.com#문서 예시 노드
| 필드 | 의미 | 주요 확인 사항 |
|---|---|---|
| address / add | 서버 도메인 또는 IP 주소 | 공백이 중복으로 복사되지 않았는지, 도메인이 여전히 해석되는지 확인 |
| port | 원격 수신 포트 | 1~65535 범위여야 하며 서버 설정과 일치해야 함 |
| id | VMess 또는 VLESS 사용자 식별자 | 문자가 완전한지, 메신저에서 잘리지 않았는지 확인 |
| type / net | TCP, WebSocket, gRPC 등의 전송 유형 | 유형을 변경하면 경로와 서비스 이름 등 관련 필드도 함께 변경해야 함 |
| security | TLS, Reality 또는 기타 보안 방식 | 서버의 실제 설정과 일치해야 함 |
| sni | TLS 핸드셰이크에 사용하는 서버 이름 | 노드 메모만으로 추측하지 말고 제공자가 지정한 값을 사용해야 함 |
v2rayN과 v2rayNG에서 올바르게 가져오기
가져오기 전에 원본 텍스트 전체를 복사하세요. 메신저에 표시된 일부만 선택하지 마세요. 링크에는 물음표, 등호, 퍼센트 기호와 해시가 포함될 수 있으며, 어느 한 부분이라도 잘리면 해석에 실패하거나 전송 설정이 빠진 구성이 생성될 수 있습니다. 다음 메뉴 이름은 v2rayN 7.14.3 및 v2rayNG 1.10.31의 일반적인 화면을 기준으로 합니다.
v2rayN에서 단일 노드 링크 가져오기
vmess://또는vless://링크 전체를 복사합니다.- v2rayN 메인 창을 열고 ‘서버’ → ‘클립보드에서 일괄 URL 가져오기’를 선택합니다.
- 서버 목록에서 새 항목을 찾아 프로토콜, 주소, 원격 포트와 메모 이름을 확인합니다.
- 해당 항목을 선택해 활성 서버로 지정한 뒤, 하단 로그 창에 설정 해석 오류나 코어 시작 오류가 표시되는지 확인합니다.
- 로컬 수신 포트를 확인하려면 ‘설정’ → ‘매개변수 설정’으로 이동해 로컬 포트가 다른 프로그램과 중복되지 않는지 확인합니다.
v2rayN에 구독 주소 추가
- ‘구독 그룹’ → ‘구독 그룹 설정’을 엽니다.
- 그룹을 추가하고 알아보기 쉬운 별칭을 입력한 다음, 완전한 HTTPS 구독 주소를 주소 입력란에 붙여 넣습니다.
- 저장한 뒤 ‘구독 그룹’ 메뉴를 열고 해당 그룹에서 ‘구독 업데이트’를 실행합니다.
- 업데이트가 끝나면 노드 수와 업데이트 시간을 확인하세요. 기존 수동 노드는 일반적으로 이 작업으로 구독 노드로 바뀌지 않습니다.
v2rayNG에서 링크 또는 구독 가져오기
- 단일 노드 링크: 링크를 복사한 뒤 오른쪽 위의 더하기 메뉴를 열고 ‘클립보드에서 구성 가져오기’를 선택합니다.
- 구독 주소: 왼쪽 위 메뉴를 열고 ‘구독 그룹 설정’으로 이동한 다음 그룹을 추가하고 구독 주소를 입력합니다.
- 메인 화면으로 돌아와 구독 업데이트를 실행하고 노드 목록이 갱신될 때까지 기다린 후, 항목 하나를 선택해 연결을 시작합니다.
- 시스템에서 로컬 연결 서비스 허용 여부를 묻는 경우 시스템 안내에 따라 확인해야 합니다. 그렇지 않으면 클라이언트가 전달이 필요한 트래픽을 처리할 수 없습니다.
결론: 가져오기에 성공했다고 설정을 사용할 수 있는 것은 아닙니다
목록에 노드가 나타났다는 것은 링크가 해석되었다는 뜻일 뿐입니다. 원격 포트, 전송 유형, TLS 또는 Reality 매개변수를 확인하고 코어 로그에서 핸드셰이크 단계의 시간 초과, 도메인 해석 실패와 포트 충돌이 없는지 확인해야 합니다.
공유 링크와 구독은 각각 언제 사용하나요?
선택 기준은 노드 수 자체가 아니라 설정을 누가 관리하고 얼마나 자주 바뀌는지입니다. 직접 관리하는 서버의 주소가 오래 고정된다면 공유 링크가 명확한 설정을 보관하기에 편리합니다. 원격에서 노드를 통합 관리하고 접속 지점이 바뀔 수 있다면 구독이 장기적인 관리 방식에 더 적합합니다.
추천 방식: 장기 구독과 임시 노드를 분리해 저장하세요
데스크톱 v2rayN
- 장기 노드는 별도 구독 그룹에 저장
- 임시 테스트 링크는 수동 노드로 가져오기
- 업데이트 후 지연 시간과 로그를 기준으로 사용 가능 여부 재확인
Android v2rayNG
- 동일한 유효 구독 주소 사용
- 임시 링크는 클립보드에서 별도로 가져오기
- 그룹에 명확한 이름을 지정해 출처를 실수로 삭제하지 않도록 하기
구독 항목과 수동 항목을 분리해 관리하면 구독 업데이트 후 임시 노드가 덮어써졌다고 오해하는 일을 줄일 수 있고, 각 설정의 출처도 쉽게 확인할 수 있습니다.
새 노드 하나만 확인하려면 공유 링크를 직접 가져오는 편이 빠릅니다. 테스트할 때는 원래 메모를 먼저 보존하고 서버 주소, 포트와 전송 설정을 확인하세요. 사용 가능 여부를 확인한 뒤 로컬 메모를 바꿀 수 있지만, 메모 이름을 프로토콜 설정으로 간주해서는 안 됩니다. 노드 이름에 ‘TLS’나 ‘고속’이라고 적혀 있어도 실제 설정 필드를 대신할 수 없습니다.
여러 기기에서 사용할 때 구독을 이용하면 반복 입력을 줄일 수 있습니다. v2rayN과 v2rayNG에 같은 구독 주소를 각각 저장할 수 있지만, 로컬 라우팅, 시스템 프록시와 앱 트래픽 처리 설정은 양쪽에서 별도로 관리해야 합니다. 구독은 노드 목록만 동기화하며 ‘로컬 네트워크 우회’, ‘앱별 프록시’ 또는 로컬 수신 포트 같은 클라이언트 설정은 동기화하지 않습니다.
| 사용 상황 | 권장 방식 | 이유 |
|---|---|---|
| 새 설정 하나를 임시로 테스트 | 공유 링크 | 가져오기 경로가 짧고 각 매개변수를 바로 확인할 수 있음 |
| 노드를 한곳에서 추가·삭제하거나 포트를 변경 | 구독 주소 | 업데이트를 실행하면 새 원격 목록을 받을 수 있음 |
| 고정 서버를 직접 관리 | 공유 링크 또는 수동 설정 | 매개변수 변경이 드물어 세밀하게 관리하기 쉬움 |
| 데스크톱과 Android에서 같은 노드 그룹 사용 | 구독 주소 | 항목별 복사를 줄일 수 있지만 양쪽 로컬 설정은 별도로 구성해야 함 |
| 특정 노드가 연결되지 않는 원인 확인 | 단일 노드 항목 | 구독 업데이트와 다른 노드의 영향을 분리할 수 있음 |
해석 실패, 빈 목록과 중복 노드 문제 해결
해석 문제는 코어를 계속 바꾸기보다 원본 입력부터 확인해야 합니다. 먼저 복사한 것이 노드 링크인지 구독 주소인지 확인하고, 링크가 완전한지와 클라이언트 버전이 해당 프로토콜 및 전송 방식을 지원하는지 점검하세요. 브라우저에서 구독 주소가 열린다고 해서 반환 내용이 클라이언트가 인식할 수 있는 노드 목록이라는 뜻은 아닙니다. 로그인 페이지, 오류 페이지와 만료 안내가 일반 웹 페이지 형태로 반환될 수도 있습니다.
vmess://를 붙여 넣었는데 형식 오류가 표시되면 어떻게 하나요?
링크 전체를 다시 복사하고 시작 부분, 끝 부분과 중간 문자가 모두 같은 줄에 있는지 확인하세요. 그래도 실패하면 클라이언트를 업데이트한 뒤 다시 가져오고, 설정 제공자에게 링크를 새로 생성해 달라고 요청하세요. 인코딩된 내용을 직접 덧붙여 수정하지 마세요.
vless://를 가져왔지만 시작하자마자 오류가 발생하면 어떻게 하나요?
노드 편집 창을 열고 security, type, sni, path 또는 serviceName을 항목별로 확인하세요. VLESS 링크 구문이 인식되었다고 해서 현재 코어가 링크에 선언된 모든 전송 매개변수를 지원하는 것은 아닙니다.
구독 업데이트 후 노드 목록이 비어 있으면 어떻게 하나요?
먼저 구독 주소가 만료되지 않았는지 확인한 다음 업데이트 안내와 클라이언트 로그를 확인하세요. 로그인 페이지나 오류 페이지가 반환된다면 구독 접근 조건을 복구한 후 다시 업데이트해야 하며, 해당 주소를 단일 노드 가져오기로 바꾸지 마세요.
업데이트할 때마다 중복 노드가 생기면 어떻게 하나요?
같은 주소를 여러 구독 그룹에 추가했는지, 또는 구독에 포함된 노드를 먼저 수동으로 가져왔는지 확인하세요. 유효한 구독 그룹 하나만 남기고 중복으로 확인된 수동 항목을 삭제한 뒤 다시 업데이트합니다.
노드는 시작되지만 웹 페이지에 접속할 수 없으면 어떻게 하나요?
v2rayN에서는 시스템 프록시 모드를, v2rayNG에서는 연결 상태를 확인한 뒤 DNS, 핸드셰이크 시간 초과 또는 로컬 포트 충돌이 로그에 표시되는지 확인하세요. 예를 들어 10808 로컬 포트를 다른 프로그램이 사용 중이라면 ‘설정’ → ‘매개변수 설정’에서 변경한 후 코어를 다시 시작합니다.
- 먼저 입력 유형을 확인하세요. 프로토콜 링크는 클립보드에서 가져오고 HTTPS 구독은 구독 그룹으로 가져옵니다.
- 그다음 해석 결과를 확인하세요. 프로토콜, 주소, 포트, 사용자 ID와 전송 계층 필드가 빠져서는 안 됩니다.
- 이후 코어 시작 상태를 확인하세요. 로그에 지원되지 않는 설정 필드나 로컬 포트 사용 중이라는 오류가 없어야 합니다.
- 마지막으로 연결 경로를 확인하세요. DNS 해석, TCP 연결, TLS 핸드셰이크와 앱 프록시 설정을 구분해 점검합니다.
저장·업데이트·공유 시 지켜야 할 범위
공유 링크와 구독 주소에는 서버 연결에 사용할 수 있는 접근 정보가 포함될 수 있으므로 계정 자격 증명처럼 다뤄야 합니다. 전체 내용을 공개 스크린샷, 로그 게시물 또는 검색 가능한 문서에 넣지 마세요. 다른 사람에게 문제 해결을 요청할 때는 프로토콜 이름, 전송 유형과 오류 메시지를 남기되 사용자 ID, 도메인, 구독 주소와 기타 식별 정보를 가리세요.
구독을 업데이트하기 전에 현재 사용 가능한 노드의 이름, 원격 포트와 업데이트 시간을 기록해 둘 수 있습니다. 업데이트 후 많은 노드가 사라지면 먼저 올바른 그룹을 선택했는지와 원격 응답이 정상인지 확인하세요. 같은 주소를 즉시 반복해서 추가하지 마세요. 구독 그룹을 삭제하기 전에는 보관해야 할 로컬 항목이 포함되어 있지 않은지도 확인해야 합니다.
- 내용을 받으면 먼저 접두사를 확인하고 출처와 용도를 파악하세요.
- 알맞은 메뉴로 가져오고, 웹 브라우저 주소창에서 프로토콜 링크를 열려고 하지 마세요.
- 가져온 후 주요 필드를 확인하고 코어를 시작한 다음 로그를 읽으세요.
- 장기 노드는 구독 그룹에 넣고 임시 노드는 별도 항목으로 보관하세요.
- 새로운 프로토콜 필드와 전송 매개변수를 해석할 수 있도록 클라이언트를 정기적으로 업데이트하세요.
최종 판단: 업데이트 방식에 따라 저장 방법이 달라집니다
설정을 원격에서 계속 관리한다면 구독을 사용하고, 매개변수가 고정되어 한 번만 가져오거나 항목별 디버깅이 필요하다면 공유 링크를 사용하세요. 어떤 방식을 선택하든 가져온 뒤 프로토콜, 포트, 전송과 보안 필드를 확인해야 하며, 노드 이름이나 목록 표시 여부만으로 사용 가능하다고 판단해서는 안 됩니다.