공식 매뉴얼 / 첫 연결
Shadowrocket 사용법
이 안내는 iPhone / iPad 화면을 기준으로 설명합니다. 보유한 서버 또는 구독을 준비한 뒤 가져오기, 라우팅 선택, 연결 및 확인을 차례로 진행합니다. 이미 가져오기를 마쳤다면 Global Routing으로 바로 이동할 수 있습니다.
서버 추가 또는 Subscribe 가져오기
먼저 보유한 정보를 확인합니다. 프로토콜, 호스트 이름, 포트 및 관련 인증 정보가 있다면 수동으로 추가하고, 서비스 제공업체에서 받은 구독 주소가 있다면 Subscribe를 선택합니다. 구독 주소와 서버 호스트 이름은 용도가 다릅니다. 전체 구독 링크를 Host에 입력하거나 단일 서버 주소를 구독 주소로 입력하지 마세요. 둘 중 하나를 선택하면 시작할 수 있으므로 같은 항목을 중복으로 가져올 필요는 없습니다.
Add Server에 직접 입력
Home을 열고 SERVER 영역에서 Add Server를 찾습니다. 양식에서 Type을 누르고 알고 있는 정보에 맞는 프로토콜을 선택합니다. 프로토콜에 따라 이후 표시되는 필드가 달라집니다. 예를 들어 Shadowsocks의 경우 Host에는 서버 호스트 이름 또는 IP를, Port에는 포트 번호를, Password에는 해당 비밀번호를 입력하고, Method는 서버 설정과 일치시킵니다. 예시 화면의 필드 구성이 다른 프로토콜에도 동일하다고 가정하지 마세요. Type을 변경한 뒤에는 실제로 표시되는 필드와 서비스 제공업체가 제공한 정보를 기준으로 입력합니다.
저장하기 전에 입력값을 다시 확인합니다. Host에 URL 경로가 들어가 있지 않은지, 포트 번호를 잘못 옮기지 않았는지, 비밀번호 앞뒤에 공백이 붙지 않았는지 확인하세요. 단일 서버 공유용 QR 코드가 있다면 Add Server에서 Scan QR Code를 사용할 수 있습니다. 스캔 후 인식된 Type과 주요 필드를 먼저 확인한 다음 저장합니다. 스캔 성공은 내용이 인식되었다는 뜻일 뿐 서버가 작동한다는 의미는 아닙니다.
Subscribe로 기존 링크 가져오기
Home에서 Add Server로 이동한 다음 Type에서 Subscribe를 선택합니다. 서비스 제공업체가 제공한 전체 링크를 구독 주소 입력란에 붙여 넣고 쿼리 매개변수를 포함해 끝까지 보존합니다. 저장 후 Home으로 돌아가 해당 구독 그룹을 찾아 업데이트한 뒤 선택 가능한 항목이 표시되는지 확인합니다. 그룹 이름만 보이고 서버가 없다면 라우팅 모드를 변경하지 말고 먼저 구독을 가져오거나 해석하는 과정에 문제가 없는지 확인합니다. 항목이 나타나면 이번에 사용할 서버를 선택하고 이름을 기억해 둡니다. 이후 테스트에서 같은 항목인지 확인해야 합니다.
Global Routing 선택
Home으로 돌아가 Global Routing을 눌러 현재 라우팅 모드를 확인합니다. 서버 선택은 사용할 프록시 출구를 정하는 것이고, 라우팅 모드 선택은 요청을 처리하는 방식을 정하는 것입니다. 두 설정은 서로 대체할 수 없습니다. 목록에서 서버를 선택했다고 해서 모든 요청이 해당 서버를 거치는 것은 아닙니다.
- 구성(Config): 현재 적용 중인 구성 파일의 규칙에 따라 요청을 처리합니다. 대상별로 트래픽을 분기하려면 이 모드를 사용합니다. 요청은 먼저 일치하는 규칙에 따라 PROXY 또는 DIRECT로 처리될 수 있습니다.
- 프록시(Proxy): 구성 파일의 분기 규칙을 하나씩 적용해 정책을 선택하지 않습니다. 선택한 서버가 프록시 요청을 처리할 수 있는지 우선 확인하려면 일시적으로 비교 테스트에 사용할 수 있습니다.
- 직접 연결(Direct): 선택한 서버를 거치지 않고 요청을 보냅니다. 현재 네트워크에서 같은 대상에 직접 접속할 수 있는지 비교할 때 적합합니다. Home의 연결 스위치를 끄는 것과는 다릅니다.
구성(Config)을 선택한 뒤 Config로 전환해 현재 사용 중인 구성 파일을 확인하고 편집 페이지에서 Rule을 찾습니다. 편집 페이지와 Home의 Global Routing을 혼동하지 마세요. 전자는 일치 조건과 정책을 정하고, 후자는 해당 규칙을 적용할지 결정합니다. 규칙은 순서대로 확인하며 처음 일치한 규칙에서 처리가 끝납니다. 아래 예시는 순서를 설명하기 위한 것이므로 기존 구성을 바꿀 필요는 없습니다.
[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
이 예시에서 docs.example.com은 첫 번째 규칙과 일치해 DIRECT로 처리됩니다. www.example.com과 같은 다른 하위 도메인만 두 번째 규칙과 일치합니다. 두 규칙의 순서를 바꾸면 더 넓은 범위의 접미사 규칙이 docs.example.com에 먼저 적용됩니다. 앞선 규칙에 일치하지 않은 요청은 FINAL이 처리합니다. 첫 연결만 확인하는 경우 기존 구성을 그대로 두고 General, Hosts 또는 URL Rewrite를 변경하지 않아도 됩니다. 일치 조건을 수정해야 한다면 먼저 백업한 뒤 규칙 매뉴얼을 참고하세요.
Home 연결 스위치 켜기
라우팅 모드를 정한 뒤 Home으로 돌아가 SERVER 아래에서 방금 사용할 서버를 선택했는지 확인합니다. 구독에 이름이 비슷한 항목이 있으면 이름만 보고 판단하지 말고 세부 정보를 열어 확인합니다. 그런 다음 Home 상단의 Not Connected 옆 스위치를 켭니다. 처음 실행할 때 iOS 또는 iPadOS에서 VPN 구성 추가를 요청할 수 있습니다. 안내가 방금 실행한 Shadowrocket 작업으로 표시되는지 확인한 뒤 추가를 허용하고 시스템 안내에 따라 인증을 완료합니다.
시스템 안내를 처리한 뒤 Home으로 돌아가 상태가 안정될 때까지 기다린 다음 스위치가 계속 켜져 있는지 확인합니다. 스위치를 켜자마자 꺼지더라도 반복해서 누르거나 동시에 서버를 바꾸지 마세요. 시스템 안내를 완료했는지, 기기에 다른 VPN 연결이 있는지, 기기 관리 정책이 연결을 제한하는지 먼저 확인합니다. 관리되는 기기라면 제한 사항을 관리자에게 확인하고 테스트를 위해 관리 구성을 제거하지 마세요.
스위치가 켜져 있으면 로컬 연결이 설정된 것이지만 원격 서버, 대상 사이트 또는 모든 분기 규칙이 정상이라는 뜻은 아닙니다. 첫 테스트에서는 현재 네트워크, 선택한 서버 및 라우팅 모드를 그대로 유지합니다. 그래야 이후 접속에 실패하더라도 로컬 연결 단계의 문제인지, 연결 후 요청이 예상대로 처리되지 않은 것인지 구분할 수 있습니다.
Connectivity Test와 실제 접속 확인
먼저 Home으로 돌아가 Connectivity Test를 누르고 현재 선택한 서버의 결과를 확인합니다. 여러 항목의 결과가 함께 표시되면 이름을 기준으로 방금 선택한 행을 찾습니다. 테스트가 정상이라는 것은 해당 항목이 현재 테스트 조건에서 응답을 받았다는 의미일 뿐, 브라우저나 대상 앱에서 실제로 접속할 수 있다는 보장은 아닙니다. 테스트가 실패하더라도 테스트 방식을 함께 고려해야 하며 모든 접속이 실패한다고 단정할 수 없습니다.
그런 다음 접속 권한이 있고 평소 결과를 알고 있는 페이지를 엽니다. 직접 새로고침해 브라우저 캐시를 보고 있는 것은 아닌지 확인하고, 필요하면 다른 페이지를 열어 재확인합니다. 구성(Config)을 사용한다면 DIRECT 및 PROXY로 처리될 것으로 예상되는 대상을 각각 선택하고 실제 호스트 이름을 기록합니다. 페이지에 표시된 사이트 이름만 기록하지 마세요. 웹페이지가 리디렉션되면 다른 호스트 이름으로 이동할 수 있고, 페이지의 이미지, 스크립트 또는 API도 서로 다른 도메인에서 제공될 수 있습니다.
요청 기록을 볼 수 있다면 시간과 호스트 이름을 기준으로 이번 접속에 해당하는 요청을 찾아 기록에 표시된 정책을 Config의 규칙과 비교합니다. 확인할 수 있는 기록이 없다면 Rule로 돌아가 원래 순서대로 직접 대조합니다. 먼저 대상이 앞쪽의 정확한 규칙이나 접미사 규칙과 일치하는지 확인한 다음 FINAL에 해당하는지 살펴봅니다. 페이지가 열린다는 사실만으로 예상한 정책이 적용되었다고 판단할 수는 없습니다.
비교 테스트가 필요하면 같은 네트워크에서 같은 대상에 접속하고 Global Routing만 한 번에 하나씩 변경합니다. 테스트가 끝나면 원래 모드로 되돌립니다. 프록시(Proxy)에서는 접속되지만 구성(Config)에서는 실패한다면 규칙과 현재 구성 파일을 먼저 확인합니다. 두 모드 모두 실패한다면 서버 설정과 현재 네트워크를 추가로 확인합니다. 서로 다른 여러 사이트의 결과를 그대로 비교하지 말고, 연결을 한 번 확인하기 위해 모드를 영구적으로 변경하지도 마세요.
Settings에서 일반적인 문제 해결
먼저 문제가 발생한 단계를 구분합니다. 목록에 선택할 항목이 없다면 가져오기 문제이고, 상단 스위치가 켜진 상태를 유지하지 못한다면 시스템 연결을 먼저 확인합니다. 스위치는 안정적으로 켜져 있지만 테스트나 접속이 실패한다면 출구, 테스트 조건 및 규칙을 구분해 살펴봅니다. 이 세 단계를 순서대로 확인하면 사용 중인 설정을 한꺼번에 바꾸는 일을 피할 수 있습니다.
구독을 업데이트해도 항목이 표시되지 않음
Type이 Subscribe인지 확인하고 서비스 제공업체가 제공한 원본에서 전체 주소를 다시 복사합니다. 주소에 쿼리 매개변수가 포함되어 있다면 물음표 뒤의 내용도 보존해야 합니다. 주소가 올바른데도 그룹이 비어 있다면 링크가 유효한지, 응답 형식이 Shadowrocket에서 사용할 수 있는지 서비스 제공업체에 확인합니다. 전체 주소를 공개된 해석 도구에 붙여 넣지 말고, 아직 사용할 수 있는 그룹을 먼저 삭제하지 마세요.
연결 후 테스트가 시간 초과되거나 일부 대상만 실패함
Settings로 이동해 Test Method를 확인하고 두 번의 비교 테스트에서 같은 방식을 사용하는지 확인합니다. 현재 서버에서 계속 시간 초과가 발생하면 먼저 기기 자체가 인터넷에 연결되는지 확인하고, 사용 가능하다고 알려진 네트워크와 비교한 뒤 Add Server의 관련 필드에서 Type, Host, Port 및 프로토콜에 필요한 매개변수를 확인합니다. 일부 대상만 실패한다면 먼저 확인 단계에 따라 같은 대상을 대상으로 모드를 비교한 다음 도메인이 REJECT와 일치하거나 예상과 다른 정책으로 처리되는지 확인합니다.
네트워크 전환 후 연결 상태가 달라짐
Settings에서 On Demand가 활성화되어 있는지 확인합니다. 활성화된 경우 네트워크 변경으로 재연결되거나 연결이 끊길 수 있습니다. 테스트할 때는 현재 조건을 기록해 두고 요청 시 연결 동작을 서버 문제로 오인하지 않도록 합니다. 원인을 찾기 어렵다면 Diagnostics를 열고 오류가 발생한 시각, 연결된 네트워크, 모드 및 화면에 표시된 오류 메시지를 기록합니다. 문제 해결을 위해 정보를 전달할 때는 서버 인증 정보, 구독 주소 및 공개하기 부적절한 접속 기록을 먼저 가립니다. 설정을 하나 변경할 때마다 Home으로 돌아가 다시 테스트하고, 해결 후에는 임시로 변경한 설정을 복원합니다.