이 글 한눈에 보기

연결 정보를 받았다면 먼저 링크 접두사를 확인하세요. 네 가지 프로토콜 공유 링크는 각각 서버 하나의 정보를 담고, HTTP 또는 HTTPS 구독 주소는 Shadowrocket이 원격 목록을 가져오도록 합니다. 아래에서는 예시를 통해 필드와 인코딩을 설명하고, iPhone / iPad의 Home 및 Add Server에서 가져오고 업데이트하는 방법과 파싱 오류와 연결 오류를 구분하는 방법을 안내합니다.

먼저 링크 접두사 확인: 단일 서버 정보인가, 구독 주소인가

ss://, vmess://, vless://, trojan:// 접두사는 프로토콜을 나타내며, 뒤에 이어지는 내용에는 연결에 필요한 매개변수가 들어 있습니다. 가져오기는 이 매개변수들을 기기에 저장하는 과정입니다. 원본 설정의 주소, 포트 또는 인증 정보가 바뀌어도 이미 저장한 항목은 자동으로 변경되지 않습니다.

구독 링크는 보통 HTTP 또는 HTTPS 주소입니다. 예를 들면 https://example.com/sub?token=xxxx와 같습니다. 이 주소는 목록을 가져올 위치를 가리키며, 목록에 포함된 특정 서버의 주소가 아닙니다. 브라우저에서 열리는 HTTPS 주소라고 해서 모두 구독 링크인 것은 아닙니다. 로그인 페이지, 오류 페이지 또는 호환되지 않는 응답은 서버 목록으로 파싱할 수 없습니다.

4가지
이 글에서 다루는 프로토콜 공유 링크 접두사
1개
프로토콜 공유 링크 하나에 담기는 서버 정보
2종류
여기서 구분할 인증 정보: 단일 연결 인증 정보와 구독 가져오기 인증 정보

네 가지 공유 링크의 필드와 인코딩

아래 링크는 모두 예시 호스트와 인증 정보를 사용하며, 형식을 설명하기 위한 용도입니다. 예시 포트인 8388과 443은 클라이언트에서 요구하는 값이 아닙니다. 실제로 설정할 때는 기존 설정의 포트, 전송 방식 및 보안 매개변수를 그대로 사용하세요.

Shadowsocks: ss://의 Base64URL 사용자 정보

ss://[email protected]:8388#SS-demo

이 SIP002 형식 링크에서 @ 앞부분은 aes-128-gcm:test를 패딩 없이 Base64URL로 인코딩한 값입니다. 디코딩하면 콜론 앞은 암호화 방식, 뒤는 비밀번호입니다. @ 뒤에는 호스트와 포트가 오고, # 뒤에는 메모가 붙습니다. 지정된 필드만 인코딩해야 하며, 링크 전체를 다시 Base64로 감싸면 안 됩니다. 플러그인 매개변수가 있거나 다른 형식으로 감싼 링크라면 원문을 유지하고, 이 간단한 예시를 기준으로 필드를 삭제하지 마세요.

VMess: vmess:// 뒤에는 Base64로 인코딩된 JSON이 자주 옵니다

{
  "ps": "VMess-demo",
  "add": "vmess.example.com",
  "port": "443",
  "id": "123e4567-e89b-42d3-a456-426614174000",
  "aid": "0",
  "net": "ws",
  "host": "vmess.example.com",
  "path": "/ws",
  "tls": "tls"
}

여기에는 일반적인 VMess 공유 형식의 디코딩 결과를 표시했습니다. 그대로 붙여 넣을 수 있는 완전한 링크는 아닙니다. ps는 메모, add와 port는 연결 주소와 포트, id는 UUID입니다. 이 예시는 WebSocket을 사용하며, net, host, path, tls는 각각 전송 방식, WebSocket Host, 경로, TLS 설정을 나타냅니다. 주소, 포트, UUID만 복사해서는 설정 전체를 재현할 수 없습니다.

VLESS: vless://는 UUID와 쿼리 매개변수를 사용합니다

