ss://·vmess://·vless://·trojan:// 링크 형식 안내: 단일 서버 공유 링크와 구독 URL 차이

1. 단일 서버 공유 링크와 구독 URL의 차이

단일 서버 공유 링크는 연결에 필요한 매개변수를 URI 하나에 담습니다. ss://, vmess://, vless://, trojan:// 접두사를 통해 가져오기 기능이 적용할 형식을 구분할 수 있습니다. 가져오면 서버 항목이 추가되며, 새 내용을 계속 가져오는 주소가 생성되는 것은 아닙니다.

구독 URL은 보통 HTTPS 주소입니다. Shadowrocket이 해당 주소에 요청을 보내고 응답 내용을 읽어 서버 항목을 파싱합니다. 구독 업데이트는 원격 콘텐츠를 다시 요청해 처리하는 방식입니다. 이미 가져온 단일 서버 링크 자체가 바뀌는 것은 아닙니다. 구독 URL은 서비스 제공업체에서 받으세요. 주소가 https://로 시작한다는 사실만으로 서버 구독인지, 구성 파일인지, 일반 웹페이지인지 알 수는 없습니다.

2. ss://: 인증 정보, 서버 주소, 메모

Shadowsocks에서 흔히 사용하는 SIP002 형식에는 Base64URL로 인코딩된 인증 정보와 서버 주소, 포트, 선택 사항인 메모가 포함됩니다. 아래 예시의 인증 정보를 디코딩하면 aes-256-gcm:password이고, 주소는 example.com, 포트는 8388입니다. 이 예시 매개변수로는 연결할 수 없습니다.

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

과거 형식 중에는 암호화 방식, 비밀번호, 주소, 포트를 통째로 인코딩하는 방식도 있습니다. 이 경우 문자열에서 @가 보이지 않을 수 있습니다. 가져오기에 실패하면 구분자를 임의로 추가하기보다 링크가 어떤 형식인지 먼저 확인하세요. 일부 링크에는 플러그인 매개변수도 포함됩니다. 주소와 비밀번호가 맞더라도 해당 매개변수를 빠뜨리면 연결되지 않을 수 있습니다.

3. vmess://: Base64로 인코딩된 JSON 매개변수

흔히 사용하는 VMess 공유 형식은 vmess:// 뒤에 Base64 텍스트가 이어집니다. 디코딩하면 보통 JSON이 나오며, 일반적인 ‘사용자 이름@서버’ 형식이 아닙니다. 아래는 인코딩 전의 예시 JSON으로, 복사해 바로 가져올 수 있는 완전한 링크가 아닙니다.

{
  "v": "2",
  "ps": "Example-VMess",
  "add": "example.com",
  "port": "443",
  "id": "11111111-2222-4333-8444-555555555555",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "example.com",
  "path": "/connect",
  "tls": "tls",
  "sni": "example.com"
}

• add와 port는 연결 대상 정보를 지정합니다. id는 인증에 사용하는 UUID이며 메모로 대체할 수 없습니다.
• net이 ws라면 WebSocket의 host와 path를 함께 확인해야 합니다. 경로의 대소문자와 앞부분의 슬래시를 그대로 유지하세요.
• tls와 sni는 TLS 연결에 영향을 줍니다. WebSocket Host와 TLS SNI는 용도가 다릅니다. 예시 값이 같더라도 동일한 항목으로 취급하면 안 됩니다.
• v는 공유 링크 형식의 필드이지 Shadowrocket 앱 버전이 아닙니다. aid 등의 필드는 실제 서비스 매개변수에 따라 해석해야 하며, 예시를 그대로 적용해 바꾸면 안 됩니다.

메시지에서 링크를 복사하는 과정에서 줄바꿈, 스마트 따옴표 삽입, Base64 문자열 잘림이 발생하면 파싱에 실패할 수 있습니다. 원본 전체 텍스트를 다시 복사한 뒤 가져온 결과를 확인하세요. VMess JSON을 Config에 구성 파일 본문처럼 붙여 넣지 마세요. JSON의 port를 구독 URL의 포트로 착각해서도 안 됩니다.

4. vless://와 trojan://: 읽기 쉬운 매개변수도 하나씩 확인

