공식 매뉴얼 / 첫 연결

Shadowrocket 구독 가져오기
및첫 연결 가이드

기존 설정에서 시작해 추가, Global Routing 선택, 연결 및 확인을 순서대로 진행합니다. 각 단계의 결과를 확인한 다음 다음 단계로 넘어가 여러 설정을 동시에 변경하지 않도록 합니다.

01 / IMPORT

Add Server: 서버 추가 또는 구독 가져오기

Shadowrocket을 열고 먼저 Home 화면으로 이동합니다. 아래의 SERVER에는 선택할 수 있는 서버가 표시됩니다. 아직 정보를 추가하지 않았다면 항목이 없는 것이 정상입니다. 보유한 정보의 유형을 먼저 확인하세요. Host, Port 및 인증 정보로 이루어진 값은 단일 서버 정보이고, 여러 서버 정보를 가져오는 전체 주소는 구독 링크입니다. 두 정보는 가져오는 방법이 다르므로 구독 주소 전체를 Host에 입력하지 마세요.

기존 구독 링크: Subscribe 선택

Home에서 Add Server를 누르고 추가 화면에서 Type을 누른 다음 Subscribe를 선택합니다. 본인의 전체 구독 링크를 URL 입력란에 입력합니다. 메모 항목이 있다면 출처를 알아보기 쉬운 이름을 적을 수 있습니다. 붙여넣은 뒤 앞뒤에 공백이나 줄바꿈이 들어갔는지 확인하세요. 특히 물음표 뒤의 매개변수를 빠뜨리지 않도록 합니다. 매개변수는 구독 권한 확인에 사용될 수 있으므로 누락되면 주소가 비슷해 보여도 오류가 발생하거나 내용이 비어 있을 수 있습니다.

저장한 뒤 Home으로 돌아가 구독 내용을 가져올 때까지 기다린 다음 SERVER에 항목이 나타나는지 확인합니다. 구독 이름만 표시되고 서버가 없다면 곧바로 같은 주소를 반복해서 추가하지 말고, 5단계에 따라 가져오기 결과를 확인하세요. 이후 구독을 갱신할 때는 기존 구독을 업데이트해야 합니다. 같은 구독을 반복해서 가져오면 비슷한 그룹이 여러 개 생겨 어느 항목을 선택했는지 혼동할 수 있습니다.

기존 서버 정보: Type에 맞춰 입력

Add Server를 다시 열면 Type은 서비스 제공업체에서 안내한 프로토콜과 일치해야 합니다. 예를 들어 Shadowsocks를 선택했다면 Host, Port, Password 및 Method를 확인해 입력합니다. Host에는 보통 도메인이나 IP 주소만 입력하고, Port는 별도로 입력합니다. 설명 문구, 웹페이지 경로 또는 공유 정보 전체를 Host에 넣지 마세요. 다른 프로토콜은 표시되는 항목이 다를 수 있으므로, 선택한 Type에 실제로 표시되는 항목과 원본 정보를 기준으로 입력해야 합니다. 스크린샷의 항목 조합을 그대로 따라 입력하지 마세요.

호환되는 QR 코드가 있다면 추가 화면에서 Scan QR Code를 사용해 읽은 뒤, 인식된 Type과 주소가 올바른지 확인합니다. Import from Cloud JSON은 해당 형식의 JSON 가져오기에 사용하는 기능이며, 임의의 구독 링크를 가져오는 공용 메뉴가 아닙니다. 저장에 성공하면 Home으로 돌아가 새 항목을 선택할 수 있는지 확인합니다. 이 단계에서는 정보가 클라이언트에 들어왔을 뿐 서버가 사용 가능한지 확인된 것은 아닙니다. 다음 단계에서 트래픽 처리 방식을 먼저 정합니다.

구독 링크, QR 코드 및 인증 항목에는 접근 권한 정보가 포함될 수 있습니다. 스크린샷으로 도움을 요청할 때는 전체 주소와 인증 정보를 가리세요. 문제 해결을 위해 전체 구성을 공개할 필요는 없습니다.

Shadowrocket 공식 Add Server 스크린샷. Type, Host, Port, Password, Method 및 가져오기 메뉴가 표시됩니다
Add Server: 먼저 Type을 선택한 뒤 보유한 정보에 따라 입력합니다. 스크린샷은 항목을 확인하기 위한 자료이며 연결 정보로 사용할 수 없습니다.

02 / ROUTING