vless://[email protected]:443?encryption=none&security=tls&type=ws&host=vless.example.com&path=%2Fws&sni=vless.example.com#VLESS-demo

@ 앞에는 UUID가, ? 뒤에는 연결 옵션이 옵니다. 여기서 type=ws는 WebSocket을 의미하고, path=%2Fws를 디코딩하면 /ws가 됩니다. sni는 TLS 핸드셰이크에 사용할 서버 이름을 지정합니다. 예시의 encryption=none과 security=tls는 서로 다른 계층의 설정이므로, none을 보고 TLS를 끄면 안 됩니다. 예시에서는 호스트 주소, WebSocket Host, SNI가 우연히 같지만 실제 설정에서는 서로 다를 수 있습니다.

Trojan: trojan://은 UUID가 아닌 비밀번호를 사용합니다

trojan://demo%[email protected]:443?security=tls&type=tcp&sni=trojan.example.com#Trojan-demo

예시 비밀번호는 demo@pass입니다. 인증 정보 안의 @는 뒤에 오는 주소 구분자와 혼동되지 않도록 %40으로 표기합니다. 마찬가지로 필드 값에 포함된 #을 메모 구분자로 그대로 사용하면 안 됩니다. 문제를 확인할 때는 디코딩한 필드를 참고할 수 있지만, 가져오기는 원래 URI로 해야 합니다. 링크 전체를 먼저 디코딩해 붙여 넣으면 필드 구분이 달라질 수 있습니다.

Home에서 가져오기 방식 선택

구독 주소로 가져오기(Type → Subscribe)

권장

iPhone / iPad에서 Home 오른쪽 위의 +를 눌러 Add Server를 열고, Type에서 Subscribe를 선택합니다. 전체 주소를 URL 필드에 붙여 넣고 저장한 뒤 Home으로 돌아가 구독 그룹과 그룹 내 항목을 확인하세요. 주소에 쿼리 매개변수가 있다면 매개변수까지 모두 복사해야 합니다.

적합한 경우: 구독 주소가 있고, 원본에 맞춰 같은 서버 목록을 업데이트하려는 경우

프로토콜 공유 링크로 가져오기

공유 링크 전체를 복사한 뒤 Shadowrocket을 엽니다. 클립보드에서 가져오라는 안내가 표시되면 확인하고, Home에서 새로 추가된 항목을 확인하세요. 같은 설정의 QR 코드가 있다면 Home에서 스캔 기능을 사용할 수 있습니다. 가져오기 안내가 표시되지 않으면 클립보드에 완전한 URI 하나만 있는지 확인한 다음 붙여넣기가 허용되어 있는지 확인하세요.

적합한 경우: 지정한 서버 항목 하나만 저장하려거나 프로토콜 공유 링크만 받은 경우

가져오기 전에 원본 문자열 보관

두 종류의 주소를 받았다면 각각 따로 보관하세요. 프로토콜 URI는 개별 연결 설정을 확인할 때, 구독 URL은 목록을 업데이트할 때 사용합니다. 줄바꿈이나 끝의 문장 부호가 포함되었다면 매개변수를 직접 정리하지 말고 원본에서 다시 복사하세요. URI의 비밀번호나 UUID, 구독 URL의 token을 공개된 곳에 공유하지 마세요. Base64는 인코딩일 뿐 인증 정보를 숨기지 않습니다.

구독 업데이트, 규칙 분기, 연결 테스트는 각각 따로 확인

