Shadowrocket 공식 매뉴얼 · 초보자 가이드

Shadowrocket 구독 가져오기와첫 연결

가져오기 → 라우팅 선택 → 연결 → 확인 → 문제 해결 순서로 진행하세요. 먼저 재현 가능한 연결을 한 번 완료한 뒤 규칙과 자동 연결 설정을 조정합니다.

시작 전 확인: App Store에서 Shadowrocket을 설치했고, 본인의 구독 링크나 서버 정보를 보유하고 있어야 합니다. 이 사이트는 서버나 구독을 제공·판매·추천하지 않습니다. 앱은 한 번 구매하면 계속 사용할 수 있지만, 이는 회선 요금제가 아니며 앱 구매만으로 연결 서비스가 제공되지는 않습니다.

아직 설치하지 않았다면 먼저 App Store 정식 구매 안내를 읽고 개발자 Shadow Launch Technology Limited와 앱 ID 932747118을 확인하세요. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 기준으로 합니다.

아래 안내는 iPhone과 iPad에서의 조작을 기준으로 하며, 화면에 표시되는 용어는 영어 그대로 사용합니다. 보유한 정보에 해당하는 가져오기 방법만 확인하면 됩니다. 두 가지 방법을 모두 진행할 필요는 없습니다. 화면 배치에 따라 버튼 위치가 다를 수 있으니 이름을 기준으로 찾으세요.

단계 01 · 서비스 정보 가져오기

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

먼저 보유한 정보의 종류를 확인하세요. 구독은 일반적으로 전체 링크 하나로 제공되며, 가져오면 여러 서버 항목이 생성될 수 있습니다. 서버 정보 하나에는 프로토콜, 주소, 포트, 인증 정보가 포함됩니다. 두 입력 방식은 서로 다르므로 구독 링크를 서버 주소란에 입력하면 안 됩니다. 링크가 웹 주소처럼 보인다는 이유만으로 브라우저에서 공개적으로 열지도 마세요. 구독 링크에는 개인 인증 정보가 포함될 수 있으니 비밀번호처럼 안전하게 보관하세요.

구독 링크가 있는 경우: Subscribe 선택

Shadowrocket의 Home을 열고 오른쪽 위의 추가 버튼을 눌러 Add Server로 이동합니다. Type에서 Subscribe를 선택한 다음, 보유한 구독 링크 전체를 URL에 입력하세요. 나중에 여러 구독을 구분할 수 있도록 알아보기 쉬운 이름을 지정할 수도 있습니다. 붙여넣은 뒤 링크 앞뒤에 공백이나 줄바꿈이 없는지, 메신저에서 링크가 잘리지 않았는지, 안내 문구가 함께 복사되지 않았는지 확인하세요.

저장한 뒤 Home으로 돌아가 구독 정보를 불러올 때까지 기다립니다. 구독 이름만 표시되고 선택할 서버 항목이 없다면 해당 구독의 작업 메뉴를 열어 업데이트하고 오류 메시지를 확인하세요. 저장 버튼을 누를 수 있는지가 아니라 구독 아래에 실제 서버가 표시되는지가 성공 여부를 판단하는 기준입니다. 서버 하나를 선택하고, 가져오기가 확인되기 전에 같은 링크를 반복해서 추가하지 마세요.

구독을 업데이트하려면 현재 네트워크에서 구독 내용을 가져올 수 있어야 합니다. 가져오기에 실패했다고 해서 링크가 만료된 것은 아닙니다. 기본 네트워크, 도메인 이름 확인 또는 응답 형식에 문제가 있을 수도 있습니다. 원래 링크를 보관하고 오류를 기록한 뒤 문제 해결 항목을 차례로 확인하세요. 구독에 표시되는 서버 이름은 식별용일 뿐, 이름만으로 실제 사용 가능 여부를 판단할 수 없습니다.

서버 정보가 하나만 있는 경우: 프로토콜에 맞춰 입력

Home에서 Add Server로 이동한 뒤 Type에서 보유한 정보와 일치하는 프로토콜을 선택합니다. 예를 들면 Shadowsocks, VMess, VLESS, Trojan이 있습니다. 서버 주소, 포트, 해당 프로토콜의 인증 정보를 차례로 입력하세요. 프로토콜마다 필요한 항목이 다릅니다. 비밀번호와 UUID는 서로 대신 사용할 수 없으므로, 항목 이름이 비슷해 보여도 다른 프로토콜의 정보를 입력하지 마세요.