Global Routing: Config, Proxy 또는 Direct 선택

서버가 Home에 표시되면 Global Routing을 눌러 현재 처리 방식을 확인합니다. 여기서는 트래픽이 사용할 경로를 정합니다. 서버 정보를 보완하거나 인증 오류를 자동으로 수정하는 기능은 아닙니다. 세 가지 모드는 Config, Proxy, Direct로 표시됩니다. 처음 설정할 때는 현재 선택 항목을 파악한 뒤 연결을 시작해야 이후 테스트 결과를 제대로 해석할 수 있습니다.

Config: 현재 구성의 규칙에 따라 매칭

Config는 현재 활성화된 구성을 기준으로 요청에 DIRECT, 프록시 정책 또는 다른 처리 방식을 적용합니다. Config를 열면 구성 파일을 확인할 수 있으며, 파일 안의 General, Rule, Hosts 등의 구역에서 각각 다른 설정을 관리합니다. 스크린샷의 Add Rule은 규칙 추가 메뉴이며 서버 추가 메뉴가 아닙니다. 처음 사용하는 경우 활성화된 파일이 무엇인지 먼저 확인하세요. 기존 구성이 있다면 사본을 저장하고, 서버를 테스트하는 동안 전체 규칙을 동시에 수정하지 않는 것이 좋습니다.

예를 들어 DOMAIN-SUFFIX,example.com,DIRECT는 해당 도메인과 하위 도메인에 일치하는 요청에 DIRECT를 사용한다는 뜻입니다. 규칙은 보통 순서대로 확인하므로 앞에서 일치한 결과가 이후 처리에 영향을 줍니다. FINAL은 앞선 규칙이 하나도 일치하지 않았을 때 적용되는 최종 정책입니다. 구성에서 정책 이름을 사용하는 경우에는 해당 정책이 유효한 대상을 찾을 수 있는지도 확인해야 합니다. 규칙 파일이 있다는 사실만으로 파일 안에서 참조하는 정책까지 올바르게 연결되었다고 볼 수는 없습니다.

Proxy와 Direct: 경로 구분에 사용

Proxy는 프록시할 수 있는 트래픽을 선택한 프록시로 전달하며, 해당 서버 경로에서 요청을 처리할 수 있는지 잠시 확인할 때 유용합니다. 기기의 모든 트래픽이 반드시 프록시를 거친다는 뜻은 아니며, 실제 동작은 앱의 기능과 시스템 네트워크 동작에도 영향을 받습니다. Direct는 직접 연결을 사용합니다. 따라서 연결 스위치가 켜져 있더라도 Direct만으로 선택한 서버가 요청을 처리 중임을 확인할 수는 없습니다.

현재 모드를 먼저 기록해 두세요. 기존 구성의 출처와 용도가 분명하다면 Config를 유지할 수 있습니다. 규칙의 영향을 분리해 확인해야 한다면 잠시 Proxy로 바꿔 비교하고 테스트가 끝난 뒤 Config로 복구합니다. Proxy를 모든 문제의 해결책으로 여기지 마세요. 프로토콜 항목과 기술 선택에 관해서는 프로토콜 해설을 참고하세요. 이 페이지에서는 먼저 연결 절차를 완료합니다.

Shadowrocket 공식 Config 스크린샷. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule이 표시됩니다
Config: 구성 파일의 Rule은 Home의 Global Routing과 관련이 있지만, 두 항목은 서로 다른 설정 메뉴입니다.

03 / CONNECTION

Home: 서버를 선택하고 연결 켜기

Home으로 돌아가 SERVER 그룹에서 사용할 서버를 누르고 해당 항목에 선택 표시가 나타나는지 확인합니다. 구독 이름은 항목을 정리하는 방식일 뿐, 그룹이 보인다고 실제 서버가 선택된 것은 아닙니다. 목록이 길다면 현재 항목의 메모를 기록해 두세요. 나중에 서버를 바꿀 때 비교 대상을 명확히 알 수 있습니다. 그런 다음 Global Routing에 표시된 모드가 2단계에서 선택한 항목과 일치하는지 확인합니다.

Home 상단의 연결 스위치를 누릅니다. 처음 사용할 때 시스템에서 VPN 구성을 추가할지 묻는 메시지가 표시되며, 이는 시스템 네트워크 연결을 설정하는 데 필요한 승인입니다. 현재 작업에서 비롯된 요청인지 확인한 뒤 허용하고, 기기의 안내에 따라 암호 또는 시스템 인증을 완료합니다. 도중에 취소했다면 앱으로 돌아와 상태를 확인하세요. 목록에 서버가 있다는 이유만으로 시스템 승인이 완료되었다고 판단하지 마세요.

