먼저 받은 항목이 단일 노드 설정인지, 노드 목록을 가져오는 구독 URL인지 확인한 뒤 클립보드, QR 코드 스캔 또는 구독 관리 메뉴를 선택하세요. 클라이언트를 설치하고 처음 설정을 가져오려는 사용자를 위해 필드 의미, 두 클라이언트의 작업 순서, 업데이트 실패 시 확인할 범위를 설명합니다. 가져오기가 끝난 뒤에는 코어 호환성, 프록시 적용, 라우팅 규칙도 각각 확인해야 합니다.
공유 링크와 구독 URL: 설정 스냅샷과 업데이트 경로
vmess:// 및 vless:// 공유 링크는 보통 서버 주소, 포트, 사용자 식별자와 전송 관련 매개변수를 포함한 단일 연결 설정입니다. 클라이언트에 복사해 가져오면 그 시점의 설정이 저장됩니다. 이후 서버 주소나 포트가 바뀌어도 이미 가져온 설정은 대개 자동으로 변경되지 않으므로 다시 가져오거나 직접 수정해야 합니다.
구독 URL은 대개 접근 토큰이 포함된 HTTPS 주소입니다. 클라이언트가 해당 주소에 요청을 보내 노드 데이터를 받아 설정 목록으로 변환합니다. 구독 응답은 인코딩된 공유 링크 모음일 수도 있고 특정 설정 형식일 수도 있습니다. 가져올 수 있는지는 클라이언트의 파서에 달려 있으므로 HTTPS로 시작한다는 이유만으로 호환된다고 판단하면 안 됩니다.
구독 URL: 노드 목록 관리
권장제공자가 현재 클라이언트 형식을 지원한다면 구독으로 여러 노드를 한꺼번에 가져오고 이후에도 업데이트할 수 있습니다. 업데이트는 클라이언트가 직접 요청해야 하며, 서버 변경 사항이 기기로 실시간 푸시되는 것은 아닙니다.
적합한 경우: 노드가 여러 개이거나 주소가 바뀔 수 있고 목록을 계속 관리해야 할 때
공유 링크: 단일 설정 가져오기
특정 설정 하나를 정확히 전달하거나 구독에 포함되지 않은 노드를 따로 테스트할 때 적합합니다. QR 코드는 같은 텍스트를 다른 방식으로 전달할 뿐, 구독 업데이트 기능을 제공하지 않습니다.
적합한 경우: 직접 구축한 노드, 임시 테스트, 단일 연결 매개변수 확인
가져오기 경로 선택: 먼저 내용을 확인하세요
완전한 vmess:// 또는 vless:// 텍스트를 받았다면 노드 가져오기를 사용하세요. 제공자가 구독 URL이라고 명시한 주소라면 구독 설정으로 이동하세요. 계정 로그인 페이지, 주문 페이지, 사용 안내 페이지를 구독 URL로 착각하지 마세요.
링크 구조: VMess 인코딩 데이터와 VLESS 쿼리 매개변수
일반적인 VMess 공유 형식은 vmess:// 뒤에 Base64로 인코딩된 JSON을 둡니다. 디코딩하면 add(주소), port(포트), id(사용자 식별자), net(전송 방식), host, path, tls 등의 필드를 확인할 수 있습니다. 이는 공유 링크 형식에 관한 규약이며 코어에서 바로 실행할 수 있는 완전한 JSON 설정은 아닙니다. 내보내기 도구마다 VMess 공유 형식이 완전히 같다고 볼 수도 없습니다.
VLESS 공유 링크는 보통 URI 형식을 사용합니다. 아래는 구조를 살펴보기 위한 가상 예시이며, example.com은 문서용 도메인으로 실제 연결에 사용할 수 없습니다. 예시에는 TCP와 TLS만 있으며 REALITY나 다른 추가 조합은 포함되지 않습니다.
vless://[email protected]:443?encryption=none&security=tls&type=tcp&sni=example.com#demo-tls| 필드 | 예시에서 뜻하는 내용 | 확인할 사항 |
|---|---|---|
UUID@주소:포트 | 사용자 식별자와 서버 접속 지점 | 서버 설정과 일치해야 합니다. 로컬 프록시 포트로 바꾸면 안 됩니다. |
encryption=none | VLESS 암호화 필드 | 연결 전체에 TLS가 없다는 뜻은 아닙니다. 보안 계층 매개변수도 함께 확인하세요. |
security=tls | TLS 보안 계층 사용 | 서버가 해당 설정을 지원해야 하며 인증서 검증과 서버 이름도 일치해야 합니다. |
type=tcp | 이 공유 형식에서 TCP 전송을 나타내는 값 | 가져오기 도구가 코어 필드로 변환합니다. 다른 전송 이름으로 임의 변경하지 마세요. |
sni=example.com | TLS 서버 이름 | 접속 주소와 서버 이름은 다를 수 있습니다. 제공자가 안내한 설정을 따르세요. |
#demo-tls | 노드 이름 | 목록에 표시되는 이름입니다. 이름을 바꿔도 인증이나 연결 오류는 해결되지 않습니다. |
실제 링크에서 REALITY를 사용한다면 이는 VMess·VLESS와 같은 계층의 독립 프록시 프로토콜이 아니라 연결의 보안 계층 설정입니다. 공개 키, 짧은 ID, 서버 이름, 지문, 그리고 포함될 수 있는 flow 매개변수는 서버와 코어 버전을 함께 확인해야 합니다. 가져오기 도구가 VLESS를 인식하더라도 이러한 추가 매개변수까지 제대로 보존된다는 뜻은 아닙니다.
v2rayN: 클립보드 가져오기, 화면 QR 코드 스캔, 구독 업데이트
아래 메뉴 이름은 v2rayN 중국어 인터페이스에서 흔히 사용하는 표현을 기준으로 합니다. 버전이나 데스크톱 인터페이스에 따라 이름과 위치가 달라질 수 있으므로 실제 사용 시에는 ‘클립보드에서 일괄 URL 가져오기’, ‘화면의 QR 코드 스캔’, ‘구독 그룹 설정’ 기능을 찾으세요. 클라이언트는 공유 링크를 해석하고 설정을 관리하며, 실제 연결은 코어가 처리합니다. 두 부분의 호환성을 각각 확인해야 합니다.
공유 링크 하나 가져오기
vmess://또는vless://로 시작하는 한 줄 전체를 복사하세요. 앞뒤의 설명, 따옴표, 메신저가 삽입한 줄바꿈은 제외해야 합니다.- v2rayN을 열고 ‘서버’ → ‘클립보드에서 일괄 URL 가져오기’로 이동하세요. 일부 인터페이스에서는 메인 창에서
Ctrl+V를 사용할 수 있으며, 메뉴를 직접 이용해도 됩니다. - QR 코드가 화면에 표시되어 있다면 ‘서버’ → ‘화면의 QR 코드 스캔’을 선택하세요. QR 코드 전체가 보이도록 한 뒤 가리는 창을 닫으세요. 화면 스캔은 카메라를 실행하는 기능이 아닙니다.
- 추가된 항목을 확인하고 편집 화면에서 프로토콜, 주소, 포트, 전송 방식, TLS 설정을 점검하세요. 그런 다음 목록에서 마우스 오른쪽 버튼을 눌러 해당 항목을 활성 서버로 설정합니다.
구독 URL 추가
- ‘구독 그룹’ → ‘구독 그룹 설정’으로 이동해 그룹을 추가하세요. 구분하기 쉬운 이름을 입력하고 주소란에 구독 URL 전체를 붙여 넣은 뒤 저장합니다.
- 메인 창으로 돌아와 ‘구독 그룹’ 메뉴에서 구독 업데이트 기능을 사용하세요. 사용할 수 있는 프록시가 없다면 먼저 ‘프록시 사용 안 함’으로 업데이트해 보세요. ‘프록시 사용’은 연결 가능한 프록시가 이미 있을 때만 의미가 있습니다.
- 대상 그룹에 그룹 이름뿐 아니라 노드도 표시되는지 확인하세요. URL 추가와 구독 내용 가져오기는 별개의 단계입니다. 저장에 성공했다고 구독 다운로드까지 완료된 것은 아닙니다.
- 노드를 선택한 뒤 필요에 따라 시스템 프록시를 설정하고 라우팅 모드를 확인하세요. 필요한 트래픽이 클라이언트로 전달되어야 노드 설정이 실제 접속에 사용됩니다.
v2rayNG: 클립보드, 카메라 QR 스캔, 구독 그룹
v2rayNG는 Xray 코어를 사용하는 Android 클라이언트입니다. 데스크톱과 같은 유형의 공유 텍스트를 받을 수 있지만, 양쪽의 가져오기 도구와 설정 항목, 업데이트 동작은 버전에 따라 다를 수 있습니다. 데스크톱 클라이언트에서 내보낸 프로그램 설정 파일 전체를 Android에서 인식하는 구독 콘텐츠로 간주하지 마세요.
- 클립보드에서 가져오기: 공유 링크 전체를 복사하고 v2rayNG를 연 다음 오른쪽 상단의 ‘+’ → ‘클립보드에서 가져오기’를 누르세요. 완료되면 해당 노드를 눌러 현재 설정으로 선택합니다.
- 카메라로 QR 코드 스캔: ‘+’ → ‘QR 코드 스캔’을 누르고 시스템 안내에 따라 카메라 권한을 허용하세요. 다른 화면의 QR 코드를 스캔할 때는 네 모서리가 모두 보이고 밝기가 적절한지 확인한 다음, 새로 추가된 노드를 점검합니다.
- 구독 추가: 사이드 메뉴에서 ‘구독 그룹 설정’을 열고 ‘+’를 누른 다음 이름과 구독 URL을 입력하고 저장합니다.
- 노드 가져오기: 메인 화면으로 돌아와 오른쪽 상단의 더보기 메뉴를 열고 ‘구독 업데이트’를 선택하세요. 현재 화면이 그룹별로 필터링되어 있다면 방금 추가한 그룹을 보고 있는지 확인합니다.
- 연결 시작: 노드를 선택하고 연결 버튼을 누른 뒤, 처음 시작할 때 Android 시스템의 VPN 연결 요청을 승인하세요. 이 시스템 권한은 기기 트래픽을 로컬 서비스에 전달하기 위한 것이며 별도의 구독 계정이 아닙니다.
일부 버전에는 이미지에서 QR 코드를 인식하는 기능도 있으며 메뉴 이름과 위치는 다를 수 있습니다. 해당 기능이 없다면 원본 텍스트를 복사하거나 다른 화면에 QR 코드를 표시해 스캔하세요. QR 코드 인식을 위해 인증 정보가 담긴 이미지를 온라인 해석 사이트에 업로드하지 마세요.
두 기기에서 함께 사용하기: 같은 구독을 각자 관리
데스크톱: v2rayN
- 호환되는 형식의 구독을 추가하고 처음에는 직접 업데이트합니다.
- 선택한 코어가 노드의 전송 방식과 보안 계층을 지원하는지 확인합니다.
- 필요에 따라 시스템 프록시를 켜고 데스크톱 라우팅을 별도로 설정합니다.
Android: v2rayNG
- 같은 구독을 사용하기 전에 계정에서 여러 기기 사용을 허용하는지 확인합니다.
- 목록을 별도로 업데이트하고 활성 노드와 VPN 연결 상태를 확인합니다.
- 앱별 설정을 확인해 대상 앱이 처리 범위에 포함되어 있는지 확인합니다.
구독을 공유해도 설정이 동기화되지는 않습니다. 업데이트 시각, 활성 노드, 라우팅, 적용할 앱 범위는 각 클라이언트가 별도로 저장합니다.
가져온 다음 확인할 세 가지 항목
‘목록에 노드가 표시됨’은 클라이언트가 항목을 해석했다는 뜻일 뿐, 원격 서버가 온라인인지, 인증이 유효한지, 모든 매개변수가 지원되는지는 보장하지 않습니다. 공유 형식과 프로토콜 구현은 서로 다른 계층입니다. 클라이언트가 필드를 저장해도 코어는 버전이나 설정 조합이 호환되지 않아 시작을 거부할 수 있습니다.
- 설정: 제공자의 원본 정보와 대조해 주소, 포트, UUID, 전송 경로, 서버 이름, 보안 계층을 확인하세요. 특히 인코딩된 경로와 쿼리 매개변수에 주의하세요. 메신저가 문자를 변경해도 문제가 생길 수 있습니다.
- 코어: 시작 로그에 알 수 없는 필드, 미지원 전송 방식, 설정 오류가 표시되는지 확인하세요. v2rayNG는 Xray를, v2flyNG는 V2Fly를 사용합니다. 두 앱이 인터페이스만 다르다고 볼 수 없으며 모든 VLESS 추가 매개변수를 서로 바꿔 쓸 수 있다고 가정해서도 안 됩니다.
- 트래픽 처리: 데스크톱에서는 시스템 프록시나 실제로 사용하는 트래픽 처리 방식을 확인하고, Android에서는 VPN 서비스, 앱별 설정, 라우팅을 확인하세요. 구독은 보통 노드만 제공하며 모든 트래픽 정책을 자동으로 설정해 주지는 않습니다.
연결 테스트 결과도 단계별로 해석해야 합니다. TCP 지연 시간 테스트가 성공해도 테스트 조건에서 대상 포트에 연결할 수 있다는 뜻일 뿐, TLS와 사용자 인증, 웹 요청까지 성공했다는 의미는 아닙니다. 먼저 코어가 시작되는지 확인하고 실제로 접속해 본 다음 로그에서 연결 및 라우팅 결과를 확인하세요. 가져오기를 반복하는 것보다 효과적일 때가 많습니다.
자주 묻는 질문: 증상에 맞춰 확인하기
붙여넣은 뒤 유효한 설정이 없다고 나옵니다. 링크가 잘못된 건가요?
먼저 복사한 내용의 시작 부분을 확인하세요. HTTPS 구독 URL이라면 구독 그룹의 주소란에 입력해야 합니다. 공유 링크라면 접두사가 온전한지, 한글 문장부호가 섞이지 않았는지 확인하세요. v2rayN에서는 ‘서버’ 메뉴의 클립보드 가져오기를, v2rayNG에서는 ‘+’ 메뉴의 클립보드 가져오기를 사용합니다. 그래도 실패하면 클라이언트가 해당 공유 형식을 지원하는지 확인하세요.
구독 업데이트 시간이 초과됐는데 프록시를 켜서 업데이트하면 되나요?
사용 가능한 노드와 올바른 프록시 경로가 있을 때만 프록시를 통한 업데이트를 시도하세요. 먼저 기기 네트워크, 구독 도메인 조회, 업데이트 로그를 확인합니다. 현재 노드도 작동하지 않는다면 업데이트 방식을 바꿔도 연결이 저절로 복구되지는 않습니다. 제공자에게 주소 변경이나 구독 만료 여부를 문의할 때는 오류 유형만 알리고 URL 전체는 공개하지 마세요.
업데이트 결과가 401 또는 403이거나 웹페이지 내용이 가져와졌다면 어떻게 해야 하나요?
401은 보통 인증 문제와 관련이 있고, 403은 요청이 거부됐다는 뜻입니다. 구체적인 원인은 서버 규칙에 따라 다릅니다. 토큰이 잘리지 않았는지, 계정이 유효한지, 올바른 클라이언트 형식을 선택했는지 확인하세요. 로그인 페이지나 다른 HTML이 반환되면 먼저 실제 구독 주소를 다시 확인하세요. 웹페이지 내용을 노드 목록으로 억지로 가져오면 안 됩니다.
QR 코드는 인식되는데 연결은 왜 실패하나요?
QR 코드는 텍스트를 전달할 뿐 원격 설정을 검증하지 않습니다. 노드 편집 화면을 열어 포트, 전송 방식, TLS 또는 REALITY 매개변수를 하나씩 확인하고 코어 로그를 살펴보세요. 인증서 이름 오류가 있다면 인증서 검증을 끄기 전에 서버 이름이나 서버 인증서를 바로잡아야 합니다.
구독을 업데이트할 때마다 직접 수정한 노드 이름과 매개변수가 바뀌어요.
업데이트하면 구독 응답에 따라 항목이 교체될 수 있습니다. 이는 목록 관리 방식입니다. 고정해 둘 설정은 별도의 수동 그룹에 복사한 뒤 구독을 업데이트하세요. 제공자가 노드 식별자나 목록 순서를 변경했다면 현재 선택된 노드도 다시 확인해야 합니다.
인증 정보 보호와 가져온 뒤 확인할 사항
공유 링크의 사용자 식별자와 관련 인증 매개변수는 연결 자격 증명입니다. 구독 URL의 토큰도 보유자가 노드 목록을 읽을 수 있게 하는 경우가 많으므로 비밀로 관리해야 합니다. Base64는 인코딩 방식이지 암호화 수단이 아니며, QR 코드에도 별도의 접근 제어는 없습니다. 오류 화면을 공유하기 전에는 링크 전체, QR 코드, UUID, 구독 토큰을 가리세요.
- 신뢰할 수 있는 경로에서 설정을 받고, 링크를 공개 온라인 디코더에 붙여 넣거나 공개 게시판에 구독 URL을 게시하지 마세요.
- 구독 그룹에 노드가 실제로 가져와졌는지 확인하고 업데이트 시간을 기록하세요. 자동 업데이트를 사용하더라도 실패 알림을 확인해야 합니다. 예약 작업이 업데이트 성공을 보장하지는 않습니다.
- 활성 노드를 선택하고 코어 실행 상태를 확인한 뒤, 시스템 프록시나 Android VPN 서비스가 대상 트래픽을 처리하는지 점검하세요.
- 인증 정보가 유출됐다면 제공자 제어판에서 구독 토큰 또는 해당 인증 정보를 재설정한 다음, 사용하는 모든 기기에서 기존 설정을 새 설정으로 교체하세요.
클라이언트와 코어의 관계는 용어 빠르게 확인하기에서, 설치부터 첫 연결까지의 전체 과정은 입문 가이드에서 확인할 수 있습니다. 공유 링크는 설정 전달에, 구독은 목록 가져오기와 업데이트에 사용됩니다. 실제 연결 가능 여부는 서버, 코어, 로컬 실행 설정에 따라 달라집니다.