보유한 정보에 TLS, Server Name, 전송 방식, Host, Path 등의 설정이 명시되어 있다면 함께 확인하세요. 서버 주소와 TLS 인증에 사용하는 이름은 다를 수 있으므로 임의로 같은 값으로 바꾸지 말고 원래 제공된 정보를 따르세요. 주소를 입력할 때는 호스트 이름과 전체 URL을 구분해야 합니다. 호스트 이름만 요구하는 항목에는 경로를 추가하지 마세요. 저장한 뒤 Home으로 돌아가 서버 항목이 있는지 확인하고 선택합니다.

본인 서버의 QR 코드가 있다면 Home의 스캔 메뉴에서 Scan QR Code를 사용할 수 있습니다. 스캔한 뒤에도 프로토콜과 주요 설정을 확인하세요. 스캔에 성공했다고 연결까지 확인된 것은 아닙니다. iPad에서는 창 배치에 따라 메뉴 위치가 다를 수 있으므로 Add Server, Type, Subscribe 등의 이름을 기준으로 찾으면 됩니다.

완료 기준: Home에 실제 서버 항목이 하나 이상 표시되고 선택되어 있어야 합니다. 다음으로 요청에 사용할 라우팅 방식을 정하세요. 곧바로 Settings의 여러 항목을 변경할 필요는 없습니다.

단계 02 · 라우팅 방식 결정

Global Routing: Config, Proxy, Direct

Home에서 Global Routing을 누르고 이번 연결에 사용할 모드를 선택합니다. 세 가지 옵션은 Config, Proxy, Direct입니다. 이 선택은 요청 처리 방식을 정할 뿐, 서버 설정을 보완하거나 만료된 인증 정보를 복구하지는 않습니다. 처음 설정할 때는 서버 연결 여부와 규칙이 예상대로 작동하는지 따로 확인하세요.

Config: 현재 구성의 규칙에 따라 요청 처리

Config는 현재 사용 중인 구성에 따라 요청별 정책을 결정합니다. Config 페이지에서 사용할 구성이 선택되어 있는지 확인한 뒤 Home으로 돌아가 Global Routing에서 Config를 선택하세요. 서버 구독을 가져오는 것과 규칙 구성을 선택하는 것은 별개의 작업입니다. 구독에 서버가 여러 개 표시되더라도 현재 구성이 의도한 대로 트래픽을 분기한다는 뜻은 아닙니다. 기존 구성을 처음 사용할 때는 출처와 용도, 참조하는 정책을 확인하세요.

규칙에서 흔히 사용하는 정책으로는 DIRECT, PROXY, REJECT가 있습니다. Config를 선택한 뒤 일부 요청이 직접 연결되는 것은 규칙에 따른 정상적인 결과일 수 있으며, 연결이 끊겼다는 뜻은 아닙니다. 특정 도메인에 현재 정책이 적용된 이유가 확실하지 않다면 확인 단계에서 해당 요청을 살펴본 뒤 규칙 순서를 확인하세요. 규칙 매칭 순서는 초보자부터 고급 사용자까지 보는 안내서에서 자세히 설명합니다. 이 페이지에서는 우선 기본 연결 과정을 완료합니다.

Proxy: 선택한 서버 경로 확인

보유한 서버를 먼저 테스트하려면 Proxy를 잠시 선택해 규칙 분기의 영향을 줄일 수 있습니다. 이 모드에서는 클라이언트가 처리하는 범위의 요청을 프록시 방식으로 처리하지만, 기기의 모든 트래픽이 반드시 같은 경로를 사용한다는 뜻은 아닙니다. 테스트할 대상은 명확히 정하고 실제 요청 결과도 확인하세요. 서버를 사용할 수 있음을 확인한 뒤 Config로 돌아가 평소 사용하는 규칙을 점검합니다.

Direct: 기본 네트워크와 비교

Direct는 해당 요청을 선택한 프록시 서버를 거치지 않고 대상에 직접 연결합니다. 기본 네트워크가 정상인지 비교하는 데 사용할 수 있지만 서버 연결 여부를 확인해 주지는 않습니다. Direct를 선택한 상태에서 웹페이지가 열린다면 해당 요청이 직접 연결에 성공했다는 뜻입니다. 선택한 서버를 테스트하려면 Proxy 또는 프록시가 명시된 Config로 돌아간 뒤 실제 접속을 다시 확인하세요.