구독 업데이트는 같은 URL에 다시 요청을 보내 응답을 파싱하는 과정입니다. 공유 링크에서 별도로 가져온 같은 이름의 항목을 대체하지는 않습니다. 반대로 직접 가져온 항목이 일시적으로 작동하더라도 이전 구독 주소가 여전히 유효하다는 뜻은 아닙니다. 원본 목록이 업데이트되었는지 확인하려면 이전 항목의 주소, 포트, 전송 방식을 기록한 뒤 새 목록과 비교하세요. 메모만 비교해서는 안 됩니다.

  1. 먼저 목록 업데이트: Home에서 기존 구독 그룹을 업데이트하고 항목이 표시되는지 확인하세요. 원본에서 주소나 token이 바뀌었다면 저장된 URL도 업데이트해야 합니다. 이전 주소로 계속 요청해도 새 목록을 받을 수 없습니다.
  2. 다음으로 선택한 항목 확인: 목록이 표시되면 사용할 항목을 선택하고 포트, 인증 정보, TLS, SNI, 전송 경로를 확인하세요. 설정을 가져올 수 있다는 것은 필드를 파싱할 수 있다는 뜻일 뿐, 서버에 연결할 수 있거나 인증 정보가 유효하다는 보장은 아닙니다.
  3. 마지막으로 규칙을 확인하세요: 연결은 되었지만 요청이 예상한 경로로 처리되지 않는다면 Home에서 Global Routing을 확인하세요. Config를 사용 중이라면 Config에서 적용 중인 규칙과 순서를 확인하세요. 서버 항목을 가져와도 규칙은 변경되지 않습니다.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

이 규칙 조각에서는 example.com과 하위 도메인에 일치하는 요청에 PROXY를 적용하고, 일치하지 않는 나머지 요청은 FINAL,DIRECT로 처리합니다. 따라서 다른 도메인으로 테스트했을 때 직접 연결되더라도 공유 링크 가져오기에 실패했다고 단정할 수 없습니다.

자주 묻는 질문: 파싱 오류, 빈 목록, 이름이 같은 항목

vmess://를 복사했는데 가져올 때 형식 오류가 표시되는 이유는 무엇인가요?

원본 텍스트에서 다시 복사하고 접두사가 빠지지 않았는지, 끝에 마침표나 따옴표 또는 메시지의 말줄임표가 붙지 않았는지 확인하세요. 화면에서 줄이 바뀌어 보이는 것인지 실제 줄바꿈 문자가 들어갔는지도 확인해야 합니다. 먼저 등호를 삭제하거나 문자를 바꾸지 마세요. 링크마다 사용하는 인코딩 형식이 다를 수 있습니다.

구독 주소가 열리는데 Home에 항목이 표시되지 않는 이유는 무엇인가요?

받은 주소가 계정 페이지나 다운로드 안내 페이지가 아니라 구독 URL인지 확인하세요. 기존 원본에서 401 또는 403 응답을 받는다면 token과 읽기 권한을 먼저 확인합니다. 200 응답이어도 내용이 로그인 페이지이거나 호환되지 않는 목록일 수 있습니다. 응답 형식은 원본 제공처에 확인하고, 전체 URL을 타사 파싱 사이트에 입력하지 마세요.

업데이트 후 이름이 같은 항목이 두 개 생겼습니다. 어느 항목을 선택해야 하나요?

먼저 항목이 방금 업데이트한 구독 그룹에 있는지 확인한 다음, 상세 정보를 열어 호스트, 포트, 전송 방식을 비교하세요. 다른 항목이 이전에 단일 링크로 가져온 것이라면 이번 업데이트로 바뀌지 않습니다. 새 항목이 작동하는지 확인한 뒤 이전 항목을 삭제할지 결정하세요.

메모는 바꿀 수 있는데 path나 sni는 왜 함께 바꾸면 안 되나요?

메모는 항목을 식별하기 위한 값이고, path와 sni는 연결에 사용됩니다. 가져온 뒤 핸드셰이크에 실패한다면 원래 설정과 항목별로 비교하세요. 메모에 적힌 도메인을 SNI로 바꾸거나 테스트를 위해 인증서 검증을 끄지 마세요.

Shadowrocket 다운로드

iPhone / iPad 버전은 App Store에서 받을 수 있으며, $2.99의 일회성 결제가 필요합니다. 시스템 요구 사항은 App Store 페이지를 확인하세요. Mac(Apple 실리콘 / Intel), Windows, Android, Linux 버전은 무료이며, 설치 파일은 이 사이트에서 받을 수 있습니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다.