공식 매뉴얼 첫 연결

Shadowrocket 사용법:
구독 가져오기와 첫 연결

기존 연결 정보를 바탕으로 추가, 라우팅 선택, 연결 권한 설정과 확인을 차례로 진행합니다. 이 문서는 첫 사용에 필요한 조작을 설명하며, 규칙 항목과 매칭 원리는 설정 참고 자료에서 확인할 수 있습니다.

이미 완료한 단계가 있다면 다음 섹션으로 바로 이동할 수 있습니다. 문제를 확인할 때는 현재 설정을 기록하고 한 번에 하나의 조건만 변경하세요.

STEP 01 / IMPORT

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

Shadowrocket을 열고 먼저 Home으로 이동합니다. 여기에서 서버 목록 확인, 현재 서버 선택, 연결 제어를 할 수 있습니다. 처음 사용할 때는 보유한 정보가 전체 구독 링크인지, 프로토콜·서버 주소·포트·인증 항목이 포함된 단일 서버 정보인지 확인하세요. 둘 중 한 가지 방법만 선택하면 되며, 연결을 시작하기 위해 두 가지를 모두 설정할 필요는 없습니다.

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

Home 오른쪽 위의 추가 메뉴를 눌러 Add Server로 이동한 다음 Type을 열고 Subscribe를 선택합니다. URL 입력란에 전체 구독 링크를 붙여 넣고, 구분하기 쉬운 이름을 입력한 뒤 화면 오른쪽 위의 저장 메뉴를 눌러 추가합니다. 붙여 넣은 후에는 주소의 앞부분과 끝부분, 쿼리 매개변수를 확인하세요. 복사 과정에서 공백이나 줄바꿈이 들어가지 않았는지도 살펴봅니다.

저장한 뒤 Home으로 돌아와 구독 정보를 가져올 때까지 기다린 다음, 구독 그룹과 그 안의 서버 항목을 확인합니다. 구독 이름이 표시되더라도 서버 정보가 제대로 불러와졌다는 뜻은 아닐 수 있습니다. 해당 그룹을 펼쳐 선택할 수 있는 항목이 있는지 확인하세요. 목록이 비어 있거나 가져오기 오류가 표시되면 이 단계에서 멈추고 링크와 현재 네트워크를 확인하세요. 연결 스위치를 서둘러 켜지 마세요.

구독 업데이트는 서비스 제공업체가 게시한 목록을 다시 가져오는 작업이며, 연결이 수립되었다는 뜻은 아닙니다. 나중에 서비스 제공업체가 서버 정보를 변경하면 해당 구독의 작업 메뉴에서 업데이트한 뒤 항목을 확인하세요. 목록 변경으로 기존 선택을 다시 확인해야 할 수 있으므로 업데이트 후 현재 선택된 서버도 살펴봅니다.

서버 정보가 있는 경우: Type에 맞춰 입력

단일 서버 정보를 받은 경우에도 Home에서 Add Server로 이동합니다. 단, Subscribe가 아니라 자료에 지정된 프로토콜에 해당하는 Type을 선택하세요. 예를 들어 Shadowsocks, VMess, VLESS 또는 Trojan을 선택할 수 있습니다. 선택한 Type에 표시되는 항목에 따라 서버 주소, 포트, 비밀번호 및 기타 인증 정보를 입력합니다. 입력할 항목은 프로토콜과 보유한 정보에 따라 달라지므로 다른 프로토콜의 예시를 보고 임의로 값을 추가하지 마세요.

서버 주소와 전체 웹 주소는 서로 다릅니다. 호스트 이름을 입력하라는 안내가 있으면 해당 호스트 이름만 입력하고, 포트와 인증 정보는 각각 지정된 입력란에 입력하세요. TLS, Server Name 또는 전송 매개변수가 있다면 제공받은 정보와 하나씩 대조합니다. 매개변수를 수정하는 대신 보안 검사를 끄지 마세요. 입력을 마치고 저장한 다음 Home으로 돌아와 항목이 표시되는지 확인합니다.

