먼저 받은 항목이 구독 주소인지, 단일 노드 링크인지, 다운로드한 구독 텍스트인지 확인한 뒤 알맞은 메뉴를 선택하세요. 데스크톱 v2rayN이나 Android v2rayNG를 처음 설정하는 사용자를 위해 그룹 저장, 구독 업데이트, 노드 선택, 트래픽 확인 순서로 설명합니다. 목록이 비어 있거나 클립보드 파싱에 실패하거나 업데이트 시간이 초과될 때 확인할 사항도 함께 다룹니다.
구독 주소·공유 링크·Base64의 차이
구독 주소는 설정 목록을 받아오는 경로이지 특정 서버 자체가 아닙니다. 보통 https://로 시작하며, 경로나 쿼리 매개변수에 액세스 토큰이 포함될 수 있습니다. 클라이언트가 이 주소에 요청을 보내야 노드 데이터를 받을 수 있습니다. 주소를 그룹에 저장하는 것은 등록 단계일 뿐이며, 업데이트를 실행해야 서버 목록이 표시됩니다.
개별 공유 링크는 보통 vmess:// 또는 vless:// 같은 프로토콜 식별자로 시작하며, 노드 하나의 연결 매개변수를 담고 있습니다. 클립보드 가져오기는 이런 텍스트를 읽어 들이는 방법일 뿐, 별도의 프로토콜이 아니며 클라이언트가 원래 구독 주소까지 자동으로 저장한다는 뜻도 아닙니다.
| 받은 항목 | 내용 | 사용할 메뉴 |
|---|---|---|
| HTTPS 구독 주소 | 요청하면 노드 목록이 반환되며, 액세스 토큰이 필요할 수 있음 | 구독 그룹 설정 |
| 단일 프로토콜 링크 | 노드 하나의 주소, 인증 정보 및 전송 매개변수 | 클립보드에서 가져오기 |
| 여러 줄의 프로토콜 링크 | 줄바꿈으로 구분된 여러 노드 항목 | 해당 형식을 지원하는 일괄 가져오기 메뉴 |
| Base64로 인코딩된 구독 텍스트 | 여러 줄의 공유 링크를 통째로 인코딩한 경우가 많음 | 가능하면 원본 구독 주소로 업데이트 |
| 웹페이지 또는 전체 설정 파일 | 로그인 페이지, 오류 페이지 또는 코어 설정 파일일 수 있음 | 먼저 내용 형식을 확인하세요. 일반 구독 가져오기로 처리할 수 없습니다. |
Base64는 인코딩이지 암호화가 아니며, VMess와 같은 뜻도 아닙니다. 기존 VMess 공유 링크는 노드 JSON을 인코딩해 프로토콜 접두사 뒤에 붙이는 경우가 많습니다. 기존 구독은 여러 줄의 링크 전체를 한 번 더 인코딩할 수도 있습니다. 인코딩 대상이 서로 다른 두 형식이므로 영숫자 문자열이 보인다고 무조건 단일 노드로 가져오면 안 됩니다. 구독 응답이 디코딩되지 않은 여러 줄 텍스트일 수도 있으며, 사용 가능 여부는 클라이언트 파서와 서버 출력 형식에 따라 달라집니다.
v2rayN: 그룹을 추가한 뒤 구독 업데이트
아래 설명은 중국어 데스크톱 인터페이스에서 흔히 볼 수 있는 메뉴 이름을 기준으로 합니다. 버전에 따라 버튼 위치가 다르거나 ‘추가’가 더하기 아이콘으로 표시될 수 있습니다. ‘구독 그룹 설정’과 ‘구독 업데이트’라는 기능을 기준으로 메뉴를 찾으세요. 먼저 신뢰할 수 있는 계정 페이지에서 전체 구독 주소를 복사하세요. 페이지 제목이나 로그인 페이지 전체 URL을 복사하지 마세요.
-
그룹 메뉴 열기
메인 화면에서 ‘구독 그룹’ → ‘구독 그룹 설정’으로 이동한 뒤 ‘추가’를 선택합니다. 그룹은 구독 출처를 연결하는 기능이며, 코어 JSON의 최상위 설정 항목이 아닙니다.
-
주소 입력
‘메모’에 ‘개인 구독’처럼 알아보기 쉬운 이름을 입력하고, ‘선택 주소(URL)’ 또는 해당 구독 주소 입력란에 전체 HTTPS 주소를 붙여 넣습니다. 개별 서버의 ‘주소’ 입력란에는 넣지 마세요.
-
저장 후 업데이트
저장한 뒤 메인 화면으로 돌아와 ‘구독 그룹’ → ‘모든 구독 업데이트(프록시 사용 안 함)’를 선택해 처음으로 요청합니다. 특정 그룹만 업데이트하려면 현재 버전에서 제공하는 해당 그룹 업데이트 메뉴를 사용하세요.
-
목록 확인
새 그룹을 선택해 노드 이름, 주소, 포트가 표시되는지 확인합니다. 목록이 비어 있다면 먼저 검색 조건을 지운 뒤 업데이트 결과나 로그를 확인하세요. 같은 주소를 연달아 다시 추가하지 마세요.
-
노드 선택
노드를 선택한 뒤 마우스 오른쪽 메뉴에서 ‘활성 서버로 설정’을 선택하거나 현재 버전에서 제공하는 동일한 기능을 실행합니다. 이어서 시스템 프록시를 설정하고 웹페이지에 접속해 확인하세요. 가져오기에 성공했다고 트래픽이 이미 프록시를 통과하는 것은 아닙니다.
직접 연결로 구독 주소에 접속할 수 없지만 클라이언트에 사용 가능한 노드가 있다면, 먼저 해당 노드를 활성화한 다음 ‘모든 구독 업데이트(프록시 사용)’를 선택할 수 있습니다. 두 업데이트 메뉴는 구독을 다운로드할 때 사용할 네트워크 경로를 결정할 뿐, 구독에서 반환하는 노드 프로토콜은 바꾸지 않습니다. 처음 설정하는 중이라 사용 가능한 노드가 없다면 프록시 사용 업데이트를 반복해도 대개 해결되지 않습니다.
v2rayNG: 구독 그룹과 클립보드 메뉴를 구분해서 사용
Android용 v2rayNG는 Xray 코어를 사용합니다. 구독 관리는 클라이언트가 담당하고, Xray는 클라이언트가 생성한 연결 설정을 해석해 실행합니다. 구독 주소를 UUID, 서버 주소 또는 전송 경로 입력란에 넣지 마세요. 이 항목들은 모두 개별 노드의 매개변수입니다.
-
구독 메뉴 열기
사이드 메뉴에서 ‘구독 그룹 설정’을 열고 오른쪽 위의 ‘+’를 누릅니다. 일부 버전에서는 같은 메뉴가 ‘구독 설정’으로 표시됩니다. 이름과 URL 입력란이 있는 그룹 관리 화면으로 이동하세요.
-
그룹 저장
메모 이름을 입력하고 구독 링크를 ‘URL’ 입력란에 붙여 넣은 다음 저장 또는 확인 아이콘을 누릅니다. ‘업데이트 사용’ 옵션이 있다면 해당 그룹이 업데이트 대상에 포함되도록 설정하세요.
-
노드 가져오기
메인 화면으로 돌아가 오른쪽 위 메뉴를 열고 ‘구독 업데이트’를 선택합니다. 그룹 범위를 선택할 수 있다면 대상 그룹 또는 모든 그룹을 지정하세요. 결과가 표시될 때까지 기다린 뒤 해당 그룹에 노드가 나타나는지 확인합니다.
-
연결 시작
원하는 노드를 눌러 현재 설정으로 선택한 다음 메인 화면의 시작 버튼을 누릅니다. 처음 사용할 때는 Android의 VPN 연결 요청을 승인하세요. 권한을 거부했다면 연결을 다시 시작하고 시스템 확인 절차를 완료해야 합니다.
vless:// 또는 vmess:// 링크가 하나뿐이라면 링크 전체를 복사한 뒤 메인 화면에서 ‘+’ → ‘클립보드에서 가져오기’를 누릅니다. 가져오기 전에 클립보드에 설명 문구, 따옴표, 코드 블록 표시가 포함되지 않았는지 확인하세요. 이 작업은 보통 로컬 노드 항목을 만들 뿐, 나중에 업데이트할 구독 출처를 자동으로 생성하지 않습니다.
가져온 뒤 노드 매개변수와 로컬 리스너 확인
먼저 원격 노드를 확인한 다음 로컬 프록시 진입점을 확인하세요. 구독에 표시된 서버 포트와 컴퓨터의 로컬 리스너 포트는 서로 다른 개념입니다. 예를 들어 노드는 원격 포트 443을 사용하고 로컬 혼합 프록시 리스너는 10808로 설정될 수 있습니다. 이는 설명을 위한 예시일 뿐이므로 실제 노드와 클라이언트 설정을 기준으로 확인하고, 예시 값으로 일괄 변경하지 마세요.
구독 노드 필드
- 서버 주소
- 제공업체가 지정한 도메인 또는 IP 주소
- 원격 포트
- 구독에 지정된 값을 유지하세요. 예: 443
- 인증 매개변수
- UUID 등의 값은 빠짐없이 그대로 유지하세요
- 전송 및 보안
- WS 경로, TLS 이름 또는 REALITY 매개변수 확인
이 항목은 원격 서버 연결 방식을 결정하므로 업데이트 전에 추측으로 수정하지 마세요.
로컬 프록시 진입점
- 리스닝 주소
- 로컬에서 사용할 때는 보통 127.0.0.1
- 리스닝 포트
- 클라이언트의 실제 설정에서 확인하세요. 예: 10808
- 프록시 유형
- HTTP, SOCKS 또는 혼합 리스너인지 구분
- 트래픽 진입 경로
- 데스크톱 시스템 프록시 또는 Android VPN 인터페이스
로컬 포트는 앱에서 사용하는 프록시 주소와 일치해야 합니다. 원격 포트를 그대로 사용하지 마세요.
v2rayN에서는 ‘설정’ → ‘매개변수 설정’에서 로컬 리스너 관련 옵션을 확인하고, 로그를 함께 살펴 코어가 실제로 실행 중인지 확인할 수 있습니다. 브라우저에 별도의 프록시 확장 프로그램을 설정했다면 이전 포트를 가리키고 있지 않은지 확인하세요. 시스템 프록시는 시스템 설정을 따르는 앱에만 영향을 주므로 모든 프로그램의 트래픽이 프록시로 전환된다고 볼 수는 없습니다.
- 노드 수가 0보다 큼: 반환된 내용 중 일부 이상을 클라이언트가 인식했다는 뜻입니다.
- 지연 시간 테스트 성공: 해당 테스트 방식이 성공했다는 뜻일 뿐, 브라우저 요청도 같은 경로를 사용한다고 보장하지는 않습니다.
- 웹페이지 접속에 성공하고 로그에 해당 요청이 나타남: 시작 아이콘만 확인하는 것보다 현재 앱의 트래픽이 클라이언트를 거치는지 판단하는 데 더 유용합니다.
- 규칙 기반 분할 라우팅에서 특정 웹사이트가 직접 연결됨: 규칙에 따른 정상 동작일 수 있습니다. 먼저 라우팅 모드를 확인한 뒤 가져오기 오류인지 판단하세요.
장기 관리에는 구독, 임시 확인에는 개별 링크
두 가져오기 방식은 함께 사용할 수 있지만, 구독 관리를 수동 가져오기로 대체하지 마세요. 비교가 필요하다면 임시 노드를 별도 그룹에 넣고 기존 구독 그룹과 출처를 유지하세요. 구독 업데이트로 해당 그룹의 노드가 덮어써지거나 다시 만들어질 수 있어 로컬에서 수정한 내용이 보존되지 않을 수 있습니다.
구독 주소 저장
권장구독 그룹에 출처를 저장하면 주소, 포트, 노드 목록의 변경 사항을 나중에 직접 가져올 수 있습니다. 제공업체가 호환되는 구독 형식을 명시적으로 제공할 때 적합하며, 업데이트에 실패해도 같은 출처를 기준으로 문제를 확인할 수 있습니다.
추천 상황: 장기 사용, 정기 업데이트, 출처별 노드 관리
개별 링크 가져오기
클립보드에서 노드 하나를 추가해 프로토콜 매개변수를 확인하거나 임시로 교체할 수 있습니다. 보통 구독 업데이트 정보는 포함하지 않으므로 서버 매개변수가 바뀌면 링크를 다시 받거나 직접 수정해야 합니다.
추천 상황: 단일 노드 테스트, 임시 연결, 문제 설정 분리
오프라인 텍스트 가져오기
클라이언트가 지원한다고 명시한 일괄 텍스트 형식에 적합합니다. 먼저 텍스트가 여러 줄의 링크인지, 전체 인코딩 데이터인지, 완전한 코어 설정 파일인지 확인하세요. 가져오기 도구마다 같은 내용을 지원하는 것은 아닙니다.
추천 상황: 오프라인 이전, 호환되는 텍스트 보유, 통제된 환경에서 백업
구독 목록이 비어 있거나 업데이트가 시간 초과되거나 클립보드 가져오기에 실패할 때
문제를 확인할 때는 한 번에 조건 하나만 바꾸세요. 현재 사용 가능한 노드는 그대로 두고 오류가 ‘구독 요청’, ‘내용 파싱’, ‘연결 시작’ 중 어느 단계에서 발생하는지 기록합니다. 요청 시간 초과와 파싱 실패는 서로 다른 문제입니다. 노드 UUID를 수정해도 구독 서버의 HTTP 오류는 해결되지 않습니다.
구독을 저장했는데 노드가 하나도 표시되지 않는 이유는 무엇인가요?
먼저 메인 화면으로 돌아가 ‘구독 업데이트’를 한 번 실행한 뒤 올바른 그룹으로 전환하고 검색 조건을 지우세요. 업데이트 성공으로 표시되는데도 목록이 비어 있다면 그룹이 활성화되어 있는지, 주소가 호환되는 형식을 반환하는지, 계정에 사용 가능한 노드가 있는지 확인하세요. 그룹을 추가했다고 목록을 가져온 것은 아닙니다.
구독 업데이트가 계속 시간 초과됩니다. 프록시를 켜야 하나요?
사용 가능한 노드가 있다면 먼저 연결을 시작한 뒤 프록시를 통해 업데이트해 보세요. v2rayN에서는 해당 업데이트 메뉴를 선택하면 됩니다. v2rayNG에서는 현재 버전의 구독 업데이트 프록시 옵션을 조정하세요. 사용할 수 있는 프록시가 없다면 먼저 현재 네트워크에서 구독 서비스에 접속할 수 있는지 확인하세요. 아직 연결되지 않은 프록시를 전제로 삼지 마세요.
클립보드에서 인식할 수 없다는 메시지가 표시되면 어떻게 하나요?
프로토콜 접두사로 시작하는 전체 공유 링크를 다시 복사하고 앞뒤의 설명 문구를 제거하세요. 받은 항목이 HTTPS 구독 주소라면 구독 그룹 설정에 붙여 넣습니다. Base64 텍스트만 받았다면 제공업체에 원본 구독 주소나 클라이언트 호환 형식을 요청하는 것이 좋습니다. 인코딩 문자열을 반복해서 수정하지 마세요.
로그에 401, 403 또는 인증서 오류가 표시되면 어떻게 하나요?
401이나 403은 보통 액세스 자격 증명, 계정 상태 또는 서버의 접근 제한을 확인해야 한다는 뜻이며, 클라이언트가 손상됐다고 단정할 수는 없습니다. 인증서 오류가 발생하면 먼저 시스템 날짜, 시간, 시간대를 확인한 다음 도메인과 네트워크 로그인 상태를 점검하세요. 인증서 검증을 끄는 방법으로 문제를 가리지 마세요. 필요한 경우 민감한 정보를 가린 오류 내용을 구독 제공업체에 전달하세요.
업데이트 후 직접 수정한 노드 매개변수가 사라졌어요.
구독은 해당 그룹 설정의 원본이며, 업데이트 과정에서 서버 데이터가 로컬 항목을 대체할 수 있습니다. 테스트할 노드는 별도의 수동 그룹에 복사하고 수정 이유를 기록하세요. 장기적으로 필요한 매개변수 수정은 제공업체가 구독 소스에 반영해야 업데이트할 때마다 다시 수정하는 일을 피할 수 있습니다.
가져오기를 마치면 그룹에 노드가 있는지, 원하는 노드가 선택됐는지, 코어가 실행 중인지, 앱 요청을 확인할 수 있는지 순서대로 점검하세요. 문제가 계속되면 고급 설정에서 인바운드, 라우팅, DNS, 아웃바운드의 역할을 구분해 볼 수 있습니다. 관련 개념이 낯설다면 먼저 용어 빠른 안내를 읽어 구독 관리 문제와 코어 라우팅 문제를 혼동하지 마세요.