이 글의 핵심

자신이 이용 중인 서비스의 구독 정보나 서버 설정값을 이미 보유한 사용자를 위한 안내입니다. 먼저 서버 구독과 원격 설정 파일의 차이를 확인한 뒤, Subscribe, Add Server, QR 코드, 클립보드 중 하나로 가져옵니다. 마지막으로 업데이트 결과, Global Routing, Connectivity Test를 확인합니다. 가져오기 방법에 따라 업데이트 가능한 구독 그룹이 만들어지지 않을 수 있으며, 가져오기에 성공했다고 연결까지 완료된 것은 아닙니다.

서버 구독과 Config 설정 파일 구분하기

Shadowrocket의 Home은 주로 서버 선택, 서버 구독 관리와 연결에 사용하고, Config는 규칙 설정 파일 관리에, Settings는 앱 설정 조정에 사용합니다. 서버 구독에는 연결 항목이 들어 있고 규칙 설정은 요청의 라우팅 방식을 정하므로, HTTPS 주소라는 이유만으로 두 자료를 같은 종류로 볼 수는 없습니다.

Config의 Subscribe는 원격 설정 파일을 위한 기능입니다. 서비스 제공업체에서 받은 서버 구독 주소라면 Home 오른쪽 위의 «+»를 눌러 Add Server로 이동한 다음 Type을 Subscribe로 설정하세요. 서버 구독을 규칙 설정 파일로 가져오면 파싱에 실패하거나, 가져온 뒤에도 예상한 서버 목록이 보이지 않을 수 있습니다.

서버 구독

위치
Home → + → Type → Subscribe
내용
서버 연결 설정값 모음
주소 예시
https://example.com/sub?token=xxxx
확인 위치
Home의 구독 그룹 및 항목

주소는 형식 예시일 뿐입니다. 실제로 가져올 때는 본인이 보유한 유효한 주소를 사용하세요.

원격 규칙 설정

위치
Config → Subscribe
내용
[General], [Rule] 등의 섹션이 포함된 설정 텍스트
주소 예시
https://example.com/profile.conf
확인 위치
Config에 저장해 선택한 설정 파일

설정 파일은 DNS, 규칙, 정책 참조에 영향을 줄 수 있으므로 적용 전에 내용을 확인하세요.

형식을 판단할 때는 먼저 제공업체가 안내한 링크 용도를 확인하고, 그다음 응답 내용을 살펴보세요. 파일 확장자만으로 판단하지 마세요. HTTPS 주소도 로그인 페이지, 오류 메시지 또는 만료 안내를 반환할 수 있으며, 이런 내용은 서버 구독으로 파싱할 수 없습니다. 구독 URL의 token은 보통 접근 자격 증명 역할을 하므로 문제를 확인할 때는 전체 주소, 비밀번호, UUID를 가리세요.

방법 1: Subscribe로 업데이트 가능한 구독 추가하기

서버 항목을 계속 동기화하려면 Type이 Subscribe인 구독 항목을 사용하세요. 이 항목에는 구독 주소가 저장되며, 이후 업데이트할 때 서버 목록을 다시 가져옵니다. 서버 설정값을 하나씩 저장하는 방식과 달리, 반복해서 요청할 데이터 출처를 보존합니다.

  1. 주소 복사

    자신의 서비스 정보에서 구독 주소 전체를 복사하세요. https://, 경로, 쿼리 매개변수를 빠뜨리지 마세요. 설명 문구나 줄바꿈, 끝에 붙은 문장 부호는 함께 복사하지 마세요.

  2. 유형 선택

    Home → 오른쪽 위 «+» → Add Server → Type → Subscribe로 이동한 다음, 개별 서버 프로토콜 유형이 선택되어 있지 않은지 확인하세요.

  3. 주소 입력

    URL에 구독 주소를 붙여 넣고, 메모에는 알아보기 쉬운 이름을 입력하세요. token이 온전히 포함되었는지 확인한 뒤 저장합니다.

  4. 목록 업데이트

    Home으로 돌아가 아래로 당겨 구독을 업데이트하세요. 요청이 끝나면 해당 구독 그룹을 펼쳐 서버 항목이 생성되었는지 확인합니다. 빈 그룹만 표시되는지 살펴보세요.

  5. 항목 확인

    항목 하나의 편집 정보를 열고 Type, 서버 주소, Port가 보유한 정보와 일치하는지 확인한 뒤 Home에서 해당 서버를 선택하세요. 먼저 연결을 한 번 확인한 다음 자동 업데이트 설정을 조정하세요.

