이 글의 핵심

구독 URL이 있다면 Home → + → Type → Subscribe에서 추가합니다. 서버 한 대의 연결 정보만 있다면 Add Server에서 직접 입력하세요. QR 코드와 클립보드는 입력 방법이 다를 뿐, 가져온 결과는 그 안에 담긴 내용에 따라 달라집니다. 이 글은 사용자가 이미 서비스 제공업체와 구독을 보유한 경우를 전제로 추가 경로, 입력 항목, 업데이트 및 확인 방법을 설명하고, Config 파일과 Subscribe 서버 목록의 차이도 짚습니다.

1. 먼저 링크 종류 확인하기: Subscribe와 Config는 서로 다릅니다

Shadowrocket 구독을 가져올 때는 먼저 받은 내용이 서버 목록인지, 단일 서버 공유 링크인지, 아니면 구성 파일인지 확인해야 합니다. 링크가 https://로 시작한다는 이유만으로 가져오기 경로를 정하지 마세요. HTTPS 주소라도 응답 내용은 서로 다를 수 있습니다.

Subscribe는 서버 목록을 가져오고 업데이트하는 기능이며, Config는 규칙과 DNS 등의 설정이 담긴 구성 파일을 관리합니다. ‘Config의 Subscribe’를 검색할 때는 두 개념을 구분하세요. 일반적인 서버 구독은 Home → + → Type → Subscribe에서 추가하며, 서버 구독을 Config 구성 파일로 내려받는 것이 아닙니다.

서버 구독

내용
여러 서버의 연결 정보
추가 경로
Home → + → Type → Subscribe
예시
https://example.com/sub?token=xxxx
업데이트 결과
구독 응답에 따라 서버 목록이 변경됨

예시 값은 임의로 작성한 것으로 연결에 사용할 수 없습니다. 사용자가 이미 보유한 구독의 전체 URL을 입력하세요.

Config 구성 파일

내용
규칙, DNS 등의 설정 항목
추가 경로
Config → +에서 원격 구성 주소 추가
일반적인 구성
[General]、[Rule]
적용 조건
구성 파일을 선택하고 적절한 Global Routing 모드 사용

파일명과 확장자만으로는 내용 유형을 확인할 수 없습니다. 제공업체가 안내한 용도를 확인하세요.

단일 서버 공유 링크에는 보통 ss://, vmess://, vless://, trojan:// 같은 프로토콜 접두사가 붙습니다. 이런 링크는 대개 서버 하나의 정보만 담고 있어 지속적으로 업데이트되는 구독과는 다릅니다. QR 코드나 클립보드에서 이런 링크를 가져올 수도 있으니, 저장한 뒤 실제로 추가된 항목이 서버 하나인지 구독 그룹인지 확인하세요.

2. Subscribe 링크로 가져오기: 추가한 뒤 첫 업데이트 결과 확인

이미 이용 중인 서비스 제공업체의 관리 페이지에서 클라이언트 전용 구독 URL을 복사하세요. 로그인 페이지 주소를 복사하면 안 됩니다. 링크의 token은 접근 자격 정보이므로 대소문자, 물음표, 연결 문자를 포함해 그대로 유지하세요. 공개 댓글에 공유하거나 기록하기 편하도록 매개변수를 임의로 삭제하지 마세요.

  1. 링크 복사

    기존 구독의 전체 URL을 복사하세요. 앞뒤에 공백, 따옴표, 한글 문장부호가 붙지 않았는지 확인하고 페이지 제목이나 브라우저의 공유 안내 문구는 복사하지 마세요.

  2. 추가 화면 열기

    Home에서 오른쪽 위의 +를 눌러 Add Server로 이동합니다. Type을 열고 Subscribe를 선택하세요. 직전에 수동 입력할 때 선택했던 프로토콜을 그대로 사용하지 않도록 주의하세요.

  3. 항목 입력

    URL에 구독 주소를 붙여 넣고 Remarks에는 알아보기 쉬운 이름을 입력하세요. URL은 목록을 가져오는 주소이므로 Address와 Port로 나눠 입력하지 않습니다.

  4. 저장하고 업데이트

    저장한 뒤 Home으로 돌아와 구독 그룹과 서버 항목이 표시되는지 확인하세요. 목록이 아직 불러와지지 않았다면 아래로 당겨 업데이트하고 오류가 표시되는지 확인합니다.

  5. 내용 확인

    그룹을 펼쳐 서버 수, 이름, 프로토콜이 기존 서비스 제공업체의 안내와 일치하는지 확인하세요. 그룹 이름만 있고 서버가 없다면 업데이트 응답부터 확인하고, 같은 구독을 연달아 추가하지 마세요.

