· 입문 가이드 · 약 8분

V2Ray 구독 URL 가져오기 가이드: v2rayN·v2rayNG 설정 위치와 주요 구독 형식

v2rayN 구독 그룹과 v2rayNG 구독 설정 위치, Base64 구독과 vmess://·vless:// 공유 링크의 차이, 구독 업데이트 후 서버 목록이 비어 있을 때의 해결 방법을 안내합니다.

이 글의 핵심

먼저 보유한 정보가 구독 URL인지 단일 공유 링크인지 확인한 다음 알맞은 가져오기 메뉴를 선택하세요. 처음 설정하거나 데스크톱에서 Android로 옮기는 경우, 업데이트 후 목록이 비어 있는 경우에 유용합니다. 그룹 설정, URL 저장, 구독 업데이트, 연결 확인 순서로 진행하면 다운로드 실패, 형식 호환성 문제, 연결 실패를 구분해 해결할 수 있습니다.

구독 URL, Base64, 공유 링크의 차이

구독 URL은 보통 https://로 시작하는 웹 주소입니다. 클라이언트가 해당 주소에 접속해 여러 설정을 받아오고, 인식 가능한 항목을 목록에 추가합니다. URL 자체는 서버 설정값이 아니며 브라우저에서 정상적인 웹페이지처럼 표시되지 않을 수도 있습니다. 계정 로그인 페이지, 요금제 안내 페이지, 구독 정보를 제공하는 API는 같은 도메인에 있더라도 서로 대체할 수 없습니다.

단일 공유 링크는 보통 vmess:// 또는 vless://로 시작하며 설정 하나를 나타냅니다. 클립보드에서 가져와야 하며 구독 URL 입력란에 넣으면 안 됩니다. 여러 줄의 공유 링크를 한꺼번에 복사해 가져올 수는 있지만, 이는 정적인 가져오기입니다. 이후 서버 주소나 포트가 바뀌어도 이 텍스트만으로 새 설정을 자동으로 받을 수는 없습니다.

클라이언트 호환 구독

권장

서비스 제공업체에서 v2rayN 또는 v2rayNG용으로 명시된 구독 메뉴를 선택하세요. 저장하는 것은 설정을 가져오는 URL이며, 이후 구독을 업데이트해 목록을 새로고침합니다.

적합한 경우: 장기간 사용하거나 제공처의 설정 변경을 반영하려는 경우

단일 또는 여러 줄의 공유 링크

VMess, VLESS 등의 공유 텍스트 전체를 복사한 뒤 클립보드에서 가져옵니다. 일반적으로 구독 그룹처럼 자동으로 새로고침되지는 않습니다.

적합한 경우: 임시 테스트 또는 특정 설정만 가져오려는 경우

Base64는 인코딩 방식이지 프록시 프로토콜이나 암호화 방식이 아닙니다. 구독 응답은 여러 줄의 공유 링크를 통째로 인코딩하는 경우가 많고, VMess 공유 링크의 매개변수에도 Base64가 자주 사용됩니다. 겉보기는 비슷해도 역할은 다릅니다. 전자는 설정 목록을 감싸는 형식이고, 후자는 단일 설정을 표현하는 방식입니다. 긴 문자열이라고 해서 무조건 구독 URL이라고 판단하지 마세요.

v2rayN 구독 그룹 설정 및 업데이트

데스크톱에서는 먼저 구독 그룹을 만든 뒤 그룹에 포함된 설정을 가져옵니다. 아래는 일반적인 중국어 인터페이스 기준입니다. 버전에 따라 버튼 위치나 문구가 다를 수 있으니 ‘구독 그룹 설정’과 구독 업데이트 메뉴를 찾으세요. ‘매개변수 설정’에서 구독 URL 입력란을 찾을 필요는 없습니다.

  1. 구독 URL 복사

    서비스 제공업체의 구독 페이지에서 v2rayN에 맞는 메뉴를 선택하고 전체 URL을 복사합니다. 브라우저 주소창의 계정 페이지를 복사하거나 안내 문구까지 함께 붙여넣지 마세요.

  2. 구독 그룹 추가

    메인 화면에서 ‘구독 그룹’ → ‘구독 그룹 설정’을 열고 설정 창에서 ‘추가’를 선택합니다. 메모에는 제공처 이름을 적고 구독 URL 입력란에 주소를 붙여넣습니다. 앞뒤에 공백이나 줄바꿈이 들어가지 않았는지 확인하세요.

  3. 저장 후 업데이트

    저장한 뒤 메인 화면으로 돌아가 ‘구독 그룹’ 메뉴에서 업데이트를 실행합니다. 사용할 수 있는 연결이 아직 없다면 먼저 ‘모든 구독 업데이트(프록시 사용 안 함)’를 선택하세요. 사용 가능한 프록시가 있는데 직접 연결에 실패할 때는 ‘모든 구독 업데이트(프록시 사용)’를 시도합니다.

  4. 가져온 결과 확인

    해당 그룹을 선택하고 서버 목록과 하단 로그를 확인합니다. 원하는 설정이 표시되면 하나를 선택해 활성 서버로 지정한 뒤, 사용 환경에 맞게 시스템 프록시나 다른 트래픽 처리 방식을 켭니다.