QR 코드가 있는 경우: Scan QR Code 사용

정보가 QR 코드로 제공되었다면 Scan QR Code로 스캔하고 시스템 안내에 따라 카메라 접근을 허용하세요. 인식이 끝난 뒤에도 가져온 항목의 Type, 주소와 필수 입력값을 확인해야 합니다. QR 코드를 읽었다는 것은 내용이 인식되었다는 뜻일 뿐, 서버에 연결할 수 있다는 뜻은 아닙니다. QR 코드에도 개인 인증 정보가 포함될 수 있으므로 공개하지 마세요.

마지막으로 Home에서 사용할 서버를 선택하고 목록의 선택 표시가 원하는 항목에 있는지 확인합니다. 여기까지 마쳐야 연결 정보가 준비된 것입니다. 다음 단계에서는 트래픽 처리 방식을 선택한 뒤 연결을 시작합니다.

STEP 02 / ROUTING

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

Home으로 돌아와 Global Routing을 눌러 현재 선택을 확인합니다. 세 가지 방식은 Config, Proxy, Direct입니다. 이 설정은 요청에 적용할 정책을 결정하며 서버 주소나 인증 정보를 변경하지 않습니다. 잘못된 구독 링크를 수정해 주지도 않습니다.

Config: 현재 설정 파일에 따라 처리

Config는 현재 활성화된 설정 파일을 사용해 요청에 PROXY, DIRECT, REJECT 또는 설정 파일에 지정된 정책 그룹을 적용합니다. 이 방식을 사용하기 전에는 화면 하단의 Config 페이지로 이동해 현재 적용 중인 설정 파일을 확인하세요. 목록에 파일이 하나만 보여도 해당 파일이 현재 선택되었다는 뜻은 아닙니다. 선택 표시나 현재 설정 상태를 확인해야 합니다.

처음 사용할 때 전체 규칙을 바로 편집할 필요는 없습니다. 신뢰할 수 있고 자신의 필요에 맞는 설정 파일이 있다면 먼저 활성화 여부를 확인한 뒤 Home으로 돌아와 Config를 선택하세요. 구독은 주로 서버 정보를 업데이트하고, 설정 파일은 규칙과 기타 설정을 관리하므로 서로 다른 내용입니다. 구독을 추가했다고 해서 모든 라우팅 규칙까지 설정된 것은 아닙니다.

Proxy: 서버 연결 먼저 확인

Proxy는 요청을 프록시 방식으로 처리하므로 첫 연결에서 규칙 분기의 영향을 줄여 점검할 때 유용합니다. 서버가 있고 먼저 작동 여부를 확인하려면 Proxy를 임시로 선택한 뒤 연결 및 웹 페이지 테스트를 진행하세요. 모든 앱과 요청이 같은 결과를 얻는다는 뜻은 아니며, 서버에 반드시 연결할 수 있다고 보장하지도 않습니다.

Proxy에서 대상에 접근할 수 있지만 Config로 전환한 뒤 같은 대상에 접근할 수 없다면, 서버를 바로 삭제하기보다 현재 설정, 일치한 규칙과 정책 그룹 선택을 먼저 확인하세요. 점검이 끝나면 평소 사용 목적에 맞는 방식으로 돌아가면 됩니다. 문제 해결을 위해 선택한 방식을 계속 사용할 필요는 없습니다.

Direct: 프록시 서버를 거치지 않고 요청 처리

Direct는 요청을 직접 연결 방식으로 처리합니다. 기존 네트워크 접속이 정상인지 확인하거나 직접 연결이 필요한 경우에 사용할 수 있습니다. Direct를 선택하면 연결 스위치가 켜져 있더라도 요청이 선택한 프록시 서버를 거친다고 볼 수 없습니다. 결과를 판단할 때는 Global Routing 선택과 스위치 상태를 함께 확인하세요.