처음 저장에 성공했다는 것은 구독 정보가 기록됐다는 뜻일 뿐, 원격 콘텐츠를 정상적으로 가져왔다는 의미는 아닙니다. 업데이트 과정에서는 네트워크 연결, 인증 정보, 응답 파싱도 필요합니다. 응답이 로그인 웹페이지라면 페이지가 열리더라도 서버 목록으로 가져올 수 없습니다.

3. Add Server에서 직접 입력하기: 프로토콜에 맞춰 입력하고 기본값을 그대로 쓰지 않기

Address, Port, 비밀번호나 키 등 연결 정보만 있다면 Home → + → Add Server로 이동해 Type에서 실제 프로토콜을 선택하세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 인증 및 전송 항목이 서로 다릅니다. Type 이름만 바꾸고 이전 항목의 설정을 그대로 사용하면 안 됩니다.

포트에는 모든 경우에 맞는 정답이 없습니다. 제공업체가 Port로 443을 명시한 경우에만 443을 입력하세요. 숫자만으로 TLS 사용 여부를 알 수 없으며 비밀번호, UUID, 공개 키나 다른 인증 정보도 대신할 수 없습니다.

저장한 뒤 먼저 세부 정보를 확인하고 연결 상태를 점검하세요. 직접 입력한 항목은 구독을 통해 업데이트되지 않습니다. 제공업체가 포트, 비밀번호, 전송 설정을 변경하면 직접 수정해야 합니다. 기존 구독을 이용할 수 있다면 목록 변경 사항을 동기화하기 편하지만, 업데이트 결과는 여전히 확인해야 합니다.

4. QR 코드와 클립보드: 내용과 저장 위치 확인하기

QR 코드는 별도의 프로토콜이 아닙니다. 단일 서버 공유 링크나 구독 URL이 담길 수 있습니다. QR 코드의 크기, 이미지 이름, 주변 설명만으로 내용을 확인할 수는 없습니다. 이미 이용 중인 서비스 제공업체가 제공했거나 직접 저장한 QR 코드만 스캔하고 출처를 알 수 없는 구성을 가져오지 마세요.

QR 코드 스캔

  1. Home 상단의 스캔 기능을 눌러 카메라를 실행하고, 시스템 안내에 따라 카메라 접근을 허용한 뒤 QR 코드 전체가 화면에 들어오도록 맞추세요.
  2. QR 코드가 현재 기기에 저장되어 있다면 스캔 화면에서 사진을 불러오는 기능을 사용할 수 있습니다. 사진 접근 권한은 시스템 안내를 따르세요.
  3. 인식한 뒤 가져올 내용을 확인하세요. 단일 프로토콜 링크는 서버 항목으로, 구독 URL은 Subscribe로 처리해야 합니다. 인식에 성공했다고 해서 확인 절차를 건너뛰지 마세요.
  4. 저장한 뒤 Home으로 돌아가 새 항목이나 그룹이 추가됐는지 확인하세요. 구독은 목록 업데이트까지 성공해야 하며, QR 코드 스캔만으로 서버를 사용할 수 있다는 뜻은 아닙니다.

클립보드에서 가져오기

  1. 공유 링크 전체를 복사하세요. 채팅 기록에 포함된 설명, 번호, 코드 블록 표시까지 함께 복사하지 마세요.
  2. Shadowrocket으로 돌아가 필요한 클립보드 읽기를 허용하세요. 클립보드 가져오기 안내가 나타나면 내용을 확인한 뒤 진행합니다.
  3. 자동 인식 안내가 표시되지 않으면 먼저 텍스트가 지원되는 전체 공유 링크인지 확인하세요. 일반 HTTPS 구독 URL은 Home → + → Type → Subscribe에서 URL에 직접 붙여 넣으면 됩니다. 자동 인식에 의존할 필요는 없습니다.
  4. 새로 추가된 항목의 Type, Address, Port를 확인하세요. 작업을 마친 뒤에는 클립보드에 자격 정보가 남지 않도록 일반 텍스트로 바꿔 두면 실수로 다시 붙여 넣는 일을 줄일 수 있습니다.

5. 가져온 뒤 확인하기: 서버 목록과 Global Routing을 따로 점검

먼저 Home에서 가져온 서버 하나를 선택한 뒤 연결을 켜고, 시스템 안내에 따라 VPN 구성을 추가하도록 허용하세요. 시스템에 VPN 상태가 표시되면 터널이 연결됐다는 뜻일 뿐, 모든 대상 연결이 선택한 서버를 거친다는 의미는 아닙니다. 특정 연결이 전달되는지는 Global Routing과 현재 구성에도 달려 있습니다.

Config

권장