단일 공유 링크만 있다면 메인 화면에서 ‘서버’ → ‘클립보드에서 여러 URL 가져오기’를 선택합니다. 가져온 뒤 서버 주소, 포트, 전송 매개변수를 확인하세요. 메모가 표시되는지만 확인해서는 안 됩니다. 구독 업데이트로 제공처의 설정이 다시 생성될 수 있으므로 계속 유지할 수동 변경 사항은 별도 설정으로 저장해 다음 새로고침 때 덮어쓰이지 않도록 하세요.

v2rayNG 구독 설정 및 그룹 업데이트

Android용 v2rayNG는 Xray 코어를 사용하지만 구독 파싱은 클라이언트가 처리합니다. 특정 구독 텍스트를 인식하는지와 하위 연결 프로토콜을 지원하는지는 별개의 문제입니다. 먼저 가져오기가 정상적으로 완료되는지 확인한 뒤 해당 서버에 연결할 수 있는지 점검하세요. 두 문제를 한꺼번에 진단하지 마세요.

  1. 구독 설정 열기

    메인 화면 왼쪽 위의 사이드 메뉴를 열고 ‘구독 설정’으로 이동합니다. 여기에서 구독 제공처를 관리합니다. 메인 화면 오른쪽 위의 ‘+’는 주로 설정을 가져오거나 추가하는 메뉴로, 구독 설정과는 다릅니다.

  2. 이름과 주소 입력

    ‘구독 설정’에서 ‘+’를 누르고 메모와 구독 URL을 입력합니다. 구독이 활성화되어 있는지 확인한 다음 저장 버튼을 누르세요. 처음 가져올 때는 서버 키워드 필터를 설정하지 않는 것이 좋습니다.

  3. 구독 업데이트

    메인 화면으로 돌아가 오른쪽 위의 더보기 메뉴를 열고 ‘구독 업데이트’를 선택합니다. 일부 화면에는 ‘현재 그룹 구독 업데이트’가 있습니다. 이 기능을 쓰기 전에 대상 그룹을 선택해 다른 제공처를 업데이트하고도 동작하지 않았다고 오해하지 않도록 하세요.

  4. 연결 시작 및 권한 허용

    목록에서 설정을 선택한 뒤 연결 버튼을 누릅니다. 처음 실행할 때 Android의 VPN 연결 요청이 표시되면 허용하고 연결 상태와 로그를 확인하세요. 구독 업데이트 자체에는 VPN 권한이 필요하지 않습니다.

단일 공유 링크를 받았다면 텍스트 전체를 복사한 뒤 메인 화면에서 ‘+’ → ‘클립보드에서 가져오기’를 선택합니다. 가져오기와 연결은 별개의 작업입니다. 항목이 목록에 나타나면 클라이언트가 파싱을 완료했다는 뜻일 뿐, 서버가 온라인이거나 계정, 인증서, 전송 매개변수가 올바르다는 뜻은 아닙니다.

데스크톱과 Android에서 같은 구독 사용하기

같은 구독 URL을 함께 사용할 수 있는지는 제공처가 반환하는 형식, 계정 정책, 양쪽 클라이언트의 파싱 지원 여부에 따라 달라집니다. 일부 API는 요청 매개변수나 클라이언트 식별자에 따라 서로 다른 콘텐츠를 반환합니다. 양쪽에서 각각 업데이트에 성공했더라도 각자 인식할 수 있는 설정을 받았다는 뜻일 뿐, 표시 순서, 메모, 지원 프로토콜까지 모두 같다는 보장은 없습니다.

두 기기에서 가져오기: 각각 저장하고 각각 확인

데스크톱 v2rayN
  • ‘구독 그룹 설정’에서 제공처를 저장합니다.
  • 업데이트 후 현재 그룹과 로그를 확인합니다.
  • 연결에 성공하면 시스템 프록시 상태를 확인합니다.
Android v2rayNG
  • ‘구독 설정’에서 호환되는 URL을 저장합니다.
  • 업데이트 후 검색 및 필터 조건을 지웁니다.
  • 연결을 시작하고 VPN 권한을 허용했는지 확인합니다.

제공처에서 허용하는 경우 같은 URL을 사용할 수 있지만, 구독 업데이트와 라우팅, 연결 상태는 양쪽에서 각각 확인해야 합니다.

구독은 주로 설정 목록을 업데이트하며, 데스크톱의 시스템 프록시 모드나 라우팅 규칙, Android의 앱별 프록시 설정까지 옮기지는 않습니다. 두 기기의 화면을 ‘똑같이’ 보이게 하려고 설정 파일 전체를 무작정 복사하지 마세요. 먼저 제공처의 항목을 사용할 수 있는지 확인한 다음 각 기기에서 트래픽 처리 방식을 따로 설정하세요.

업데이트 후 서버 목록이 비어 있을 때: 로그를 따라 단계별 점검

