Shadowrocket 공식 사이트 · 매뉴얼

Shadowrocket 빠른 시작

기존 구독 또는 서버 정보로 시작해 분할 모드를 선택하고 연결한 다음, 실제 접속이 예상대로 작동하는지 확인합니다.

01 · 가져오기

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

Shadowrocket을 열고 Home 화면에 둡니다. SERVER 그룹을 찾아 Add Server를 탭합니다. 먼저 보유한 정보의 종류를 확인하세요. 구독 링크는 서버 목록을 가져오는 데 사용하며, 호스트·포트·인증 정보가 따로 있다면 서버를 하나 추가할 수 있습니다. 둘 중 한 가지 방법을 사용하면 되며, 연결을 위해 같은 항목을 중복 입력할 필요는 없습니다.

개별 서버 정보가 있는 경우

Type에서 제공된 정보에 명시된 프로토콜을 선택한 다음 앱에 표시된 항목을 입력합니다. 예를 들어 Shadowsocks를 선택했다면 호스트 이름 또는 주소는 Host에, 포트는 Port에, 비밀번호는 Password에 입력하고 Method는 원래 정보와 일치시킵니다. 호스트, 포트, 경로를 하나로 합쳐 Host에 입력하지 마세요. 프로토콜에 따라 표시되는 항목이 다릅니다. 화면의 항목이 보유한 정보와 맞지 않는다면 먼저 Type을 확인하고, 비밀번호나 다른 인증 항목에 임의로 입력하지 마세요.

구독 링크가 있는 경우

Type에서 Subscribe를 선택하고 전체 링크를 주소 입력란에 붙여 넣은 다음 저장합니다. 링크를 복사할 때 물음표와 그 뒤에 오는 매개변수를 포함하고, 메시지에서 함께 복사된 앞뒤 공백이나 줄바꿈은 제거하세요. 구독 주소를 개별 서버의 Host에 입력하지 마세요. 구독에 포함된 각 항목을 먼저 하나씩 등록할 필요도 없습니다.

저장한 뒤 Home으로 돌아갑니다. 직접 추가한 서버는 목록에 표시되어야 합니다. 구독을 가져왔다면 구독 이름만 보이는 것이 아니라 선택할 수 있는 항목이 실제로 목록에 있는지 확인하세요. 처음 테스트할 서버 하나를 보유한 정보와 대조해 선택합니다. 목록에 항목이 있다는 사실은 정보가 저장되었다는 뜻일 뿐, 서버에 연결할 수 있다는 의미는 아닙니다. 목록이 비어 있다면 라우팅 모드를 먼저 바꾸지 말고 가져오기 문제 해결로 이동하세요.

Shadowrocket Add Server 화면. Type, Host, Port, Password, Method와 하단의 Scan QR Code 및 Import from Cloud JSON 표시
Add Server의 입력 항목은 Type에 따라 달라집니다. 화면은 개별 서버 정보를 입력하는 예입니다.
02 · 분할

Global Routing: 연결 처리 방식 선택

서버를 선택한 다음에도 Home에서 Global Routing을 탭합니다. 여기서는 트래픽 처리 방식을 정합니다. 앞서 서버를 고른 것과는 별개의 설정입니다. 서버 선택은 “프록시를 사용할 때 어떤 서버를 쓸지”를 정하고, 라우팅 모드는 “이번 연결에서 프록시를 사용할지”를 정합니다. 먼저 한 가지 모드를 선택해 테스트한 뒤 결과에 따라 전환하세요.

  • Config: 현재 구성 파일의 규칙에 따라 연결을 처리합니다. 한 기기에서도 대상에 따라 직접 연결하거나 프록시로 처리하거나 거부할 수 있습니다. 사용할 규칙이 이미 있다면 이 항목을 선택하세요.
  • Proxy: 클라이언트가 처리하는 트래픽을 프록시로 전달합니다. 분할 규칙을 아직 준비하지 않았다면 선택한 서버를 확인하는 용도로 잠시 사용할 수 있습니다. 규칙 매칭과 서버 연결 상태를 분리해 확인할 수 있습니다.
  • Direct: 클라이언트가 처리하는 연결을 프록시 서버를 거치지 않고 연결합니다. 이 모드에서 웹 페이지가 열려도 선택한 서버를 사용할 수 있다는 뜻은 아닙니다. 이번 연결을 완전히 종료하려면 Home의 연결 스위치를 끄세요.

