Shadowrocket 공식 가이드 · 시작하기
Shadowrocket
구독 가져오기 및 연결 가이드
iPhone / iPad 화면을 기준으로 기존 서버를 추가하고 라우팅 방식을 선택한 다음, 연결을 켜고 결과를 확인합니다. 처음 설정한다면 아래 다섯 단계를 따르고, 복잡한 설정은 연결이 정상 작동한 뒤 진행하세요.
단계 01 · Add Server / Subscribe
서버 추가 또는 기존 구독 가져오기
Shadowrocket을 열고 하단의 Home으로 이동합니다. 아직 항목을 추가하지 않았다면 Add Server를 찾으세요. 페이지 오른쪽 위의 추가 항목을 통해 같은 양식으로 이동할 수도 있습니다. 구독 링크는 Subscribe로, 개별 서버 정보는 해당 프로토콜 유형으로 입력합니다. 가지고 있는 정보의 종류를 먼저 확인하고 구독 주소를 Host에 입력하지 마세요.
기존 구독 링크: Subscribe 선택
Add Server를 열고 Type을 선택한 다음 Subscribe를 선택합니다. 양식으로 돌아와 구독 주소 입력란에 전체 링크를 붙여 넣고, 알아보기 쉬운 이름을 입력한 뒤 저장합니다. 주소는 처음부터 끝까지 한 번에 복사하고 물음표 뒤의 매개변수도 유지하세요. 메시지에 포함된 설명, 따옴표, 공백 또는 줄바꿈은 넣지 마세요. 구독 주소에는 개인 인증 정보가 포함되는 경우가 많으므로 비밀번호처럼 안전하게 보관해야 합니다.
저장한 뒤 Home으로 돌아와 구독 내용이 로드될 때까지 기다린 다음 SERVER 아래에 해당 그룹과 서버가 나타나는지 확인합니다. 구독 이름만 보이고 서버가 나타나지 않는다면 업데이트가 완료되었는지, 오류 메시지가 표시되었는지 먼저 확인하세요. 같은 항목을 연속해서 다시 추가하지 마세요. 같은 주소를 반복해서 가져오면 목록만 복잡해질 수 있고, 만료된 주소가 복구되는 것도 아닙니다.
기존 서버 매개변수: Add Server 항목별 입력
주소, 포트, 비밀번호 및 프로토콜 설명을 받았다면 Type에서 정확한 프로토콜을 선택한 다음 Host와 Port를 입력합니다. Host에는 서비스 제공업체가 알려 준 호스트 이름이나 IP 주소만 입력하고, Port에는 해당 포트를 입력합니다. Password, Method 등의 항목은 선택한 Type에 따라 나타나며 모든 프로토콜이 같은 항목을 사용하는 것은 아닙니다. 스크린샷은 가능한 입력 항목 조합 중 하나를 보여 줍니다. 프로토콜을 바꾸면 양식이 달라지는 것은 정상입니다.
예를 들어 Shadowsocks에서는 Method와 비밀번호가 서로 맞는지 확인해야 합니다. Trojan의 비밀번호와 TLS 관련 설정도 받은 정보에 따라 입력하세요. 제공된 정보에 SNI, 전송 방식 또는 경로가 따로 명시되어 있다면 해당 설정을 열어 확인해야 합니다. 포트 번호만 보고 프로토콜을 추측하지 마세요. 항목의 의미가 확실하지 않다면 용어집을 확인하고, 매개변수 값은 본인의 서버 정보를 기준으로 입력하세요.
QR 코드가 있다면 Add Server에서 Scan QR Code를 사용할 수 있습니다. 스캔하기 전에 카메라 접근을 허용하고, 스캔 후 인식된 Type, Host, Port를 확인하세요. 클립보드에 단일 공유 링크가 있다면 앱에 표시되는 가져오기 안내를 따릅니다. Import from Cloud JSON은 구조화된 데이터를 가져오는 별도 기능으로, 일반 구독 주소 입력란과는 다릅니다. 서로 다른 형식을 혼용하지 마세요.
이 단계의 완료 기준: Home으로 돌아왔을 때 SERVER에서 사용할 서버를 찾을 수 있어야 합니다. 목록에 이름이 보인다는 것은 저장 또는 가져오기가 완료되었다는 뜻일 뿐, 연결 가능하다는 의미는 아닙니다. 다음으로 Global Routing을 선택한 뒤 연결을 테스트하세요. 구독 업데이트, 그룹 정리 및 일괄 관리는 구독 및 서버 관리 가이드를 참조하세요.
단계 02 · Global Routing / Config
Global Routing 모드 선택
서버를 추가한 다음 Home으로 돌아와 Global Routing을 엽니다. 이 설정은 트래픽의 라우팅 방식을 결정하며, 구독 업데이트 방식을 정하는 것은 아닙니다. 세 가지 모드는 구성(Config), 프록시(Proxy), 직접 연결(Direct)입니다. 시작하기 전에 확인할 내용이 “서버를 사용할 수 있는지”인지, “내 분할 규칙이 올바른지”인지 구분하세요. 두 가지는 확인 방법이 다릅니다.
구성(Config): 구성 규칙에 따라 처리
구성(Config)은 현재 선택된 구성 파일의 규칙에 따라 트래픽을 처리합니다. 규칙 기반 분할이 필요하다면 하단의 Config로 이동해 사용할 수 있는 파일이 있는지 확인하고 선택한 다음, Home으로 돌아와 구성(Config)을 선택하세요. 규칙은 순서에 따라 적용되며 먼저 일치하는 규칙이 보통 해당 연결의 처리 방식을 결정합니다. 구독에 서버가 있다고 해서 Config에 필요한 모든 정책이 설정되어 있다는 뜻은 아닙니다.
공식 스크린샷은 Config의 구성 편집 화면으로, General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션과 Add Rule이 표시되어 있습니다. 처음 사용할 때 이 항목들을 일일이 수정할 필요는 없으며, 연결을 위해 HTTPS Decryption을 켜지 마세요. 서비스 제공업체가 자체 구성 안내를 제공했다면 적용 범위를 먼저 확인하세요. 확실하지 않다면 기존 구성을 유지하고 편집 전에 백업하세요.
프록시(Proxy): 규칙의 영향을 분리해 확인
프록시(Proxy)는 현재 프록시 연결로 처리되는 트래픽에 프록시 경로를 사용합니다. 문제를 확인할 때 규칙의 영향을 일시적으로 줄이는 데 유용합니다. 선택한 뒤에도 Home에서 사용할 수 있는 서버를 선택하고 상단 스위치를 켜야 합니다. Global Routing만 바꾼다고 서버 매개변수가 자동으로 올바르게 설정되지는 않습니다. Proxy에서는 접속되지만 Config에서 일부 대상만 실패한다면 규칙 일치 여부와 정책 연결을 중점적으로 확인하세요.
직접 연결(Direct): 원격 프록시 경로를 거치지 않음
직접 연결(Direct)은 원격 프록시 경로를 거치지 않고 접속할 때 사용합니다. 원격 서버가 정상적으로 작동한다는 것을 확인하는 방법으로는 적절하지 않습니다. 스위치가 켜져 있지만 Direct를 선택한 상태를 서버 연결 성공의 증거로 보지 마세요. 모드를 비교한 뒤에는 계속 사용할 모드로 되돌려 문제 해결 중의 임시 선택이 그대로 남지 않게 하세요.
이 단계의 완료 기준: Home으로 돌아왔을 때 Global Routing 행에 예상한 옵션이 표시되어야 합니다. Config를 선택했다면 현재 활성화된 구성 파일도 알고 있어야 합니다. DOMAIN-SUFFIX, GEOIP, FINAL 등의 규칙 키워드는 용어집에서 확인할 수 있습니다. 이 페이지에서는 규칙 작성 방법을 다루지 않습니다.
단계 03 · Home / SERVER
서버를 선택하고 연결하기
Home으로 돌아와 SERVER 그룹에서 사용할 서버를 선택하고 선택 표시가 올바른 항목에 있는지 확인합니다. 구독이 여러 개라면 해당 그룹을 먼저 확인한 다음 서버 이름을 확인하세요. 새 구독을 가져왔다고 해서 앱이 그 구독의 서버로 자동 전환되는 것은 아닙니다. 구성이 별도 정책 그룹을 사용하는 경우 관련 정책이 사용할 수 없는 항목을 가리키지 않는지도 확인하세요.
Global Routing을 확인한 다음 Home 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가할지 물을 수 있습니다. 방금 Shadowrocket을 열어 발생한 요청인지 확인하고 시스템 안내에 따라 허용한 뒤, 기기에서 요구하는 인증을 완료하세요. 이 과정은 기기 자체의 확인 절차이며, 구독 제공업체에 기기 잠금 해제 정보를 보낼 필요는 없습니다.
승인이 끝나면 Shadowrocket으로 돌아와 상단 상태가 Not Connected에서 Connected로 바뀌는지 확인합니다. 시스템 승인 후에도 스위치가 꺼져 있다면 Home으로 돌아온 뒤 한 번 더 켤 수 있습니다. 곧바로 꺼지거나 연결이 계속 실패한다면 스위치를 빠르게 반복해서 전환하지 마세요. 안내 메시지를 기록하고 이 페이지의 설정 및 문제 해결 섹션으로 이동하세요.
VPN 구성 승인과 서버 인증은 별개의 과정입니다. 시스템에서 구성을 추가하도록 허용했다는 것은 기기가 해당 네트워크 연결을 만들 수 있도록 허용했다는 뜻입니다. 서버 주소, 포트 및 인증 매개변수는 별도로 확인해야 합니다. 따라서 Connected는 다음 단계로 넘어가기 위한 시작점이며, 모든 웹사이트와 규칙이 정상 작동한다는 뜻은 아닙니다.
처음 확인할 때는 Home 화면을 열어 둔 상태에서 연결이 안정될 때까지 기다린 뒤 브라우저를 여는 것이 좋습니다. 서버를 바꾸거나 중요한 매개변수를 수정하려면 먼저 연결을 끄고 변경 사항을 저장한 뒤 다시 연결하세요. 그러면 현재 테스트에 사용한 설정을 분명히 확인할 수 있습니다. 테스트를 마친 뒤 연결을 중지하려면 Home으로 돌아와 상단 스위치를 끄세요.
이 단계의 완료 기준: 서버를 선택하고 시스템 승인을 마친 뒤 Home에 Connected가 표시되어야 합니다. 다음 단계에서는 구성을 더 수정하지 말고 고정된 대상을 이용해 실제 접속 결과를 확인하세요. 그래야 연결 수립과 앱 접속 중 어느 단계에서 문제가 발생하는지 구분할 수 있습니다.
단계 04 · Connectivity Test
연결 및 실제 접속 결과 확인
방금 선택한 서버와 라우팅 모드를 유지한 채 Home에서 Connectivity Test를 실행합니다. 이 테스트는 현재 네트워크에서 서버에 연결할 수 있는지 확인합니다. 결과는 Test Method, 네트워크 환경 및 대상의 응답에 따라 달라집니다. 시간이 표시되어도 모든 서비스가 사용 가능하다는 뜻은 아닙니다. 시간 초과가 발생해도 한 번의 결과만으로 비밀번호가 잘못되었다고 단정하지 말고, 뒤이어 실제 접속 결과를 확인하세요.
그다음 브라우저를 열어 정상 작동을 확인한 적이 있고 이번 테스트 목적에 맞는 대상을 방문합니다. 이전에 캐시된 내용만 보이지 않도록 새 페이지를 열거나 새로고침하세요. 먼저 같은 대상으로 한 번 확인한 뒤 다른 대상으로 바꿉니다. 무선 네트워크, 서버, Global Routing을 동시에 변경하지 마세요. 결과가 달라져도 어떤 항목이 영향을 미쳤는지 판단하기 어렵습니다.
현재 프록시(Proxy)를 선택했다면 선택한 서버로 실제 접속이 가능한지 확인합니다. 구성(Config)을 선택했다면 대상이 프록시와 직접 연결 중 어떤 경로를 사용해야 하는지도 확인해야 합니다. 규칙에서 DIRECT로 지정된 대상에 접속된 것만으로는 원격 프록시가 사용 가능하다고 증명할 수 없습니다. 프록시를 사용해야 하는 대상에 접속할 수 없다면 일치하는 규칙과 해당 정책을 계속 확인하세요.
네트워크 요인을 비교하려면 현재 상태를 먼저 기록하고 한 번에 조건 하나만 바꾸세요. 예를 들어 서버와 구성을 그대로 둔 채 무선 네트워크에서 모바일 네트워크로 바꾸고 다시 테스트합니다. 같은 서버가 특정 네트워크에서만 실패한다면 모든 네트워크에서 실패하는 경우와 점검 방향이 다릅니다. 지연 시간 숫자만으로 항목을 선택하지 말고 실제 접속이 안정적인지를 기준으로 판단하세요.
이 단계의 완료 기준: Connected가 표시되는 것뿐 아니라 어떤 대상에 접속되었는지, 어떤 모드를 사용했는지, 테스트 당시 어떤 네트워크였는지 설명할 수 있어야 합니다. 결과가 예상과 다르다면 이 세 가지 조건을 기록하고 다음 단계에 따라 원인을 좁혀 보세요. 이미 정상 작동한다면 이름을 정리하고 그룹을 조정하거나 구성을 백업할 수 있습니다.
단계 05 · Settings / Diagnostics
문제가 발생한 범위에 따라 설정 점검
문제가 발생한 단계부터 확인하세요. 가져오기에 실패했다면 주소와 형식을 확인하고, 서버가 보이지만 테스트에 실패한다면 서버 매개변수를 확인합니다. Connected로 표시되지만 일부 대상에만 문제가 있다면 라우팅과 이름 해석을 확인하세요. 한 번에 조건 하나만 변경하고 변경 후에는 같은 테스트를 반복합니다. 이렇게 하면 원인과 결과를 분명히 파악할 수 있고, 원래 정상 작동하던 항목까지 잘못 바꾸는 일을 줄일 수 있습니다.
구독을 가져오지 못했거나 업데이트 후 비어 있는 경우
구독 링크가 완전한지, 공백이 추가되지 않았는지, 단일 서버 공유 링크를 Subscribe 주소로 잘못 입력하지 않았는지 다시 확인합니다. 링크에 유효 기간이나 접근 인증 정보가 있다면 서비스 제공업체에 현재 상태를 확인하세요. 전체 구독 주소를 공개적으로 붙여 넣어 문의하지 말고, 같은 이름의 구독을 연속해서 만들지도 마세요. 기존 기록을 보존한 뒤 오류 안내에 따라 처리합니다. 삭제하기 전에 보관해야 할 사용자 지정 내용은 백업하세요.
테스트 시간 초과 또는 연결이 즉시 끊기는 경우
먼저 연결을 끈 상태에서 기기가 일반 네트워크에 정상적으로 접속되는지 확인한 다음, 선택한 서버의 Type, Host, Port, 인증 정보 및 전송 설정을 확인합니다. 한 항목만 실패하고 같은 그룹의 다른 항목은 정상이라면 해당 서버 정보를 먼저 확인하는 것이 좋습니다. 모두 실패한다면 현재 네트워크, 구독 상태 및 시스템 시간도 확인하세요. TLS 관련 연결은 올바른 시간 설정이 필요합니다. 시스템의 날짜 및 시간에서 자동 설정을 확인하고, 인증서 확인을 끄는 방식으로 문제를 진단하지 마세요.
Connected 상태에서 일부 대상에만 문제가 있는 경우
Home으로 돌아와 Global Routing을 확인하고 직접 연결(Direct)이 남아 있지 않은지 확인합니다. 프록시(Proxy)와 구성(Config)의 결과를 일시적으로 비교할 수 있습니다. 전자에서는 정상 작동하고 후자에서는 실패한다면 현재 Config에서 올바른 파일을 선택했는지, 규칙에서 참조하는 정책이 있는지 확인하세요. DNS나 특정 앱의 별도 네트워크 동작이 관련된 경우 용어를 먼저 확인한 뒤 구성을 조정하세요. 모든 설정을 한꺼번에 바꾸지 마세요.
백그라운드 동작 및 Settings 옵션
하단의 Settings로 이동하면 Test Method, On Demand, Diagnostics와 Proxy, TCP, UDP 등의 설정 분류를 확인할 수 있습니다. Test Method는 Connectivity Test의 검사 방식에 영향을 주므로 서로 다른 테스트 방식에서 나온 수치를 직접 비교하기 어렵습니다. On Demand는 조건을 만족할 때 자동으로 연결하는 기능이며, 잘못된 서버 매개변수를 고치는 스위치가 아닙니다. 수동으로 연결을 끊은 뒤 다시 자동 연결된다면 해당 규칙이 활성화되어 있는지 먼저 확인하세요.
원인을 찾기 어렵다면 Diagnostics에서 사용 가능한 진단 정보를 확인할 수 있습니다. 문제가 발생했을 때의 네트워크 유형, Global Routing 선택, 테스트 결과 및 안내 문구를 기록한 뒤 서비스 제공업체에 문의할지 판단하세요. 스크린샷이나 로그를 공유하기 전에 구독 링크, 비밀번호, 개인 주소 및 기타 인증 정보를 가리세요. SERVER에 입력한 개인적인 이름도 먼저 확인해야 합니다.
이 단계의 완료 기준: 문제를 가져오기, 서버, 시스템 연결 또는 구성 규칙 중 한 범위로 좁힐 수 있어야 합니다. 여러 구독 정리, 업데이트 정책, 삭제 및 백업에 관해서는 구독 및 서버 관리 가이드를 참조하세요. 영어 인터페이스 용어의 의미만 궁금하다면 모든 단계를 다시 진행하지 말고 용어집을 확인하세요.