원격 규칙 설정 주소를 받았다면 Config → Subscribe로 이동해 설정 파일을 추가하고 가져오세요. Config에서 내용을 확인한 뒤 선택해 사용합니다. 원격 설정 파일 업데이트와 서버 구독 업데이트는 별개의 작업이므로 하나를 업데이트해도 다른 하나까지 동기화되는 것은 아닙니다.

방법 2: Add Server에 설정값 직접 입력하기

서버 주소, 포트, 인증 정보만 있고 가져올 링크가 없다면 Home → «+» → Add Server를 사용하세요. 먼저 Type을 선택한 뒤 프로토콜에 맞는 항목을 입력합니다. Type을 바꾸면 필요한 인증, 전송, TLS 설정도 달라집니다. 수동으로 추가한 항목은 단일 연결 항목이며 업데이트 가능한 구독으로 자동 전환되지 않습니다.

Add Server에서 원본 정보와 대조할 설정값
Type필수 설정값자주 빠뜨리는 항목
Shadowsocks서버 주소, Port, 암호화 방식, Password암호화 방식이 서버와 다르거나 서버에서 요구하는 플러그인 설정을 입력하지 않음
VMess / VLESS서버 주소, Port, UUID, 전송 설정UUID만 입력하고 실제로 사용 중인 TLS, SNI, WebSocket Path 등의 설정을 빠뜨림
Trojan서버 주소, Port, Password, TLS 관련 설정연결 주소와 인증서 확인에 사용하는 서버 이름을 혼동함
Hysteria2서버 주소, Port, 인증 정보, TLS 설정서버에서 사용하는 혼합·난독화 설정을 빠뜨리거나 현재 네트워크에서 UDP가 제한됨
WireGuard개인 키, 피어 공개 키, Endpoint, 인터페이스 주소키를 일반 비밀번호처럼 취급하거나 피어 및 인터페이스 설정을 빠뜨림

예를 들어 제공된 정보에 Port가 443으로 명시된 경우에만 443을 입력하세요. TLS를 사용한다는 이유로 포트를 임의로 이 값으로 바꾸지 마세요. 연결 IP, SNI, HTTP Host는 서로 다른 역할을 할 수 있으므로 원본 설정에 따라 각각 입력해야 합니다. TLS 인증 오류가 발생하면 기기 시간, 서버 이름, 인증서 정보를 먼저 확인하세요. 인증 확인을 끄는 것은 일반적인 해결 방법이 아닙니다.

방법 3·4: QR 코드 스캔 및 클립보드에서 가져오기

QR 코드와 클립보드는 데이터를 전달하는 수단이지 새로운 연결 프로토콜이 아닙니다. QR 코드에는 단일 서버 URI나 구독 주소가 담길 수 있으며, 클립보드도 마찬가지입니다. 구독 그룹이 만들어지는지는 가져오기 방식이 아니라 파싱된 콘텐츠에 따라 달라집니다.

QR 코드 스캔

  1. 보유한 QR 코드를 다른 화면에 표시하거나 인쇄한 뒤 Home에서 스캔 기능을 여세요. 처음 사용할 때는 카메라 접근을 허용합니다.
  2. QR 코드 가장자리가 잘리지 않도록 하고 화면을 선명하게 유지하세요. 스캔한 뒤 파싱 결과를 확인합니다. 단일 서버라면 Type과 Port를, 구독 주소라면 URL을 확인하세요.
  3. 확인 후 저장하고 Home으로 돌아가 새 항목이나 구독 그룹이 추가되었는지 확인하세요. QR 코드에 일반 웹페이지 주소만 들어 있다면 이를 억지로 구독으로 저장하지 말고, 먼저 실제 연결 정보를 확인하세요.