현재 선택한 구성으로 연결을 처리합니다. 규칙에 따라 PROXY, DIRECT 또는 다른 정의된 정책을 적용할 수 있습니다. 앞선 규칙에 해당하지 않는 연결의 처리 방식은 FINAL 등 구성 내용에 따라 달라지므로 모두 직접 연결된다고 볼 수 없습니다.

적합한 경우: Config 파일을 확인했고, 정해진 규칙에 따라 트래픽을 분기해 사용하려는 경우.

Proxy

가로채는 연결을 프록시로 처리해 규칙 선택의 영향을 잠시 배제할 수 있습니다. 비밀번호 오류, 연결할 수 없는 포트, 만료된 서버 설정을 해결해 주지는 않습니다.

적합한 경우: 선택한 서버가 대상 연결을 전달할 수 있는지 임시로 확인할 때.

Direct

연결을 직접 연결 모드로 처리합니다. Direct로 전환한 뒤 웹페이지가 열린다고 해서 방금 가져온 서버를 사용할 수 있다는 뜻은 아닙니다. 이 테스트는 프록시 연결을 확인하지 않습니다.

적합한 경우: 로컬 네트워크 상태와 비교해 기존 네트워크 접근 문제인지 확인할 때.

확인할 때는 한 번에 조건 하나만 바꾸세요. 서버와 테스트 대상을 고정한 뒤 Proxy와 Config를 비교합니다. Proxy에서는 접속되지만 Config 결과가 예상과 다르면 Config의 일치 규칙을 확인하세요. 둘 다 실패하면 서버 정보와 네트워크 연결 상태부터 다시 점검합니다. Global Routing의 Scene은 상황별 선택 기능이므로 처음 문제를 확인할 때는 Scene 변경을 동시에 적용하지 마세요.

6. 가져오기 및 업데이트 관련 자주 묻는 질문

구독을 저장했는데 서버 목록이 비어 있는 이유는 무엇인가요?

Home으로 돌아가 아래로 당겨 업데이트하고 시간 초과, 인증 오류, 파싱 실패 중 어떤 응답이 나오는지 먼저 확인하세요. URL이 관리 웹페이지가 아니라 기존 서비스 제공업체가 제공한 클라이언트용 구독 주소인지 확인한 뒤 token이 온전히 포함됐는지 점검합니다. 같은 구독을 계속 새로 만들어 재시도하지 마세요.

업데이트가 시간 초과되면 프록시를 통한 업데이트를 켜야 하나요?

먼저 현재 네트워크에서 구독 주소에 접근할 수 있는지 확인하세요. 이미 사용할 수 있는 서버가 있다면 연결한 뒤 Settings → Subscribe에서 Update via Proxy를 확인하고 업데이트를 다시 시도할 수 있습니다. 연결 가능한 서버가 없다면 이 옵션만 켜서는 접근 경로가 생기지 않으므로 먼저 구독 주소에 연결할 수 있는 네트워크 상태를 해결해야 합니다.

QR 코드 인식은 성공했는데 구독 그룹이 없는 이유는 무엇인가요?

QR 코드 내용이 ss:// 같은 단일 공유 링크인지 확인하세요. 서버 한 대를 가져온 경우 구독 그룹이 없는 것이 정상입니다. 지속적으로 업데이트되는 목록이 필요하다면 같은 항목을 반복해서 스캔하지 말고 사용자가 이미 보유한 Subscribe URL을 사용하세요.

링크를 복사했는데 가져오기 안내가 표시되지 않는 이유는 무엇인가요?

시스템에서 이번 클립보드 읽기를 허용했는지 확인하고, 클립보드에 설명 문구가 섞이지 않았는지도 살펴보세요. 일반 HTTPS 주소는 서버 가져오기를 자동으로 시작하지 않을 수 있습니다. 구독 URL이라면 Home → + → Type → Subscribe로 이동해 전체 주소를 URL에 붙여 넣으면 됩니다.

업데이트 후 서버가 줄었는데 다시 추가해야 하나요?

먼저 이번 업데이트가 성공했는지 확인한 뒤 기존 서비스 제공업체가 안내한 목록과 비교하세요. 원격 목록에서 항목이 제거되면 로컬 그룹도 함께 변경되는 것이 정상적인 동기화 결과일 수 있습니다. 기존 구독을 먼저 삭제하지 마세요. 주소, 그룹, 오류 안내를 확인한 뒤 기록을 수정할지 결정하세요.

가져오기가 완료됐다고 판단하려면 콘텐츠 유형이 맞고, 항목이 온전히 저장되며, 구독 업데이트가 가능하고, 서버와 라우팅 모드를 선택한 뒤 실제 요청이 예상대로 처리되어야 합니다. 항목이 표시되거나 QR 코드 인식에 성공하거나 VPN 아이콘이 보이는 것만으로는 충분하지 않습니다.