승인한 뒤 Home으로 돌아가 상단 상태가 Not Connected에서 연결 상태로 바뀌는지 확인합니다. 계속 Not Connected로 표시되거나 스위치가 곧바로 꺼진다면 Rule을 수정하기 전에 시스템 승인과 앱의 안내를 확인하세요. 기기에서 다른 VPN 연결을 사용 중이거나 기기 관리 정책의 제한을 받는 경우 현재 연결이 예상대로 설정되지 않을 수 있습니다. 기기에서 해당 VPN 구성을 사용할 수 있는지 먼저 확인한 뒤 다시 시도하세요.

연결 상태가 설정되면 곧바로 여러 항목을 바꾸거나 On Demand를 함께 켜지 마세요. 서버 하나, 모드 하나, 동일한 네트워크를 유지한 채 다음 단계에서 확인합니다. 상단 상태는 시스템 연결이 설정되었음을 주로 나타낼 뿐, 원격 인증, 대상 서비스 및 각 규칙이 모두 정상임을 단독으로 증명하지 않습니다. 연결 스위치가 켜진 상태와 요청 성공 여부를 따로 판단하면 불필요한 반복 작업을 줄일 수 있습니다.

Shadowrocket 공식 Home 스크린샷. 상단에 Not Connected, Global Routing 및 Connectivity Test가 표시되고 아래에 SERVER와 Add Server가 보입니다
Home: SERVER → Global Routing → 상단 스위치 순서로 확인합니다. 스크린샷의 Not Connected는 화면 예시 상태입니다.

04 / VERIFICATION

Connectivity Test: 연결과 규칙을 각각 확인

연결을 켠 뒤 Home에서 Connectivity Test를 누르고 테스트가 끝날 때까지 기다립니다. 현재 조건에서 연결 가능한지 확인하는 데 유용하지만, 테스트 대상이 실제로 사용할 서비스와 같지는 않을 수 있습니다. 한 번 성공했다고 모든 웹사이트와 앱에 접속할 수 있는 것은 아닙니다. 실패한 경우에도 테스트 방식, 현재 네트워크 및 대상 서비스의 상태를 함께 확인하세요. 결과 하나만으로 구독을 삭제하지 마세요.

먼저 대상 요청이 완료되는지 확인

브라우저나 사용할 앱을 열고 사용 권한이 있으며 예상 동작을 명확히 아는 대상 서비스에 접속합니다. 캐시된 페이지를 확인하는 데 그치지 말고 새 요청을 보내는 것이 좋습니다. 테스트는 성공했지만 대상 서비스가 실패한다면 도메인 해석 실패, 연결 시간 초과 또는 서비스가 로그인·권한 안내를 반환한 것인지 기록합니다. 이러한 현상은 서로 다른 단계에서 발생하므로 서비스의 안내 응답을 단순히 프록시 연결 실패로 볼 수 없습니다.

그다음 요청이 어떤 경로를 통과했는지 확인

Config가 적용되는지 확인하려면 앱에서 볼 수 있는 요청 기록을 확인하고, 동일한 대상을 중심으로 도메인, 일치한 규칙 및 최종 정책을 대조합니다. DIRECT를 사용한 요청은 페이지가 열렸다는 이유만으로 서버를 거쳤다고 판단해서는 안 됩니다. 반대로 프록시 정책에 일치해도 원격 대상이 요청을 받아들인다는 보장은 없습니다. 기록에 예상한 도메인이 없다면 요청을 다시 보내 캐시된 결과를 사용했는지, 앱이 다른 도메인을 사용했는지 확인합니다.

결과가 분명하지 않다면 서버와 네트워크를 유지한 채 Config만 잠시 Proxy로 바꾸고 같은 대상에 접속합니다. Proxy는 되지만 Config가 되지 않는다면 규칙 순서, 정책 참조 및 DNS 관련 설정을 먼저 확인합니다. 둘 다 되지 않는다면 서버 항목, 원격 상태 및 네트워크 조건을 다시 점검합니다. 비교가 끝나면 원래 모드로 되돌리고, 실패 현상과 변경 내역을 기록한 뒤 다음 단계에서 항목별로 점검합니다.

05 / DIAGNOSTICS