선택을 마치면 현재 모드와 서버 이름을 기억해 두세요. 이후 테스트에 실패하면 한 번에 조건 하나만 바꾸고 다시 시도해야 서버 문제인지 규칙 문제인지 구분할 수 있습니다. 같은 테스트에서 서버를 바꾸고 DNS를 수정하고 구성을 교체하지 마세요.

단계 03 · 연결하기

Home: 연결 스위치 켜기 및 VPN 구성 승인

Home으로 돌아가 선택한 서버와 Global Routing 모드를 다시 확인한 뒤 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 Shadowrocket의 VPN 구성 추가를 허용할지 물을 수 있습니다. 이는 클라이언트가 시스템 네트워크 연결 구성을 만들도록 승인하는 절차이며, 구독의 유효성과는 별개입니다. 방금 직접 실행한 작업으로 요청이 표시되었는지 확인한 다음 시스템 안내에 따라 승인하고 기기 인증을 완료하세요.

승인한 뒤 Shadowrocket으로 돌아와 스위치와 연결 상태를 확인하세요. 앞서 취소했다면 연결이 진행되지 않을 수 있습니다. 연결 스위치를 다시 켜고 안내에 따라 승인하면 됩니다. 요청이 다시 표시되지 않으면 기기의 Settings에서 VPN 관련 설정을 확인하세요. 시스템 버전에 따라 설정 메뉴 위치가 다를 수 있으므로 실제 화면에서 찾아보세요. 정확한 경로를 찾으려고 설정을 반복해서 삭제할 필요는 없습니다.

연결이 완료되면 시스템의 VPN 표시를 상태 참고 자료로 볼 수 있습니다. 하지만 이 표시는 관련 네트워크 구성이 실행 중임을 나타낼 뿐, 서버 인증, DNS 또는 대상 페이지 접속이 모두 정상이라는 뜻은 아닙니다. 클라이언트에 연결됨으로 표시되어도 실제 요청은 실패할 수 있으므로 다음 단계에서 확인해야 합니다. 상태가 천천히 바뀐다는 이유로 스위치를 연속해서 빠르게 켰다 끄지 말고, 현재 연결 결과가 확인된 뒤 다시 시도하세요.

기기에서 다른 VPN 연결이 활성화되어 있거나 회사·학교에서 관리하는 네트워크 구성이 있다면 이번 연결에 영향을 줄 수 있습니다. 현재 실제로 활성화된 연결을 확인하고 기기 관리 정책을 따르세요. 용도를 모르는 관리 구성을 임의로 제거하지 마세요. 첫 테스트에서는 On Demand 설정도 잠시 미루는 것이 좋습니다. 수동으로 연결을 끊은 뒤 자동 연결 조건이 다시 작동해 결과 확인이 복잡해지는 것을 방지할 수 있습니다.

완료 기준: 시스템 승인을 마쳤고 Shadowrocket에 연결 중으로 표시되어야 합니다. 다음 단계에서는 실제 접속으로 확인하세요. 스위치 위치만으로 테스트 결과를 대신할 수는 없습니다.

단계 04 · 결과 확인

Connectivity Test와 실제 접속 확인

먼저 Home에서 Connectivity Test를 실행해 보유한 서버를 기본 점검합니다. 테스트 결과는 해당 테스트 방식에서의 연결 가능 여부를 보여 주며, 실제 웹페이지 접속을 대신하지는 않습니다. 응답 시간이 표시되어도 모든 도메인, 프로토콜, 대상에 접속할 수 있다는 뜻은 아닙니다. 시간 초과가 발생해도 테스트 방식과 실제 사용 상황을 함께 고려하세요. 한 번의 결과만으로 모든 서버 항목을 삭제하지 마세요.

그다음 브라우저를 열어 접근 권한이 있고 정상적으로 표시되는 내용을 확인할 수 있는 페이지에 접속합니다. 서버와 라우팅 모드는 그대로 둔 채 새로고침하고 페이지의 다른 링크도 열어 캐시된 내용만 보이는 것은 아닌지 확인하세요. 특정 대상만 실패한다면 다른 대상을 선택해 비교합니다. 모든 접속이 실패하는 경우와 웹사이트 하나만 실패하는 경우는 해결 방향이 다르므로 먼저 구분해야 합니다.