방식을 선택한 뒤 Home으로 돌아와 서버 선택 상태를 다시 확인합니다. 다음으로 연결을 시작하고 첫 사용 시 필요한 시스템 권한을 처리합니다.

STEP 03 / CONNECT

Home: 연결 스위치 켜기 및 첫 권한 승인

Home에서 사용할 서버가 선택되어 있는지, Global Routing이 이번 테스트 목적에 맞는지 확인한 다음 화면 상단의 연결 스위치를 켭니다. 처음 연결을 설정할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 요청할 수 있습니다. 안내에 표시된 앱 이름을 확인한 뒤 허용을 선택하고, 시스템 지침에 따라 기기 암호나 생체 인증으로 승인하세요.

이 안내는 앱이 시스템 네트워크 연결 구성을 만들도록 허용하는 절차입니다. 구독 로그인 절차가 아니며, 팝업에서 서버 비밀번호를 입력할 필요도 없습니다. 시스템 인증을 마친 뒤 Shadowrocket으로 돌아와 스위치와 연결 상태를 확인하세요. 권한 승인 중 작업이 중단되었다면 스위치를 다시 켜야 할 수 있습니다. 시스템 팝업이 사라졌다는 이유만으로 연결이 수립되었다고 판단하지 마세요.

이전에 권한 요청을 취소했다면 연결 스위치를 다시 켜고 표시되는 시스템 안내에 따라 진행하세요. 기기가 조직에서 관리되거나 설정 제한이 있거나 시스템에 관련 설정을 변경할 수 없다고 표시되면 먼저 기기 관리 정책을 확인하세요. 기존 시스템 구성을 반복해서 삭제하지 마세요. 권한 문제와 서버 인증 실패는 서로 다른 단계의 문제이므로 따로 확인해야 합니다.

첫 연결을 확인하는 동안에는 On Demand를 꺼 두는 것이 좋습니다. 수동으로 켜고 끈 결과를 명확하게 확인할 수 있습니다. On Demand는 지정한 조건에 따라 연결을 시작하는 기능이지, 연결 품질을 높이는 스위치가 아닙니다. 수동 연결, 라우팅 선택과 대상 접속이 모두 정상인지 확인한 다음 필요에 따라 조건 설정을 살펴보세요.

시스템에 VPN 상태가 표시되거나 앱에서 연결이 켜졌다고 표시되더라도, 이는 관련 연결 상태가 수립되었다는 뜻일 뿐 원격 서버, DNS와 대상 웹사이트가 모두 정상 작동한다는 보장은 아닙니다. 여기서 확인을 끝내지 말고 실제 요청을 보내 결과를 확인하세요. 연결 스위치가 켜진 상태와 대상에 접속할 수 있는 상태는 구분해야 합니다.

사용을 마치려면 Home으로 돌아와 연결을 직접 끈 다음 시스템 상태가 함께 바뀌는지 확인하세요. 연결을 껐는데 다시 자동으로 연결된다면 스위치가 고장 났다고 판단하기 전에 On Demand 활성화 여부와 조건을 확인하세요. 주문형 연결에 대한 자세한 설명은 자주 묻는 질문의 On Demand 항목에서 확인할 수 있습니다.

STEP 04 / VERIFY

Connectivity Test: 연결 및 라우팅 확인

먼저 기존 네트워크부터 확인합니다. 현재 Wi-Fi에서 웹 로그인 인증을 해야 한다면 브라우저에서 먼저 인증을 완료하세요. 모바일 네트워크를 사용하는 경우 데이터 연결이 정상인지 확인합니다. 기본 네트워크를 사용할 수 없다면 서버를 반복해서 바꿔도 문제가 해결되지 않는 경우가 많습니다. 평소 접속할 수 있다고 확인한 페이지 하나를 기본 네트워크 점검에 사용하세요.