Config를 선택했다면 하단의 Config를 열어 사용하려는 파일이 현재 활성화되어 있는지 확인합니다. 파일을 열어 Rule 섹션을 확인할 수 있습니다. 구독을 가져와 서버 목록을 만들더라도 분할 규칙이 자동으로 설정되지는 않습니다. 구성 파일의 출처나 용도를 모른다면 먼저 내용을 확인하고, 첫 연결을 위해 Add Rule로 수정할 필요는 없습니다.

규칙은 순서대로 적용되며, 일반적으로 먼저 일치하는 항목이 처리 방식을 결정합니다. 앞선 조건과 일치하지 않으면 마지막의 FINAL을 확인합니다. 예를 들어 파일에 특정 도메인에 대한 DIRECT 규칙이 있으면, 뒤에 FINAL,PROXY가 있더라도 마지막 줄만을 이유로 해당 도메인이 프록시를 사용하지는 않습니다. 키워드별 설명은 용어 설명을 참고하세요. 파일을 확인한 뒤 Home으로 돌아와 Global Routing에 표시된 모드를 확인하고 연결을 켭니다.

Shadowrocket Config 구성 파일 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션과 Add Rule 표시
Config에서 현재 파일의 Rule 섹션을 확인하세요. 모드는 Home의 Global Routing에서 전환합니다.
03 · 연결

Home: 스위치를 켜고 시스템 권한 확인

Home에서 먼저 SERVER의 선택 항목과 Global Routing 모드를 확인합니다. 그런 다음 상단의 Not Connected 옆 스위치를 탭합니다. 처음 실행할 때 시스템에서 Shadowrocket의 VPN 구성 추가를 허용할지 물을 수 있습니다. 방금 실행한 동작 직후에 표시된 창인지, 앱 이름이 일치하는지 확인한 다음 허용을 탭하세요. 기기에서 인증을 요구하면 시스템 안내에 따라 완료하고 Home으로 돌아갑니다.

이 권한은 시스템이 로컬 네트워크 터널을 설정하고 해당 트래픽을 클라이언트가 처리하도록 하는 데 사용됩니다. 구독 로그인과는 다르며 서버 비밀번호를 확인해 주지는 않습니다. 창이 표시되지 않아도 스위치가 켜진 상태로 유지된다면 기기에서 이미 권한을 승인했을 수 있습니다. 스위치를 켠 직후 다시 꺼지면 계속해서 재시도하지 마세요. 권한을 거부했는지, 기기에 다른 VPN 연결이 있는지, 시스템에서 구성 추가를 제한하는지 확인하세요.

Home으로 돌아와 상단 상태가 Not Connected에서 Connected로 바뀔 때까지 기다린 다음 다음 단계로 진행합니다. 이 상태는 연결 스위치가 적용되었음을 뜻할 뿐, 모든 외부 대상에 접속할 수 있음을 보장하지는 않습니다. 처음 확인하는 동안에는 같은 네트워크를 유지하세요. 테스트 도중 Wi-Fi와 셀룰러 네트워크를 오가면 설정 변경과 네트워크 전환 중 무엇이 결과에 영향을 줬는지 구분하기 어렵습니다.

Shadowrocket Home 화면. 상단에 Not Connected 스위치, 아래에 Global Routing, Connectivity Test, SERVER 그룹 및 Add Server 표시
Home에서 연결 스위치, 현재 Global Routing 모드 및 Connectivity Test 항목을 확인할 수 있습니다.
04 · 확인

Connectivity Test: 서버를 테스트하고 실제 접속 확인

방금 선택한 서버와 모드를 유지한 채 Home에서 Connectivity Test를 탭하고 테스트가 끝나면 선택한 항목의 결과를 확인합니다. 응답이 있으면 현재 방법으로 테스트 결과를 얻은 것입니다. 시간 초과가 발생했다면 원인을 더 확인해야 하는 상태로 판단하세요. 테스트 대상과 브라우저에서 접속하려는 대상은 다를 수 있으므로 한 번의 성공이나 시간 초과만으로 결론 내리지 마세요.

그다음 브라우저로 이동해 현재 네트워크에서 이전에 접속할 수 있었던 페이지를 열고 직접 새로고침합니다. 화면을 전환했을 때 남아 있는 이전 페이지 내용만 확인하지 마세요. 이전 내용은 브라우저 캐시에 저장되어 있을 수 있어 새 요청이 전송되었는지 알 수 없습니다. Config를 사용한다면 현재 규칙에서 프록시로 처리될 대상 하나와 직접 연결될 대상 하나를 골라 각각 접속합니다. 페이지가 열렸다면 해당 접속이 완료되었다는 뜻입니다. 예상한 경로로 연결되었는지 확인하려면 현재 규칙과 사용 가능한 연결 기록도 함께 확인해야 합니다.

