Shadowrocket 사용 가이드
설정 가져오기 및 연결 확인
기존 구독이나 서버 정보로 시작해 추가, 모드 선택, 연결 및 확인을 순서대로 진행합니다. 이 페이지에서는 처음 사용할 때 필요한 절차만 다룹니다. 복잡한 규칙이나 지속적인 오류는 문제 진단에서 이어서 점검하세요.
먼저 하나의 구성을 끝까지 확인한 다음 여러 설정을 가져오거나 규칙을 조정하세요. 아래 공식 스크린샷은 화면을 식별하는 데 사용합니다. 실제 필드는 Type, 구성 내용 및 앱 화면에 따라 달라질 수 있으므로 기기에 표시되는 내용을 기준으로 하세요.
Add Server: 기존 구독 또는 서버 가져오기
추가 방법을 하나 선택하고 저장 후 항목이 표시되는지 확인한 다음 모드를 선택합니다.
기존 구독 링크: Subscribe 사용
Shadowrocket의 Home을 열고 SERVER 그룹 근처에서 Add Server를 찾습니다. 추가 화면에서 Type을 누른 뒤 Subscribe를 선택하고 사용자가 보유한 전체 구독 링크를 해당 주소 필드에 입력합니다. 구독 링크는 일반 웹사이트의 홈이나 단일 서버 도메인이 아닙니다. 서비스 제공자가 사용자에게 명확히 안내한 구독 주소를 사용해야 합니다. 복사할 때 물음표 뒤의 매개변수를 유지하고 공백, 줄바꿈, 따옴표 또는 대화 메시지의 설명이 섞이지 않도록 주의하세요.
구분하기 쉬운 메모를 입력하고 저장한 다음 구독 내용을 가져올 때까지 기다립니다. Home으로 돌아와 구독 그룹과 서버 항목이 표시되는지 확인합니다. 그룹 이름만 있고 서버가 없다면 연결 스위치를 바로 켜지 마세요. 먼저 구독을 정상적으로 불러왔는지 확인한 다음 주소가 완전한지, 구독 권한이 아직 유효한지 점검합니다. 구독을 업데이트하면 원격 내용을 다시 가져옵니다. 구독에 포함된 서버 매개변수를 직접 변경하면 업데이트 후 덮어써질 수 있으므로 장기적으로 조정하려면 먼저 구성의 출처를 확인하세요.
기존 서버 정보: Type에 맞춰 입력
항목별 매개변수를 받은 경우 Add Server에서 해당 Type을 선택한 뒤 Host, Port 및 해당 유형에서 요구하는 인증 정보를 입력합니다. 공식 스크린샷의 Password, Method 등의 필드는 스크린샷에서 선택한 유형에 해당하며 모든 프로토콜에 동일하게 적용되는 것은 아닙니다. Shadowsocks, VMess, VLESS 또는 Trojan 등의 유형은 보유한 정보에 맞춰 각각 입력해야 합니다. 필드가 비슷해 보인다는 이유로 서로 바꾸어 사용하면 안 됩니다.
Host에는 일반적으로 도메인 또는 IP 주소를 입력하며 웹 페이지 경로를 임의로 덧붙이지 않습니다. Port는 서버에서 안내한 포트와 일치해야 합니다. 기존 정보에 TLS, 전송 방식, 경로 또는 다른 매개변수가 포함되어 있다면 각각 대조해 입력하세요. 저장하기 전에 특히 복사한 인증 정보의 앞뒤 문자를 빠뜨리지 않았는지 확인합니다. 항목의 의미가 확실하지 않으면 값을 추측해 반복해서 시도하지 말고 본인의 서비스 제공자에게 먼저 문의하세요.
기존 QR 코드: Scan QR Code 사용
호환되는 구성 QR 코드가 있다면 Scan QR Code에서 스캔을 시작할 수 있습니다. 시스템에서 카메라 권한을 요청하면 필요한 경우 허용하세요. 스캔이 끝나도 인식된 Type, Host, Port를 확인한 다음 저장해야 합니다. Import from Cloud JSON은 별도의 가져오기 경로이므로 일반 구독 주소, 웹 주소와 JSON 구성을 혼동하지 마세요. QR 코드와 구독 링크에는 접근 자격 정보가 포함될 수 있으므로 공개 게시판에 전달하지 마세요.
Home으로 돌아와 SERVER 그룹에서 방금 추가한 서버를 선택합니다. 목록에 항목이 표시된다는 것은 정보가 저장되었다는 뜻일 뿐, 서버에 반드시 연결할 수 있다는 뜻은 아닙니다. 다음으로 요청을 처리할 방식을 정한 뒤 연결 스위치를 켜야 확인 결과를 명확하게 판단할 수 있습니다.
Global Routing: Config, Proxy 또는 Direct 선택
선택한 서버는 사용할 프록시 출구를 결정하고, Global Routing은 요청의 처리 방식을 결정합니다.
추가를 마치면 Home으로 돌아와 Global Routing을 눌러 현재 모드를 확인합니다. 이 가이드에서는 Config, Proxy, Direct 세 가지 선택을 설명합니다. 처음 사용할 때 특정 옵션의 위치만 외우지 말고 이번 테스트에서 확인하려는 내용부터 정하세요. 서버가 작동하는지 확인하려는 것인지, 규칙이 예상대로 요청을 분기하는지 확인하려는 것인지에 따라 관찰할 항목이 다릅니다. 한 번 웹 페이지를 열어 본 결과만으로 두 가지 목적의 설정이 모두 올바르다고 판단할 수 없습니다.
Config: 현재 구성을 기준으로 처리
일상적으로 규칙 분기가 필요하면 Config를 선택합니다. 그런 다음 Config 화면에서 실제로 사용할 구성이 활성화되어 있는지 확인하세요. 파일이 존재하는 것만으로는 충분하지 않습니다. 서버 구독과 규칙 구성은 서로 다른 종류의 정보입니다. 전자는 연결 정보를 제공하고 후자는 요청의 처리 방식을 설명합니다. 구독을 가져와도 필요한 규칙 구성이 완료된 것은 아닙니다.
공식 Config 스크린샷에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션이 표시됩니다. 처음에는 구성 출처, 현재 활성화 상태 및 Rule의 처리 방식을 확인하면 됩니다. 각 섹션을 수정할 필요는 없습니다. 편집이 필요하면 먼저 사본을 보관한 다음 Add Rule이나 기존 규칙 편집 메뉴에서 한 항목씩 조정하세요. 특히 한 번의 테스트를 통과시키려고 Hosts, DNS 관련 설정과 규칙을 동시에 바꾸지 마세요. 문제가 생겼을 때 원인을 파악하기 어려워집니다.
Proxy 및 Direct: 비교 확인에 사용
Proxy는 현재 선택된 프록시 연결을 중심으로 테스트할 때 사용합니다. 서버 매개변수와 연결이 사용 가능한지 임시로 판단하는 데 적합하지만 모든 앱과 모든 종류의 요청에서 결과가 반드시 같다는 뜻은 아닙니다. Direct는 직접 연결을 비교할 때 사용합니다. 이 모드에서 웹 페이지가 열린다고 해서 서버 연결이 성공했다고 단정할 수 없습니다. 비교가 끝나면 원래 사용하려던 모드로 되돌리세요.
예를 들어 Rule의 DOMAIN-SUFFIX,example.com,PROXY는 example.com과 그 하위 도메인에 일치하는 요청을 PROXY로 처리한다는 뜻입니다. 사용할 수 있는 서버 정보가 아니며 구독을 대신할 수도 없습니다. 규칙은 구성에 나열된 순서대로 일치하므로 앞선 규칙이 이후 결과에 영향을 줄 수 있습니다. 처음 연결할 때 복잡한 규칙을 작성하지 말고 출처와 용도를 확인한 구성을 사용하세요. 규칙의 예외와 오류 상황은 문제 진단에서, 자주 묻는 개념은 문제 해결에서 확인할 수 있습니다.
Home: 연결 스위치를 켜고 권한 허용
테스트 대상이 예상과 달라지지 않도록 연결 전에 서버 선택과 Global Routing을 다시 확인합니다.
이제 Home으로 돌아와 SERVER 그룹에서 테스트할 서버가 선택되어 있는지 확인하고 Global Routing의 현재 값을 기억합니다. 화면 상단의 연결 스위치를 누릅니다. 연결되지 않은 상태에서는 Not Connected가 표시됩니다. 처음 연결을 시작할 때 시스템에서 VPN 구성 추가 권한을 요청할 수 있습니다. 요청을 보낸 앱이 Shadowrocket인지 확인한 뒤 허용하고 시스템 안내에 따라 기기 인증을 완료하세요. 이 단계는 클라이언트가 시스템 네트워크 구성을 만들도록 허용하는 과정이지, 회선을 구매하거나 구독을 받는 과정이 아닙니다.
권한을 허용한 뒤 Home으로 돌아와 스위치와 연결 상태가 유지되는지 확인합니다. 이전에 권한을 취소했다면 연결 스위치를 다시 켜고 시스템 안내를 확인하세요. 한 번 스위치를 눌렀다는 이유만으로 권한 설정이 끝났다고 판단하지 마세요. iPad에서는 화면 너비에 따라 배치가 달라질 수 있지만 Home, Global Routing, SERVER 같은 화면 용어를 기준으로 해당 위치를 찾으면 됩니다. 스크린샷의 픽셀 위치를 그대로 따라 누를 필요는 없습니다.
스위치가 켜졌다는 것은 클라이언트가 연결 절차를 시작했다는 뜻일 뿐입니다. 시스템에 VPN 상태가 표시되어도 원격 서버, 도메인 해석 및 각 규칙이 모두 정상적으로 확인된 것은 아닙니다. 따라서 이 시점에 서버를 여러 개 바꾸거나 설정을 더 가져오지 말고 다음 단계의 테스트를 진행하세요. 서버, 네트워크 및 모드를 그대로 유지하면 이후 결과를 비교하기 쉽습니다.
스위치를 켠 직후 다시 꺼진다면 먼저 권한 안내나 오류 메시지가 표시되는지 확인한 다음 시스템의 VPN 구성을 사용할 수 있는지 점검하세요. 조직에서 관리하는 기기는 네트워크 권한 정책의 영향을 받을 수 있으므로 기기 관리자에게 확인하고 관리 구성을 임의로 삭제하지 마세요. 기기에 다른 VPN 연결이 활성화되어 있다면 충돌하는 연결을 먼저 중지한 뒤 다시 시도하세요. 용도를 알 수 없는 시스템 구성은 삭제하지 마세요.
서버를 바꾸거나 구성을 크게 수정하기 전에 연결을 끄고 변경 사항을 저장한 다음 다시 켜세요. 이렇게 하면 현재 어떤 정보를 사용하고 있는지 확인할 수 있고 이전 연결 상태를 새 구성의 결과로 오해하지 않게 됩니다. 이후 자동으로 다시 연결되는 현상이 있으면 먼저 기록한 뒤 Settings에서 On Demand를 확인하세요. 스위치를 연속해서 반복해서 누르지 마세요.
Connectivity Test: 테스트와 실제 접속을 따로 확인
먼저 연결 경로를 확인하고 대상 요청을 점검합니다. 단일 테스트로 실제 사용 확인을 대신할 수 없습니다.
앞 단계에서 연결한 상태를 유지한 채 Home에서 Connectivity Test를 누르고 테스트 결과가 나올 때까지 기다립니다. 테스트 결과는 현재 테스트 방식에서의 연결 가능성을 확인하는 용도입니다. 실제 다운로드 속도로 간주해서는 안 되며, 한 기록에 응답이 있다는 이유만으로 모든 웹사이트를 사용할 수 있다고 단정할 수 없습니다. 결과가 예상과 다르면 당시 사용한 서버, Global Routing, 네트워크를 먼저 기록한 뒤 비교를 이어가세요.
그런 다음 브라우저를 열어 익숙하고 접속 권한이 있는 페이지를 방문합니다. 새 탭을 사용해 실제로 새로고침하면 캐시된 내용을 방금 보낸 요청으로 오해하지 않을 수 있습니다. 현재 구성에서 다른 방식으로 처리되어야 하는 대상도 확인해 각각 로드되는지 살펴보세요. 이른바 “범용 테스트 주소”를 찾을 필요는 없습니다. 각 대상이 현재 구성에서 PROXY 또는 DIRECT 중 어느 방식으로 처리될 것으로 예상되는지 아는 것이 중요합니다.
현재 Config 모드에서 테스트 응답은 있지만 특정 페이지가 계속 열리지 않는다면 Proxy로 잠시 전환해 같은 대상을 다시 방문합니다. Proxy에서는 정상이지만 Config에서 문제가 발생하면 현재 구성이 활성화되어 있는지, 규칙 순서와 처리 정책이 맞는지 우선 확인하세요. 두 모드 모두 실패하면 서버 매개변수, 네트워크 및 테스트 방식을 먼저 점검합니다. Direct는 별도의 비교 기준일 뿐이며 이 모드의 접속 결과를 프록시 연결 성공으로 기록하지 마세요.
연결 기록을 볼 수 있다면 대상 도메인, 일치한 규칙, 실제 사용된 처리 방식을 함께 확인하세요. 상태 아이콘만 보지 마세요. 페이지 하나를 열어 본 뒤 여러 설정을 바꾸면 캐시, 네트워크 변경, 규칙 수정이 뒤섞일 수 있습니다. 대상을 고정하고 한 번에 변수 하나만 바꾼 뒤 같은 방법으로 다시 테스트하는 것이 좋습니다. 그래야 변화의 원인을 알 수 있습니다.
확인이 끝나면 장기간 사용할 Global Routing으로 되돌립니다. 완료 기준은 구성 항목이 있고, 올바른 서버가 선택되어 있으며, 연결 상태가 유지되고, 실제 요청이 예상과 일치하는 것입니다. 이후 구독을 여러 개 관리하거나 규칙을 추가하세요. 결과가 계속 불안정하다면 같은 내용을 반복해서 가져오지 말고 다음 단계에서 증상별로 점검합니다.
Settings: 실패한 단계부터 하나씩 점검
가장 먼저 실패한 단계부터 확인하세요. 입력과 권한을 바로잡은 뒤 규칙과 네트워크를 점검합니다.
저장 또는 가져오기 실패: 입력 내용 확인
구독을 불러오지 못하면 전체 주소가 제대로 복사되었는지, 현재 네트워크에서 구독 서비스에 접근할 수 있는지, 본인의 구독 권한이 유효한지 확인합니다. 서버 항목 저장에 실패하면 Type과 필수 필드를 확인하세요. 입력 오류를 해결하기 위해 Global Routing을 바꾸지 마세요. 구독 업데이트는 성공했지만 예상한 항목이 없다면 반환된 내용과 그룹을 먼저 확인한 뒤 본인의 서비스 제공자에게 문의하세요. 링크를 공개 페이지에 게시해 다른 사람에게 대신 테스트하게 하지 마세요.
스위치가 유지되지 않음: 권한 및 시스템 상태 확인
스위치를 켜는 순간 문제가 발생하면 시스템 권한을 허용했는지, 다른 VPN 연결이나 기기 관리 정책의 영향을 받는지 먼저 확인합니다. 스위치를 끈 뒤에도 자동으로 다시 연결된다면 Settings에서 On Demand가 활성화되어 있는지와 연결 조건을 확인하세요. On Demand는 조건에 따라 연결하는 기능이며 서버 비밀번호나 포트 오류를 해결하지 않습니다. 문제 확인을 위해 임시로 설정을 변경할 때는 원래 값을 기록하고 확인 후 사용 방식에 맞춰 복원하세요.
테스트 시간 초과: 매개변수 및 Test Method 확인
Settings에서 Test Method 등의 옵션을 볼 수 있습니다. 테스트 방식에 따라 결과가 나타내는 의미도 다를 수 있으므로 Connectivity Test 결과를 해석하기 전에 현재 방식을 확인하세요. 보유한 서버 정보와 포트, 인증, TLS, 전송 매개변수를 대조하고 시스템 날짜와 시간이 정확한지 확인합니다. 한 네트워크에서만 실패한다면 가능한 경우 다른 네트워크로 바꾸어 다시 테스트할 수 있지만, 네트워크를 바꿀 때마다 연결 상태를 새로 확인해야 합니다.
일부 요청만 실패: 구성 및 Diagnostics 확인
일부 웹 페이지에 문제가 생겼다고 해서 모든 요청을 계속 Proxy로 바꾸지 마세요. 앞 단계의 모드별 테스트 결과를 비교하고 Config에서 더 먼저 일치하는 규칙이 있는지 확인한 다음 Settings의 Diagnostics와 확인 가능한 기록을 이용해 원인을 찾으세요. 스크린샷의 Proxy, TCP, UDP는 설정 분류이며 반드시 모두 바꾸어야 하는 해결 목록이 아닙니다. 구체적인 옵션이 원인이라는 근거가 있을 때만 해당 설정을 조정하세요.
진단 정보를 공유해야 한다면 서버 주소, 인증 정보, 구독 매개변수 및 개인의 접속 내용을 식별할 수 있는 기록을 먼저 삭제하세요. 한 번의 실패만으로 원인을 판단할 수 없다면 앱을 반복해서 삭제하는 것보다 최소한의 재현 절차를 기록하는 것이 더 유용합니다. 재설치 전에 기존 구성을 백업하세요. 그렇지 않으면 다시 가져오고 복원하는 작업이 추가됩니다.
이 페이지에서 처음 사용을 위한 기본 절차를 마쳤습니다. 시간 초과가 계속되거나 DNS 오류, 업데이트 후 문제 또는 iPad 관련 문제가 있다면 문제 진단에서 증상별로 확인하세요. 화면 용어와 일상적인 사용에 관한 질문은 문제 해결에서 확인할 수 있습니다. 추가 점검 시에도 한 번에 한 항목만 바꾸고 같은 대상을 다시 테스트하여 새로운 변수를 줄이세요.
다른 기기의 설치 경로
이 페이지의 설명은 iPhone·iPad를 기준으로 합니다. Mac(Apple 칩 및 Intel), Windows, Android, Linux용 Shadowrocket도 제공됩니다. iPhone·iPad 버전은 App Store에서 $2.99 일회성 결제이며 Mac·Windows·Android·Linux 버전은 무료입니다. 다른 플랫폼의 설치 파일은 사이트의 /dl/에서 제공됩니다. 플랫폼 선택과 첫 실행 시 허용 절차는 다운로드 페이지를 확인하세요.
처음 설치할 때 시스템에서 차단하면 설치 파일의 출처를 먼저 확인한 뒤 해당 시스템의 권한을 점검하세요. 출처를 확인하지 않고 바로 허용하지 마세요. 설치 및 첫 실행 안내를 먼저 읽을 수 있습니다. Mac은 이 Mac에 관하여에서 칩 정보를 확인해 버전을 선택하세요. 확실하지 않다면 정보를 먼저 확인한 뒤 다운로드하세요.