링크를 받았다면 먼저 단일 연결 설정이 담긴 링크인지, 설정 목록을 가져오는 원격 주소인지 확인하세요. 설정을 처음 가져오거나 기기를 옮기는 경우, 구독 업데이트 문제를 해결하려는 경우에 유용합니다. vmess://, vless://, HTTPS 구독 URL을 구분한 뒤 주요 항목을 확인하고, 클라이언트에서 가져오기와 활성화, 연결 상태를 점검하는 순서로 살펴봅니다.
공유 링크와 구독 URL: 설정 저장과 목록 가져오기의 차이
vmess://와 vless://는 보통 단일 설정을 공유하는 형식입니다. 클라이언트가 링크에서 서버 주소, 포트, 인증 정보, 전송 옵션을 읽어 로컬 설정으로 저장합니다. 공유 링크 두 개를 복사해 설정 두 개를 한꺼번에 가져올 수도 있지만, 이 방식만으로 업데이트 가능한 구독이 만들어지는 것은 아닙니다.
구독 URL은 보통 HTTPS 주소입니다. 클라이언트가 해당 주소에 접속해 서버가 제공하는 설정 목록을 가져온 다음 파싱하고 업데이트합니다. 주소에 계정 토큰이 포함될 수도 있습니다. 경로에 sub가 있는지, 특정 파일 확장자로 끝나는지는 구독 URL을 판별하는 확실한 기준이 아닙니다. 일반 웹페이지 주소나 단일 JSON 파일 주소도 구독용으로 사용할 수 있다고 단정할 수 없습니다.
구독 URL
추천설정을 지속적으로 관리할 때 적합합니다. 업데이트를 실행하면 목록을 다시 가져오며, 서버에서 주소나 포트를 변경하거나 설정을 추가·삭제한 경우 클라이언트가 정상적으로 업데이트해야 변경 사항이 반영됩니다.
적합한 경우: 서비스 제공자가 구독 URL을 안내했고 설정을 장기간 동기화하려는 경우
단일 공유 링크
가져온 시점의 설정을 로컬에 저장합니다. 링크 내용이 그대로라면 다시 가져와도 서버에서 나중에 변경한 설정은 보통 반영되지 않습니다.
적합한 경우: 일시적인 테스트, 단일 설정 확인, 확인된 소수 설정의 기기 이전
여기서 구독을 추천하는 것은 신뢰할 수 있는 구독 출처가 있다는 전제에서입니다. 구독은 연결 프로토콜이 아니며, 목록에 있는 모든 설정의 연결을 보장하지도 않습니다. VMess와 VLESS는 연결 프로토콜이고, 구독은 설정을 배포하고 업데이트하는 방식으로 서로 다른 계층에 속합니다.
vmess://: 디코딩한 뒤 주소·전송 방식·TLS 확인
일반적인 VMess 공유 형식은 vmess:// 뒤에 Base64로 인코딩된 JSON이 붙습니다. Base64는 인코딩 방식일 뿐 UUID 같은 연결 인증 정보를 숨기지는 않습니다. 도구마다 형식이 다를 수 있으므로 Base64 문자열을 임의로 VMess 설정이라고 간주해서는 안 됩니다.
아래는 일반적인 공유 내용을 디코딩했을 때의 구조입니다. 도메인과 UUID는 항목을 설명하기 위한 예시이며 실제로 연결할 수 있는 서비스 정보가 아닙니다. 이 짧은 키는 공유 형식의 항목으로, 그대로 붙여 넣어 실행할 수 있는 완전한 코어 설정이 아닙니다.
{
"v": "2",
"ps": "VMess 예시",
"add": "edge.example.org",
"port": "443",
"id": "123e4567-e89b-42d3-a456-426614174000",
"aid": "0",
"scy": "auto",
"net": "ws",
"type": "none",
"host": "edge.example.org",
"path": "/gateway",
"tls": "tls",
"sni": "edge.example.org"
}add와port: 실제 연결에 사용할 서버 주소와 포트입니다. 포트는 서버 측에서 수신하는 포트와 일치해야 합니다. 예시에 443이 쓰였다고 해서 모두 443으로 변경하면 안 됩니다.id: VMess 사용자 UUID입니다.aid는 이전 버전과의 호환을 위한 항목입니다. 최신 VMess AEAD 설정에서는 보통 0을 사용하므로 임의로 다른 값으로 바꾸지 마세요.net,host,path: 예시는 WebSocket을 사용합니다. 여기서host는 요청 Host,path는 경로이며 서버 또는 리버스 프록시 설정과 일치해야 합니다.tls와sni: TLS 사용 여부와 서버 이름을 지정합니다. 연결 주소, 요청 Host, TLS 서버 이름은 같을 수도 있고 서버 구성에 따라 서로 다를 수도 있습니다.ps: 보통 화면에 표시되는 메모입니다. 메모를 바꿔도 주소, UUID, 전송 설정 오류가 해결되지는 않습니다.
디코딩한 항목을 이해했다고 해서 클라이언트가 모든 조합을 지원하는 것은 아닙니다. GUI 클라이언트는 공유 형식을 파싱해 설정을 만들고, 코어는 실제 연결을 처리합니다. 문제를 진단할 때는 클라이언트에서 가져온 설정과 현재 코어의 지원 범위를 함께 확인하세요.
vless://: 쿼리 매개변수로 전송 방식과 보안 계층 확인
VLESS 공유 링크는 보통 URI 형식을 사용합니다. UUID 뒤에 @가 오고, 그 뒤로 서버 주소와 포트가 이어집니다. 물음표 뒤에는 쿼리 매개변수, 해시 기호 뒤에는 메모가 붙습니다. 아래는 VLESS, WebSocket, TLS 조합의 구조를 보여주는 예시이며 실제 연결에는 사용할 수 없습니다.
vless://[email protected]:443?encryption=none&security=tls&type=ws&host=edge.example.org&path=%2Fgateway&sni=edge.example.org#VLESS-WS-TLS| 항목 | 예시 값 | 확인할 내용 |
|---|---|---|
encryption | none | TLS가 꺼졌다는 뜻은 아닙니다. 외부 보안 설정과는 별개의 항목입니다. |
security | tls | 예시는 TLS를 사용합니다. 이름만 바꾼다고 서버가 REALITY로 전환되는 것은 아닙니다. |
type | ws | 전송 방식은 서버 설정과 일치해야 합니다. |
path | %2Fgateway | URI를 디코딩하면 /gateway가 됩니다. 이중 인코딩되지 않도록 주의하세요. |
sni | edge.example.org | TLS 핸드셰이크에 사용할 서버 이름입니다. 서버 요구 사항에 맞춰 입력하세요. |
REALITY 설정을 받은 경우 출처에서 제공한 pbk, sid, fp 등의 매개변수도 확인해야 합니다. flow=xtls-rprx-vision 사용 여부는 서버와 전송 조합에 따라 다릅니다. 위의 WebSocket 예시에 Vision 항목만 추가했다고 프로토콜이 업그레이드되는 것은 아닙니다.
결론: 가져온 뒤 항목별로 확인하고, 프로토콜부터 바꾸지 마세요
먼저 주소, 포트, UUID, 전송 방식, 보안 계층의 다섯 항목을 대조하세요. 출처에서 제공한 설정이 완전하고 클라이언트가 해당 조합을 지원하는지 확인한 뒤 연결을 테스트하세요. TLS, REALITY, 전송 방식을 임의로 바꾸면 설정 간 불일치가 생길 수 있습니다.
v2rayN과 v2rayNG: 링크 종류에 맞는 가져오기 메뉴
아래에서는 일반적으로 사용되는 중국어 메뉴 이름을 기준으로 설명합니다. 버전에 따라 버튼 위치나 문구가 바뀔 수 있으므로 메뉴를 찾을 때는 '클립보드에서 가져오기', '구독 그룹 설정', '구독 업데이트'와 같은 기능을 확인하세요. 가져오기, 설정 선택, 연결 시작, 프록시 활성화는 각각 다른 작업입니다. 목록에 설정이 표시되는 것만으로 모든 과정이 끝난 것은 아닙니다.
두 클라이언트에서 가져오기: 단일 링크와 원격 구독 구분
데스크톱: v2rayN
- 단일 링크: 전체 링크를 복사한 다음 메인 창에서 「서버」→「클립보드에서 URL 일괄 가져오기」를 선택하세요. 해당 단축키를 지원하는 버전에서는 Ctrl+V를 사용할 수도 있습니다.
- 구독 URL: 「구독 그룹」→「구독 그룹 설정」으로 이동해 그룹을 추가하고 메모와 URL을 입력한 뒤 저장하세요. 그런 다음 「구독 업데이트」를 실행합니다.
- 업데이트가 끝나면 사용할 설정을 선택하고 마우스 오른쪽 버튼 메뉴에서 「활성 서버로 설정」을 선택하세요. 필요에 따라 시스템 프록시도 설정합니다.
Android: v2rayNG
- 단일 링크: 전체 링크를 복사한 뒤 오른쪽 위의 「+」→「클립보드에서 가져오기」를 누르세요.
- 구독 URL: 사이드 메뉴에서 「구독 그룹 설정」을 열고 「+」를 눌러 메모와 URL을 추가하세요. 저장한 다음 메인 화면으로 돌아가 「구독 업데이트」를 실행합니다.
- 사용할 설정을 선택하고 연결 버튼을 누르세요. 처음 연결할 때는 시스템 안내에 따라 VPN 연결을 허용한 뒤 연결 상태와 로그를 확인합니다.
같은 구독을 두 클라이언트에 각각 추가할 수는 있지만, 업데이트 일정과 현재 선택한 설정, 로컬 라우팅 설정이 자동으로 동기화되지는 않습니다.
v2rayNG는 Xray 코어를 사용하고 v2flyNG는 v2fly 코어를 사용합니다. 화면 구성이 비슷하거나 같은 구독을 사용한다고 해서 두 클라이언트가 동일한 프로토콜 확장을 지원하는 것은 아닙니다. 특히 VLESS의 특정 보안 및 흐름 제어 조합은 실제 코어의 지원 여부를 확인하세요. 링크를 인식한다는 이유만으로 사용할 수 있다고 판단해서는 안 됩니다.
- 가져오기 전에 클립보드에 대화 내용이나 따옴표가 섞이지 않았는지, 줄바꿈이 들어가거나 링크 끝에 중국어 문장 부호가 붙지 않았는지 확인하세요.
- 가져온 뒤 편집 화면을 열어 메모 이름만 보지 말고 서버, 포트, 전송 방식, TLS 설정을 확인하세요.
- 구독을 업데이트한 뒤 해당 그룹에 설정이 표시되는지 확인하고, 사용할 설정 하나를 현재 설정으로 선택하세요.
- 연결을 시작한 뒤 실제 앱으로 테스트 대상에 접속하고 로그를 함께 살펴 연결 및 라우팅 상태를 확인하세요.
구독 업데이트와 포트 점검: 두 연결 경로를 따로 확인
구독 업데이트는 '클라이언트에서 구독 서버에 접속하는' 경로를 사용합니다. 평소 트래픽은 '앱에서 로컬 프록시로 전달한 뒤 코어가 원격 서버에 연결하는' 경로를 사용합니다. 한쪽 경로가 작동한다고 다른 쪽도 작동하는 것은 아닙니다. 구독 다운로드 성공은 이번에 목록을 가져와 파싱했다는 뜻일 뿐, 목록에 있는 모든 서버에 연결할 수 있다는 뜻은 아닙니다.
이 숫자는 점검 위치를 설명하기 위한 예시이며 모든 설치 환경의 기본값은 아닙니다. 원격 포트는 설정 제공자가 안내한 값을 사용하세요. 로컬 포트는 v2rayN의 「설정」→「매개변수 설정」에 표시된 수신 설정을 기준으로 합니다. 로컬 SOCKS 인바운드가 실제로 127.0.0.1:10808을 수신 중이라면 터미널에서 다음 명령으로 프록시를 명시할 수 있습니다.
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 --head https://example.com/여기서 socks5h는 대상 도메인 이름을 프록시 측에서 해석하도록 지정합니다. 10초와 20초는 각각 해당 명령의 연결 시간 제한과 전체 시간 제한입니다. 명령이 실패하면 오류 내용을 기록하고 한 번의 응답 시간만 비교하지 마세요. 브라우저가 시스템 프록시를 사용하는지, 터미널에서 프록시를 명시했는지는 각각 확인해야 합니다.
- 로컬 포트에 연결할 수 없다는 메시지가 표시되면 먼저 코어가 실행 중인지, 수신 포트가 올바른지, 포트 충돌이 있는지 확인하세요.
- 로컬 프록시에는 연결됐지만 원격 핸드셰이크가 실패한다면 주소, UUID, TLS 서버 이름, 전송 경로, 시스템 시간을 확인하세요.
- 구독 업데이트만 시간 초과된다면 구독 도메인에 접속할 수 있는지 확인하세요. 버전에 '프록시를 통해 업데이트' 옵션이 있다면 정상 연결을 사용할 수 있는 상태에서 시도해 볼 수 있습니다.
- 업데이트 후 설정 수가 줄었다면 그룹을 잘못 선택하지 않았는지, 구독 내용이 바뀌었는지, 로그에 형식 파싱 오류가 있는지 확인하세요.
가져오기 및 업데이트 관련 자주 묻는 질문
HTTPS 주소를 복사했는데 유효한 설정이 없다고 나오는 이유는 무엇인가요?
복사한 주소가 계정 관리 페이지가 아니라 구독 URL인지 먼저 확인하세요. 주소를 「구독 그룹 설정」의 URL 입력란에 넣고 업데이트를 실행합니다. 원격 주소를 단일 VMess 또는 VLESS 링크처럼 가져오지 마세요. 그래도 실패한다면 로그에 로그인 페이지, 접근 거부, 지원되지 않는 형식이 표시되는지 확인하세요. 문제 해결 과정에서 토큰을 공개하지 마세요.
단일 링크는 가져왔는데 구독 업데이트 후에도 바뀐 것이 없는 이유는 무엇인가요?
단일 링크는 로컬 설정 스냅샷으로 저장되며 구독 출처가 자동으로 연결되지 않습니다. 실제 구독 URL을 별도로 추가한 다음 해당 그룹을 업데이트해야 합니다. 공유 링크를 구독 URL 입력란에 넣지 말고, 메모를 수정하면 새 서버 설정을 받을 수 있다고 기대하지 마세요.
구독을 새로 고친 뒤 수동으로 바꾼 설정이 원래대로 돌아온 이유는 무엇인가요?
구독 업데이트는 클라이언트 버전과 업데이트 방식에 따라 그룹 내 설정을 다시 만들거나 덮어쓸 수 있습니다. 수동 변경을 장기간 유지해야 한다면 설정을 별도의 로컬 그룹에 복사하고 두 설정의 출처를 확인하세요. 다음에 잘못된 버전을 선택하지 않도록 주의해야 합니다.
공유 링크를 온라인 디코딩 사이트에 넣어 확인해도 되나요?
링크에는 UUID, 구독 토큰, 서버 정보가 포함될 수 있습니다. 클라이언트의 편집 화면에서 확인하거나 신뢰할 수 있는 로컬 오프라인 도구를 우선 사용하세요. 전체 링크, QR 코드, 민감한 정보가 가려지지 않은 로그를 공개 게시판에 올리지 마세요. 인증 정보가 유출됐다면 제공자 계정에서 재설정한 뒤 두 클라이언트의 설정을 업데이트하세요.
기기를 옮기기 전에 마지막으로 확인할 사항
공유 링크에는 보통 연결 설정이 담기고, 구독은 설정 목록을 제공하는 역할을 합니다. 시스템 프록시, 앱별 규칙, DNS, 라우팅, 로컬 인바운드 포트, 로그 수준까지 함께 이전된다고 가정해서는 안 됩니다. 같은 출처의 설정을 두 기기에 가져온 뒤 동작이 다르다면 원격 서버 문제로 판단하기 전에 각 기기의 로컬 설정을 비교하세요.