테스트에는 응답이 있지만 특정 도메인만 접속할 수 없다면 같은 네트워크에서 서버를 그대로 둔 채 잠시 Proxy로 전환해 같은 대상에 다시 접속한 다음 원래 모드로 돌아갑니다. 결과가 다르면 구성 파일에서 더 앞에 있는 일치 조건이나 FINAL을 먼저 확인하세요. 두 모드의 결과가 같다면 대상 자체와 서버 연결 상태를 계속 점검하고, 한 번의 비교만으로 구성 전체를 바꾸지 마세요.

현재 모드, 테스트 결과, 문제가 발생한 도메인을 기록하세요. 예상한 접속이 모두 정상이라면 첫 설정이 완료된 것입니다. 문제가 남아 있다면 이 테스트 결과를 기준으로 삼고, 한 번에 조건 하나만 변경해야 어떤 조치가 결과를 바꿨는지 확인할 수 있습니다.

05 · 문제 해결

Settings: 실패가 발생한 단계별로 확인

구독을 저장했지만 항목이 없습니다.Add Server로 돌아가 Subscribe를 선택했는지 확인한 다음, 원래 주소와 대조해 링크 일부가 빠지지 않았는지 확인합니다. 구독 업데이트가 계속 실패한다면 링크를 제공한 서비스 업체에 링크가 아직 유효한지 문의하세요. 서버를 직접 추가했다면 입력한 포트와 프로토콜이 제공된 정보와 일치하는지 확인한 다음 인증 정보를 살펴봅니다. 가져오기 문제는 연결을 시작하기 전에 발생하므로 Global Routing을 전환해도 누락된 정보가 보완되지는 않습니다.

스위치가 켜진 상태로 유지되지 않습니다. 먼저 시스템에서 VPN 구성 추가를 허용하는지 확인합니다. 이전에 거부했다면 Home으로 돌아가 스위치를 다시 켜고, 시스템 안내가 다시 표시되면 그에 따라 처리합니다. 기기가 조직에서 관리되고 구성이 제한되어 있다면 기기 관리자에게 문의하세요. 관리 구성을 삭제하지 마세요. 연결된 뒤 저절로 다시 연결되거나 끊어진다면 Settings에서 On Demand가 활성화되어 있는지 확인합니다. 필요에 따라 조정하기 전에 조건을 먼저 확인하세요.

스위치는 정상인데 테스트가 시간 초과됩니다. 먼저 연결을 끄고 현재 네트워크 자체에서 평소 사용하는 페이지에 접속할 수 있는지 확인합니다. 공용 Wi-Fi에 로그인 또는 확인 페이지가 있다면 먼저 연결을 완료하세요. 앱으로 돌아와 Type, Host, Port와 프로토콜별 인증 정보를 하나씩 확인합니다. 사용 중인 구독에 상태가 명확한 다른 서버가 있다면 같은 네트워크와 같은 모드에서 비교 테스트하세요. 서버와 분할 규칙을 동시에 변경하지 마세요.

테스트는 결과를 반환하지만 접속이 예상과 다릅니다. 먼저 Settings에서 Test Method를 확인해 앱 테스트와 실제 접속 결과가 달라질 수 있는 이유를 살펴봅니다. 그런 다음 구성 파일로 돌아와 실제로 적용된 규칙을 확인합니다. 필요한 경우 Diagnostics를 열어 이용할 수 있는 정보를 확인하고, 문제 발생 시간, 네트워크 유형, 연결 상태와 실행한 동작을 대조합니다. 스크린샷이나 진단 내용을 공유하기 전에 전체 구독 링크, 비밀번호와 기타 비공개 항목을 삭제하세요.

증상에 따라 더 확인하려면 문제 해결 안내를 참고하세요. 스토어에서 앱을 받거나 기기를 교체하고 복원하는 중에 발생한 문제라면 정품 안내로 이동하세요. 이러한 문제는 앱 내부 설정과 별도로 확인해야 합니다.

Shadowrocket Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP 및 UDP 표시
Settings에서 Test Method, On Demand, Diagnostics를 확인하고 문제 발생 단계에 맞는 항목을 살펴보세요.
Shadowrocket 모든 플랫폼 다운로드