처음 구독 주소를 받았거나 가져온 뒤 서버가 보이지 않는 사용자를 위한 안내입니다. v2rayN과 v2rayNG의 전체 설정 경로, 업데이트 방법, 주요 링크 형식과 단계별 문제 해결 순서를 다룹니다. 설정을 마치면 두 클라이언트에서 같은 구독 소스로 노드 목록을 관리할 수 있습니다.
가져오기 전에 구독 링크와 단일 노드 링크 구분하기
구독 링크는 보통 https://로 시작하는 주소입니다. 클라이언트가 이 주소에 접속하면 서버에서 설정 묶음을 반환하며, Base64로 인코딩된 여러 줄의 노드 링크일 수도 있고 클라이언트가 인식하는 구조화된 구독 형식일 수도 있습니다. 구독의 핵심은 링크 길이가 아니라 다시 요청해 전체 노드 목록을 업데이트할 수 있다는 점입니다.
vmess://, vless://, trojan://, ss://는 일반적으로 단일 서버 설정을 뜻합니다. 클라이언트에 바로 가져올 수 있지만 자동으로 업데이트되는 구독 그룹이 되지는 않습니다. vless:// 링크 하나를 ‘구독 주소’ 입력란에 붙여 넣으면 가져오기 실패, 빈 결과 또는 파싱된 노드 수 0이 표시될 수 있습니다.
HTTPS 구독 주소
권장여러 노드를 한 번에 관리하고 클라이언트에서 수동 또는 예약 새로고침을 할 수 있어, PC와 Android 기기의 목록을 일관되게 유지하기 좋습니다.
적합한 경우: 장기 사용, 여러 노드, 기기 간 동기화
단일 노드 공유 링크
하나의 VMess, VLESS, Trojan 또는 Shadowsocks 노드를 직접 지정합니다. 가져오기는 빠르지만 서버 매개변수가 바뀌면 다시 받아야 합니다.
적합한 경우: 임시 추가, 단일 항목 테스트, QR 코드 전달
Base64 텍스트 콘텐츠
여러 공유 링크를 인코딩한 텍스트인 경우가 많습니다. 일반적으로 전체 인코딩 문자열을 직접 복사하기보다 클라이언트가 구독 주소를 통해 가져오도록 해야 합니다.
적합한 경우: 클라이언트가 자동으로 읽고 파싱하는 방식
아래 세 줄의 예시는 외형상의 차이만 보여 줍니다. 예시 도메인과 매개변수는 형식 식별용일 뿐 직접 연결할 수 없습니다. 실제 구독 주소는 설정 서비스 제공자가 발급하며, 보통 계정과 연결된 경로 또는 접근 매개변수를 포함합니다.
https://sub.example.com/client/account-a
vmess://eyJ2IjoiMiIsInBzIjoiZXhhbXBsZSJ9
vless://[email protected]:443?security=tls&type=ws#Examplev2rayN에서 구독 추가하기
아래 경로는 v2rayN 7.x 중국어 인터페이스를 기준으로 합니다. 7.x의 세부 버전에 따라 버튼 위치는 조금 다를 수 있지만 핵심 순서는 같습니다. 먼저 구독 그룹을 만든 다음 업데이트하고, 마지막으로 서버를 선택해 시스템 프록시를 활성화합니다. 그룹에 주소만 저장한다고 노드가 즉시 생성되지는 않습니다.
그룹 열기
v2rayN을 실행한 뒤 메인 화면 상단에서 「구독 그룹」→「구독 그룹 설정」으로 이동합니다. 창이 좁으면 해당 메뉴가 같은 이름의 메뉴 안에 들어 있을 수 있습니다.
구독 추가
「추가」를 클릭하고 별칭에 알아보기 쉬운 이름을 입력한 다음, 주소 입력란에 전체
https://구독 링크를 붙여 넣습니다. 붙여 넣은 뒤 앞뒤에 공백이나 줄바꿈이 섞이지 않았는지 확인하세요.설정 저장
그룹이 활성화된 상태인지 확인하고 저장합니다. 코어를 바꿔야 한다면 「설정」→「매개변수 설정」→「Core 유형」으로 이동하세요. 일상적으로 VLESS, VMess 등의 설정을 사용할 때는 보통 Xray 코어를 선택합니다.
구독 업데이트
메인 화면으로 돌아가 「구독 그룹」→「모든 구독 업데이트(프록시 사용 안 함)」를 선택합니다. 현재 네트워크에서 기존 연결을 통해서만 구독 주소에 접근할 수 있다면 프록시를 통한 업데이트를 시도하세요.
서버 선택
노드가 나타나면 대상 서버를 더블클릭하거나 마우스 오른쪽 메뉴에서 활성 서버로 지정합니다. 그런 다음 트레이 메뉴에서 시스템 프록시 모드를 선택하세요. 일반적인 테스트는 먼저 「시스템 프록시 자동 설정」을 사용하면 됩니다.
로그 확인
연결한 뒤 로그 영역을 열어 코어가 정상적으로 시작되었고 포트 충돌, 설정 파싱 또는 도메인 조회 오류가 없는지 확인합니다. v2rayN의 로컬 혼합 프록시 포트는 흔히
10808이지만, 실제 값은 「설정」→「매개변수 설정」의 로컬 포트를 기준으로 해야 합니다.
업데이트가 끝나면 먼저 서버 목록에 새 항목이 추가되었는지 확인하고, 그룹 열에 방금 만든 구독이 표시되는지 확인하세요. 목록이 비어 있는 문제와 노드 연결 실패는 서로 다른 문제입니다. 전자는 구독 가져오기와 파싱을 먼저 확인하고, 후자는 서버 주소, 전송 방식, TLS, REALITY, 공개 키 또는 네트워크 연결성을 점검해야 합니다.
- 목록이 전혀 바뀌지 않음: 그룹 설정만 저장한 것이 아니라 ‘구독 업데이트’를 실행했는지 확인하세요.
- 시간 초과 표시: ‘프록시 사용 안 함’과 ‘프록시 사용’ 업데이트 방식을 바꿔 보고 로그의 요청 대상을 확인하세요.
- 파싱된 노드 수가 0: 단일 노드 링크, 웹 로그인 주소 또는 이미 만료된 구독 주소를 잘못 입력하지 않았는지 확인하세요.
- 노드는 있지만 숨겨짐: 서버 필터 입력을 지우고 현재 표시 중인 구독 그룹을 확인하세요.
v2rayNG에서 구독 추가하기
v2rayNG는 Xray 코어를 사용하며, 구독 관리와 단일 노드 가져오기는 서로 다른 메뉴에 있습니다. 구독은 ‘구독 그룹 설정’으로 추가하고, 클립보드 가져오기와 QR 코드 스캔은 단일 vmess:// 또는 vless:// 설정에 적합합니다. v2rayNG 1.10.x 인터페이스를 기준으로 하며, 먼저 구독을 저장한 뒤 직접 새로고침해야 합니다.
주소 복사
제공 페이지에서 전체 구독 링크를 복사합니다. 링크가 길어도 나누어 선택하지 마세요. 복사한 뒤 일반 텍스트 입력란에서
https://로 시작하는지 확인하고 실수로 포함된 공백을 삭제할 수 있습니다.구독 메뉴 열기
v2rayNG를 열고 왼쪽 상단 메뉴를 펼친 뒤 「구독 그룹 설정」으로 이동합니다. 오른쪽 상단의 「+」를 눌러 새 구독 기록을 추가합니다.
입력 후 저장
메모에 출처 이름을 입력하고 선택 주소 입력란에 구독 링크를 붙여 넣습니다. 활성화 상태를 유지한 채 저장하세요. 메모는 로컬 식별용일 뿐 노드 매개변수는 바꾸지 않습니다.
목록 업데이트
메인 화면으로 돌아가 오른쪽 상단 메뉴를 열고 「구독 업데이트」를 선택합니다. 하단 안내가 완료될 때까지 기다린 뒤 메인 목록의 설정 수와 그룹 이름을 확인하세요.
연결 시작
설정 하나를 눌러 현재 노드로 지정한 다음 하단 연결 버튼을 누릅니다. 처음 시작할 때는 시스템 연결 요청을 확인하고, 상태 영역에 실행 중이라는 안내가 나타난 뒤 접속을 테스트하세요.
업데이트 후에도 이전 노드가 표시되면 먼저 「구독 그룹 설정」으로 다시 들어가 현재 편집 중인 그룹이 활성화된 그룹인지 확인하고 주소가 잘리지 않았는지 점검하세요. 이후 메인 화면으로 돌아가 「구독 업데이트」를 다시 실행합니다. 앱 데이터를 모두 삭제하면 로컬 설정도 함께 지워지므로 첫 번째 문제 해결 방법으로 사용해서는 안 됩니다.
권장 구성: 두 기기에서 하나의 구독 사용
데스크톱(v2rayN)
- 일반적인 VMess 및 VLESS 설정을 Xray 코어로 처리
- 「구독 그룹」에서 출처를 저장하고 업데이트 주기 설정
- 로그에서 로컬
10808등의 포트가 정상적으로 수신 대기 중인지 확인
Android(v2rayNG)
- 동일한 전체 구독 주소 추가
- 메인 화면에서 「구독 업데이트」를 직접 실행
- 앱별 프록시가 필요할 때만 앱별 프록시 설정
두 기기에서 같은 구독 소스를 사용하면 서버에서 노드를 변경한 뒤 각각 새로고침하면 됩니다. 다만 클라이언트의 라우팅, 현재 선택한 노드와 로컬 설정은 각 기기에 따로 저장됩니다.
‘구독 공유’는 클라이언트 상태가 실시간으로 동기화된다는 뜻이 아닙니다. v2rayN에서 선택한 활성 노드가 v2rayNG를 자동으로 제어하지 않으며, 데스크톱의 라우팅 규칙도 Android로 자동 복사되지 않습니다. 구독은 주로 서버 설정을 동기화하고, 시스템 프록시·앱별 프록시·DNS·라우팅 분기는 기기 환경에 맞춰 각각 설정해야 합니다.
VMess, VLESS, Base64 구독이란?
VMess 공유 링크는 흔히 vmess:// 뒤에 Base64 텍스트가 이어지는 형태입니다. 디코딩된 내용에는 주소, 포트, 사용자 식별자, 전송 방식, TLS 등의 필드가 포함됩니다. 이는 여러 노드가 아니라 하나의 노드를 설명합니다. 일부 구형 형식은 전체 JSON 데이터를 링크에 인코딩하므로 육안으로 각 매개변수를 확인하기 어렵습니다.
VLESS 링크는 일반적인 URI 형식에 더 가깝습니다. 사용자 식별자는 호스트 이름 앞에 있고 포트는 도메인 뒤에 이어지며, 전송·보안·흐름 제어 매개변수는 쿼리 문자열에 들어갑니다. 흔한 필드로 type=ws, type=grpc, security=tls, security=reality, flow=xtls-rprx-vision 등이 있습니다. 이러한 필드는 서버 설정과 일치해야 하므로 연결 실패만으로 임의 변경해서는 안 됩니다.
| 콘텐츠 형태 | 일반적인 의미 | 올바른 가져오기 메뉴 | 전체 업데이트 가능 여부 |
|---|---|---|---|
https:// 주소 |
구독 요청 주소 또는 설정 API | 구독 그룹 설정 | 대체로 가능 |
vmess:// |
단일 VMess 노드 | 클립보드에서 가져오기 또는 QR 코드 스캔 | 불가능 |
vless:// |
단일 VLESS 노드 | 클립보드에서 가져오기 또는 QR 코드 스캔 | 불가능 |
| 연속된 Base64 문자 | 인코딩된 노드 묶음 또는 노드 데이터 | 기존 구독 주소를 통한 가져오기 우선 | 구독 출처가 유지되는지에 따라 다름 |
Base64는 텍스트 인코딩 방식이며 프록시 프로토콜이 아니고 연결 기능도 제공하지 않습니다. 구독 응답이 Base64로 인코딩되어 있으면 클라이언트가 먼저 텍스트로 복원한 뒤 VMess, VLESS, Trojan 또는 Shadowsocks 링크를 줄 단위로 인식합니다. 일부 구독 응답은 Base64를 사용하지 않고 구조화된 설정을 직접 반환하기도 합니다. 호환 여부는 서버 출력 형식과 클라이언트의 파싱 기능에 따라 달라집니다.
가져온 설정을 사용할 수 있는지 확인하는 방법
구독 업데이트 성공은 클라이언트가 콘텐츠를 가져와 파싱했다는 뜻일 뿐, 모든 노드가 연결된다는 의미는 아닙니다. ‘노드 표시, 코어 시작, 로컬 프록시를 통한 트래픽 흐름, 대상 요청 성공’ 순서로 확인하고 메인 화면의 상태 색상만 보지 마세요.
- 노드 수 확인: 업데이트 전후 목록을 비교해 최소한 구독 그룹 아래에 서버 항목이 나타나는지 확인하세요.
- 노드 매개변수 확인: 프로토콜, 주소, 포트와 전송 유형이 완전한지 확인하세요. VLESS REALITY 설정에는 서버 이름, 공개 키, 짧은 식별자 등 필수 필드도 있어야 합니다.
- 코어 시작 확인: v2rayN 로그에 설정 로드와 로컬 수신 대기 정보가 표시되어야 하며, 포트 충돌이나 설정 필드 오류가 계속 나타나서는 안 됩니다.
- 트래픽 처리 방식 확인: v2rayN은 용도에 따라 시스템 프록시 또는 TUN을 활성화해야 하며, v2rayNG는 시작 후 시스템 연결 상태가 표시되어야 합니다.
- 라우팅 결과 확인: 일부 웹사이트만 열리지 않는다면 구독을 즉시 다시 만들지 말고 라우팅 규칙과 DNS를 확인하세요.
v2rayN의 10808은 흔히 로컬 혼합 프록시 포트로 사용되지만, 사용자가 설정을 바꾸면 다른 값이 될 수 있습니다. 브라우저 수동 프록시, 명령줄 도구 또는 로컬 네트워크 기기가 여전히 이전 포트를 가리키면 클라이언트는 연결된 것처럼 보여도 요청이 통과하지 않습니다. 「설정」→「매개변수 설정」에서 현재 표시된 로컬 포트를 기준으로 설정하세요.
지연 시간 테스트도 실제 연결을 대신할 수는 없습니다. 일부 서버는 탐색 요청을 제한해 지연 테스트 결과가 비어도 실제 웹 요청은 작동할 수 있습니다. 반대로 탐색 응답은 빠르지만 TLS, 전송 경로 또는 라우팅 문제로 실제 전송이 실패할 수도 있습니다. 코어 로그와 실제 요청 한 번을 함께 확인하는 것이 더 확실합니다.
먼저 구독에서 노드가 파싱되었는지 확인하고, 다음으로 코어가 시작되었는지 확인합니다. 그 뒤 시스템 프록시 또는 Android 연결 상태를 확인하고 마지막으로 DNS와 라우팅을 점검하세요. 한 번에 하나의 설정만 바꾸고 변경 전후 로그를 남기면 반복해서 삭제하고 다시 가져오는 것보다 빠르게 원인을 찾을 수 있습니다.
구독 업데이트 실패 및 노드가 표시되지 않을 때의 해결 방법
구독 문제는 대체로 세 단계 중 하나에서 발생합니다. 주소 자체를 사용할 수 없거나, 클라이언트가 응답을 받지 못했거나, 콘텐츠는 받았지만 파싱하지 못한 경우입니다. 먼저 구독 설정에서 전체 주소를 다시 복사한 뒤 오류 메시지에 따라 시간 초과, 비정상 HTTP 상태, 파싱 실패를 구분하면 모든 문제를 노드 회선 탓으로 돌리는 일을 피할 수 있습니다.
구독 업데이트가 시간 초과로 실패하나요?
v2rayN에서는 먼저 「구독 그룹」→「모든 구독 업데이트(프록시 사용 안 함)」를 시도하세요. 사용 가능한 노드가 있다면 프록시를 통한 업데이트로 바꿔 보세요. v2rayNG는 현재 네트워크를 바꾼 뒤 재시도하고 시스템 시간이 정확한지도 확인하세요.
저장에는 성공했지만 목록이 비어 있나요?
구독을 저장하는 것은 그룹을 만드는 단계일 뿐입니다. 메인 화면으로 돌아가 「구독 업데이트」를 실행해야 합니다. 업데이트 후 필터 입력 내용을 지우고 해당 그룹으로 전환해 확인하세요. 파싱된 노드 수가 0이면 입력한 것이 단일 vmess:// 또는 vless:// 링크인지 확인합니다.
반환된 콘텐츠를 파싱할 수 없다고 표시되는 이유는?
구독 주소가 로그인 페이지, 만료 안내 페이지 또는 일반 웹페이지를 반환하는 경우가 흔한 원인입니다. 출처 페이지에서 클라이언트용 구독 주소를 다시 복사하세요. 브라우저의 계정 센터 주소를 복사하거나 QR 코드 이미지 주소를 구독 주소로 사용해서는 안 됩니다.
업데이트 후에도 이전 노드가 남아 있는 이유는?
먼저 이전 노드가 다른 구독 그룹 또는 수동 가져오기 그룹에 속한 것인지 확인하세요. v2rayN에서는 그룹 열로 필터링하고, v2rayNG에서는 설정이 어느 구독에 속하는지 확인할 수 있습니다. 출처를 확인하기 전에는 항목을 하나씩 삭제하지 마세요.
연결은 됐는데 웹페이지가 열리지 않나요?
v2rayN에서는 시스템 프록시가 활성화되었는지 확인하고 「설정」→「매개변수 설정」의 로컬 포트를 점검하세요. v2rayNG에서는 연결 상태와 앱별 프록시 범위를 확인합니다. 이후 코어 로그에서 DNS, 핸드셰이크와 라우팅 오류를 살펴보세요.
오류 메시지에 401 또는 403이 포함되면 일반적으로 구독 접근 매개변수가 만료되었거나 권한이 변경되었거나 요청 조건이 충족되지 않았다는 뜻입니다. 404는 경로가 변경되었을 가능성이 높고, 5xx는 응답 서버에 일시적인 문제가 있음을 의미합니다. 이런 상태에서는 클라이언트 코어와 로컬 포트를 반복해서 바꿔도 도움이 되지 않으므로 현재 유효한 구독 주소를 먼저 받아야 합니다.
PC에서는 업데이트되지만 Android에서는 되지 않는다면 두 기기에 저장된 주소의 문자가 완전히 같은지 먼저 비교하세요. 특히 링크 끝의 매개변수, 등호와 대소문자를 주의해야 합니다. 두 기기의 네트워크와 시스템 시간도 비교하세요. 반대로 Android에서는 업데이트되지만 v2rayN에서 실패한다면 v2rayN이 프록시를 통한 업데이트를 잘못 선택하지 않았는지, 현재 활성 서버가 만료되지 않았는지 확인해야 합니다.
- 웹 계정 비밀번호를 노드 설정 필드에 입력하지 마세요.
- 코어, DNS, 라우팅, 포트와 구독 주소를 동시에 변경하지 마세요. 어느 단계가 적용되었는지 판단하기 어려워집니다.
- 구독 링크를 단체 채팅이나 스크린샷으로 공개하지 마세요. 링크의 접근 매개변수가 개인 설정 권한과 연결되어 있을 수 있습니다.
- 구독 출처를 바꾼 뒤에는 새 그룹에 알아보기 쉬운 별칭을 지정하고, 정상 작동을 확인한 후 이전 그룹을 정리하세요.
구독 관리 및 두 기기 사용 팁
구독 설정을 마친 뒤 일상적인 관리에서 중요한 것은 업데이트 주기와 그룹 구분입니다. 너무 자주 새로고침해도 노드 품질이 좋아지지 않으며 서버의 접근 빈도 제한을 유발할 수 있습니다. 일반적으로 필요할 때 수동 업데이트하거나 몇 시간에서 하루에 한 번 정도로 설정하면 됩니다. 구체적인 주기는 구독 제공자의 안내를 따르세요.
여러 출처를 하나의 그룹에 모두 몰아넣지 마세요. ‘일상’, ‘테스트’ 또는 출처 이름처럼 용도별로 그룹을 만들면 노드가 작동하지 않을 때 영향 범위를 빠르게 파악할 수 있습니다. 수동으로 가져온 단일 노드도 구독 노드와 분리해야 합니다. 그래야 구독 그룹을 업데이트한 뒤 수동 설정까지 바뀐 것으로 오해하지 않습니다.
v2rayN 관리 핵심
- 각 구독에 알아보기 쉬운 별칭을 지정하세요.
- 업데이트 후 그룹별로 추가 및 삭제된 항목을 확인하세요.
- 자주 사용하는 라우팅 규칙은 유지하고 라우팅 문제와 구독 문제를 섞지 마세요.
- 다른 프로그램이 포트를 사용 중이면 먼저 로그를 확인한 뒤 로컬 포트를 변경하세요.
v2rayNG 관리 핵심
- 업데이트 전에 현재 구독 그룹이 활성화되어 있는지 확인하세요.
- 앱별 프록시는 어떤 앱이 연결을 사용할지만 결정하며 구독 콘텐츠를 바꾸지 않습니다.
- 노드 목록에 이상이 있으면 먼저 새로고침한 뒤 그룹과 필터 조건을 확인하세요.
- 네트워크를 바꾼 뒤 현재 노드를 다시 테스트하면 되며 구독을 반복해서 가져올 필요는 없습니다.
v2flyNG는 v2fly 코어를 사용하므로 해당 코어의 호환 경로가 필요한 Android 설정에 적합합니다. v2rayNG는 Xray 코어를 사용해 최신 VLESS, REALITY 조합에는 보통 더 적합합니다. 어떤 Android 클라이언트를 사용하든 먼저 구독 출력에 해당 코어가 인식할 수 있는 프로토콜과 전송 매개변수가 포함되어 있는지 확인해야 합니다.
처음 가져오기를 마친 뒤에는 구독 그룹 이름, 마지막으로 업데이트에 성공한 시각, 현재 클라이언트 버전 세 가지를 기록해 두는 것이 좋습니다. 다음에 목록이 달라졌을 때 구독 콘텐츠 업데이트, 클라이언트 업그레이드 또는 로컬 설정 변경 중 무엇이 원인인지 먼저 판단할 수 있어 전체 설정을 처음부터 다시 만들 필요가 없습니다.