공식 매뉴얼 · 첫 연결 가져오기 → 트래픽 분기 → 연결 → 확인

Shadowrocket 사용법

iPhone·iPad 화면을 기준으로 기존 구독에서 시작해 서버 선택, Global Routing 설정, 연결 확인까지 안내합니다.

아래 다섯 단계를 순서대로 진행하세요. 이미 서버 목록이 있다면 두 번째 단계부터 시작할 수 있습니다. 연결 스위치가 켜져 있는데도 접속되지 않으면 다섯 번째 단계로 이동하고 현재 설정을 비교용으로 보존하세요.

Add Server: 서버 추가 또는 구독 가져오기

Shadowrocket을 열고 먼저 Home으로 이동합니다. 여기에서 서버 목록을 확인하고 현재 서버를 선택하며 연결을 제어합니다. 목록이 비어 있다면 먼저 Config나 DNS를 조정할 필요는 없습니다. 기존 구독 또는 서버 정보를 추가하세요. 구독 링크와 개별 서버 공유 링크는 용도가 다릅니다. 전자는 보통 여러 서버를 관리하는 데 쓰이고, 후자는 특정 항목 하나를 추가합니다. 보유한 정보가 어느 쪽인지 먼저 확인한 뒤 알맞은 메뉴를 선택해 구독 주소를 서버 주소 입력란에 넣지 않도록 합니다.

구독 링크가 있는 경우: Subscribe 선택

Home에서 오른쪽 위의 추가 버튼을 누르고 Add Server로 이동한 다음 Type을 열어 Subscribe를 선택합니다. URL 입력란에 본인의 전체 구독 링크를 붙여 넣고 알아보기 쉬운 메모를 입력한 뒤 저장합니다. 붙여 넣은 후 링크의 시작과 끝이 온전한지, 채팅 문구나 줄바꿈 또는 불필요한 공백이 함께 들어가지 않았는지 확인하세요. 구독을 식별하는 데 쓰이는 링크의 쿼리 매개변수도 주소의 일부이므로 표시를 짧게 하려고 임의로 삭제하지 마세요.

저장한 후 Home으로 돌아가 구독 내용이 로드될 때까지 기다립니다. 가져오기가 성공하면 저장된 구독 주소만 보이는 것이 아니라 해당 항목이나 그룹이 목록에 표시되어야 합니다. 그룹 이름만 보이고 그룹 안에 서버가 없다면 업데이트가 완료되었는지 확인한 뒤 링크가 여전히 유효한지 점검하세요. 같은 링크를 반복해서 추가해도 대개 해결되지 않으며, 나중에 항목을 구분하고 삭제하기만 더 번거로워집니다. 업데이트 메뉴, 그룹, 여러 구독 정리 방법은 구독 및 서버 관리 안내서에서 확인할 수 있습니다.

개별 서버 정보가 있는 경우: 프로토콜에 맞춰 입력

서버 주소, 포트, 인증 정보가 있다면 Add Server의 Type에서 자료에 지정된 프로토콜(예: Shadowsocks, VMess, VLESS 또는 Trojan)을 선택하고 각 항목을 입력합니다. Address에는 서버 도메인이나 주소를, Port에는 포트를 입력합니다. 비밀번호, UUID, 암호화 방식 및 기타 옵션은 본인이 받은 원본 정보를 기준으로 입력하세요. 프로토콜마다 필요한 필드가 다릅니다. 이름이 비슷하다고 서로 바꿔 적용하지 말고, 서버 도메인만 받는 필드에 웹 주소 전체를 입력하지 마세요.

자료에 TLS, SNI, 전송 방식, 경로 등의 매개변수가 있으면 함께 확인해야 합니다. 주소와 포트만 저장하면 끝나는 것이 아닙니다. 확실하지 않은 필드는 값을 바꿔 가며 시도하지 말고 원본 자료를 확인하세요. QR 코드가 있다면 Scan QR Code를 사용할 수 있습니다. 개별 서버 공유 링크가 있다면 앱 안내에 따라 클립보드에서 가져오세요. 어떤 방법을 사용하든 가져온 다음 항목을 열어 프로토콜과 주요 매개변수를 확인해야 합니다. 스캔이나 붙여 넣기만으로 정보가 모두 온전하다고 볼 수는 없습니다.