사용 중인 설정과 오류 로그를 보존한 뒤 하나씩 변경하세요. 매번 조건을 하나만 바꾸면 원인을 파악하기 쉽습니다. 로그에 HTTP 상태 코드가 있다면 응답 성공 여부를 먼저 구분할 수 있습니다. 아래 숫자는 프로토콜 상태 코드이며 클라이언트 버전이나 속도 측정 결과가 아닙니다.

200
HTTP 요청에 성공해도 응답 형식 확인 필요
401
인증 문제: 구독 인증 정보 확인
403
서비스에서 접근을 거부함: 권한 또는 접근 제한 확인
  1. 그룹과 표시 조건을 확인하세요. 대상 구독을 선택하고 검색어를 지운 뒤 서버 키워드 필터도 잠시 해제합니다. 로그에는 가져오기에 성공했다고 나오지만 목록이 비어 있다면 이 항목부터 확인하세요.
  2. 제공처가 실제 설정을 반환하는지 확인하세요. HTTP 200 응답에도 로그인 페이지, 만료 안내, 오류 설명이 포함될 수 있습니다. 브라우저에서 페이지가 열린다고 해서 클라이언트가 구독 콘텐츠를 받은 것은 아닙니다.
  3. 주소가 유효한지 확인하세요. 구독이 초기화되었는지, 계정에 제한이 있는지, 복사 도중 쿼리 매개변수가 잘렸는지 확인합니다. 물음표 뒤의 토큰 매개변수를 임의로 삭제하지 마세요.
  4. 네트워크 오류를 구분하세요. 시간 초과, 도메인 이름 확인 실패, 인증서 오류는 서로 다른 문제입니다. 먼저 기기의 시간과 현재 네트워크를 확인한 뒤 기존 프록시를 사용해 업데이트해야 하는지 판단하세요.
  5. 콘텐츠 형식을 확인하세요. 주소에 접속할 수 있지만 파싱에 실패한다면 제공처에서 v2rayN 또는 v2rayNG용 형식을 다시 선택하세요. 파일 확장자를 바꿔 한 종류의 설정을 다른 종류로 변환하려고 하지 마세요.

가져온 뒤 연결 확인 및 자주 묻는 문제

가져오기에 성공한 뒤에는 설정 선택, 연결 시작, 로그 확인, 실제 접속 테스트 순서로 점검합니다. 지연 시간 측정은 해당 테스트 방식의 결과만 보여 주며 전체 연결 확인을 대신할 수 없습니다. TLS 핸드셰이크나 인증 오류가 발생하면 인증서 검증을 먼저 끄지 말고 기기 시간, 서버 주소, 포트, 제공처 매개변수를 확인하세요.

브라우저에서는 주소가 열리는데 왜 가져오기에 실패하나요?

열린 페이지가 설정 텍스트인지 로그인 화면인지 확인하세요. 브라우저에는 로그인 상태가 저장되어 있을 수 있지만 클라이언트에는 보통 그 상태가 없습니다. 제공처의 구독 페이지에서 전용 주소를 다시 복사하고 현재 클라이언트가 지원하는 형식을 선택했는지 확인하세요.

업데이트에 성공했는데 설정 목록은 왜 그대로인가요?

방금 업데이트한 그룹을 선택하고 검색 조건을 지운 다음 업데이트 시각 전후의 로그를 확인하세요. 제공처 콘텐츠에 변경이 없다면 목록이 그대로인 것이 정상입니다. 다른 그룹을 업데이트했다면 대상 그룹을 다시 선택한 뒤 업데이트하세요.

같은 구독인데 왜 두 클라이언트의 가져오기 결과가 다른가요?

먼저 양쪽에서 동일한 전체 URL을 사용했는지 확인한 뒤 필터 조건을 점검하세요. 그래도 다르면 제공처가 클라이언트별로 다른 형식을 반환하는지, 양쪽에서 같은 프로토콜과 전송 매개변수를 지원하는지 확인하세요. 메모만 비교해서는 안 됩니다.

서버가 목록에 나타났는데 웹페이지가 열리지 않으면 다시 가져와야 하나요?

먼저 연결 로그를 확인하세요. v2rayN에서는 활성 서버와 시스템 프록시를, v2rayNG에서는 VPN이 실행 중인지와 대상 앱이 앱별 규칙에서 제외되었는지 확인합니다. 설정이 없거나 매개변수가 잘못된 경우에만 설정을 다시 가져오는 것이 도움이 됩니다.

구독 URL에는 계정 토큰이 들어 있는 경우가 많으므로 접속 정보처럼 안전하게 보관해야 합니다. 로그나 스크린샷을 공유하기 전에 전체 URL, 토큰, 사용자 식별 정보, 민감한 서버 매개변수를 가리세요. 전체 구독 내용을 낯선 온라인 디코더나 변환 페이지에 입력하지 마세요. 주소가 유출되었다면 제공처에서 재설정한 뒤 양쪽 클라이언트의 구독 설정에서도 기존 주소를 새 주소로 바꾸고 다시 업데이트하세요.

클라이언트 다운로드플랫폼에 맞는 설치 파일 선택