같은 기기에 QR 코드가 표시되어 있다면 관련 텍스트 링크를 사용하는 편이 좋습니다. 인증 정보가 포함된 이미지를 반복해서 캡처하거나 전달할 필요가 없습니다. QR 코드에 비밀번호, UUID, 구독 token이 들어 있을 수도 있으므로 연결 자격 증명과 동일하게 안전하게 보관하세요.

클립보드에서 가져오기

  1. ss://, vmess://, vless://, trojan://로 시작하는 단일 공유 링크처럼 전체 링크 텍스트만 복사하세요. 대화 내용 전체를 복사하지 마세요.
  2. Shadowrocket으로 돌아가 클립보드 인식 안내에 따라 가져오기를 진행하세요. 시스템에서 붙여넣기 권한을 묻는 경우, 직접 실행한 이번 작업에 대해서만 허용하세요.
  3. 인식 안내가 표시되지 않으면 클립보드에 원문이 남아 있는지 먼저 확인하세요. 일반 HTTPS 구독 주소는 Home → «+» → Type → Subscribe로 이동해 URL에 붙여 넣으면 됩니다. 자동 인식 기능을 사용할 필요는 없습니다.
  4. 저장한 뒤 항목 수와 이름을 확인하세요. 여러 번 복사해 가져오면 단일 항목이 중복 생성될 수 있으므로 하나씩 확인해 필요한 항목만 남기세요.
서버 구독 주소 형식 예시:
https://example.com/sub?token=xxxx

원격 설정 주소 형식 예시:
https://example.com/profile.conf

단일 서버 공유 링크에 흔히 사용되는 접두사:
ss://
vmess://
vless://
trojan://

위의 도메인과 token은 형식 예시일 뿐 실제 연결 정보가 아닙니다. 공유 링크의 인코딩된 내용을 직접 수정하지 마세요. 특히 +, /, =, % 등의 문자가 메신저에서 바뀌거나 잘리면 원래 설정값을 복구하지 못할 수 있습니다.

가져온 뒤 Global Routing 및 연결 결과 확인하기

가져오기는 자료를 앱에 입력하는 단계일 뿐입니다. 다음으로 Home에서 서버를 선택하고 Global Routing을 확인한 뒤 연결 스위치를 켜세요. 시스템 안내가 표시되면 VPN 구성을 추가하도록 허용합니다. 그런 다음 Connectivity Test를 실행하고 실제로 접속하려는 대상도 확인하세요. 테스트 한 번이 성공했다는 사실은 해당 테스트 요청에서 결과를 얻었다는 의미일 뿐입니다.

Config

권장

현재 선택한 설정의 규칙에 따라 처리합니다. Config에서 규칙 순서와 정책 참조를 확인한 뒤 요청이 직접 연결되어야 하는지 프록시를 거쳐야 하는지 판단하세요.

적합한 경우: 규칙 설정을 확인한 뒤 일상적으로 사용할 때

Proxy

일반 요청을 프록시 경로로 보냅니다. 규칙의 영향을 임시로 확인할 때 사용할 수 있습니다. 시스템 트래픽, 우회 설정, 네트워크 환경도 고려해야 하며, 기기의 모든 패킷이 같은 경로를 거친다고 단정할 수는 없습니다.

적합한 경우: 서버의 기본 연결 상태를 확인하거나 규칙 문제를 일시적으로 분리할 때

Direct

직접 연결 경로를 사용합니다. 서버를 가져와 선택했더라도 이 상태에서 웹페이지가 열린다는 사실만으로 프록시 서버가 작동한다고 판단할 수는 없습니다.

적합한 경우: 로컬 네트워크의 직접 연결 상태를 확인할 때

Scene

설정한 Scene 조건에 따라 해당 라우팅 동작을 적용합니다. 현재 적용 중인 Scene과 설정을 먼저 확인하세요. 의미가 고정된 별도의 전역 프록시 모드로 간주하지 마세요.

적합한 경우: Scene 조건을 설정하고 확인한 뒤 네트워크 전환이 필요할 때

Config 모드에서는 아래 규칙 예시로 첫 번째 일치 규칙의 처리 방식을 이해할 수 있습니다. 완전한 설정 파일은 아닙니다. PROXY가 참조하는 정책은 실제 설정에서 사용할 수 있어야 하며, 몇 줄의 규칙을 붙여 넣는 것만으로 모든 설정이 완료되는 것은 아닙니다.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

