링크를 처음 받았다면 먼저 바로 가져올 수 있는 단일 설정인지, 저장한 뒤 새로고침해야 하는 구독 주소인지 확인하세요. 가져온 다음에는 목록과 그룹을 살펴보고 연결을 테스트하면, 오류가 났을 때 링크를 읽지 못한 것인지, 구독을 가져오지 못한 것인지, 노드 자체에 연결할 수 없는 것인지 구분하기 쉽습니다.
단일 노드와 구독 주소의 차이
vmess:// 또는 vless://로 시작하는 공유 링크에는 노드 설정 하나가 들어 있습니다. 클라이언트가 링크를 해석하면 설정을 로컬 목록에 저장합니다. 보낸 사람이 나중에 서버 주소나 포트를 바꿔도 이미 받은 링크는 바뀌지 않으므로, 새 링크를 받아 다시 가져와야 합니다.
구독 주소는 보통 https://로 시작하며, 클라이언트가 해당 주소에 요청을 보내 현재 노드 목록을 가져옵니다. 로그인 페이지나 도움말 페이지도 https://로 시작하므로 접두사만으로는 구독 주소인지 판단할 수 없습니다. 설정 제공자가 ‘구독 주소’라고 명시한 링크를 복사하고, 브라우저 주소창의 페이지 URL은 사용하지 마세요.
- 단일 노드는 별도로 저장하기 좋습니다: 이미 알고 있는 설정 하나를 구독과 분리해 관리할 수 있습니다. 한 텍스트에 공유 링크가 여러 개 있으면 일괄 가져오기 결과는 로컬에 저장된 여러 항목일 뿐, 구독 관계가 만들어지는 것은 아닙니다.
- 구독은 설정 여러 개를 관리하기 좋습니다: 다음에 업데이트하면 클라이언트의 동기화 방식에 따라 항목이 추가·교체·삭제될 수 있습니다. 직접 수정한 설정을 보관하려면 먼저 해당 구독에 속하지 않는 그룹에 따로 저장하세요.
- 업데이트가 연결을 뜻하지는 않습니다: 구독 업데이트에 성공했다는 것은 목록을 가져와 해석했다는 의미일 뿐입니다. 실제 접속을 확인하려면 노드를 선택하고 앱의 트래픽이 클라이언트를 거치도록 설정해야 합니다.
VMess·VLESS 공유 링크의 구성 항목
일반적인 VMess 공유 형식은 JSON을 Base64로 인코딩한 뒤 vmess:// 뒤에 붙입니다. Base64는 인코딩이지 암호화가 아닙니다. 일반적인 VLESS 공유 형식은 UUID, 서버, 포트를 주소에 직접 표시하고 쿼리 매개변수도 항목별로 확인할 수 있습니다. 원본 링크를 다른 곳에 가져가 디코딩하지 않아도 클라이언트의 노드 편집 화면에서 두 형식의 항목을 확인할 수 있습니다.
VMess: 디코딩된 JSON 항목
ps- 노드 이름(예: ‘예시’)
add/port- 서버 주소와 원격 포트(예:
node.example.invalid,443) id/aid- 사용자 UUID와 alterId. 일반적인 AEAD 설정의 alterId는
0입니다. net/path- 전송 방식과 해당 경로(예:
ws,/ws) tls/sni- TLS 사용 여부와 명시한 경우 TLS 서버 이름
노드 이름은 바꿔도 되지만 주소, 포트, 전송 매개변수는 서버 설정과 일치해야 합니다.
VLESS: 주소와 쿼리 매개변수
@왼쪽- 사용자 UUID. 아래 예시는 위치를 보여 주기 위해 모두 0인 값을 사용합니다.
@오른쪽부터?앞까지- 서버와 원격 포트(예:
node.example.invalid:443) type/path- 전송 방식과 경로(예:
ws, URL 인코딩된%2Fws) security/sni- 연결 보안 방식과 서버 이름. 예시에서는 TLS를 사용합니다.
#뒤- 노드 이름이며 연결 경로가 아닙니다.
예시의 encryption=none은 TLS를 끈다는 뜻이 아닙니다. TLS 사용 여부는 security=tls로 지정합니다.
아래는 형식을 확인하기 위한 VLESS 링크 예시입니다. 예시 도메인은 접속할 수 없으며, 443도 모든 노드에 공통으로 쓰는 포트가 아닙니다. 시스템 프록시 설정에 입력하는 로컬 수신 포트와도 다릅니다.
vless://[email protected]:443?encryption=none&type=ws&security=tls&sni=node.example.invalid&path=%2Fws#demo
WebSocket 노드를 확인할 때는 연결 주소, TLS 서버 이름, WebSocket 요청의 Host를 구분해야 합니다. 세 값은 같을 수도 다를 수도 있습니다. 연결 주소는 접속 대상을 정하고, 서버 이름은 TLS 핸드셰이크와 인증서 검증에 사용됩니다. 요청의 Host는 HTTP 계층의 항목입니다. 편집 화면에서 모두 ‘도메인’처럼 보여도 같은 값으로 바꾸지 마세요.
v2rayN·v2rayNG에서 클립보드로 단일 노드 가져오기
vmess:// 또는 vless://로 시작하는 한 줄 전체를 복사하세요. 메신저 화면에서 줄이 바뀌어 보여도 복사한 내용에는 보통 영향을 주지 않지만, 실제 줄바꿈이 들어갔거나 따옴표·목록 번호·문장 부호까지 함께 복사하면 클라이언트가 읽지 못할 수 있습니다. 직접 디코딩한 텍스트를 공유 링크 가져오기 화면에 붙여 넣지 마세요.
- v2rayN(데스크톱): 메인 창에서 ‘서버’ 메뉴를 열고 클립보드에서 가져오기 명령을 선택합니다. 일반적인 7.x 화면에서는 ‘클립보드에서 일괄 URL 가져오기’로 표시되며, 단일 링크도 이 메뉴로 가져옵니다. 가져온 뒤 목록에서 노드 이름으로 항목을 찾아 편집 화면에서 프로토콜, 서버, 포트를 확인한 다음 선택해 연결을 테스트하세요.
- v2rayNG(안드로이드): 설정 목록 오른쪽 위의 ‘+’를 누르고 ‘클립보드에서 가져오기’를 선택합니다. 설정을 직접 추가하는 메뉴는 사용하지 마세요. 가져온 항목을 선택한 뒤 연결 버튼을 누릅니다. 처음 사용할 때는 시스템에서 VPN 연결을 허용할지 물을 수 있습니다.
- 성공 메시지가 떴는데 항목이 보이지 않는다면: 먼저 목록 검색 조건을 지우고 ‘전체’로 전환하거나 현재 그룹을 확인하세요. 그런 다음 노드 이름이나 서버 주소로 찾아보세요. 계속 가져오기를 반복하면 겉보기에 같은 항목이 여러 개 생겨 테스트할 때 잘못 선택할 수 있습니다.
v2rayN·v2rayNG에서 구독 추가 및 업데이트
구독 설정은 두 단계로 진행합니다. 먼저 주소를 저장한 다음 업데이트를 실행하세요. ‘저장 완료’는 클라이언트가 주소를 기억했다는 뜻일 뿐, 노드 목록까지 가져왔다는 의미는 아닙니다. 구독 두 개를 서로 다른 그룹에 저장하면 다음 업데이트에서 어떤 주소가 빈 목록을 반환했거나 오류가 났는지 확인하기 쉽습니다.
- v2rayN(데스크톱): ‘구독 그룹’ → ‘구독 그룹 설정’을 열어 그룹을 추가하고, 알아보기 쉬운 이름과 전체 구독 주소를 입력해 저장합니다. 메인 창으로 돌아와 해당 그룹을 선택한 뒤 ‘구독 그룹’ 메뉴에서 현재 구독을 업데이트합니다. 메뉴에 프록시 사용 여부가 나뉘어 있고 구독 서버에 직접 접속할 수 있다면 먼저 프록시를 사용하지 않는 항목을 선택하세요.
- v2rayNG(안드로이드): 왼쪽 위 메뉴에서 ‘구독 그룹 설정’을 열고 ‘+’를 눌러 이름과 주소를 입력한 뒤 저장합니다. 설정 목록으로 돌아와 해당 그룹을 선택하고 오른쪽 위 더보기 메뉴에서 ‘구독 업데이트’를 실행하세요. 버전에 따라 메뉴 문구가 조금 다를 수 있습니다. 먼저 구독 그룹에 저장한 다음 목록에서 업데이트하는 것이 핵심입니다.
- 업데이트 후 확인: 대상 그룹에 항목이 나타났는지 확인하고, 설정 하나를 열어 서버·포트·전송 방식을 확인한 뒤 선택해 연결하세요. 항목이 하나만 보여도 구독이 현재 한 개만 반환했을 수 있습니다. 개수가 아니라 그룹 소속 여부로 구독에서 가져온 항목인지 판단하세요.
전체 주소에는 물음표 뒤의 쿼리 매개변수도 포함됩니다. 매개변수를 임의로 지우거나 대소문자를 바꾸지 말고, 구독 주소를 노드의 서버 입력란에 넣지도 마세요. 제공자가 여러 구독 형식을 안내한다면 현재 클라이언트용이라고 명시된 주소를 우선 선택하세요. 주소에 접속할 수 있어도 응답 내용을 클라이언트가 해석할 수 있다는 보장은 없습니다.
가져오기 실패, 구독 시간 초과, 연결 오류
붙여넣은 뒤 유효한 설정이 없다고 나오면 어디부터 확인해야 하나요?
클립보드 내용이 vmess:// 또는 vless://로 시작하는지 확인하고, 중간에 줄바꿈이 들어갔거나 끝에 문장 부호가 붙지 않았는지 살펴보세요. 복사한 것이 https:// 구독 주소라면 노드 가져오기를 반복하지 말고 구독 그룹 메뉴를 사용하세요.
구독 업데이트 시간이 초과됐는데 프록시를 통해 업데이트하면 해결되나요?
먼저 네트워크에 연결되어 있는지 확인하고 프록시를 사용하지 않는 방식으로 다시 시도하세요. 구독 서버에 직접 연결할 때 시간이 초과됐지만 목록에 사용할 수 있는 노드가 있다면, 노드를 선택한 다음 클라이언트의 프록시 경유 업데이트 명령을 시도할 수 있습니다. 사용할 노드가 없으면 이 옵션만으로 연결이 생기지는 않습니다. 구독 주소에 접속할 권한과 연결이 있는 네트워크에서 다시 시도하세요.
구독 업데이트 완료로 표시되는데 그룹이 비어 있는 이유는 무엇인가요?
방금 업데이트한 그룹으로 전환하고 필터를 지우세요. 로그에 해석 오류가 표시되면 제공자 페이지에서 현재 클라이언트용 주소를 다시 복사하세요. 로그에 401 또는 403이 표시되면 계정 상태와 토큰 만료 여부를 먼저 확인하고, 로그인 페이지 주소를 복사한 것은 아닌지 살펴보세요.
노드를 가져왔는데 웹페이지가 열리지 않는 이유는 무엇인가요?
먼저 방금 가져온 노드가 실제로 선택되어 있는지 확인하고 트래픽이 클라이언트를 통과하는지 살펴보세요. 데스크톱에서는 시스템 프록시가 켜져 있고 브라우저가 이를 사용하는지 확인합니다. 안드로이드에서는 연결이 시작됐는지 확인하세요. 연결 로그에 TLS 핸드셰이크 또는 인증서 오류가 표시되면 원래 설정의 서버 이름과 기기 시간을 확인하세요. 인증서 검증을 꺼서 설정 오류를 덮으려 하지 마세요.