이 단계의 완료 기준: Home에 알아볼 수 있는 서버 항목이 하나 이상 표시되고, 사용할 항목이 선택되어 있어야 합니다. 항목에 알아보기 쉬운 메모를 추가해 테스트 대상을 혼동하지 않도록 하세요. 구독 링크, 비밀번호, 전체 공유 링크에는 접속 정보가 포함될 수 있으므로 공개 스크린샷이나 문의 내용에 넣지 마세요. 다음 단계에서는 트래픽 처리 방식을 설정한 뒤 연결 스위치를 켭니다.

Global Routing: 트래픽 처리 방식 선택

서버를 선택한 후 Home에서 Global Routing을 엽니다. 여기에서는 연결을 어떤 방식으로 처리할지 정합니다. 서버를 추가하거나 잘못된 인증 정보를 자동으로 수정하는 기능은 아닙니다. 처음 사용할 때는 자주 쓰이는 세 가지 방식인 Config, Proxy, Direct를 구분하세요. 이는 속도 설정이 아닙니다. 규칙에 따라 트래픽을 분기할지, 일상적으로 사용할지 또는 연결 문제를 점검할지에 따라 선택합니다.

Config: 선택한 구성에 따라 처리

Config는 현재 활성화된 구성 파일의 규칙을 기준으로 연결을 처리합니다. 신뢰할 수 있는 구성 파일이 있다면 먼저 Config로 이동해 파일이 기기에 다운로드되어 선택된 상태인지 확인한 다음 Home으로 돌아와 Global Routing을 Config로 설정하세요. 원격 구성 주소만 추가하고 다운로드나 활성화를 완료하지 않았다면 해당 규칙이 적용된 것으로 볼 수 없습니다. 서버 구독과 구성 파일은 서로 다른 항목입니다. 서버 목록을 가져왔다고 해서 트래픽 분기 규칙도 함께 가져온 것은 아닙니다.

Config를 사용하면 같은 기기의 요청도 서로 다른 정책을 따를 수 있습니다. DIRECT와 일치하는 요청은 서버를 선택했더라도 해당 서버를 거치지 않습니다. PROXY와 일치하는 요청만 해당 정책에 따라 처리됩니다. 따라서 웹페이지 하나가 열린다고 모든 요청이 선택한 서버를 거친다는 뜻은 아닙니다. DOMAIN-SUFFIX, IP-CIDR, GEOIP, FINAL 등의 용어는 용어집에서 확인할 수 있습니다. 이 안내서에서는 연결 완료를 먼저 다루므로 처음 설정할 때 규칙 파일 전체를 수정하지 않습니다.

Proxy 및 Direct: 명확한 비교에 사용

Proxy는 클라이언트가 처리해야 하는 접속을 프록시 경로로 보냅니다. 처음 선택한 서버를 확인할 때 임시 비교 방식으로 사용할 수 있습니다. 아직 구성 파일을 준비하지 않았다면 아래 연결 확인 단계에서 Proxy를 사용해 테스트한 뒤 필요에 따라 Config로 되돌리세요. 이 단계는 규칙에 따른 변수를 줄이기 위한 것이며, 모든 앱과 모든 시스템 트래픽이 완전히 동일한 경로를 사용한다고 보장하지는 않습니다.

Direct는 선택한 프록시 서버를 거치지 않고 해당 접속을 처리합니다. 기본 네트워크를 확인하거나 잠시 직접 연결과 비교할 때 적합합니다. 프록시 서버를 확인하려는데 Global Routing이 Direct로 설정되어 있다면 연결 스위치가 켜져 있어도 서버가 정상 작동한다고 판단할 수 없습니다. 방식을 변경한 뒤에는 Home으로 돌아가 표시된 값을 다시 확인하세요. 메뉴를 살펴보기만 하고 선택을 완료하지 않은 경우를 방지할 수 있습니다.