VLESS와 Trojan 공유 링크는 흔히 직관적인 URI 구조를 사용합니다. 인증 정보는 @ 앞에 있고, 뒤에는 주소와 포트, 쿼리 매개변수가 이어집니다. 예시의 &는 페이지에서 링크 매개변수를 구분하는 기호로 표시됩니다. 실제로 복사할 때는 원본 링크 전체를 유지하세요.

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

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

path=%2Fconnect의 %2F는 슬래시를 퍼센트 인코딩한 값입니다. 비밀번호에 @, # 같은 URI 예약 문자가 포함된 경우에도 올바르게 인코딩해야 합니다. 그렇지 않으면 파서가 비밀번호 일부를 주소나 메모로 인식할 수 있습니다. 필드 경계를 정확히 모른다면 링크 전체를 임의로 디코딩한 뒤 가져오지 마세요.

VLESS 예시의 encryption=none은 프로토콜에 해당하는 매개변수입니다. 이 설정만으로 예시 링크에 TLS가 없다는 뜻은 아닙니다. 공유 형식에 따라 매개변수 이름이 다를 수 있으므로 접두사만 바꿔 VLESS 링크를 Trojan 링크로 변환할 수는 없습니다.

5. Shadowrocket 가져오기 경로: 서버 구독과 Config 구분하기

Home에서는 서버 항목과 연결 대상을 관리하고, Config에서는 규칙 구성을 관리하며, Settings에서는 앱 설정을 관리합니다. 서버 구독은 여러 서버 항목을 일괄 관리하기 위한 기능입니다. 원격 구성에는 [General], [Rule] 같은 섹션이 포함될 수 있습니다. 두 종류 모두 HTTPS로 가져올 수 있지만 주소가 비슷해 보여도 같은 메뉴에 입력하면 안 됩니다.

클립보드 및 카메라 권한은 시스템에서 관리합니다. 링크 전체를 복사한 뒤 Home으로 돌아가 표시되는 가져오기 안내를 따르세요. QR 코드는 Home의 스캔 기능으로 원본 텍스트를 읽습니다. 인식 안내가 표시되지 않으면 접두사와 공백, 줄바꿈을 먼저 확인하세요. 구독 URL을 단일 서버의 Address 필드에 입력하면 안 됩니다.

6. 구독 업데이트 방식, 민감한 매개변수, 문제 해결 순서

아래는 실제 주소가 아닌 예시입니다. token=xxxx는 인증 매개변수가 들어가는 위치를 나타내며 실제 인증 정보가 아닙니다. 서버는 요청을 받으면 인코딩된 서버 목록이나 클라이언트가 인식할 수 있는 다른 구독 콘텐츠를 반환할 수 있습니다. HTTPS URL만으로는 응답 형식을 알 수 없습니다.

https://example.com/sub?token=xxxx

1. 먼저 리소스 유형을 확인합니다. 해당 주소가 서버 구독인지 원격 구성인지 서비스 제공업체에 확인하세요. 로그인 페이지, 오류 메시지 또는 빈 내용이 반환되면 유효한 서버 목록으로 처리할 수 없습니다.
2. 다음으로 요청이 성공했는지 확인합니다. 시간 초과가 발생하면 현재 네트워크에서 구독 도메인에 접속할 수 있는지 먼저 확인하세요. HTTP 401 또는 403은 대개 권한이나 링크 상태를 확인해야 합니다. 브라우저에 웹페이지가 표시된다는 이유만으로 구독이 유효하다고 판단하지 마세요.
3. 그다음 파싱 결과를 확인합니다. 요청은 성공했지만 항목이 표시되지 않는다면 현재 가져오기 경로에서 지원하지 않는 콘텐츠이거나 실제로 사용 가능한 항목이 없는 것일 수 있습니다. 형식 안내를 확인하고 같은 구독을 반복해서 추가하지 마세요.
4. 마지막으로 연결과 규칙을 확인합니다. 업데이트에 성공해도 모든 항목이 연결되는 것은 아닙니다. 먼저 Home에서 선택된 항목을 확인한 다음 Global Routing을 살펴보세요. Config는 구성 규칙을 사용합니다. Proxy는 프록시 처리 대상 트래픽을 프록시 정책에 전달하고, Direct는 직접 연결하며, Scene은 선택한 시나리오 설정에 따라 트래픽을 처리합니다. 서버 공유 링크만으로는 전체 트래픽 분기 규칙이 설정되지 않습니다.

7. 링크 가져오기 및 구독 업데이트 자주 묻는 질문