Data에서 요청 확인

Shadowrocket으로 돌아와 Data에서 현재 확인할 수 있는 트래픽 및 요청 기록을 살펴봅니다. 방금 접속한 시간과 대상 도메인을 기준으로 요청을 찾은 뒤, 기록에 표시된 정책, 오류 또는 연결 정보를 함께 확인하세요. Config를 사용 중이라면 해당 요청이 의도한 대로 PROXY, DIRECT 중 어느 경로를 사용했는지, 또는 REJECT되었는지 확인합니다. 전체 트래픽이 늘어난 것만으로 대상 페이지 접속이 성공했다고 판단할 수는 없습니다. 백그라운드 앱에서도 요청이 발생할 수 있습니다.

기록에 필요한 정보가 없다면 어떤 규칙이 적용되었는지 추측하지 마세요. 먼저 Proxy로 서버 경로를 비교 테스트한 다음 Config로 돌아와 같은 대상을 다시 확인할 수 있습니다. Proxy에서는 접속되지만 Config에서 예상과 다르게 작동한다면 서버 정보를 모두 다시 입력하기보다 현재 구성, 규칙 순서, 정책 참조를 먼저 확인하세요. 두 모드에서 모두 실패한다면 서버 설정, 기본 네트워크, 도메인 이름 확인을 계속 점검합니다.

직접 연결과 비교하려면 잠시 Direct로 전환하거나 현재 연결을 중지한 뒤 같은 대상을 테스트하고 원래 설정으로 되돌립니다. 비교 테스트는 네트워크 경로를 바꾸므로 직접 연결에 적합한 대상만 이용하고 작업 전에 접속 요건을 확인하세요. 결과는 막연히 네트워크가 안 된다고 적는 대신 대상, 모드, 성공 여부를 기록합니다.

첫 확인을 마친 뒤 Wi-Fi와 셀룰러 네트워크를 한 번씩 바꿔 재시험하면 특정 네트워크에서만 발생하는 문제를 찾는 데 도움이 됩니다. 기기에서 셀룰러 네트워크를 사용할 수 없다면 이 단계는 건너뛰어도 됩니다. 평소 사용하기 전에 필요한 Config 또는 다른 모드로 되돌렸는지 확인하세요. 구독 업데이트 후 서버 이름이나 항목이 바뀌었다면 선택된 서버와 정책 참조도 다시 확인합니다.

단계 05 · 단계별 문제 해결

구독 가져오기 실패, 연결 실패, 웹페이지 접속 불가

문제를 확인할 때는 현재 설정과 오류 메시지를 보존하고 아래 순서대로 원인을 좁혀 보세요. 각 항목을 확인한 뒤에는 해당 항목과 직접 관련된 내용만 변경하고 같은 대상을 다시 테스트합니다. 앱을 바로 재설치하면 서버 선택, 구성, 승인 상태가 바뀌어 실제 원인을 파악하기 어려워질 수 있으므로 첫 조치로 권장하지 않습니다.

구독을 저장했지만 서버 항목이 표시되지 않음

Add Server에서 해당 구독의 편집 화면으로 돌아가 Type이 Subscribe인지, URL에 보유한 링크 전체가 입력되었는지 확인합니다. 페이지 제목을 함께 복사했거나 링크 끝부분의 매개변수가 빠지지는 않았는지, 공백이나 줄바꿈이 섞이지 않았는지도 확인하세요. 기본 네트워크에서 정상적으로 접속할 수 있는지 점검한 뒤 구독을 한 번 업데이트하고 오류를 기록합니다. 클라이언트가 읽을 구독 내용 대신 로그인 페이지나 안내 페이지가 표시된다면 기존 서비스 관리 측에 링크의 용도와 형식을 확인하세요.

전체 구독 링크를 공개 게시판에 올리지 말고, 문제를 해결하려고 링크의 매개변수를 함부로 삭제하지 마세요. 일부 매개변수는 개인 구독 자격을 확인하는 데 사용됩니다. 변경한 뒤에도 URL이 열릴 수 있지만 올바른 내용이 반환된다는 보장은 없습니다. 기존 서비스 정보에 링크가 변경되었다고 안내되어 있다면 원래 구독 항목을 업데이트해 오래된 항목을 잘못 선택하지 않도록 하세요.