이 단계의 완료 기준: 현재 Config, Proxy, Direct 중 무엇을 선택했는지 설명할 수 있고 이번 테스트에서 어떤 경로를 사용해야 하는지 알고 있어야 합니다. Config를 사용할 경우 활성화된 구성 파일의 이름도 확인하세요. 해당 상태를 기록하고 다음 단계에서는 서버와 규칙을 동시에 바꾸지 말고 연결 스위치와 시스템 승인만 처리합니다.

Home: 스위치 켜기 및 VPN 구성 허용

Home으로 돌아가 선택한 서버와 Global Routing이 앞의 두 단계에서 확인한 상태인지 살펴본 뒤 상단의 연결 스위치를 켭니다. 처음 연결할 때 iPhone·iPad에 시스템의 ‘VPN 구성 추가’ 안내가 표시될 수 있습니다. 앱이 기기에 로컬 VPN 구성을 생성하도록 허용하는 절차입니다. 구독을 가져오는 단계가 아니며 원격 서버를 대신 생성하지도 않습니다. 직접 연결을 시작한 직후라면 안내를 표시한 앱이 맞는지 확인한 다음 승인하세요.

Shadowrocket에서 시작한 요청인지 확인한 후 허용을 선택하고 시스템 안내에 따라 암호 또는 생체 인식 인증을 완료합니다. 인증 방식은 기기의 현재 설정에 따라 다릅니다. Shadowrocket으로 돌아와 연결 스위치가 계속 켜져 있는지 확인하세요. 시스템 승인은 클라이언트가 연결을 생성하는 데 필요한 시스템 권한을 받았다는 뜻일 뿐입니다. 서버 사용 가능 여부, 인증 정보의 정확성, 규칙이 예상대로 작동하는지는 다음 단계에서 각각 확인해야 합니다.

실수로 거부했다면 Home으로 돌아가 다시 켜기를 시도하고 시스템 안내가 다시 표시되는지 확인하세요. 계속 진행할 수 없다면 시스템 설정의 VPN 페이지에서 기존 구성을 살펴본 뒤 앱으로 돌아와 다시 시도합니다. 시스템 버전에 따라 설정 메뉴의 위치가 다를 수 있으므로 설정에서 VPN을 검색할 수 있습니다. 모든 네트워크 설정을 삭제하는 것을 첫 번째 해결 방법으로 삼지 마세요. 먼저 구체적인 안내와 구성 상태를 확인해 정상적으로 사용 중인 다른 네트워크 기능에 영향을 주지 않도록 합니다.

기기에 다른 VPN 연결이 있으면 현재 사용하지 않는 연결을 먼저 끊은 다음 Shadowrocket을 켭니다. 회사나 학교에서 관리하는 기기는 정책에 따라 VPN 구성이 제한될 수 있습니다. 이 경우 구독을 반복해서 변경하지 말고 기기 관리 규정을 따르세요. 문제를 확인하는 동안에는 On Demand를 활성화하거나 변경하지 않는 편이 좋습니다. 자동 연결 조건으로 스위치 상태가 달라지면 이번 수동 연결을 판단하기 어려워집니다.

이 단계의 완료 기준: 시스템 승인이 완료되고 Home의 연결 스위치가 바로 꺼지지 않은 채 유지되어야 합니다. 켜자마자 꺼진다면 시스템 안내 내용을 기록하고 다섯 번째 단계에서 승인 및 구성을 확인하세요. 스위치가 켜져 있는데도 웹페이지가 열리지 않으면 여기서 반복해서 전환하지 말고 실제 접속을 확인하는 단계로 진행합니다.

Connectivity Test: 테스트 후 실제 접속 확인