현재 서버를 테스트한 뒤 실제 요청 보내기

Home으로 돌아와 Connectivity Test로 서버 연결 상태를 확인하고 테스트 대상에 현재 선택한 서버가 포함되어 있는지 살펴봅니다. 테스트 결과는 서버에 연결할 수 있는지 확인하는 데 도움이 되지만, 테스트 대상과 현재 네트워크 및 서버 상태에 따라 달라질 수 있습니다. 한 번 테스트에 성공했다고 모든 웹사이트와 앱에 접속할 수 있는 것은 아니며, 한 번 시간 초과가 발생했다고 구독이 만료된 것도 아닙니다.

이어서 브라우저를 열고 접속할 수 있다고 확인한 대상 페이지로 이동합니다. 캐시된 페이지를 새 요청의 성공으로 오인하지 않도록 페이지를 새로 고치거나 주소를 다시 열고, 다른 페이지에도 계속 접속할 수 있는지 확인하세요. 실제로 사용할 앱에서도 점검하면 연결 상태만 확인하는 것보다 현재 설정이 적합한지 더 잘 알 수 있습니다.

Config에서 적용된 정책 확인

Config를 사용하는 경우 Logs에서 방금 보낸 요청의 기록을 찾아 대상 도메인, 일치한 규칙과 최종 정책을 확인하세요. 요청에 DIRECT가 적용되었다고 반드시 문제가 있는 것은 아닙니다. 현재 규칙에서 예상한 결과일 수 있습니다. 마찬가지로 PROXY가 표시되더라도 프록시 정책이 선택되었다는 뜻일 뿐이므로 요청 성공 여부와 함께 판단해야 합니다.

프록시를 사용해야 하는데 직접 연결되는 경우에는 현재 설정 파일이 올바른지, 앞선 규칙이 먼저 적용되었는지, 정책 그룹에서 예상한 항목을 선택했는지 확인하세요. 규칙은 보통 순서대로 적용되므로 하나를 변경하면 뒤이은 요청에도 영향을 줄 수 있습니다. 처음 사용하는 단계에서는 결과 확인에 집중하고, 한 번의 이상 현상 때문에 여러 규칙을 연달아 바꾸지 않는 것이 좋습니다.

조건을 통제한 비교 테스트를 할 수 있습니다. 네트워크, 서버와 대상을 그대로 유지하고 Proxy와 Config에서 각각 같은 요청을 반복하세요. Config에서만 실패한다면 규칙과 설정을 중점적으로 확인하고, 둘 다 실패한다면 서버 정보, 기본 네트워크와 서버 상태를 계속 살펴봅니다. 비교할 때 한 번에 하나의 조건만 변경해야 결과를 해석할 수 있습니다.

STEP 05 / DIAGNOSE

자주 발생하는 문제: 발생 단계별 확인

앞선 확인에서 문제가 해결되지 않았다면 어느 단계에서 실패했는지 먼저 기록한 다음 아래 순서로 확인하세요. 구독 가져오기 실패, 서버 연결 실패, 특정 웹사이트 접속 실패는 서로 다른 단계의 문제입니다. 이를 모두 “Shadowrocket 연결 오류”로 묶으면 확인 범위가 지나치게 넓어지고, 올바른 설정을 잘못 바꿀 수 있습니다.

구독을 가져오지 못한 경우: URL과 가져오기 결과 확인

해당 Subscribe 항목으로 돌아가 URL 전체가 입력되었는지, 설명 문구가 섞이지 않았는지, 서비스 제공업체에서 받은 링크가 아직 유효한지 확인하세요. 브라우저에서 계정 정보를 확인하는 페이지가 바로 가져올 수 있는 구독 주소인 것은 아닙니다. 링크 유형이나 유효성이 확실하지 않다면 서비스 제공업체에 문의하세요. 쿼리 매개변수를 임의로 삭제하거나 수정해 해결하려고 하지 마세요.

