링크에 서버 접속 정보가 담겼는지, 서버 목록을 가져오는 주소인지 먼저 확인한 뒤 가져오기 방법을 선택하세요. 서비스 제공업체에서 받은 링크가 있고 Shadowrocket에서 가져온 결과를 확인하려는 사용자를 위한 안내입니다. 네 가지 URI를 구분하고 구독 메뉴를 찾는 방법, 필드별로 가져오기 및 업데이트 실패 원인을 확인하는 방법을 다룹니다. 아래 절차는 iPhone / iPad 화면을 기준으로 하며, 다른 플랫폼에서는 실제 화면을 확인하세요.
접두사부터 확인하기: 단일 서버 URI와 구독 URL의 차이
ss://, vmess://, vless://, trojan://는 일반적으로 서버 항목 하나에 필요한 정보를 직접 담습니다. 링크 전체를 복사하면 클라이언트가 주소, 포트, 인증 정보, 전송 설정을 로컬에서 해석합니다. 항목이 생성되었다고 연결에 성공한 것은 아니며, 서버가 현재 사용 가능하다는 뜻도 아닙니다.
구독 링크는 보통 https:// 주소입니다. Shadowrocket이 해당 주소에 접속해 응답 내용을 읽고 서버 목록을 생성하거나 업데이트합니다. 주소에 접근 토큰이 포함될 수 있으며, 일반 공개 웹페이지나 특정 프록시 프로토콜이 아닙니다. HTTPS 접두사만으로 구독 링크라고 단정할 수 없으므로 링크의 용도와 응답 형식을 함께 확인해야 합니다.
요약: 내용을 먼저 확인한 뒤 가져오기 메뉴 선택
프로토콜 접두사가 보이면 단일 서버 정보로 처리하세요. 서비스 제공업체가 구독 주소라고 명확히 안내한 경우에는 Subscribe를 사용하세요. 구독 URL의 도메인을 단일 서버의 Address에 입력하거나, 프로토콜 URI 전체를 구독 다운로드 주소로 사용하지 마세요.
ss://: 인증 정보가 Base64로 인코딩되어 있을 수 있음
ss://는 Shadowsocks 공유 링크에 사용됩니다. 일반적인 SIP002 형식은 암호화 방식과 비밀번호를 사용자 정보로 담고 서버 주소 및 포트와 연결합니다. 사용자 정보는 보통 URL-safe Base64를 사용합니다. 이전 형식에서는 인증 정보, 주소, 포트를 통째로 Base64 인코딩했을 수도 있으므로 서버 도메인이 바로 보이는지만으로 링크의 완전성을 판단할 수 없습니다.
| 구성 요소 | 확인 방법 |
|---|---|
ss:// | Shadowsocks 공유 형식이며 구독 업데이트 주소가 아닙니다. |
| 사용자 정보 | 디코딩하면 보통 암호화 방식, 콜론, 비밀번호가 포함됩니다. Base64 자체는 정보를 보호하지 않습니다. |
| 서버 및 포트 | 예시 주소는 node.example.com:8388입니다. 8388은 예시일 뿐, 고정 포트가 아닙니다. |
?plugin= | 선택적 플러그인 매개변수입니다. 클라이언트가 모든 플러그인을 지원한다고 가정할 수 없으며, 가져오기를 위해 임의로 삭제해서도 안 됩니다. |
# 뒤의 내용 | 보통 메모 이름입니다. 공백이나 ASCII가 아닌 문자가 포함되면 퍼센트 인코딩될 수 있습니다. |
가져온 뒤 Home에서 해당 항목의 편집 화면을 열고 Type, Address, Port, 암호화 방식, Password를 중점적으로 대조하세요. 암호화 방식과 비밀번호는 각각 해당 필드에 입력해야 하며, Base64 문자열 전체를 Password에 넣으면 안 됩니다. 원본 링크에 이미 문자가 빠져 있다면 인코딩된 모양을 보고 내용을 추측해 보충하지 말고 링크를 다시 복사하세요.
vmess://: 인코딩된 JSON과 다른 공유 형식 구분하기
일반적인 vmess:// 공유 링크는 접두사 뒤에 Base64로 인코딩된 JSON이 오는 형식입니다. 디코딩한 JSON에는 보통 add, port, id, net, tls 등의 필드가 포함됩니다. 생성 도구에 따라 공유 형식이 다를 수 있으므로 모든 VMess 링크의 바깥 구조가 같다고 가정해서는 안 됩니다.
다음은 필드 구조를 설명하기 위한 예시 JSON입니다. 실제로 사용할 수 있는 서버 정보가 아니며, 그대로 붙여넣어 가져올 수 있는 완전한 링크도 아닙니다. 도메인은 예시용이고 UUID는 모두 0인 시연 값입니다. 실제 연결에는 서비스 설정에 있는 해당 값만 사용할 수 있습니다.
{
"v": "2",
"ps": "Example",
"add": "node.example.com",
"port": "443",
"id": "00000000-0000-0000-0000-000000000000",
"aid": "0",
"scy": "auto",
"net": "ws",
"type": "none",
"host": "edge.example.com",
"path": "/demo",
"tls": "tls",
"sni": "edge.example.com"
}
add와port는 연결 대상입니다. 443은 TLS에 흔히 사용되는 포트지만, 포트 번호만으로 TLS가 활성화되었다고 판단할 수는 없습니다.id는 UUID 인증 정보이며 구독 URL의 token으로 대체할 수 없습니다.net이ws라면 WebSocket의 Host와 Path도 함께 확인해야 합니다. 주소와 포트만 확인해서는 안 됩니다.tls와sni는 각각 TLS 사용 여부와 핸드셰이크에 사용하는 서버 이름에 관련된 설정입니다. Host, SNI, 연결 주소는 서로 다를 수 있습니다.
이름은 해석되지만 연결에 실패한다면 이름이 잘못된 것이 아니라 전송 매개변수가 빠진 경우가 흔합니다. Address가 맞더라도 Host, Path, TLS를 확인하세요. 원래 설정을 확인할 수 없는 상태에서 ws를 다른 전송 방식으로 임의 변경하지 마세요.
vless://와 trojan://: 형식은 비슷하지만 인증 필드는 다름
이 두 링크는 사용자 정보, 주소, 포트, 쿼리 매개변수를 포함하는 URI 형식을 사용하는 경우가 많습니다. VLESS의 사용자 정보는 보통 UUID이고, Trojan은 보통 비밀번호입니다. 접두사만 바꿔 서로 변환할 수 없습니다. 다음 두 줄은 구조를 보여 주기 위한 예시이며, 예시 도메인과 모두 0인 UUID, 시연용 비밀번호는 연결에 사용할 수 없습니다.
vless://[email protected]:443?encryption=none&security=tls&type=ws&host=edge.example.com&path=%2Fdemo&sni=edge.example.com#Example
trojan://[email protected]:443?security=tls&type=tcp&sni=edge.example.com#Example
| 필드 | 의미 및 확인 사항 |
|---|---|
@ 앞 | VLESS는 보통 UUID, Trojan은 보통 비밀번호를 사용합니다. 특수 문자는 URI 규칙에 따라 인코딩해야 합니다. |
security=tls | TLS 관련 설정을 나타냅니다. 실제 서비스 설정과 일치해야 하며 포트만으로 추정할 수 없습니다. |
type=ws / type=tcp | 전송 방식을 나타냅니다. 전송 방식에 따라 확인해야 할 추가 필드가 다릅니다. |
sni | TLS 핸드셰이크에 사용하는 서버 이름입니다. 서비스 설정 및 인증서 검증 요구 사항과 일치해야 합니다. |
host / path | WebSocket 설정에서 자주 사용됩니다. %2Fdemo는 디코딩하면 /demo입니다. |
encryption=none은 VLESS 프로토콜 자체의 암호화 필드를 설명하며, 연결 전체가 암호화되지 않는다는 뜻은 아닙니다. TLS 사용 여부는 별도로 확인해야 합니다. Trojan은 보통 TLS를 통해 전송됩니다. 인증서 오류가 발생하면 기기 시간, SNI, 인증서를 확인하고, 인증서 검증을 끄는 방법을 일반적인 해결책으로 사용하지 마세요.
확장 매개변수 지원 여부는 파서에 따라 다를 수 있습니다. 공유 링크에 이 글에서 다루지 않은 매개변수가 있다면 원문을 보존하고 편집 화면에서 확인하세요. 가져오기에 성공했다고 모든 확장 매개변수가 적용된 것은 아닙니다.
QR 코드·클립보드·Subscribe: 링크 유형에 맞게 가져오기
QR 코드는 텍스트를 담는 또 다른 방식일 뿐입니다. QR 코드에는 단일 서버 URI나 구독 URL이 들어갈 수 있으며, 스캔한다고 단일 서버 링크가 업데이트 가능한 구독 링크로 바뀌지는 않습니다. 먼저 출처 안내를 확인한 다음 인식된 내용을 살펴보세요.
Subscribe: 구독 업데이트 연결 유지
권장기존 구독을 계속 업데이트하려면 Home → + → Type에서 Subscribe를 선택하고 화면의 필드에 구독 URL을 입력한 뒤 저장하세요. 처음 가져오기가 완료되면 생성된 항목과 구독 그룹을 확인하세요.
적합한 경우: 구독 주소임을 확인했고 직접 사용하는 서버 목록을 계속 동기화하려는 경우
클립보드 가져오기: 전체 URI 해석
프로토콜 접두사부터 마지막 메모까지 링크 전체를 복사한 뒤 Home으로 돌아가세요. 클립보드 접근 또는 가져오기 안내가 표시되면 확인한 다음 해석 결과를 점검하세요. 안내가 표시되지 않으면 +를 눌러 원래 매개변수대로 항목을 직접 만들 수 있습니다.
적합한 경우: 완전한 단일 서버 공유 링크가 하나 이상 있는 경우
QR 코드 스캔: QR 코드의 원본 내용 읽기
Home에서 스캔 메뉴를 열고 카메라 접근을 허용한 뒤 기존 QR 코드를 스캔하세요. 인식된 내용이 웹페이지나 일반 텍스트라면 용도를 먼저 확인하고 서버 항목으로 저장하지 마세요.
적합한 경우: 링크가 다른 화면에 표시되어 직접 복사하기 어려운 경우
구독 주소의 예시는 https://example.com/sub?token=xxxx와 같은 형태입니다. URL 형식을 설명하기 위한 것으로, 실제로 사용할 수 있는 내용은 포함되어 있지 않습니다. 쿼리 매개변수의 token은 온전히 보존해야 하며 단일 서버 비밀번호로 바꿔서는 안 됩니다. token이 포함된 주소를 공개 게시판에 올리지 마세요.
- 문제 해결 중 기존 설정을 잃지 않도록 현재 항목과 사용 중인 매개변수를 먼저 저장하세요.
- 가져오기가 끝나면 항목 수, Type, Address, Port, TLS 및 전송 설정을 확인하세요.
- 앱에서 해당 구독의 업데이트 기능을 사용해 업데이트가 완료되는지 확인한 뒤 자동 업데이트 설정을 검토하세요.
- 구독에 포함된 항목을 직접 편집한 경우 다음 업데이트 때 서버 응답의 매개변수로 다시 덮어써질 수 있습니다. 유지해야 할 변경 사항은 별도로 기록해 두세요.
구독 응답에는 공유 URI 여러 개가 포함될 수도 있고 클라이언트가 인식하는 다른 형식이 사용될 수도 있습니다. 서버 목록 구독과 Config의 구성 파일은 서로 다른 항목입니다. 서버를 가져와도 규칙, DNS, Global Routing이 자동으로 모두 설정되지는 않습니다.
가져오기 실패·구독 실패·연결 실패를 구분해 확인하기
먼저 문제가 발생한 단계를 파악하세요. 항목이 전혀 생성되지 않았다면 링크 형식을 우선 확인합니다. 항목은 생성됐지만 구독 업데이트에 실패한다면 URL 요청을 확인하세요. 항목을 선택해도 웹페이지가 열리지 않는다면 연결과 라우팅을 확인합니다. 문제가 발생한 단계를 찾기 전에 모든 설정을 반복해서 삭제하지 마세요.
링크를 복사했는데 인식되지 않는 이유는 무엇인가요?
텍스트가 ss:// 등의 접두사로 시작하는지 확인하고 따옴표, 한국어 설명, 메신저가 삽입한 줄바꿈이 섞이지 않았는지 살펴보세요. 표시된 문구만 복사하고 전체 내용을 복사하지 않은 것은 아닌지 확인하세요. 클립보드 접근이 거부되었다면 해당 앱의 시스템 붙여넣기 권한을 확인하거나 Home → +에서 알고 있는 매개변수를 직접 입력하세요.
QR 코드를 스캔했더니 https://로 시작합니다. 서버 항목으로 바로 사용할 수 있나요?
접두사만으로 판단할 수 없습니다. 구독 주소인지, 구성 주소인지, 일반 웹페이지인지 먼저 확인하세요. 서버 목록용 구독 URL임이 명확한 경우에만 Type이 Subscribe인 항목에 입력합니다. 스캔 후 미리보기 내용이 출처 안내와 다르면 저장하지 마세요.
구독은 저장되지만 업데이트에 실패하면 어떻게 해야 하나요?
저장되었다는 것은 로컬 항목이 만들어졌다는 뜻일 뿐, 원격 요청이 성공했다는 뜻은 아닙니다. URL이 완전한지, token이 유효한지, 네트워크에서 해당 주소에 접속할 수 있는지 확인하세요. HTTP 401 또는 403은 보통 접근 권한과 관련되고, 404는 경로나 리소스와 관련되며, 시간 초과가 발생하면 네트워크와 대상 서버의 응답을 확인해야 합니다. 구독 요청 오류를 해결하려고 단일 서버의 Port를 변경하지 마세요.
서버 항목을 가져왔는데 웹페이지가 열리지 않는 이유는 무엇인가요?
Home에서 선택한 항목과 연결 상태를 확인한 다음 Global Routing을 살펴보세요. Direct는 선택한 프록시를 통해 트래픽을 전달하지 않습니다. Proxy는 규칙이 원인인지 임시로 확인할 때 사용할 수 있으며, Config는 현재 구성에 따라 처리합니다. 기존 모드를 기록해 두고 테스트 후 복원하세요. Address, Port, 인증 정보, TLS, SNI, 전송 매개변수도 확인해야 합니다.
Settings → On Demand는 조건에 따라 연결을 시작하는 동작을 관리하며, 잘못된 공유 링크를 유효한 항목으로 고쳐 주지는 않습니다. 가져오기 문제를 점검할 때는 먼저 항목 하나를 직접 확인하고 연결을 테스트한 다음 On Demand를 별도로 확인하세요. 자동 연결 동작과 형식 문제가 뒤섞이지 않도록 주의해야 합니다.
공유 전 확인: 링크 인코딩은 정보 비식별화가 아닙니다
Base64, 퍼센트 인코딩, QR 코드는 인증 정보를 숨기는 보안 수단이 아닙니다. 공유 링크에는 비밀번호, UUID, 서버 주소가 포함될 수 있고, 구독 URL에는 서버 목록 전체를 읽을 수 있는 token이 들어갈 수 있습니다. 스크린샷에서 비밀번호가 보이지 않더라도 QR 코드와 인코딩된 문자열 전체를 복원할 수 있습니다.
- 문제 해결을 요청할 때는 프로토콜 유형, 전송 방식, 포트, 오류 메시지 등 필요한 정보만 남기세요.
- 비밀번호 전체, UUID, 구독 token, QR 코드를 제거하세요. 메모 이름만 가리는 것으로는 충분하지 않습니다.
- 구조를 보여 줘야 한다면 예시 도메인과 명확한 시연 값을 사용하고 실제 링크는 붙여넣지 마세요.
- 인증 정보가 이미 공개되었다면 사용 중인 서비스 관리 채널에서 폐기하거나 교체한 뒤 로컬 항목도 업데이트하세요.