연결 스위치가 켜진 상태에서 먼저 사용하려는 서버에 Connectivity Test를 실행합니다. 테스트 결과는 해당 테스트 방식으로 서버가 응답하는지 판단하는 데 쓰이며 모든 웹페이지, 앱, 규칙이 확인되었다는 뜻은 아닙니다. 같은 그룹에 서버가 여러 개 있다면 테스트 대상이 Home에서 현재 선택한 서버와 같은지 확인하세요. 다른 항목의 성공 결과를 현재 연결의 근거로 삼지 마세요.

다음으로 브라우저를 열어 평소 사용하는 페이지 중 내용을 정상적으로 새로고침할 수 있는 곳에 접속합니다. 기본 네트워크에서도 접속할 수 있는 페이지 하나와 현재 구성에서 프록시를 거칠 것으로 예상되는 대상 하나 이상을 확인하는 것이 좋습니다. Config를 사용하면 두 요청은 서로 다른 정책을 따를 수 있습니다. Proxy를 임시 비교 방식으로 사용한다면 선택한 서버가 실제 요청을 처리하는지 확인하세요. 나중에 변경 전후를 비교할 수 있도록 테스트 대상을 동일하게 유지합니다.

이미 로드된 페이지나 앱 캐시만 확인하지 않도록 주의하세요. 새 페이지를 열거나 확인하려는 내용을 다시 불러와 실제로 새 요청이 발생하는지 살펴봅니다. 브라우저는 정상인데 특정 앱만 실패한다면 전체 연결이 끊겼다고 단정하지 말고 해당 앱의 요청, 규칙 또는 네트워크 동작으로 범위를 좁히세요. 한 웹사이트에서만 오류가 발생하는 경우도 대상 서비스 자체의 문제일 수 있으므로 다른 대상으로 교차 확인합니다.

경로를 더 확인하려면 Data에서 관련 연결 기록을 열고 대상 도메인, 시간, 적용된 정책을 함께 살펴봅니다. 먼저 명확한 새 요청을 발생시킨 다음 해당 기록을 찾으세요. 많은 과거 기록을 보고 추측해서는 안 됩니다. 기록에는 도메인이나 개인의 접속 정보가 포함될 수 있으므로 문제 해결 자료를 공유하기 전에 민감한 내용을 삭제하고 전체 기록을 그대로 공개하지 마세요.

Connectivity Test에 응답이 없는데 웹페이지는 열리는 경우 두 테스트가 같은 서버와 경로를 사용하는지 먼저 확인하세요. 테스트 결과만으로 모든 항목을 삭제하지 마세요. 반대로 테스트에는 응답이 있지만 페이지가 열리지 않는다면 경로가 정상이라고 단정할 수 없습니다. DNS, TLS, 규칙 일치 여부, 대상 서비스 상태가 여전히 실패 원인일 수 있습니다. 초기 응답, 시스템 연결 상태, 종단 간 접속 결과를 구분해 기록하세요.

이 단계의 완료 기준: 새 요청으로 실제 페이지 접속을 확인하고 결과가 현재 Global Routing의 예상과 일치하는지 확인합니다. 서버 확인을 위해 Proxy로 잠시 변경했다면 이제 원래 Config로 되돌린 다음 같은 대상을 다시 테스트하세요. 되돌린 뒤의 결과도 예상과 일치해야 일상적인 트래픽 분기 설정이 완료된 것입니다.

연결 실패: 한 번에 하나씩 확인

접속에 실패하면 먼저 현재 서버, Global Routing, 구성 파일, 사용 중인 네트워크를 기록한 다음 아래 순서대로 확인합니다. 서버 변경, DNS 수정, 규칙 업데이트, 앱 재설치를 동시에 하지 마세요. 이렇게 하면 문제가 해결되더라도 어떤 조치가 효과가 있었는지 알기 어렵습니다. 한 항목을 변경할 때마다 다시 연결하고 네 번째 단계에서 사용한 같은 페이지를 테스트한 뒤 복원할 수 있도록 원래 설정을 보존하세요.

먼저 기본 네트워크와 서버 정보 확인

