공식 매뉴얼 / 처음 사용하기
Shadowrocket 사용법
기존 구독을 가져와 연결을 확인하기까지 다섯 단계로 처음 설정합니다. 먼저 서버 한 대를 연결한 뒤 규칙과 자동 연결을 설정하세요.
순서대로 진행하는 것이 좋습니다. 이미 가져오기를 마쳤다면 Global Routing부터 시작해도 됩니다. 여러 구독 정리, 백업 또는 일괄 업데이트가 필요하면 서버 관리 매뉴얼을 참고하세요.
단계 01 / 서버를 목록에 표시하기
Add Server / Subscribe: 추가 및 가져오기
먼저 보유한 정보의 종류를 확인합니다. 서버 목록 업데이트에 사용하는 주소는 구독 링크이며, Type, Host, Port 및 인증 항목이 포함된 정보는 일반적으로 수동 추가에 사용합니다. 두 항목의 입력 위치는 다릅니다. 구독 주소를 Host에 입력하거나 링크의 시작 부분만 보고 프로토콜을 추측하지 마세요. 서비스 제공자의 안내를 따르고, 나중에 하나씩 확인할 수 있도록 원본 정보를 보관하세요.
Subscribe로 기존 구독 가져오기
Config를 열고 Subscribe 항목에서 기존 구독을 추가합니다. 알아보기 쉬운 이름을 입력하고 전체 링크를 해당 주소 입력란에 붙여 넣은 뒤 저장합니다. 붙여 넣을 때 앞뒤 공백, 줄바꿈 또는 전각 문자가 포함되지 않았는지 확인하세요. 특히 물음표 뒤의 매개변수를 빠뜨리지 않도록 합니다. 그런 다음 업데이트를 실행하고 결과가 표시될 때까지 기다린 뒤 Home으로 돌아가 SERVER 그룹에 서버 항목이 나타나는지 확인합니다. 주소만 저장한 것은 서버 목록을 정상적으로 가져왔다는 뜻이 아닙니다.
업데이트 후에도 목록이 비어 있다면 업데이트 결과를 먼저 확인하고, 같은 구독을 반복해서 만들지 마세요. 링크 만료, 인증 매개변수 누락, 현재 네트워크에서 구독 주소에 접근할 수 없는 상황 등이 업데이트 실패의 원인일 수 있습니다. 서비스 제공자에게 링크 상태를 문의할 수 있지만, 전체 링크를 공개 스크린샷이나 게시판에 올리지 마세요. 링크 안의 매개변수는 개인 접근 권한을 나타낼 수 있습니다.
Add Server로 직접 입력하기
서버 정보 한 대만 있는 경우 Home의 SERVER 그룹에서 Add Server로 이동합니다. 먼저 Type을 선택하세요. Type에 따라 필요한 인증 방식이 달라지기 때문입니다. 스크린샷에 표시된 항목을 기준으로 Host에는 서버 도메인이나 주소를, Port에는 포트를 입력하고, Password와 Method는 원본 정보에 따라 입력합니다. Host는 일반적으로 웹페이지 주소가 아니므로 페이지 경로를 덧붙이지 않습니다. Port는 서버 측 설정과 일치해야 하며 테스트 포트로 연결 포트를 대신할 수 없습니다.
프로토콜마다 입력 항목이 다릅니다. VMess, VLESS, Trojan 또는 Hysteria2를 선택한 뒤 추가 인증이나 전송 옵션이 표시되면 해당 프로토콜 정보를 기준으로 입력하세요. 모든 인증 값을 Password로 입력하면 안 됩니다. 서버 주소와 TLS 관련 이름도 서로 다를 수 있으므로, 항목이 빠져 있다면 관련 검사를 끄기보다 먼저 원본 구성을 확인하세요.
QR 코드가 있다면 Add Server 하단의 Scan QR Code를 사용하세요. 카메라 접근을 허용한 뒤 스캔하고 가져온 결과를 확인합니다. Import from Cloud JSON은 해당 JSON 구성에 사용하며 일반 구독 주소를 대신하는 기능이 아닙니다. 시스템에서 클립보드 가져오기 안내가 표시되면 클립보드에 본인의 공유 링크가 있는지 확인한 뒤 진행하세요. 가져온 뒤에는 Type과 주소가 예상한 값인지 확인합니다.
저장한 뒤 Home으로 돌아가 새 항목이 SERVER 목록에 표시되는지 확인하고 알아보기 쉬운 이름을 지정합니다. 이 단계에서는 “추가”만 완료된 것이며 연결이 정상인지 확인한 것은 아닙니다. 다음 단계에서 Global Routing을 선택하고 서버를 선택해 연결을 켜세요. 그래야 규칙 문제를 가져오기 실패로 오해하지 않습니다.
단계 02 / 요청 처리 방식 선택하기
Global Routing: 세 가지 모드 선택
Home으로 돌아가 Global Routing을 누르고 현재 목적에 따라 구성(Config) / 프록시(Proxy) / 직접 연결(Direct)을 선택합니다. 이 항목은 트래픽 처리 방식을 결정하며 서버 정보를 대신하거나 만료된 구독을 복구하지 않습니다. 처음 사용할 때는 선택된 모드를 파악한 뒤 페이지가 프록시를 거쳐야 하는지 판단하세요.
구성(Config): 현재 규칙에 따라 분배
사용할 구성 파일이 있다면 구성(Config)을 선택하고 Config에서 원하는 파일이 활성화되어 있는지 확인합니다. 구성의 Rule은 일치하는 요청에 적용할 정책을 결정합니다. DIRECT는 직접 연결, REJECT는 거부, PROXY는 해당 프록시 정책으로 전달한다는 뜻입니다. 규칙은 일반적으로 순서대로 적용되며 먼저 일치한 결과가 이후 처리에 영향을 줄 수 있으므로, 특정 규칙의 존재 여부만 확인해서는 충분하지 않습니다.
스크린샷에는 Config의 구성 파일 편집 페이지와 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션이 표시되어 있습니다. 이 페이지는 Subscribe 주소 입력 화면이 아닙니다. 처음 연결할 때 각 섹션을 수정할 필요는 없으며, HTTPS Decryption을 켤 필요도 없습니다. 사용 목적을 확인한 구성을 먼저 사용하고, 나중에 항목별로 익히세요. 수정 전에는 복원할 수 있도록 원본 구성 사본을 보관하세요.
프록시(Proxy)와 직접 연결(Direct): 경로 확인하기
프록시(Proxy)는 선택한 서버의 프록시 경로가 작동하는지 확인하는 데 사용할 수 있습니다. 다만 시스템에서 유지되는 트래픽이나 구성의 우회 항목은 따로 고려해야 하며, 모든 데이터가 반드시 같은 경로를 통과한다고 이해해서는 안 됩니다. 직접 연결(Direct)은 프록시를 거치지 않는 접근에 사용하며 기본 네트워크 상태를 비교할 때도 유용합니다. Direct를 선택한 상태에서 일반 웹페이지가 열린다고 해서 서버 연결이 성공한 것은 아닙니다.
현재 규칙이 결과에 영향을 주는지 확실하지 않다면 Proxy로 잠시 전환해 비교 테스트를 하고 결과를 기록한 뒤 원래 Config로 되돌리세요. 문제를 해결하려고 구성 교체, 서버 변경, DNS 수정 등을 동시에 하지 마세요. 어떤 항목이 영향을 주었는지 알 수 없게 됩니다. 모드를 결정했다면 다음 단계에서 연결을 켭니다.
단계 03 / 서버를 선택한 뒤 스위치 켜기
Home: 연결하기
Home으로 돌아가 SERVER 그룹에서 사용할 서버를 선택하고, 현재 선택 표시가 앞서 확인한 항목을 가리키는지 확인합니다. 구독에 서버가 여러 대 포함되어 있다면 먼저 한 대만 선택해 확인하고, 첫 테스트 중에 서버를 자주 바꾸지 마세요. 그런 다음 Global Routing이 원하는 모드인지 확인하고 페이지 상단의 연결 스위치를 켭니다.
처음 사용할 때 시스템에서 VPN 구성 추가를 허용할지 물을 수 있습니다. 방금 연 Shadowrocket에서 요청한 동작인지 확인한 뒤 시스템 안내에 따라 허용하고, 기기 암호나 시스템이 제공하는 인증 방법으로 확인을 완료합니다. 이 단계를 취소하면 앱이 필요한 시스템 연결을 만들 수 없습니다. 서버를 다시 가져오기보다 Home으로 돌아가 스위치를 다시 켜세요.
권한을 허용한 뒤 Home으로 돌아가 상단 상태가 Not Connected에서 연결 상태로 바뀌는지, 스위치가 켜진 상태로 유지되는지 확인합니다. 바로 꺼진다면 안내 문구를 기록한 뒤 시스템 권한과 서버 항목을 확인하세요. 상태가 켜져 있다는 것은 시스템 연결 절차가 시작되었다는 뜻일 뿐, 모든 대상 페이지에 접근할 수 있다는 의미는 아닙니다. 다음 단계에서 Connectivity Test와 실제 요청으로 확인해야 합니다.
테스트 중에는 같은 Wi-Fi를 유지하는 등 네트워크 환경을 안정적으로 유지하세요. Wi-Fi에서 셀룰러 네트워크로 전환해야 한다면 네트워크가 안정된 후 다시 시도해 전환 순간의 실패를 구성 오류로 오해하지 않도록 합니다. 기기의 다른 VPN 연결도 현재 상태에 영향을 줄 수 있으므로, 문제를 점검할 때 어떤 시스템 연결이 활성화되어 있는지 먼저 확인하세요.
처음 수동 연결에 성공할 때까지 On Demand의 기존 설정은 그대로 두세요. 이 기능은 연결을 자동으로 시작하며, 누락된 인증 정보를 채워 주거나 수동 연결 실패를 감추는 기능이 아닙니다. 연결을 중지하려면 Home으로 돌아가 상단 스위치를 끄고 상태가 Not Connected로 바뀌는지 확인합니다.
단계 04 / 상태와 결과를 구분해 판단하기
Connectivity Test: 작동 여부 확인
연결을 켠 상태에서 Home의 Connectivity Test를 누르고 테스트가 끝날 때까지 기다립니다. 테스트 결과는 해당 테스트 대상과 방식에서의 연결 가능성을 판단하는 데 사용됩니다. 모든 웹사이트와 프로토콜에 동일하게 적용되는 결론은 아닙니다. 특정 테스트가 실패해도 가져온 구독을 바로 삭제하지 말고 실제 요청으로 교차 확인하세요.
- 먼저 기본 연결을 확인합니다. 브라우저에서 평소 접근할 수 있는 일반 페이지를 열고 새로고침해 캐시된 페이지를 보고 있는 것은 아닌지 확인합니다. 기본 페이지도 열리지 않으면 연결을 끄고 비교해 Wi-Fi 또는 셀룰러 네트워크 자체가 정상인지 확인하세요.
- 예상 경로를 확인합니다. 현재 구성에서 프록시로 처리되어야 하는 페이지를 엽니다. Config를 사용한다면 규칙이 요청을 DIRECT가 아닌 프록시로 전달하는지 확인하세요. 그렇지 않으면 페이지가 열리는지만으로 프록시 경로의 작동 여부를 판단할 수 없습니다.
- 마지막으로 모드를 비교합니다. 같은 서버가 Proxy에서는 작동하고 Config에서는 작동하지 않는다면 구성 활성화 여부, 규칙 순서, 정책 지정부터 확인하세요. 두 모드 모두 실패하면 서버 정보와 서비스 상태를 점검합니다.
기록에는 현재 네트워크, 선택한 서버를 알아볼 수 있는 이름, Global Routing 모드, 테스트 시간, 구체적인 오류를 포함하세요. “연결 안 됨”이라고만 기록하면 웹페이지 접근 실패, 구독 업데이트 실패, 테스트 대상 시간 초과를 구분할 수 없습니다. 비교 가능한 결과를 얻으려면 한 번에 조건 하나만 바꾸고 같은 요청을 반복하세요.
수동 연결과 일상적인 페이지 접근이 모두 정상인지 확인한 뒤 On Demand, 규칙 세부 조정 또는 여러 구독 정리를 검토하세요. 구독 업데이트에 성공했다고 서버를 사용할 수 있는 것은 아니며, 연결 스위치가 켜져 있다고 모든 규칙이 예상대로 작동하는 것도 아닙니다.
단계 05 / 바깥부터 확인하고 한 번에 하나씩 변경하기
Settings / Diagnostics: 일반적인 문제 해결
앞의 네 단계를 마친 뒤에도 문제가 있으면 “기본 네트워크 → 가져오기 결과 → 서버 항목 → 모드와 규칙 → 테스트 설정” 순서로 확인합니다. 처음부터 Settings에서 관련 없는 스위치를 여러 개 바꾸지 말고 가장 바깥 조건부터 점검하세요. 변경 전에 기존 값을 기록하고, 개선되지 않으면 원래 값으로 되돌려 문제 해결 과정을 명확히 유지합니다.
구독 업데이트 실패 또는 서버가 표시되지 않음
Config의 Subscribe로 돌아가 주소가 완전한지, 매개변수가 유지되었는지, 안내 문구를 잘못 붙여 넣지는 않았는지 확인합니다. 기본 네트워크가 정상인지 확인한 뒤 다시 한 번 업데이트하고 결과 안내를 읽으세요. 서비스 제공자가 구독 주소를 변경했다면 기존 구독 기록을 수정하고, 이전 주소로 계속 시도하지 마세요. 업데이트 결과가 비어 있다면 먼저 서비스 상태를 확인하고, 비교할 정보를 잃지 않도록 기존 항목을 바로 삭제하지 마세요.
스위치는 켜지지만 접근이 되지 않음
먼저 Home으로 돌아가 SERVER에서 실제로 어떤 서버가 선택되어 있는지 확인하고, 해당 편집 화면에서 Type, Host, Port 및 인증 값을 점검합니다. 직접 입력할 때는 전각 문자, 앞뒤 공백, 대소문자에 특히 주의하세요. 추가 전송 또는 TLS 설정을 사용한다면 원본 정보와 하나씩 대조합니다. 근거 없이 보안 설정을 낮춰서 해결하려고 하지 마세요.
입력 값이 일치하면 같은 서버로 Proxy와 Config에서 동일한 요청을 각각 테스트합니다. Config에서만 실패하면 Config에서 현재 파일과 Rule의 정책 지정을 확인합니다. 두 모드 모두 실패하면 본인이 보유한 다른 서버와 비교하고 서비스 제공자에게 서비스가 정상인지 확인하세요. 서버 변경은 진단을 위한 비교일 뿐, 기존 구성을 모두 새로 만들어야 한다는 뜻은 아닙니다.
Connectivity Test와 브라우저 결과가 다름
Settings에서 Test Method를 열고 테스트 방식이 서버 환경에 맞는지 확인합니다. 일부 탐지 방식이 실패해도 실제 웹페이지 요청은 성공할 수 있습니다. 반대로 탐지에 성공했다고 해서 웹페이지에 필요한 모든 리소스가 사용 가능하다고 볼 수는 없습니다. 테스트 결과 하나만으로 전체 구성을 조정하지 말고 브라우저의 실제 오류를 보관한 뒤 Diagnostics에서 해당 요청과 관련된 정보를 함께 확인합니다.
Diagnostics로 문제를 기록할 때는 재현에 필요한 한 번의 동작만 포함하세요. 기록을 다른 사람에게 제공하기 전 구독 주소, 인증 항목, 개인 접근 정보를 가립니다. 전체 구성 파일을 공개하지 마세요. 항목을 비교해야 한다면 필드 이름과 가린 값만 보여 주세요.
연결이 자동으로 켜지거나 네트워크 전환 후 문제가 발생함
Settings에서 On Demand가 활성화되어 있는지, 자동 연결 조건이 예상대로 설정되어 있는지 확인합니다. 문제를 점검할 때는 자동 실행을 잠시 끄고 Home으로 돌아가 수동 연결을 테스트할 수 있습니다. 정상 작동을 확인한 뒤 기존 설정을 복원하세요. TCP, UDP 등의 항목은 모든 문제를 해결하는 스위치가 아닙니다. 분명한 근거가 없다면 기존 값을 유지하세요. 업데이트 정책, 백업 및 삭제 절차를 체계적으로 정리하려면 구독 및 서버 관리 매뉴얼을 계속 읽어 보세요. 처음 사용할 때 모든 고급 설정을 한 번에 완료할 필요는 없습니다.
완료 기준: 서버를 가져왔고, Global Routing이 예상대로 설정되었으며, 수동 연결에 성공하고 실제 페이지로 확인했습니다. 이후 문제가 생기면 먼저 확인 단계를 다시 점검하세요. 구성을 먼저 모두 삭제할 필요는 없습니다.