Shadowrocket 사용 가이드:
가져오기, 연결 및작동 확인
기존 서버 정보를 추가한 다음 트래픽 처리 모드를 선택합니다. 연결 후 테스트 결과와 실제 접속을 함께 확인하고, 스위치 상태만으로 결론 내리지 마세요.
Add Server: 서버 추가 또는 구독 가져오기
구독 링크와 단일 서버 매개변수는 서로 다른 입력 방식입니다. 보유한 정보에 맞는 한 가지를 선택하고 중복 추가하지 마세요.
기존 구독 링크가 있는 경우: Subscribe 선택
Home으로 이동해 오른쪽 위 추가 버튼을 누르거나 목록에서 Add Server를 눌러 서버 편집 화면을 엽니다. 먼저 Type을 누르고 Subscribe를 선택한 다음 URL 입력란에 사용자가 보유한 전체 구독 링크를 붙여 넣습니다. 돌아온 뒤 공백이나 줄 바꿈이 추가되지 않았는지 확인하세요. 특히 설명 문구까지 함께 복사하지 않도록 주의합니다. 이름이나 메모는 구분용이므로 관리 방식에 맞게 입력할 수 있습니다.
확인한 다음 오른쪽 위 저장 또는 완료 버튼을 눌러 Home으로 돌아갑니다. 서버 항목이 보이지 않으면 해당 구독 항목의 작업 메뉴에서 업데이트를 실행하고 가져오기가 끝날 때까지 기다립니다. 구독 항목은 목록의 출처이지, 연결 가능한 서버 한 대와 같은 의미가 아닙니다. 해당 그룹을 펼쳐 실제 항목이 있는지 확인한 후 다음 단계를 진행하세요. 파싱 실패가 표시되면 링크가 완전한지, 링크가 실제 구독 내용을 반환하는지, 로그인 페이지나 일반 웹페이지가 아닌지 먼저 확인합니다.
기존 단일 서버 정보가 있는 경우: 프로토콜에 맞게 입력
같은 방법으로 Add Server에 들어가 Type에서 자료에 지정된 프로토콜(예: Shadowsocks)을 선택하고 Host(서버 주소), Port(포트), Password(비밀번호)를 차례로 입력합니다. Shadowsocks를 사용하는 경우 Method(암호화 방식)도 확인합니다. 다른 프로토콜에 추가 필드가 표시된다면 보유한 자료에 따라 각 항목을 입력해야 합니다. 다른 프로토콜의 필드를 그대로 적용하지 마세요. 주소 입력란에는 일반적으로 호스트 이름이나 IP 주소를 입력하며, 임의로 웹 경로를 덧붙이지 않습니다.
보유한 정보가 QR 코드라면 Scan QR Code를 사용해 가져오고 저장 전에 필드를 다시 확인합니다. Import from Cloud JSON은 해당 형식의 자료를 위한 기능이므로 일반 구독 링크를 임의로 입력하지 마세요. 완료하면 Home으로 돌아가 SERVER 그룹에서 새 항목의 이름과 유형을 확인합니다. 이 단계에서는 정보만 저장한 상태이며 프록시 연결은 시작되지 않았습니다. 다음 단계에서 트래픽 처리 방식을 선택해야 합니다.
구독 링크, 비밀번호, QR 코드에는 접근 인증 정보가 포함될 수 있습니다. 전체 내용을 공개 게시판에 올리지 마세요. 형식 문제는 FAQ를 먼저 확인하고, Subscribe와 구성 파일의 차이는 용어집에서 확인하세요.
Global Routing: Config, Proxy 또는 Direct 선택
서버는 트래픽이 향하는 곳을 정하고, Global Routing은 트래픽을 처리하는 방식을 정합니다. 두 설정은 서로 다릅니다.
Home으로 돌아가 Global Routing을 눌러 현재 모드를 확인합니다. 여기에는 Config / Proxy / Direct 세 가지가 있습니다. 이름만 보고 선택하지 말고, 평소 사용 중인지 서버 사용 가능 여부를 임시로 확인하는 중인지 먼저 판단하세요. 변경한 뒤 Home으로 돌아와 Global Routing 행의 내용이 바뀌었는지 확인합니다.
Config: 현재 구성 파일에 따라 처리
Config는 현재 활성화된 구성 파일의 규칙에 따라 처리합니다. Config에 들어가 사용 중인 파일을 확인한 다음 Rule 섹션을 살펴봅니다. 규칙이 일치하면 해당 정책을 적용합니다. PROXY는 프록시 정책으로 처리하고, DIRECT는 직접 연결하며, REJECT는 거부합니다. 구독 목록의 서버 정보를 업데이트했다고 해서 원하는 분할 라우팅 규칙이 다운로드되어 활성화된 것은 아닙니다.
처음 사용할 때 모든 구성을 바로 바꿀 필요는 없습니다. 현재 파일에 필요한 규칙과 기본 처리 방식이 있는지 먼저 확인하고, 기존 파일을 유지하면서 내용을 파악한 후 편집하세요. 구성 화면의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 용도가 서로 다릅니다. 기본 연결을 위해 하나씩 모두 켜거나 수정할 필요는 없으며, 사용법을 익히기 위해 복호화 설정을 변경할 필요도 없습니다.
Proxy와 Direct: 명확한 비교 점검에 사용
Proxy는 클라이언트가 처리하는 트래픽을 프록시 모드로 전달합니다. 현재 서버가 실제 접속을 처리할 수 있는지 임시로 확인하는 데 사용할 수 있지만, 시스템 네트워크와 앱 동작의 영향을 받습니다. Direct는 클라이언트가 처리하는 트래픽을 선택한 프록시 서버를 거치지 않고 직접 연결합니다. 기본 네트워크를 비교하는 데 사용할 수 있지만, 이 결과만으로 프록시 서버가 정상이라고 판단할 수는 없습니다. 비교가 끝나면 실제 필요한 모드로 되돌립니다.
규칙은 일반적으로 위에서 아래로 일치 여부를 확인하며, 앞선 규칙과 일치하지 않으면 FINAL(기본 규칙)에 도달합니다. 예를 들어 아래 조각은 example.com과 하위 도메인에 PROXY를 적용하고, 나머지 요청은 FINAL을 통해 DIRECT로 보냅니다. 문법 예시일 뿐, 현재 구성 파일 전체를 그대로 대체하라는 뜻은 아닙니다. 구성 파일 구조, 우선순위, 추가 규칙 유형은 구성 필드 참고에서 확인하세요.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
Home: 서버를 선택하고 연결 스위치 켜기
먼저 항목을 선택한 다음 연결합니다. 처음 표시되는 승인은 시스템에서 VPN 구성을 설정하는 단계입니다.
Home으로 돌아가 SERVER 그룹에서 사용할 서버를 선택하고 선택 표시가 원하는 항목에 있는지 확인합니다. 구독 그룹이 여러 개라면 먼저 올바른 그룹을 펼친 다음 서버를 선택합니다. 편집 버튼을 누르는 것과 항목을 선택하는 것은 다른 작업이므로 매개변수 화면으로 들어갔다면 먼저 홈 화면으로 돌아옵니다. 그런 다음 Global Routing을 다시 확인해 문제 해결 중 Direct 모드로 남아 있지 않은지 확인합니다.
Home 상단의 연결 스위치를 켭니다. 처음 사용할 때 시스템에서 VPN 구성 추가 승인 요청이 표시될 수 있습니다. 앱 이름과 안내를 읽고 확인한 다음 시스템 안내에 따라 기기 인증을 진행합니다. 이 단계는 시스템이 이 기기에 VPN 구성을 만들도록 허용하는 절차입니다. 구독을 추가하거나 잘못된 서버 매개변수를 보완하는 과정은 아닙니다. 승인을 취소하면 돌아왔을 때 스위치가 꺼져 있을 수 있으므로 연결을 다시 시작하고 승인을 완료합니다.
Shadowrocket으로 돌아와 상단에 Not Connected가 계속 표시되는지 확인합니다. 연결 상태로 바뀌었다면 이 기기에서 연결 절차가 시작된 것입니다. 하지만 원격 서버, DNS 또는 모든 대상 웹사이트가 정상이라는 뜻은 아닙니다. 스위치를 빠르게 반복해서 켜고 끄지 마세요. 현재 작업이 끝날 때까지 기다린 다음 확인 단계로 이동하면 각 연결 결과를 구분하기 쉽습니다.
시스템에서 다른 VPN 연결이 있다고 알리면 라우팅에 영향을 줄 수 있는 시스템 구성이 있는지 먼저 확인해 여러 연결이 서로 간섭하지 않게 합니다. 관리되는 기기에서는 관리자의 허용이 필요할 수 있습니다. 처음 문제를 점검할 때는 현재 네트워크를 유지하고, Wi-Fi와 셀룰러 네트워크를 전환하면서 프로토콜 매개변수까지 동시에 바꾸지 않는 것이 좋습니다. 사용을 마치면 Home에서 스위치를 끄고 시스템 연결 상태도 종료되었는지 확인합니다.
Connectivity Test: 실제 접속과 함께 확인
연결 상태, 테스트 결과, 대상 요청은 서로 다른 세 가지 점검 항목입니다. 어느 하나도 다른 항목을 대신할 수 없습니다.
먼저 테스트한 다음 사용할 콘텐츠 열기
Home에서 Connectivity Test를 누르고 현재 테스트가 끝날 때까지 기다립니다. 테스트 결과는 Settings의 Test Method와 테스트 대상에 영향을 받습니다. 선택한 항목에 해당 방식으로 접근할 수 있는지 판단하는 데 도움이 되지만, 모든 웹사이트가 정상적으로 로드된다고 보장하지는 않습니다. 한 번의 시간 초과만으로 모든 서버를 사용할 수 없다고 단정하지 말고, 다른 항목 및 실제 접속 결과와 함께 범위를 판단합니다.
그런 다음 브라우저로 전환해 원래 사용하려던 페이지를 새로고침하고 본문, 이미지, 후속 요청이 정상인지 확인합니다. 캐시된 홈 화면만 보지 말고 구체적인 콘텐츠 페이지를 다시 열어 현재 네트워크가 사용 가능하다고 잘못 판단하지 않도록 합니다. 브라우저에서는 접속되지만 특정 앱에서 접속되지 않는다면 해당 앱과 요청으로 문제 범위를 좁힙니다. 모든 구독을 바로 삭제할 필요는 없습니다.
Config를 사용할 때 규칙도 추가로 확인
앱으로 돌아가 Data에서 현재 버전이 제공하는 연결 또는 요청 기록을 확인하고 대상 도메인, 일치한 규칙, 적용된 정책을 대조합니다. 이 기록은 “연결은 되었지만 DIRECT를 사용함”과 “PROXY를 사용했지만 요청이 실패함”을 구분하는 데 도움이 됩니다. 연결이 나가는 경로만으로 규칙을 추측하지 말고, 요청 하나가 성공했다고 모든 트래픽이 같은 경로를 이용한다고 판단하지 마세요.
비교가 필요하다면 같은 서버와 네트워크를 유지한 채 Proxy로 잠시 전환한 뒤 같은 대상을 다시 시도합니다. Proxy는 정상이고 Config에서 문제가 있다면 활성화한 파일과 규칙 순서를 우선 확인합니다. 두 모드에서 모두 실패한다면 서버 매개변수나 기본 네트워크를 우선 확인합니다. 테스트가 끝나면 원래 모드로 복원하고 재현 가능한 현상을 기록한 다음 문제 해결을 계속합니다.
Settings: 범위별로 일반적인 실패 원인 점검
한 번에 한 항목만 변경하고 같은 대상을 다시 테스트하세요. 변경 전후의 차이를 설명할 수 있는 기록을 남깁니다.
목록이 비어 있거나 구독 업데이트 실패
먼저 기기에서 일반 웹페이지에 접속할 수 있는지 확인한 다음 구독 링크가 잘리지 않았는지, 아직 유효한지 확인합니다. 서비스 제공자가 정보를 변경했다면 같은 항목을 반복해서 추가하는 대신 사용자가 보유한 최신 링크를 확인합니다. 기존 서버는 사용할 수 있지만 업데이트에 실패하는 경우와 모든 서버에 연결할 수 없는 경우는 서로 다른 문제입니다. 두 상황을 구분해 확인하고, 원래 유효했던 항목을 실수로 삭제하지 않도록 합니다.
단일 서버 시간 초과 또는 연결 후 접속 불가
서버 하나만 실패한다면 해당 항목의 Host, Port, 프로토콜 유형, 인증 매개변수를 우선 확인합니다. 도메인 철자, 포트 번호, Method의 차이로도 실패할 수 있습니다. 추가 전송 또는 TLS 매개변수를 사용하는 프로토콜이라면 해당 필드도 확인합니다. 이어서 시스템 날짜와 시간이 정확한지 확인합니다. 매개변수나 시간 문제를 감추기 위해 인증서 검증을 임의로 끄지 마세요.
모든 항목에서 실패한다면 현재 Wi-Fi와 셀룰러 네트워크에서 결과를 비교한 다음 시스템 VPN 승인 및 연결에 영향을 줄 수 있는 다른 시스템 설정을 확인합니다. 네트워크를 바꾼 뒤 먼저 다시 테스트하고 서버 필드는 동시에 수정하지 마세요. 연결 후 일부 도메인에서만 실패한다면 Global Routing과 Config로 돌아가 규칙을 확인하고 요청 기록으로 DNS 문제, 정책 선택, 원격 응답을 구분합니다.
테스트 방식, 자동 연결, 진단 기록 확인
Settings를 열고 Test Method에서 Connectivity Test에 사용하는 방식을 확인합니다. 테스트 방식이 다른 결과를 직접 비교하지 않도록 합니다. On Demand는 조건에 따라 연결을 시작합니다. 연결을 껐는데 다시 연결된다면 관련 조건이 설정되어 있는지 확인합니다. 처음 수동으로 테스트할 때는 현재 조건이 적용 중인지 먼저 파악한 다음 변경 여부를 결정합니다.
추가로 원인을 파악해야 한다면 Diagnostics에서 현재 사용할 수 있는 도구와 기록을 확인하고 오류 발생 시 네트워크 유형, 모드, 조작 순서를 기록합니다. 진단 정보를 공유하기 전에 구독 주소, 비밀번호, QR 코드 및 개인을 식별할 수 있는 정보를 숨깁니다. Proxy, TCP, UDP 등의 설정을 “일단 시험 삼아” 모두 변경할 필요는 없습니다. 확실하지 않은 옵션은 기존 값으로 둡니다.
여기까지 진행해도 해결되지 않으면 증상에 따라 FAQ의 설치 및 연결 문제를 확인하세요. 필드의 의미가 불분명하면 용어집을 참고하고, 규칙을 수정해야 한다면 구성 필드 참고를 읽으세요. 여러 스위치를 한꺼번에 바꾸는 것보다 재현 절차를 명확하게 정리하는 편이 원인 파악에 도움이 됩니다.