먼저 받은 정보가 단일 설정인지 구독 주소인지 확인한 다음 클립보드, QR 코드, 구독 그룹 중 알맞은 방법을 선택하세요. v2rayN이나 v2rayNG를 처음 사용하는 분을 위한 안내입니다. 글을 읽고 나면 가져오기를 완료하고 주요 항목을 확인해 ‘목록에 설정이 있음’, ‘설정으로 연결 가능함’, ‘앱 트래픽이 프록시를 통과함’의 차이를 구분할 수 있습니다.
공유 링크와 구독 주소: 먼저 가져오기 방식을 선택하세요
vmess://와 vless://는 보통 서버 주소, 포트, 인증 정보, 전송 매개변수가 포함된 단일 설정용 공유 형식입니다. 클라이언트가 이를 파싱하면 로컬 설정 하나로 저장합니다. 공유 링크 여러 개를 한 번에 복사하면 여러 설정을 일괄 가져올 수도 있지만, 이는 업데이트 가능한 구독을 추가하는 것과는 다릅니다.
구독 주소는 보통 https://로 시작합니다. 클라이언트가 해당 주소에 접속해 여러 설정을 가져온 뒤 지원되는 형식으로 파싱합니다. 구독 주소는 노드 자체라기보다 최신 설정을 가져오는 경로에 가깝습니다. 일반 웹페이지나 로그인 페이지도 HTTPS로 시작하므로, 접두사만 보고 구독 주소라고 단정할 수는 없습니다.
구독 주소
추천구독 그룹에 저장하고 필요할 때 업데이트하세요. 서비스 제공자가 서버나 매개변수를 변경하면 클라이언트에서 다시 가져올 수 있습니다. 단, 주소가 유효하고 네트워크에 연결되며 반환 형식이 지원되어야 합니다.
적합한 경우: 장기간 사용, 여러 설정 관리, 여러 기기에서 각각 업데이트할 때
단일 공유 링크
클립보드나 QR 코드에서 바로 가져오면 특정 설정 하나를 간편하게 전달할 수 있습니다. 원격 매개변수가 바뀌어도 가져온 로컬 항목은 자동으로 변경되지 않습니다.
적합한 경우: 임시 테스트, 자체 서버 운영, 특정 설정의 매개변수 확인
판단 기준: 서비스 제공자가 안내한 ‘구독’ 메뉴를 먼저 찾으세요
구독 주소를 받았다면 구독 그룹에 추가하고, 프로토콜 이름으로 시작하는 완전한 텍스트를 받았다면 공유 링크로 가져오세요. 계정 관리 페이지 주소를 구독 입력란에 넣거나 구독 주소를 서버 주소로 사용하지 마세요.
VMess와 VLESS: 링크에 포함된 매개변수
일반적인 VMess 공유 형식은 vmess:// 뒤에 Base64로 인코딩한 JSON 데이터를 붙입니다. 데이터에는 add, port, id, net, path, tls 등의 필드가 포함될 수 있습니다. Base64는 인코딩 방식이지 보안 수단이 아닙니다. 텍스트를 읽을 수 없다고 해서 인증 정보가 안전하게 숨겨진 것은 아닙니다.
일반적인 VLESS 공유 형식은 URI 구조를 사용합니다. 호스트명 앞에 인증 정보가 오고, 호스트명 뒤에는 포트, 물음표 뒤에는 전송 및 보안 매개변수, 해시 기호 뒤에는 보통 메모가 붙습니다. 클라이언트마다 지원하는 공유 형식의 세부 사항이 다를 수 있습니다. vless://를 인식한다고 해서 현재 커널이 모든 조합을 지원하는 것은 아닙니다.
| 매개변수 종류 | 주요 필드 | 가져온 후 확인할 항목 |
|---|---|---|
| 서버 및 인증 | add, port, id; VLESS의 호스트, 포트, UUID | 주소, 포트, 사용자 식별 정보가 제공자가 안내한 값과 일치하는지 확인하세요. 메모만 보고 판단하면 안 됩니다. |
| 전송 방식 | net、type、path、serviceName | WebSocket과 gRPC를 구분하세요. 경로와 서비스 이름은 서로 바꿔 쓸 수 없습니다. |
| 연결 보안 | tls、security、sni、fp | TLS 또는 REALITY 유형과 서버가 요구하는 도메인 및 지문을 확인하세요. |
| REALITY 및 흐름 제어 | pbk、sid、flow | 공개 키, 짧은 ID, 흐름 제어 값은 서버 설정에 맞춰야 합니다. 다른 노드의 값을 그대로 사용하지 마세요. |
VLESS 자체에는 전송 암호화 기능이 없으므로 실제 배포된 보안 계층을 함께 고려해야 합니다. 링크의 encryption=none이 연결 전체가 반드시 평문이라는 뜻은 아닙니다. security 등의 설정도 확인해야 합니다. 연결 실패를 해결하려고 인증서 검증을 끄거나 SNI를 임의로 바꾸지 마세요.
v2rayN: 클립보드 가져오기와 화면 QR 코드 스캔
데스크톱에서는 가공되지 않은 원문 전체를 사용하세요. 줄임표가 포함된 미리보기는 복사하지 말고, 채팅 말풍선의 따옴표나 설명까지 함께 선택하지 마세요. 아래 절차는 일반적인 중국어 UI를 기준으로 합니다. 데스크톱 버전에 따라 메뉴 이름이 조금 다를 수 있으니 ‘클립보드에서 가져오기’와 ‘화면 QR 코드 스캔’ 기능을 찾으세요.
- 링크 복사.
vmess://또는vless://로 시작하는 줄 전체를 선택하세요. 여러 개를 가져올 때는 링크마다 한 줄씩 배치하고 링크 중간에서 줄을 바꾸지 마세요. - 가져오기. v2rayN을 열고 ‘서버’ → ‘클립보드에서 URL 일괄 가져오기’를 선택하세요. 안내된 가져오기 결과를 확인하고 목록에 예상한 설정이 추가되었는지 살펴보세요.
- 항목 확인. 새 설정의 편집 창을 열고 제공자가 안내한 정보와 프로토콜, 주소, 포트, 전송 및 보안 설정을 대조하세요. 메모가 같은지만 확인하지 마세요.
- 활성 서버로 설정. 목록에서 새 설정을 선택하고 활성 서버로 설정하세요. 먼저 코어가 정상적으로 시작되는지 확인한 다음 실제 접속을 테스트하세요.
QR 코드만 있을 때
QR 코드가 화면에 완전히 표시되도록 한 뒤 ‘서버’ 메뉴에서 ‘화면의 QR 코드 스캔’을 선택하세요. 데스크톱 기능은 보통 화면 내용을 읽으며 휴대전화 카메라를 직접 사용하는 것이 아닙니다. 현재 화면에 해당 기능이 없다면 제공자에게 원본 공유 텍스트를 표시해 달라고 요청한 후 클립보드에서 가져오세요.
- QR 코드를 확대하고 주변 여백을 확보하세요. 이미지 위에 겹쳐진 안내 창은 닫으세요.
- 가장자리가 흐릿해질 정도로 확대하지 마세요. 원격 데스크톱의 압축도 인식에 영향을 줄 수 있습니다.
- 스캔 결과가 HTTPS 주소라면 먼저 구독 주소인지 일반 웹페이지인지 확인하세요. 서버 설정 하나가 반드시 생성되는 것은 아닙니다.
가져오기에 성공했다는 것은 형식이 받아들여졌다는 뜻일 뿐입니다. 웹페이지가 여전히 열리지 않는다면 먼저 하단의 시스템 프록시 상태를 확인하고, 앱이 시스템 프록시를 사용하는지도 살펴보세요. 구체적인 설치 방법은 입문 가이드에서 확인할 수 있습니다. 기본 설정이 작동하는지 확인하기 전에는 시스템 프록시, TUN, 라우팅 규칙을 동시에 변경하지 마세요.
v2rayNG: Android에서 클립보드와 QR 코드로 가져오기
v2rayNG는 Xray 코어를 사용하지만 실제 연결 여부는 클라이언트에 포함된 코어 버전과 서버 매개변수에 따라 달라집니다. 아래 절차는 단일 공유 링크를 기준으로 합니다. 구독은 구독 그룹 메뉴에서 관리하고, 한 번에 함께 문제를 진단하지 마세요.
- 클립보드로 가져오기: 전체 링크를 복사하고 v2rayNG를 연 다음 메인 화면 오른쪽 위의 ‘+’ → ‘클립보드에서 가져오기’를 누르세요. 시스템에서 클립보드 접근을 묻는 경우 현재 작업에 맞게 권한을 허용하세요.
- QR 코드로 가져오기: ‘+’ → ‘QR 코드 스캔’을 누르고 안내에 따라 카메라 권한을 허용한 뒤 QR 코드 전체가 화면 안에 들어오도록 맞추세요. 이미지가 기기에 저장되어 있다면 스캔 화면에서 지원하는 경우 이미지를 선택해 인식할 수 있습니다.
- 항목 확인: 설정 목록으로 돌아가 새로 가져온 항목을 선택하고 편집 화면에서 주소, 포트, 전송 매개변수를 확인하세요. 이름이 같은 기존 설정을 새 항목으로 착각하지 않도록 주의하세요.
- 연결 시작: 연결 버튼을 누르세요. 처음 실행할 때 Android에 VPN 연결 권한 요청이 표시됩니다. 허용한 다음 상태와 로그를 확인하세요.
설정 구문 검사를 통과했는데 시작되지 않는다면 구체적인 오류 문구를 기록하세요. 지원되지 않는 프로토콜 매개변수, 인증 실패, 연결 시간 초과는 서로 다른 문제입니다. 프로토콜을 무작정 바꿔 가며 시도하지 마세요. 특히 VMess 필드를 VLESS 설정에 그대로 입력하면 안 됩니다.
구독 추가: 주소 저장 후 업데이트도 필요합니다
구독 추가에는 보통 두 단계가 있습니다. 먼저 주소를 저장한 뒤 업데이트를 실행합니다. 이름과 URL만 입력했다고 목록에 설정이 바로 나타나는 것은 아닙니다. 업데이트하면 클라이언트가 원격 콘텐츠를 요청하고 파싱한 다음 해당 그룹에 저장합니다.
두 기기에서 사용하기: 같은 구독 주소를 각각 저장
데스크톱: v2rayN
- ‘구독 그룹’ → ‘구독 그룹 설정’을 여세요.
- 그룹을 추가하고 알아보기 쉬운 메모를 입력하세요. 전체 주소를 URL 입력란에 붙여넣고 저장합니다.
- ‘구독 그룹’ 메뉴로 돌아가 구독 업데이트를 실행하세요. 처음에는 프록시를 사용하지 않고 업데이트할 수 있습니다.
- 업데이트 결과를 확인한 뒤 해당 그룹에서 활성 서버를 선택하세요.
Android: v2rayNG
- 사이드 메뉴에서 ‘구독 그룹 설정’을 여세요.
- ‘+’를 누르고 메모와 구독 URL을 입력한 다음 설정을 저장하세요.
- 메인 화면으로 돌아가 메뉴에서 ‘구독 업데이트’를 실행하세요.
- 해당 그룹에 항목이 표시되는지 확인한 뒤 설정을 선택하고 연결하세요.
두 기기의 업데이트는 각각 진행되며 로컬 설정은 서로 동기화되지 않습니다. 요청 조건에 따라 가져오는 설정이 다를 수도 있습니다. 여러 기기에서 사용할 수 있는지는 서비스 제공자의 규정을 확인하세요.
구독을 업데이트하면 보통 해당 그룹의 설정이 새로고침되며, 수동으로 변경한 내용은 다음 업데이트에서 덮어써질 수 있습니다. 사용자 지정 매개변수를 오래 유지하려면 먼저 백업한 다음 구독 업데이트 관리 대상이 아닌 독립 항목으로 따로 저장하는 방법을 고려하세요. 시스템 프록시, TUN, 앱별 프록시 같은 기기 설정도 구독 주소를 복사했다고 자동으로 이전되지 않습니다.
- 주소가 열리지 않음: 쿼리 매개변수까지 전체 주소를 복사했는지, 공백이나 전각 문장 부호가 추가되지 않았는지 확인하세요. 구독이 만료되었거나 재설정되었는지도 살펴보세요.
- 로그인 페이지로 이동함: 보통 관리 페이지나 인증 절차로 연결된 주소이며, 클라이언트가 바로 파싱할 수 있는 구독 콘텐츠가 아닙니다.
- 업데이트 시간 초과: 먼저 프록시 없이 업데이트해 보세요. 해당 주소에 실제로 프록시가 필요하다면 사용 가능한 기존 설정으로 연결한 후 프록시를 통해 업데이트하세요.
- 호환되지 않는 콘텐츠: 서비스 제공자에게 현재 클라이언트에 맞는 출력 형식을 선택해 달라고 요청하세요. 업데이트를 반복해도 지원되지 않는 형식이 사용할 수 있는 설정으로 바뀌지는 않습니다.
가져온 후 확인: 원격 포트와 로컬 포트를 구분하세요
서버 포트는 원격 서버에 연결하는 데 사용하고, 로컬 수신 포트는 기기의 앱에서 보낸 프록시 요청을 받는 데 사용합니다. 두 포트가 같아야 할 이유는 없습니다. 아래 숫자는 위치를 구분하기 위한 예시일 뿐 기본값으로 그대로 사용하면 안 됩니다. 실제 설정은 서버 제공자의 안내와 현재 클라이언트 설정을 따르세요.
예를 들어 서버 제공자가 원격 포트를 443으로 안내했다면, 브라우저 프록시 설정에 127.0.0.1:10809이 표시된다는 이유로 공유 설정의 원격 포트를 10809로 바꾸면 안 됩니다. 일부 버전은 혼합 수신 포트를 사용해 HTTP와 SOCKS가 같은 포트를 공유할 수 있으므로 현재 매개변수 설정을 직접 확인하세요.
- 먼저 코어를 확인하세요: 로그에 수신 포트가 사용 중이라고 표시되면 먼저 기기의 포트 충돌을 해결하세요. 이는 구독 콘텐츠를 파싱할 수 있는지와는 별개의 문제입니다.
- 다음으로 설정을 확인하세요: 대상 항목을 선택하고 인증, 전송, TLS 매개변수를 확인한 뒤 시스템 시간이 정확한지 살펴보세요.
- 마지막으로 앱을 확인하세요: 데스크톱에서는 시스템 프록시나 앱 내 프록시 설정을 확인하세요. Android에서는 연결이 시작되었는지, 대상 앱이 프록시 적용 범위에 포함되는지 살펴보세요.
진행 순서: 설정 하나부터 확인한 뒤 범위를 넓히세요
설정 하나로 코어를 시작하고 실제 접속이 되는지 확인한 뒤 자동 업데이트, TUN, 세부 라우팅을 설정하세요. 목록에 설정이 보인다고 연결에 성공한 것은 아니며, 지연 시간 테스트 결과가 있다고 모든 앱의 트래픽이 프록시를 통과하는 것도 아닙니다.
자주 묻는 질문: 가져오기 실패, 중복 항목, QR 코드 인식 결과
링크를 복사했는데 유효한 설정이 없다고 표시되는 이유는 무엇인가요?
먼저 텍스트를 기기의 텍스트 편집기에 붙여넣어 확인하세요. 프로토콜 접두사가 온전한지, 끝부분이 잘리지 않았는지, 따옴표나 설명이 섞이지 않았는지 살펴보세요. 물음표 뒤의 매개변수를 임의로 삭제하지 마세요. 원본 링크를 다시 복사해 가져오고, 그래도 실패하면 클라이언트가 해당 공유 형식과 매개변수를 지원하는지 확인하세요.
QR 코드를 인식했는데 새 노드가 추가되지 않는 이유는 무엇인가요?
QR 코드는 텍스트를 담는 수단일 뿐이며, 안에 구독 주소나 일반 웹페이지가 들어 있을 수도 있습니다. 인식 결과의 접두사를 확인하세요. 프로토콜 공유 링크는 설정 가져오기로, 구독 URL은 구독 그룹으로 처리해야 합니다. 문제를 확인하려고 개인 QR 코드를 공개 인식 사이트에 올리지 마세요.
같은 링크를 여러 번 가져오면 기존 항목이 자동으로 업데이트되나요?
중복 항목 처리와 덮어쓰기 방식은 버전마다 다를 수 있으므로 반복해서 가져오는 것을 신뢰할 수 있는 업데이트 방법으로 여기지 마세요. 항목의 주소와 매개변수를 먼저 확인하고 필요한 설정을 보관하세요. 지속적으로 업데이트하려면 서비스 제공자가 안내한 구독 주소를 사용해야 합니다.
하나의 구독을 컴퓨터와 휴대전화에서 동시에 사용할 수 있나요?
기술적으로는 두 기기에 같은 주소를 각각 저장할 수 있습니다. 다만 허용 기기 수, 동시 연결, 형식 호환성은 서비스 제공자와 클라이언트에 따라 달라집니다. 각 기기에서 따로 업데이트해야 하며, 한 기기에서 수동으로 추가한 설정은 다른 기기에 자동으로 표시되지 않습니다.
VLESS 링크가 있으면 반드시 연결되나요?
아닙니다. 서버 배포 방식, 인증 정보, 전송 및 보안 매개변수가 서로 맞아야 하며 해당 조합을 지원하는 코어를 사용해야 합니다. 프로토콜 이름만 보고 사용 가능 여부를 판단하지 말고 시작 및 연결 로그를 확인한 뒤 서비스 제공자에게 구체적인 항목을 문의하세요.
마지막으로 간단한 원칙을 기억하세요. 구독 주소는 인증 정보처럼 다루고, 가져온 설정은 검증이 필요한 상태로 보관하세요. 기기를 바꿀 때는 항목별 스크린샷보다 구독을 다시 추가하는 편이 관리하기 쉽습니다. 다른 사람에게 도움을 요청할 때는 민감한 정보를 가린 오류 내용과 매개변수 이름만 공유하세요.