Shadowrocket 연결을 끄고 기기 자체에서 현재 Wi-Fi 또는 Cellular를 정상적으로 사용할 수 있는지 확인합니다. 웹페이지 로그인이 필요한 Wi-Fi라면 먼저 네트워크에 로그인하세요. 기본 네트워크가 작동하지 않는다면 네트워크 접속부터 해결합니다. 그런 다음 Home으로 돌아가 선택한 항목과 구독 업데이트 여부, 서버 정보의 유효성을 확인하세요. 직접 입력한 항목은 메모 이름만 보지 말고 프로토콜, 주소, 포트, 인증 정보, TLS 관련 필드를 대조합니다.

같은 구독의 일부 항목만 실패하고 다른 기존 항목은 정상이라면 실패한 항목을 비교용으로 보존하고 검증된 항목을 잠시 선택할 수 있습니다. 모두 실패한다면 기존 정보 제공자에게 자료 상태를 확인하세요. 구독 주소를 열거나 업데이트하는 데 성공했다는 것은 목록을 가져오는 단계가 완료되었다는 뜻일 뿐, 목록에 있는 모든 서버가 연결된다는 뜻은 아닙니다.

그다음 Global Routing 및 Config 확인

Global Routing이 실수로 Direct에 남아 있거나 예상과 다른 구성 파일이 선택되지 않았는지 확인합니다. Config 사용 중 문제가 발생하면 같은 대상을 Proxy로 잠시 바꿔 테스트해 볼 수 있습니다. Proxy에서는 접속되고 Config에서는 접속되지 않는다면 서버 정보를 모두 다시 입력하기보다 규칙 일치와 정책을 우선 확인하세요. 비교를 마친 뒤에는 원래 설정으로 되돌려 임시 점검 상태를 장기 설정으로 착각하지 않도록 합니다.

구성의 FINAL은 앞선 규칙과 일치하지 않은 연결을 처리하며, 범위가 넓은 앞쪽 규칙도 대상의 경로를 바꿀 수 있습니다. 대상을 실제로 어떤 규칙이 처리했는지 확인한 뒤 조정 여부를 결정하세요. 특정 페이지 하나를 열기 위해 모든 규칙을 삭제하지 마세요. 규칙 순서와 일치 방식은 용어집에서 확인할 수 있으며 구독 항목 정리와 백업 방법은 서버 관리 안내서에서 이어서 볼 수 있습니다.

마지막으로 DNS와 시스템 연결 상태 확인

서버는 응답하지만 도메인 요청이 계속 실패한다면 현재 구성의 DNS 설정을 확인합니다. 우선 이전에 정상적으로 작동했던 설정으로 되돌리고 구성에서 DNS 동작을 별도로 지정했는지 확인하세요. ‘이름 확인 실패’가 보인다고 익숙하지 않은 주소를 임의로 입력하지 마세요. DNS 요청과 대상 연결이 각각 어떤 경로와 정책을 사용하는지 현재 구성과 함께 판단해야 하며 주소 하나만 바꿔서는 해결되지 않을 수 있습니다.

웹페이지 접속이 아니라 연결 스위치가 켜진 상태를 유지하지 못하는 문제라면 세 번째 단계로 돌아가 시스템 VPN 승인, 기존 연결, 기기 관리 제한을 확인하세요. ‘연결됨’ 상태인데 접속되지 않는 문제를 더 확인하려면 서버, Global Routing, DNS, 규칙 점검 목록을 참고하세요. 문제를 설명할 때는 어느 단계에서 실패했는지, 현재 방식과 민감한 내용을 가린 오류 안내만 제공하세요. 구독 인증 정보나 비밀번호는 공유하지 마세요.

마무리 점검: 더 이상 필요하지 않은 임시 변경 사항을 되돌리고 사용 중인 서버와 구성을 보존한 뒤 실제 접속을 다시 확인합니다. 나중에 구독이나 서버만 변경했다면 첫 번째 단계부터 다시 확인하면 됩니다. 규칙만 조정했다면 이미 완료된 시스템 승인을 반복할 필요 없이 두 번째와 네 번째 단계에서 다시 확인하세요.