서버는 표시되지만 정상적으로 접속할 수 없음

먼저 예상한 서버가 실제로 선택되어 있는지 확인한 뒤 프로토콜, 포트, 인증 정보, TLS 등의 설정을 점검하세요. 인증서 검증을 끄는 방식으로 이름이나 인증서 문제를 숨기지 말고 Server Name, 서버 주소, 기기 시간이 올바른지 확인해야 합니다. 그런 다음 Proxy를 잠시 선택해 같은 대상을 테스트하세요. 여전히 실패하면 서버 연결 가능 여부와 설정을 우선 확인하고, Proxy는 정상인데 Config에서 실패하면 구성과 규칙을 점검합니다.

연결 스위치가 유지되지 않거나 시스템 승인이 완료되지 않음

시스템 VPN 설정에서 현재 연결 상태를 확인하고 구성 추가 승인이 완료되었는지, 다른 연결이 전환 중인지 살펴보세요. 기기가 관리되는 경우 먼저 관리 제한을 확인해야 합니다. 수동으로 연결을 끊은 뒤 다시 자동으로 연결된다면 On Demand의 실행 조건이 설정되어 있는지 확인하세요. 이는 연결 스위치가 제대로 작동하지 않는 문제와는 다릅니다. 설정을 변경하기 전에 기존 조건을 기록해 필요한 자동 연결 동작까지 바뀌지 않도록 하세요.

Connectivity Test는 응답하지만 웹페이지가 열리지 않음

먼저 여러 대상에 실제로 접속해 결과를 비교한 뒤 Data에서 실패한 대상의 요청 기록을 확인하세요. 도메인 이름 확인, 규칙 선택, 서버에서 대상까지의 연결, 대상 자체의 응답 등이 원인일 수 있습니다. 근거가 충분하지 않다면 문제를 바로 DNS 탓으로 돌리지 마세요. 실제로 이름 확인 오류가 있다면 현재 구성의 DNS 설정을 먼저 확인하고, 결과를 비교할 수 없게 여러 DNS 주소를 동시에 바꾸지 마세요.

특정 Wi-Fi에서만 실패한다면 해당 네트워크에 정상적인 접속 인증이 필요한지 확인하세요. 다른 네트워크로 바꾼 뒤 해결되면 원래 네트워크의 조건을 계속 점검합니다. 앱 하나에서만 실패한다면 먼저 브라우저에서 같은 서비스의 접속 가능한 페이지를 열어 비교하고, 앱 세션, 대상 서비스, 클라이언트 연결 중 어느 쪽의 문제인지 구분하세요. 모든 규칙을 곧바로 수정하지 마세요.

필요한 내용만 기록한 뒤 조정하기

기기 종류, 현재 네트워크, Global Routing 모드, 선택한 서버의 사용자 지정 이름, 실패한 대상, 오류 현상을 기록하면 됩니다. 진단 기록을 공유하기 전에는 전체 구독 링크, 비밀번호, UUID, 개인 주소와 기타 인증 정보를 삭제하세요. 이름만 가리는 것으로 인증 정보가 삭제되는 것은 아닙니다. 변경한 뒤에는 서버 선택 → 연결 → 대상 접속 → 기록 확인 순서를 다시 진행해 같은 결과가 재현되는지 확인합니다.

초보자 과정 완료 기준: 보유한 정보를 가져왔고 현재 Global Routing 선택 이유를 설명할 수 있으며, 연결 승인을 마치고 실제 접속으로 결과를 확인했다면 초보자 과정이 완료된 것입니다. 다음으로 초보자부터 고급 사용자까지 보는 전체 안내서에서 Config 규칙, On Demand, Data, 일상적인 관리 방법을 확인하세요. 기능 범위는 기능 안내에서 살펴볼 수 있습니다.

일상적인 앱 업데이트도 App Store에서 진행합니다. 앱 업데이트, 구독 업데이트, 규칙 구성 변경은 서로 다른 작업입니다. 각각을 따로 진행한 뒤 확인하면 변경 후 문제가 생겼을 때 원인을 정확히 파악할 수 있습니다.