Shadowrocket 빠른 시작
iPhone / iPad 화면을 기준으로 기존 설정 가져오기, Global Routing 선택, 연결과 확인을 순서대로 진행합니다. 처음에는 연결을 먼저 완료한 뒤 규칙과 자동 연결 조건을 조정하세요.
읽는 순서: 1~4단계를 먼저 진행하세요. 오류가 발생하면 어느 단계에서 발생했는지 기록한 뒤 5단계로 이동합니다. 스크린샷은 화면 위치를 찾는 데 도움이 되며, 구체적인 필드는 선택한 Type과 앱 화면에 따라 다를 수 있습니다.
Add Server: 추가 및 가져오기
구독 링크와 개별 서버 정보는 서로 다른 입력 방식입니다. 가지고 있는 정보에 맞는 방법을 선택하세요.
구독 링크가 있는 경우: Subscribe 사용
Shadowrocket의 Home을 열고 Add Server를 찾습니다. 화면의 추가 메뉴로 들어가도 됩니다. 화면이 열리면 먼저 Type을 누르고 Subscribe를 선택한 뒤, 자신의 전체 구독 링크를 해당 URL 입력란에 붙여 넣습니다. 이때 구독 유형을 선택해야 합니다. 전체 링크를 개별 서버의 Host에 입력하지 마세요. 구분하기 쉬운 이름을 메모로 입력하고 확인한 뒤 저장합니다.
저장한 뒤 구독 정보를 가져올 때까지 기다린 다음 Home으로 돌아가 SERVER를 확인합니다. 하나의 구독으로 여러 서버 항목이 생성될 수 있습니다. 해당 그룹을 펼쳐 목록이 표시되는지 확인한 다음 연결할 서버를 선택하세요. 그룹 이름만 보이고 서버가 없다면 가져오기가 완료되지 않았거나 링크가 만료되었는지 먼저 확인합니다. 바로 연결 스위치를 켜지 마세요. 구독을 업데이트하면 원격 목록을 다시 가져옵니다. 항목을 수동으로 수정했다면 이후 업데이트에서 변경 내용이 덮어써질 수 있습니다.
서버 매개변수가 있는 경우: Type별로 입력
Add Server에서 제공된 정보에 지정된 Type을 선택한 다음 Host, Port, Password와 해당 프로토콜 화면에 표시되는 다른 필드를 하나씩 확인해 입력합니다. Host에는 서버 주소를 입력하고 웹페이지 경로는 덧붙이지 마세요. Port는 제공된 값을 사용하고 프로토콜 이름만 보고 추측하지 마세요. Shadowsocks의 Method는 서버 설정과 일치해야 합니다. 다른 프로토콜에서 SNI, 전송 방식 또는 인증 필드가 표시된다면 마찬가지로 원래 제공된 정보를 따르고, 서로 다른 프로토콜의 매개변수를 섞지 마세요.
정보가 QR 코드로 제공된 경우 Scan QR Code를 누르고 시스템 안내에 따라 카메라 권한을 허용한 다음 스캔합니다. Import from Cloud JSON은 해당 형식의 데이터를 가져올 때 사용하는 기능으로, 임의의 구독 링크를 가져오는 일반적인 메뉴가 아닙니다. 가져온 뒤에도 항목을 열어 Type, 주소, 포트를 확인해야 합니다. 서버 암호, 전체 구독 링크, QR 코드에는 접속 정보가 포함될 수 있으므로 공개 페이지나 스크린샷에 올리지 마세요.
이 단계의 완료 기준은 SERVER에 구분할 수 있는 항목이 나타나고 서버 하나가 선택된 상태입니다. 구독 저장 성공은 정보가 추가되었다는 의미일 뿐 서버에 연결할 수 있다는 뜻은 아닙니다. 다음 단계에서 Global Routing을 정한 후 연결을 시작해야 잘못된 모드로 서버 사용 가능 여부를 판단하지 않습니다.
Global Routing: 모드 선택
서버는 연결 대상을 정하고, Global Routing은 요청이 해당 연결을 사용하는 방식을 정합니다.
Home으로 돌아가 Global Routing을 누릅니다. 처음 사용할 때는 세 가지 모드를 구분하세요. 구성(Config)은 현재 활성화된 구성 파일에 따라 각 요청의 정책을 결정합니다. 프록시(Proxy)는 프록시 경로를 이용한 연결 테스트에 사용합니다. 직접 연결(Direct)은 트래픽을 직접 연결 방식으로 처리합니다. 세 모드는 라우팅 방식만 변경하며, 서버 암호나 구독 유효 기간, 프로토콜 매개변수를 자동으로 수정하지 않습니다.
일상적으로 규칙에 따라 트래픽을 분기하려면 구성(Config)을 선택한 다음 Config를 열어 현재 활성화된 파일을 확인합니다. 구독에 서버가 있다고 해서 자신의 용도에 맞는 규칙 구성이 준비되어 있다는 뜻은 아닙니다. Subscribe는 연결 정보를 관리하고 Config는 구성 파일을 관리하므로 서로 대체할 수 없습니다. 전환하기 전에 파일 이름과 내용을 확인하고, 사용할 수 있는 파일이 이미 있다면 이 안내를 따라 하려고 덮어쓰지 마세요.
구성 편집 화면에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션이 표시됩니다. 지금은 Rule의 규칙 순서와 마지막 처리 정책만 확인하면 됩니다. 처음 연결할 때 HTTPS Decryption을 활성화할 필요는 없으며, 모든 섹션을 한꺼번에 수정하지 마세요. 규칙은 위에서 아래로 확인하며 처음 일치한 규칙의 정책을 적용합니다. FINAL은 앞선 규칙에 일치하지 않은 요청을 처리하도록 마지막에 둡니다.
아래는 규칙 문법 예시이며, 서버 정보도 아니고 현재 파일을 통째로 교체하라는 완성된 구성도 아닙니다. example.com과 그 하위 도메인은 PROXY로 보내고, 지정한 주소 대역은 DIRECT로 처리하며, 그 외 요청은 마지막 줄에 맡기는 예시입니다. 예시 도메인은 작성 방법을 설명하기 위한 것입니다. 실제 요청을 확인하려면 본인이 접속하는 대상과 현재 구성을 기준으로 해야 합니다.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY서버 연결 실패와 규칙 미일치를 구분하고 싶다면 잠시 프록시(Proxy)로 전환해 같은 대상을 비교 테스트한 뒤 구성(Config)으로 돌아가세요. 이 임시 테스트를 일상적인 구성이 올바르다는 증거로 간주하지 마세요. 규칙 유형, 일치 범위, 구성 파일 구조는 규칙 참고 자료에서 확인할 수 있습니다. 이 페이지에서는 첫 연결에 필요한 점검만 다룹니다.
Home: 연결 스위치 켜기
서버와 모드를 먼저 확인한 다음 시스템에서 VPN 구성을 추가하도록 허용합니다.
Home으로 돌아와 SERVER에서 선택된 서버와 Global Routing에 표시된 모드를 확인합니다. 목록에 이름이 같은 항목이 여러 개 있다면 항목을 열어 주소와 그룹을 확인하세요. 방금 확인한 정보와 실제 사용 정보가 다른 상황을 방지할 수 있습니다. 처음 연결할 때는 현재 Wi-Fi 또는 셀룰러 네트워크를 안정적으로 유지하고, 결과를 단계별로 확인할 수 있도록 자동 전환 조건은 설정하지 마세요.
상단의 Not Connected 옆 스위치를 누릅니다. 처음 사용할 때 시스템에서 VPN 구성을 추가할지 묻습니다. 이번 Shadowrocket 작업으로 요청된 것이 맞는지 확인한 뒤 허용하고, 기기 안내에 따라 암호 또는 생체 인증을 완료합니다. 이 권한은 시스템이 VPN 연결을 설정하도록 허용하는 것이며, 기존 구독에 로그인하거나 구독을 변경하지 않습니다. 이전에 권한 요청을 취소했다면 스위치를 다시 조작해 시스템 안내가 다시 표시되는지 확인할 수 있습니다.
앱으로 돌아와 상단 상태가 Not Connected에서 연결 상태로 바뀌었는지, 스위치가 계속 켜져 있는지 확인합니다. 시스템 상태 막대나 제어 센터에도 VPN 상태가 표시될 수 있지만, 이는 시스템 연결 상태만 나타냅니다. 대상 페이지에 예상한 정책으로 접속했음을 단독으로 증명하지는 않습니다. 스위치가 바로 꺼진다면 빠르게 반복해서 누르지 마세요. 안내 문구를 기록한 뒤 5단계에서 권한과 구성을 확인합니다.
다른 VPN 연결이 이미 있다면 시스템 설정에서 현재 어떤 구성이 연결을 관리하는지 확인해 다른 연결 상태를 Shadowrocket 결과로 착각하지 않도록 합니다. 조직에서 관리하는 기기는 VPN 구성이 관리 정책의 제한을 받을 수 있으므로 기기 관리 지침을 따르고 시스템 구성을 반복해서 삭제하지 마세요. 연결이 유지되면 다음 단계로 이동해 실제 요청을 확인합니다. 이때 여러 설정을 동시에 변경하지 마세요.
Connectivity Test: 적용 여부 확인
서버 테스트, 실제 접속, 규칙 판단을 각각 확인하고 상태 하나만 보고 결론 내리지 마세요.
서버를 테스트한 뒤 실제 대상에 접속
Home에서 Connectivity Test를 실행해 선택한 서버가 현재 테스트를 완료할 수 있는지 확인합니다. Test Method마다 확인하는 대상과 방식이 다르므로 테스트 결과가 있다고 모든 앱에 정상적으로 접속할 수 있는 것은 아닙니다. 테스트가 실패했다면 테스트 방식도 함께 고려해야 합니다. 여기서는 성공, 시간 초과 또는 오류 안내를 기록하고 특정 숫자 하나만으로 전체 연결 품질을 판단하지 마세요.
그다음 브라우저에서 실제로 접속해야 하는 페이지를 열고 본문, 이미지 또는 필요한 기능이 로드되는지 확인합니다. 연결이 복구되었다고 판단할 때 브라우저 캐시를 혼동하지 않도록 새 페이지 요청을 우선 사용하세요. 특정 앱에서만 문제가 생기면 브라우저로 같은 서비스를 비교합니다. 모든 대상에서 실패하면 규칙을 더 추가하기보다 서버 정보, 권한, 현재 네트워크를 먼저 확인합니다.
Config의 정책 확인
구성(Config)에서 페이지를 열 수 있더라도 예상한 규칙이 적용되었다는 뜻은 아닙니다. Data에서 현재 화면에 제공되는 연결 기록을 확인하고 대상 도메인, 시간, 확인할 수 있는 정책 정보를 대조할 수 있습니다. 기록에 표시되지 않는 세부 사항을 추측으로 채우지 마세요. 기록을 확인해야 한다면 먼저 관찰을 시작한 뒤 새 요청을 한 번 보내 이전 연결이 이번 작업에 섞이지 않도록 합니다.
프록시(Proxy)에서는 접속되지만 구성(Config)에서는 접속되지 않는다면 Rule에서 DIRECT가 먼저 일치했는지, 현재 구성이 실제로 활성화되어 있는지, FINAL 위치가 올바른지 우선 확인합니다. 두 모드에서 모두 실패하면 서버와 네트워크 조건을 점검합니다. 비교가 끝나면 사용할 모드로 복원하고 같은 대상에 다시 접속합니다. 복원한 뒤에도 정상적으로 접속되어야 이번 확인을 완료한 것입니다.
Settings: 문제별 점검
한 번에 한 항목만 변경하고 같은 대상을 다시 테스트하며 변경 전 구성을 보관합니다.
항목이 없거나 연결 스위치가 유지되지 않음
가져온 뒤 SERVER가 비어 있다면 Subscribe로 돌아가 전체 링크를 확인하고 복사할 때 공백, 줄바꿈, 설명 문구가 포함되지 않았는지 확인합니다. 브라우저에서 링크가 열리더라도 인식 가능한 구독 정보가 반환된다는 뜻은 아닙니다. 로그인 페이지나 안내 페이지가 표시된다면 원본 정보 제공자에게 문의하세요. 같은 링크를 여러 Type에 반복해서 입력하거나 낯선 사람에게 링크를 공개해 대신 테스트하게 하지 마세요.
스위치가 계속 켜져 있지 않다면 먼저 시스템 안내를 읽고 VPN 구성 추가가 허용되는지, 다른 연결이 현재 연결을 관리하는지 확인합니다. 스위치는 켜지지만 바로 접속할 수 없다면 서버의 Type, Host, Port, 인증 필드를 확인합니다. Host에 도메인을 사용했다면 현재 네트워크에서 도메인을 정상적으로 확인할 수 있는지도 점검합니다. 프로토콜 매개변수가 빠졌다면 원래 제공된 정보를 보완해야 합니다. 테스트 방식을 변경해도 암호나 전송 설정을 보완할 수는 없습니다.
테스트 실패 또는 일부 대상만 접속 불가
Settings에서 Test Method를 열어 현재 테스트 방식을 확인합니다. 변경했다면 같은 네트워크에서 Connectivity Test를 다시 실행하고 서로 다른 테스트 방식의 결과를 직접 비교하지 마세요. Wi-Fi와 셀룰러 네트워크에서 각각 다시 테스트해 현재 접속 네트워크와 관련이 있는지 구분할 수 있습니다. 네트워크 전환은 원인을 확인하기 위한 것이며 어떤 서버든 모든 네트워크에서 사용할 수 있음을 보장하지 않습니다.
일부 대상만 실패한다면 4단계의 Proxy와 Config 비교를 진행한 뒤 일치 순서와 도메인 확인 관련 설정을 점검합니다. HTTPS 페이지에서 인증서 안내가 나타나도 시스템 경고를 무시하거나 첫 연결을 완료하려고 HTTPS Decryption을 임의로 활성화하지 마세요. 먼저 불필요한 변경 사항을 되돌리고 기기 시간, 대상 서비스 상태, 원래 구성의 용도를 확인한 뒤 문제를 계속 점검합니다.
자동 연결 및 Diagnostics
연결이 자동으로 복구되거나 네트워크 전환 후 동작이 달라진다면 Settings에서 On Demand를 확인합니다. On Demand는 조건에 따라 연결을 시작하므로 수동으로 연결을 끊은 뒤 예상과 다른 결과가 나타날 수 있습니다. 기본 연결이 안정되기 전에는 기존 조건을 기록하고 용도를 확인한 뒤 관련 자동 연결 조건을 잠시 비활성화해 테스트합니다. 다시 활성화할 때도 항목별로 확인해 Wi-Fi와 Cellular 조건을 동시에 변경하지 마세요.
추가 확인이 필요하다면 Settings의 Diagnostics를 사용하고 재현 시간, 네트워크 유형, 현재 모드, 오류 원문을 기록합니다. 진단 정보를 공유하기 전에 서버 주소, 구독 링크, 암호 및 기타 인증 정보가 포함되어 있는지 확인하고 필요한 경우 민감한 부분을 가리세요. 상세한 규칙 작성법과 구성 우선순위는 규칙 및 구성 참고 자료에서 확인할 수 있습니다. 다시 진행하려면 추가 및 가져오기로 돌아가 같은 순서로 테스트하세요.