DOMAIN-SUFFIX는 도메인과 하위 도메인을 일치시키고, IP-CIDR은 IP 주소 대역을 일치시키며, GEOIP는 IP 지리 정보 데이터베이스를 기준으로 일치시킵니다. FINAL은 앞선 규칙에 일치하지 않은 요청을 처리합니다. 규칙은 위에서 아래로 적용되므로 구체적인 규칙을 포괄적인 규칙보다 위에 두세요. 처음 확인할 때는 Settings → On Demand에서 자동 연결 조건이 활성화되어 있는지 확인하세요. 수동으로 연결을 끊은 뒤 조건에 의해 다시 연결되는 상황을 방지할 수 있습니다.

가져오기 실패 및 업데이트 문제 해결

먼저 증상을 세 가지로 나눠 보세요. 항목이 생성되지 않으면 가져오기 또는 파싱 단계의 문제입니다. 항목은 생성되지만 연결되지 않으면 서버 설정값이나 연결 경로를 확인해야 합니다. 연결 후 일부 대상에서만 문제가 생긴다면 규칙과 DNS를 살펴보세요. 발생 단계에 따라 확인하면 모든 문제를 단순히 «구독이 만료됐다»고 판단하는 일을 줄일 수 있습니다.

링크를 붙여 넣었는데 왜 아무것도 표시되지 않나요?

서버 구독 주소를 잘못 Config → Subscribe에 추가하지 않았는지 먼저 확인하세요. 서버 구독은 Home → «+» → Type → Subscribe에서 추가해야 합니다. URL에 token이 빠졌거나 공백이 섞였는지, 로그인 페이지나 만료 안내가 반환되는지도 확인하세요. HTTP 상태 정보가 있다면 401과 403은 권한 및 접근 조건을, 404는 경로를 확인해야 합니다.

구독 업데이트가 시간 초과되면 먼저 연결해야 하나요?

먼저 현재 네트워크에서 구독 주소에 접근할 수 있는지 확인하세요. 사용할 수 있는 서버가 이미 있다면 연결한 뒤 다시 시도할 수 있습니다. 기존 프록시를 통해 구독을 가져와야 한다면 Settings → Subscribe에서 Update via Proxy를 확인하세요. 사용할 수 있는 연결이 없다면 이 옵션을 켜도 최초 가져오기 문제가 자동으로 해결되지는 않습니다. 먼저 자신의 주소와 네트워크를 확인하세요.

QR 코드 인식에는 성공했는데 왜 연결되지 않나요?

인식에 성공했다는 것은 QR 코드 내용을 파싱할 수 있다는 의미일 뿐입니다. 가져온 항목을 열고 Type, Port, 인증 정보, TLS 설정을 하나씩 확인하세요. Home으로 돌아가 해당 항목을 선택한 뒤 Connectivity Test를 실행합니다. 모든 항목이 실패하면 로컬 네트워크를 확인하고, 하나만 실패한다면 해당 서버 설정값과 서버 상태를 먼저 살펴보세요.

업데이트 후 직접 수정한 이름과 설정값이 바뀌었나요?

구독을 업데이트하면 원격에서 반환된 데이터가 다시 적용되어 그룹 내 수동 변경 사항이 덮어쓰일 수 있습니다. 구독 그룹에서 항목의 출처를 확인하세요. 별도로 관리해야 하는 항목이라면 Add Server에서 설정값 전체를 입력해 따로 저장하고 직접 관리하세요. 해당 항목을 구독 동기화로 업데이트하지 않도록 합니다.

테스트는 통과했는데 특정 웹페이지가 열리지 않나요?

먼저 현재 Global Routing이 Config, Proxy, Direct, Scene 중 무엇으로 설정되어 있는지 확인한 다음, 해당 요청에 실제로 적용된 규칙과 DNS 결과를 살펴보세요. Config에서는 DOMAIN-SUFFIX, IP-CIDR, GEOIP, FINAL의 순서를 중점적으로 확인합니다. 특정 대상 하나 때문에 구독 전체를 반복해서 삭제하고 다시 가져오지 마세요.