이전에는 업데이트할 수 있었는데 지금 가져오기에 실패한다면 현재 네트워크에서 구독 주소에 필요한 서비스에 접속할 수 있는지 확인한 뒤 업데이트를 한 번 더 시도하세요. 오류가 네트워크 시간 초과, 인증 실패 또는 콘텐츠 해석 실패 중 무엇인지 확인하면 네트워크 문제와 링크 문제를 구분하는 데 도움이 됩니다. 새 링크가 유효한지 확인하기 전에 기존에 작동하던 항목을 삭제하지 마세요.

목록은 있지만 연결할 수 없는 경우: 서버 입력값 확인

먼저 선택한 항목이 비어 있는 그룹이나 잘못된 서버가 아닌지 확인한 뒤 Type, 서버 주소, 포트, 인증 정보와 필요한 전송 매개변수를 하나씩 대조하세요. 직접 입력할 때는 비밀번호의 대소문자, 포트와 Server Name을 틀리기 쉽습니다. 구독에서 가져온 정보라면 직접 수정해 다음 업데이트에서 덮어쓰게 하지 말고, 먼저 업데이트 성공 여부와 서비스 상태를 확인하세요.

Connectivity Test 시간이 초과되면 가능한 경우 기본 네트워크를 한 번 바꿔 비교하되 서버와 테스트 대상은 그대로 유지하세요. 네트워크를 바꾼 뒤 결과가 달라졌다면 그 차이를 기록합니다. 여러 네트워크에서 모두 실패한다면 서버 상태를 추가로 확인하세요. 연결 스위치가 켜진다는 이유만으로 서버 연결 실패를 배제하지 마세요.

일부 요청만 실패하는 경우: 라우팅, DNS와 로그 확인

먼저 Global Routing이 실수로 Direct에 설정되어 있지 않은지 확인한 다음, Config 페이지에서 예상한 파일이 활성화되어 있는지 살펴봅니다. 특정 대상에 문제가 있다면 Logs에서 해당 요청을 찾아 REJECT, 예상치 못한 DIRECT 또는 다른 정책 그룹이 적용되었는지 확인하세요. 모든 요청을 계속 Proxy로 바꿔 설정의 구체적인 문제를 감추지 마세요.

기록에 도메인 이름 확인 실패가 표시된다면 DNS를 별도의 단계로 점검하세요. 기본 네트워크가 정상인지, 현재 설정에서 DNS 항목을 변경했는지, 같은 도메인이 안정적으로 확인되는지 살펴봅니다. DNS 항목은 서로 영향을 주므로 첫 연결 가이드에서 각 값을 임의로 입력해 보는 것은 적절하지 않습니다. 조정이 필요하다면 설정 항목 및 규칙 참고 자료를 확인하고 현재 구성을 이해한 다음 한 번에 하나씩 변경하세요.

연결 상태가 반복해서 바뀌는 경우: 시스템 조건 확인

Wi-Fi에서 모바일 네트워크로 막 전환했는지, 네트워크 인증이 끝나지 않았는지, On Demand가 재연결을 실행했는지 확인하세요. 수동으로 연결을 끈 직후 다시 연결된다면 먼저 주문형 조건을 일시 중지하고 상태를 살펴봅니다. 기기에 권한 또는 관리 제한이 표시되면 시스템 안내에서 원인을 확인하세요. 이를 구독 만료 문제로 처리하지 마세요.

원인을 찾기 어렵다면 현재 Global Routing, 선택한 서버의 프로토콜 유형, 실패한 대상, 오류 원문과 발생 단계를 정리한 뒤 자주 묻는 질문과 문제 해결을 확인하세요. 기록을 정리할 때 구독 URL, 비밀번호, 인증 정보와 QR 코드 등 개인 정보는 가리세요. 오류 유형과 필요한 상황 정보만 남기면 됩니다.