Shadowrocket 사용법
기존 구독 또는 서버 정보를 바탕으로 추가, 모드 선택, 연결 및 확인을 차례로 진행합니다. 먼저 연결 하나를 정상적으로 작동시킨 뒤 규칙과 요청 시 연결 설정을 조정하세요.
진행 순서: 먼저 입력 정보가 완전한지 확인한 다음 처리 방식을 선택합니다. 연결 스위치를 켠 뒤에는 실제 요청도 확인해야 합니다. 구독과 설정 파일은 서로 다른 종류이므로 파일 이름만 보고 가져오기 메뉴를 판단하지 마세요.
Add Server: 서버 추가 및 구독 가져오기
서버를 직접 추가하거나 구독을 가져오는 방법 중 하나를 선택하면 됩니다. 가져오기가 완료되었는지는 링크가 저장되었는지가 아니라 Home의 SERVER에 선택할 수 있는 서버가 표시되는지로 확인하세요.
직접 추가: Type에 맞는 정보 입력
Shadowrocket의 Home을 열고 SERVER 영역에서 Add Server를 선택합니다. 먼저 Type을 누른 뒤 서버 정보에 지정된 프로토콜을 선택하고 Host와 Port를 입력합니다. Host에는 제공받은 서버 주소를 입력하세요. 구독 링크 전체를 여기에 붙여 넣으면 안 됩니다. Port에는 해당 포트 번호만 입력하고 설명은 덧붙이지 마세요. 프로토콜을 선택하면 관련 인증 정보 입력란이 표시됩니다. 필수 입력 여부는 프로토콜과 서버 설정에 따라 다릅니다.
예를 들어 Shadowsocks를 선택했다면 제공받은 정보에 따라 Password와 Method를 입력하세요. 이름이 비슷하다는 이유만으로 암호화 방식을 선택하면 안 됩니다. VMess, VLESS, Trojan 또는 Hysteria2를 사용할 때는 해당 프로토콜의 사용자 정보, TLS 및 전송 매개변수도 확인하세요. 한 프로토콜의 값을 다른 프로토콜에 적용하지 마세요. 필수 정보가 빠져 있다면 임의의 값을 시도하지 말고 서비스 제공업체에 필요한 정보를 요청하세요. 알아보기 쉬운 이름을 메모로 입력할 수 있지만, 메모는 실제 주소나 인증 정보를 대신할 수 없습니다.
입력 내용을 확인한 뒤 저장하고 Home으로 돌아갑니다. SERVER에 방금 추가한 항목이 표시되고 이름이 예상한 것과 일치하는지 확인한 다음 서버를 선택하세요. 이 단계는 정보 입력을 마친 것일 뿐, 서버가 사용 가능하다는 뜻은 아닙니다. 인식 가능한 서버 QR 코드가 있다면 Add Server의 Scan QR Code에서 읽을 수 있습니다. 가져온 뒤에도 항목을 열어 Type, Host, Port 등을 확인하세요. 스캔 성공이 연결 성공을 의미하지는 않습니다.
Subscribe: 기존 구독 가져오기
구독 링크를 보유하고 있다면 Add Server에서 Subscribe를 선택하고, 화면의 입력란에 링크 전체와 알아보기 쉬운 메모를 입력한 뒤 저장합니다. 복사할 때는 기존 쿼리 매개변수를 그대로 유지하고, 채팅 문구와 줄바꿈, 링크를 둘러싼 따옴표는 제거하세요. 접속 정보가 포함된 구독 링크는 민감한 정보입니다. 공개 게시물이나 공개 스크린샷에 올리지 마세요. 도움이 필요하면 오류 증상만 설명하고 링크의 민감한 부분은 가리세요.
Home으로 돌아가 구독 내용이 로드될 때까지 기다립니다. 필요한 경우 해당 구독 항목을 업데이트하세요. 정상적으로 가져오면 구독에서 생성된 서버 항목이 표시됩니다. 구독 이름만 보이고 서버가 없다면 먼저 가져오기 오류가 있는지 확인한 다음, 링크가 Shadowrocket에서 인식할 수 있는 구독 내용을 반환하는지 살펴보세요. 로그인 페이지나 일반 웹페이지를 반환하는 링크일 수도 있습니다. 한 번의 실패를 해결하려고 같은 이름의 구독을 반복해서 만들지 마세요. 나중에 잘못된 항목을 선택할 가능성이 커집니다.
구독 업데이트는 원격 서버 정보를 동기화하는 기능이며, 규칙 설정을 가져오는 것과는 다릅니다. 구독 항목을 직접 수정한 내용이 유지되지 않을 수도 있습니다. 먼저 정보가 완전한 서버 하나를 선택해 다음 단계로 진행하세요. 구독 업데이트 실패, 내용 변경 및 중복 항목에 관한 자세한 내용은 자주 묻는 질문을 참조하세요. 설정 파일 구조는 설정 필드 참조에서 확인할 수 있습니다. 이 단계에서는 규칙을 수정하지 않습니다.
Global Routing: Config, Proxy 및 Direct
서버 항목은 연결할 대상을 정하고, Global Routing은 요청 처리 방식을 정합니다. 두 항목을 각각 확인해야 합니다.
추가를 마치면 Home으로 돌아가 Global Routing을 눌러 현재 선택된 방식을 확인합니다. 자주 사용하는 세 가지 방식은 Config, Proxy, Direct입니다. 먼저 현재 선택된 항목을 확인한 뒤 변경 여부를 결정하세요. 연결이 실패한다고 여러 방식을 연달아 전환하면 어떤 변경이 결과에 영향을 미쳤는지 파악하기 어렵습니다.
Config: 현재 설정에 따라 규칙 적용
Config를 선택하면 요청은 현재 적용 중인 설정의 규칙에 따라 처리됩니다. Config로 이동해 어떤 설정 파일이 사용 중인지 확인한 다음 해당 파일의 Rule을 살펴보세요. 파일 목록에 설정 파일이 있다고 해서 반드시 활성화된 것은 아닙니다. 다른 파일을 편집해도 현재 연결에 적용된 규칙은 자동으로 바뀌지 않습니다. 처음 사용하는 경우 현재 파일이 예상한 파일인지 먼저 확인하세요. General, Rule 및 다른 모든 섹션을 한꺼번에 수정할 필요는 없습니다.
Rule은 일반적으로 위에서 아래 순서로 확인하며, 일치하는 규칙이 있으면 지정된 정책을 사용합니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 지정한 도메인 접미사에 PROXY를 적용하고, IP-CIDR,192.168.0.0/16,DIRECT는 해당 주소 범위와 일치하는 요청에 사용됩니다. 마지막의 FINAL,PROXY는 앞의 규칙과 일치하지 않은 요청의 처리 방식을 지정합니다. 다음은 문법 예시입니다. 현재 사용 중인 규칙을 예시 전체로 덮어쓰지 마세요.
PROXY, DIRECT, REJECT는 정책 키워드이므로 한국어 뜻만 보고 임의로 바꾸면 안 됩니다. 규칙을 확인할 때 해당 정책이나 정책 그룹이 실제로 존재하는지, 대상 선택이 예상대로인지도 살펴보세요. 규칙 유형, DNS 조회 및 일치 조건의 관계는 고급 설정에 해당합니다. 구체적인 작성법은 Rule 및 규칙 순서 안내를 참조하세요. 이 가이드에서는 우선 현재 파일과 실제 정책을 확인하는 방법을 다룹니다.
Proxy 및 Direct: 연결 경로 비교
Proxy를 선택하면 복잡한 규칙을 함께 고려하지 않고 선택한 프록시 경로가 정상인지 확인할 수 있습니다. Direct는 직접 연결 상태를 확인하는 방식이며, 선택한 프록시 서버가 사용 가능하다는 것을 증명하지는 않습니다. Proxy에서는 정상인데 Config에서 특정 대상에 문제가 발생한다면 서버 매개변수를 모두 다시 입력하기 전에 해당 대상에 적용된 규칙과 정책을 확인하세요.
방식을 선택한 뒤 Home으로 돌아가 Global Routing에 표시된 값을 다시 확인하고, SERVER에서 현재 선택된 서버도 확인합니다. 비교 테스트가 끝나면 장기적으로 사용할 방식으로 되돌리세요. 규칙 기반으로 사용할 계획이라면 보통 Config로 돌아가 방금 확인한 유효한 설정을 유지합니다. 다음 단계에서는 연결 스위치만 켜고 설정 파일은 편집하지 마세요.
Home: 연결을 켜고 VPN 구성 허용
먼저 서버와 Global Routing을 확인한 뒤 상단 스위치를 켭니다. 시스템 권한과 서버 인증은 서로 다른 절차입니다.
Home으로 돌아가 SERVER에서 방금 테스트하려고 준비한 서버가 선택되어 있는지 확인합니다. 이름이 같은 이전 항목을 선택하지 않도록 주의하세요. 이어서 Global Routing이 앞 단계에서 선택한 방식과 같은지 확인한 다음 화면 상단의 연결 스위치를 켭니다. 아직 연결되지 않은 경우 Not Connected로 표시될 수 있습니다. 스위치를 켠 뒤 상태가 바뀌는지는 시스템 연결이 설정되었는지를 보여줄 뿐, 특정 웹사이트에 접속할 수 있는지를 판단하는 기준은 아닙니다.
처음 연결할 때 시스템에서 Shadowrocket의 VPN 구성을 추가하도록 허용할지 묻습니다. 안내에 표시된 앱 이름이 현재 작업 중인 앱과 일치하는지 확인한 뒤 허용하고, 기기의 안내에 따라 인증을 완료하세요. 여기서 만드는 것은 시스템 네트워크 확장 기능에 필요한 VPN 구성입니다. 서버 Password를 다시 입력하는 절차가 아닙니다. 서버 비밀번호를 관련 없는 시스템 인증 화면에 입력하지 마세요. 이 안내를 위해 별도의 설정 파일을 가져올 필요도 없습니다.
시스템 확인을 마치면 Shadowrocket으로 돌아와 연결 스위치가 계속 켜져 있는지, 화면 상태가 Not Connected에서 연결됨으로 바뀌었는지 확인합니다. 시스템 안내에서 취소를 선택했다면 앱이 연결을 설정하지 못할 수 있습니다. 연결을 다시 시도하고 안내에 따라 권한을 허용하세요. 시스템 설정에서 해당 VPN 구성을 삭제한 적이 있다면 이 절차를 다시 진행해야 할 수도 있습니다.
스위치가 바로 꺼지면 권한 안내나 오류 메시지가 표시되었는지 먼저 기록하세요. iPhone / iPad의 시스템 설정에서 VPN을 검색해 해당 구성이 있는지, 다른 연결이 현재 네트워크를 사용 중인지 확인할 수 있습니다. 기록 없이 모든 네트워크 설정을 삭제하지 마세요. 권한, 현재 연결 및 앱 내 옵션을 먼저 확인하면 문제를 더 쉽게 찾을 수 있습니다. 기기 관리 제한이 있는 기기에서는 관리 정책도 따라야 합니다.
스위치가 켜진 상태로 유지되면 앱의 상태 업데이트가 끝날 때까지 기다린 뒤 접속을 확인합니다. 시스템에 VPN 표시가 나타나면 관련 시스템 연결이 활성 상태라는 뜻일 뿐, 구독 유효 기간, 서버 인증, 원격 접속 또는 모든 분기 규칙이 정상이라는 뜻은 아닙니다. 아직 On Demand를 켜거나 여러 서버를 동시에 전환하지 마세요. 현재 조건을 그대로 유지해야 다음 단계의 테스트 결과를 이 연결과 정확히 비교할 수 있습니다.
연결을 잠시 중단하려면 Home으로 돌아가 상단 연결 스위치를 끄면 됩니다. 수동 연결과 연결 해제를 한 번씩 확인한 뒤 요청 시 연결 설정을 고려하세요. 첫 권한 허용의 의미와 VPN 구성 삭제 후 조치 방법은 VPN 구성 추가 안내 설명에서도 확인할 수 있습니다.
Connectivity Test: 테스트 후 실제 접속 확인
테스트 응답, 시스템 연결, 대상 접속 성공 여부를 각각 확인하세요. 세 상태는 서로 대신할 수 없습니다.
먼저 현재 서버를 테스트한 뒤 대상 페이지 열기
Home에서 Connectivity Test를 찾아 실행하고 결과가 나올 때까지 기다립니다. 먼저 현재 선택된 서버의 결과를 확인하세요. 목록 전체를 한 번에 비교할 필요는 없습니다. 테스트 결과는 Settings의 Test Method, 현재 네트워크 및 테스트 대상 등의 영향을 받습니다. 응답이 있다는 것은 해당 테스트 조건에서 결과가 나왔다는 뜻일 뿐, 모든 프로토콜 매개변수와 대상 접속 및 규칙이 올바르다는 의미는 아닙니다.
그런 다음 브라우저를 열어 본인이 이용 권한을 보유하고 평소 정상적으로 접속되는 페이지를 방문합니다. 주소가 명확한 URL을 사용하고 페이지가 로드될 때까지 기다린 다음 주요 콘텐츠를 사용할 수 있는지 확인하세요. 캐시된 홈페이지나 앱에서 갱신되지 않은 이전 내용을 보고 판단하지 마세요. 필요하면 한 번 새로고침하고, 문제가 이름 확인·연결·로딩·로그인 중 어느 단계에서 발생하는지 기록합니다. 웹사이트 로그인이 실패했다고 해서 반드시 프록시 연결 문제인 것은 아닙니다. 네트워크 요청 실패와 구분해 판단하세요.
Data에서 실제 정책 확인
페이지에 접속할 수 있지만 예상한 경로를 거치는지 확인하고 싶다면 Data에서 관련 요청 기록을 살펴보세요. 현재 버전에서 제공하는 정보를 바탕으로 대상 도메인, 일치한 규칙 및 적용된 정책을 확인합니다. Config에서 일부 요청이 DIRECT와 일치하는 것은 규칙이 적용된 결과이며, 연결 전체가 비활성화되었다는 뜻이 아닙니다. 마찬가지로 상단 연결 스위치가 켜져 있어도 모든 요청에 PROXY가 적용되어야 하는 것은 아닙니다.
특정 대상 하나에서만 문제가 발생한다면 서버를 그대로 둔 채 Proxy와 Config의 결과를 비교하세요. 전자는 성공하고 후자는 실패한다면 현재 설정, 규칙 순서 및 정책 그룹 대상이 올바른지 확인합니다. 둘 다 실패하면 서버 매개변수와 원격 서버 상태를 다시 살펴보세요. Direct로 비교할 때는 요청 경로가 바뀐다는 점을 기억해야 합니다. Direct 결과를 프록시 서버 테스트 성공으로 판단하면 안 됩니다.
유효한 확인을 위해서는 재현 가능한 조건을 기록해야 합니다. 당시 네트워크, 선택한 서버, Global Routing 값, 대상 주소 및 오류 증상을 남기세요. Wi-Fi와 셀룰러 네트워크를 바꿔 보면 네트워크 환경을 구분하는 데 도움이 되지만, 전환 후에는 다시 테스트해야 합니다. 서로 다른 네트워크의 결과를 한데 섞어 비교하지 마세요. 실제 접속이 가능하고 처리 정책이 예상대로라면 해당 연결의 기본 점검을 마친 것입니다.
Settings: 자주 발생하는 문제 및 추가 설정
문제가 발생한 단계를 먼저 확인한 뒤 관련 설정을 변경하세요. 한 번에 하나씩만 바꾸고 원래 설정으로 되돌릴 수 있도록 기록해 두세요.
가져오기 실패: 링크와 내용 확인
Subscribe 저장 또는 업데이트 과정에서 실패한다면 먼저 기기에서 인터넷에 접속할 수 있는지 확인한 다음 링크가 완전한지, 인증 정보가 아직 유효한지 살펴보세요. 구독을 가져오는 단계에서 오류가 발생했다고 해서 목록의 모든 서버를 사용할 수 없는 것은 아닙니다. 서비스 제공업체가 안내한 링크의 용도와 콘텐츠 형식을 확인하세요. 규칙 설정 주소를 서버 구독으로 가져오지 마세요. 링크를 업데이트해야 한다면 기존 구독 항목을 먼저 수정하고, 업데이트 후 항목이 어떻게 바뀌었는지 확인합니다.
테스트 시간 초과: 매개변수와 테스트 방식 확인
서버를 가져왔지만 Connectivity Test에 응답이 없다면 Settings에서 Test Method를 확인해 현재 테스트 방식을 파악한 뒤 Type, Host, Port, 인증 정보와 관련 TLS 및 전송 매개변수를 점검하세요. 테스트 방식에 따라 결과가 다르게 나타날 수 있습니다. 응답을 얻기 위해 알 수 없는 항목을 반복해서 바꾸지 마세요. 기기의 날짜와 시간대가 올바른지도 확인해야 합니다. 특히 인증서 검증이 관련된 경우 시스템 시간을 확인하고 검증 조건을 무작정 완화하지 마세요.
같은 서버가 한 네트워크에서는 실패하고 다른 네트워크에서는 정상이라면 두 결과를 기록하고 현재 네트워크에 추가 제한이 있는지 확인하세요. 모든 매개변수가 원래 정보와 일치하는데도 연결할 수 없다면 서비스 제공업체에 서버 상태와 정보의 유효성을 문의하세요. 다른 사람에게 문제를 알리기 전에 Password, 사용자 인증 정보, 구독 링크 및 서비스 접속에 사용할 수 있는 정보를 가리세요.
연결됐지만 일부 요청 실패: 규칙과 기록 확인
스위치가 켜져 있는데 일부 페이지만 문제가 발생한다면 Data에서 해당 요청을 확인한 다음 Global Routing과 현재 Config를 점검하세요. 예상한 PROXY, DIRECT 또는 REJECT가 적용되었는지, 정책 그룹에서 사용 가능한 대상을 선택했는지 확인합니다. 도메인 이름 확인이 관련된 문제라면 실패한 도메인과 오류를 기록하세요. DNS, 규칙 파일 및 서버를 동시에 바꾸지 마세요. DNS와 규칙 필드에 관한 자세한 설명은 설정 필드 참조를 확인하세요. 먼저 증상에 따라 문제를 좁힌 뒤 해당 항목을 읽으면 됩니다.
Diagnostics 및 On Demand: 기본 연결 확인 후 사용
Settings의 Diagnostics에서 진단 정보를 자세히 확인할 수 있습니다. 진단 기록은 문제를 판단하는 데 도움을 주지만 유효한 서버 정보를 대신하지는 않습니다. 기록을 공유하기 전에 비공개 주소나 인증 정보가 포함되어 있는지 확인하세요. 문제가 계속 재현된다면 단순히 “작동하지 않음”이라고만 설명하기보다 조작 순서, 오류 메시지 및 네트워크 환경을 기록하는 편이 문제 해결에 도움이 됩니다. 시간 초과 문제의 전체 점검 순서는 연결 실패 점검 목록을 참조하세요.
On Demand는 수동 연결이 정상적으로 확인된 뒤 설정하는 것이 좋습니다. 켜기 전에 작동 조건을 이해하고 어떤 네트워크 환경에서 자동으로 연결할지 확인하세요. 잘못된 구독이나 서버 매개변수를 해결해 주지는 않습니다. 연결을 끈 뒤 다시 자동으로 연결된다면 On Demand와 관련 트리거 설정을 확인하세요. 백그라운드 연결과 배터리 소모의 균형은 On Demand 사용 시점 안내에서 확인할 수 있습니다. 처음 설정할 때 모든 옵션을 한꺼번에 구성할 필요는 없습니다.
설정을 마친 뒤 정상 작동을 확인한 조합, 즉 서버, Global Routing 및 현재 설정을 보관하세요. 이후 설정을 변경할 때는 먼저 백업하고 한 번에 하나의 항목만 수정한 다음 연결, 실제 접속 및 기록 확인을 반복합니다. 결과에 문제가 생겨도 처음부터 모든 내용을 다시 가져올 필요 없이 이전에 정상 작동했던 설정으로 돌아갈 수 있습니다.