Settings: 실패 단계에 따라 설정 점검

문제 해결은 가장 먼저 실패한 단계부터 시작합니다. 첫 단계에서 서버 정보를 가져오지 못했다면 규칙을 먼저 살펴볼 필요는 없습니다. 연결은 되었지만 특정 대상에 문제가 있다면 해당 대상을 중심으로 요청을 확인해야 합니다. Settings의 Test Method, On Demand 및 Diagnostics는 각각 테스트 방식, 조건부 연결 및 진단과 관련된 기능입니다. 이를 한꺼번에 변경해 ‘일반적인 해결 설정’으로 사용하지 마세요. 변경 전에 기존 값을 기록해 두면 테스트 후 복구할 수 있습니다.

가져오기 실패: 정보 유형과 완전성 확인

구독 링크는 Host가 아니라 Subscribe의 해당 입력란에 넣었는지 확인합니다. 링크가 완전한지, 불필요한 공백이 들어갔는지, 본인의 구독 권한이 아직 유효한지 점검하세요. 브라우저에서 웹페이지가 열린다고 해서 클라이언트가 읽을 수 있는 구독 내용이 해당 주소에 있다는 뜻은 아닙니다. 로그인 페이지나 오류 안내가 표시된다면 본인의 서비스 제공업체에 정보를 다시 확인하세요. 반복해서 시도하는 동안 기존에 정상 작동하는 항목을 지우지 마세요.

연결 실패: 정보와 시스템 승인을 나눠 확인

스위치를 켜진 상태로 유지할 수 없다면 시스템 VPN 구성이 정상적으로 추가되었는지, 다른 연결이 사용 중인지 먼저 확인합니다. 스위치는 켜지지만 요청이 실패한다면 Type, Host, Port 및 인증 항목을 하나씩 확인합니다. QR 코드로 가져온 정보도 확인해야 합니다. 정보가 변경되었는데 QR 코드가 이전 내용일 수 있습니다. 기기의 날짜와 시간이 잘못되면 보안 연결에 영향을 줄 수 있으므로 시스템 시간이 정확한지 확인하세요. 인증 거부나 원격 서버 이용 불가는 본인의 서비스 제공업체에 서버 상태를 확인해야 합니다.

테스트와 실제 사용 결과가 다름: Test Method 확인

Settings에서 Test Method를 확인해 현재 테스트가 어떤 방식을 사용하는지 살펴봅니다. 테스트 방식마다 확인하는 범위가 다르므로 특정 테스트의 실패가 실제 요청의 실패를 반드시 뜻하지는 않습니다. 마찬가지로 테스트 결과가 나온다고 대상 서비스를 사용할 수 있다는 보장도 없습니다. 4단계로 돌아가 동일한 대상에 실제 요청을 보내고 기록과 대조하세요. 현재 네트워크가 특정 전송 방식을 제한한다고 의심되면 권한이 있는 다른 네트워크에서 다시 시도하되, 서버와 모드는 그대로 유지합니다.

상태가 반복해서 바뀜: On Demand 및 진단 기록 확인

On Demand는 조건에 따라 연결을 시작하는 기능입니다. 처음 문제를 확인할 때는 현재 상태를 기록하고, 필요하면 자동 실행을 잠시 꺼서 수동으로 연결과 연결 해제를 한 차례 진행합니다. 자동 동작이 확인을 방해하지 않도록 하기 위한 것입니다. 그런 다음 Diagnostics에서 확인 가능한 정보를 살펴봅니다. 문제를 설명할 때는 오류 문구, 발생 단계 및 네트워크 유형을 남기고 구독 주소, 인증 항목 및 불필요한 요청 상세 정보는 가립니다.

점검을 마친 뒤에는 세 가지를 답할 수 있어야 합니다. 정보가 정상적으로 가져와졌는지, 시스템 연결이 설정되었는지, 대상 요청에 실제로 어떤 정책이 적용되었는지입니다. 하나라도 확실하지 않다면 설정을 계속 추가하기보다 해당 단계로 돌아가 다시 확인하세요. 절차를 처음부터 다시 진행하려면 추가 및 가져오기 단계로 돌아가고, 프로토콜 항목의 의미와 선택 기준은 프로토콜 해설을 참고하세요.

Shadowrocket 공식 Settings 스크린샷. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP가 표시됩니다
Settings: 실패 현상에 따라 관련 설정을 확인합니다. 기존 값을 먼저 기록한 다음 한 항목씩 비교하세요.