Shadowrocket
가져오기 및 연결 가이드

Shadowrocket을 열고 Home 화면에 머뭅니다. 상단 연결 스위치는 아직 켜지 마세요. 먼저 보유한 정보가 서버 목록을 갱신하는 구독 링크인지, 프로토콜·주소·포트·인증 정보가 포함된 단일 서버 정보인지 확인합니다. 두 정보는 연결된 기능을 하지만 입력 위치와 용도는 다릅니다. 구독 주소를 서버의 Host에 입력할 수 없으며, 단일 서버 주소는 구독 링크가 아닙니다.

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

Home에서 Add Server를 누르거나 화면의 추가 메뉴를 이용합니다. Type을 누르고 Subscribe를 선택한 다음 URL 입력란에 기존 구독 링크 전체를 붙여 넣습니다. 물음표 뒤의 매개변수가 구독 확인에 필요할 수 있으므로 도메인만 복사하지 말고, 링크 앞뒤에 공백이나 줄바꿈을 넣지 마세요. 이름이나 메모 입력란이 있다면 알아보기 쉬운 이름을 입력하고 저장 버튼을 눌러 돌아갑니다.

저장한 뒤 구독 정보를 불러올 때까지 기다리고, Home에서 해당 그룹과 서버 항목을 확인합니다. 구독 이름만 보이고 그룹 안에 서버가 없다면 바로 연결 단계로 넘어갈 수 없습니다. 서버 목록을 정상적으로 가져오지 못한 상태일 수 있습니다. 먼저 붙여 넣은 내용이 완전한지 확인하고 구독 항목의 업데이트 기능을 사용해 다시 시도하세요. 구독 링크에는 개인 식별 정보가 포함될 수 있으므로 공개된 곳에 게시하거나 스크린샷에 담지 마세요. 업데이트가 계속 실패한다면 문서 끝의 가져오기 문제 해결 순서에 따라 확인합니다.

단일 서버 정보가 있는 경우: 항목별로 입력

Add Server에서 Type을 선택해 보유한 정보의 프로토콜과 맞춥니다. 이어서 Host, Port와 필요한 인증 정보를 입력합니다. 공식 스크린샷에는 Password와 Method 입력란이 표시되어 있습니다. 프로토콜을 바꾸면 입력란도 달라지므로 스크린샷의 양식이 모든 프로토콜에 적용되는 것은 아닙니다. Method, 전송 방식, TLS 및 기타 옵션은 보유한 정보를 기준으로 설정하고 이름이 비슷하다는 이유로 임의 변경하지 마세요.

Host에는 서버 도메인 또는 주소를, Port에는 안내받은 포트 번호를 입력합니다. 주소와 포트가 따로 제공되었다면 각 입력란에 나누어 입력하세요. 전체 웹 주소를 Host에 붙여 넣지 마세요. 입력 후 저장하고 Home의 SERVER 그룹에서 항목을 확인합니다. QR 코드로 정보를 받았다면 Add Server에서 Scan QR Code를 사용할 수 있습니다. 해당 형식의 Cloud JSON이 제공된 경우에만 Import from Cloud JSON을 사용하세요. 스캔한 뒤에도 인식된 Type과 주소를 확인해야 합니다.

Home에서 가져온 서버를 확인할 수 있고 상세 정보를 열어 입력 항목을 살펴볼 수 있다면 이 단계는 완료된 것입니다. 정보가 저장되었다는 뜻일 뿐, 서버 연결이 가능하다는 의미는 아닙니다. 다음 단계에서는 이 정보로 트래픽을 처리할 방식을 정한 뒤 서버를 선택합니다.

Home으로 돌아가 Global Routing을 누릅니다. 여기서는 트래픽을 처리할 방식을 정하며, 서버를 생성하거나 잘못된 서버 정보를 수정하지는 않습니다. 선택지는 Config(구성), Proxy(프록시), Direct(직접 연결)입니다. 규칙을 사용할지 연결 경로를 비교할지 먼저 정한 뒤 선택하세요. 이름이 더 완전해 보인다는 이유로 반복해서 모드를 바꾸지 마세요.

Config: 현재 구성에 따라 처리

Config를 선택하면 현재 구성의 규칙과 정책에 따라 연결이 처리됩니다. 앱의 Config 페이지로 이동해 사용할 구성 파일이 선택되어 있는지 확인한 뒤 내용을 살펴보세요. 스크린샷의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption은 구성 편집 화면의 각 항목입니다. 첫 연결에서는 현재 구성과 Rule을 확인하면 충분하며 모든 항목을 수정할 필요는 없습니다.

구독은 주로 서버 목록을 관리하고, 구성 파일은 트래픽 처리 방식을 정의합니다. 두 정보는 서로 다릅니다. 구독을 가져왔다고 해서 모든 접속이 예상대로 라우팅된다고 단정하지 마세요. 선택한 구성에 필요한 규칙이 포함되어 있는지, 규칙에서 사용하는 정책을 이용할 수 있는지 확인해야 합니다. 사용 가능한 구성이 있다면 우선 그대로 두고, 편집하기 전에 사본을 저장하세요. 첫 연결 테스트를 위해 설정을 완성한다는 이유로 HTTPS Decryption을 켜거나 용도를 모르는 규칙을 추가할 필요는 없습니다.

Proxy와 Direct: 연결 경로 확인

Proxy를 선택하면 해당 연결이 프록시 방식으로 처리되어 선택한 서버가 대상에 접속할 수 있는지 확인하는 데 활용할 수 있습니다. 실제 결과는 서버와 대상에 연결할 수 있는지에 따라 달라집니다. Direct를 선택하면 해당 연결은 직접 연결 경로를 사용하므로 서버가 유효한지 확인할 수 없습니다. 가져온 서버를 확인하려는 경우 Direct에서 웹페이지가 열려도 서버가 정상이라고 판단할 수 없습니다.

구성의 규칙은 보통 위에서부터 순서대로 일치 여부를 확인하므로 구체적인 조건을 기본 규칙보다 앞에 배치해야 합니다. 다음 예시는 지정한 도메인 접미사와 일치시키고 나머지는 FINAL에 맡기는 방식입니다. example.com은 예시 도메인일 뿐 사용할 수 있는 서버가 아닙니다. 규칙의 의미를 설명하기 위한 예시이므로 첫 연결 때 기존 구성을 덮어쓸 필요는 없습니다.

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

이 단계가 끝나면 Home으로 돌아가 Global Routing에 표시된 모드를 다시 확인합니다. 기존 규칙을 사용하려면 Config와 해당 구성을 확인하세요. 서버만 따로 테스트하려면 현재 모드를 기록한 뒤 잠시 Proxy를 사용할 수 있으며 테스트 후 원래대로 되돌립니다. 규칙 순서와 정책 그룹에 대한 자세한 설명은 기능 및 설정을 참고하세요. 이 가이드에서는 첫 연결을 계속 진행합니다.

Home의 SERVER 또는 구독 그룹에서 이번에 사용할 서버를 선택합니다. 항목 왼쪽에 점 표시가 나타나는지 확인해 기본 선택이 올바른 서버에 적용되었는지 살펴보세요. 서버 상세 정보 확인과 서버 선택은 별개의 작업입니다. 상세 화면에서 돌아온 뒤 선택 표시를 다시 확인하세요. 목록에 항목이 여러 개라면 테스트할 서버 하나를 먼저 정하세요. 서버를 바꾸는 동시에 규칙까지 수정하면 결과에 영향을 준 변경 사항을 파악하기 어렵습니다.

기본 서버 선택은 해당 기본 항목을 사용하는 연결에 적용됩니다. Config의 정책 그룹에서 서버를 따로 선택할 수 있으므로 실제 접속이 해당 그룹의 선택을 따를 수도 있습니다. 따라서 항목이 선택되어 있어도 모든 규칙이 반드시 그 서버를 사용하는 것은 아닙니다. 처음 설정할 때는 기존 구성을 그대로 사용하고 이번에 선택한 항목을 기억해 두세요. 복잡한 정책 그룹은 기본 연결을 확인한 다음 점검하면 됩니다.

Global Routing을 확인한 뒤 Home 상단의 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용할지 묻는 메시지가 표시될 수 있습니다. 앱 이름이 Shadowrocket인지 확인하고 시스템 안내에 따라 승인한 뒤 기기에서 요청하는 인증을 완료하세요. 이 권한은 기기에 네트워크 연결 구성을 만들기 위한 것으로 구독을 가져오거나 앱을 다시 구매하는 절차가 아닙니다. 취소하면 연결을 설정하지 못할 수 있습니다.

승인한 뒤 Home으로 돌아가 상단 상태가 Not Connected에서 연결됨으로 바뀌는지, 스위치가 바로 꺼지지 않는지 확인하세요. 시스템에 VPN 상태가 표시되는 것은 기기에 연결 구성이 설정되었다는 의미일 뿐, 원격 서버와 DNS 및 모든 규칙이 정상이라는 증거는 아닙니다. 스위치가 바로 꺼지면 현재 항목과 모드를 유지하고 시스템 메시지를 기록한 뒤 마지막 단계에서 연결 실패 항목을 확인하세요. 승인을 반복해서 요청하지 마세요.

연결을 중지하려면 같은 스위치를 끄면 됩니다. 처음 테스트하는 동안에는 수동 스위치의 동작을 먼저 확인한 다음 On Demand 자동 연결 조건을 설정하는 것이 좋습니다. 수동으로 껐는데 다시 자동 연결된다면 On Demand와 시스템의 관련 연결 설정을 함께 확인하세요. 이제 연결이 안정적으로 유지되는지 확인하고 다음 단계에서 실제 접속을 테스트합니다.

문제를 확인하기 전에 연결을 끄고 기기의 기존 Wi-Fi 또는 셀룰러 네트워크로 평소 사용하는 대상에 접속할 수 있는지 확인하세요. 로그인이 필요한 네트워크라면 먼저 접속 절차를 완료해야 합니다. 기존 네트워크 자체가 작동하지 않는다면 서버 비밀번호나 규칙을 바꿔도 해결되지 않는 경우가 많습니다. 기본 네트워크를 복구한 뒤 연결을 다시 켜고, 아래에서 현재 증상에 맞는 항목을 확인하세요.

가져온 뒤 서버 항목이 표시되지 않음

Type이 Subscribe인지, URL 전체가 입력되었는지 확인합니다. 해당 주소가 계정 관리 페이지나 일반 웹페이지가 아니라 실제 구독 링크인지도 확인하세요. 응답이 로그인 안내, 오류 페이지 또는 빈 내용이라면 클라이언트가 서버 목록으로 처리할 수 없습니다. 같은 구독을 반복해서 추가해 중복 그룹을 만들지 말고 기존 항목의 업데이트 결과부터 확인하세요. 링크 유효 기간이나 접근 권한에 관한 문제는 해당 정보를 제공한 서비스에 문의해야 합니다. 이 가이드에서는 대체 정보를 제공하지 않습니다.

항목은 있지만 테스트 또는 연결에 실패함

서버 상세 정보를 열고 원본 자료와 대조해 Type, Host, Port, Password 및 해당 프로토콜에 필요한 다른 매개변수를 확인합니다. 비밀번호 앞뒤의 공백, 잘못 입력한 포트, 일치하지 않는 Method 등이 인증이나 연결 실패의 원인일 수 있습니다. TLS 또는 특정 전송 항목이 필요한 정보라면 해당 설정도 일치시켜야 합니다. 테스트를 위해 인증 관련 설정을 임의로 끄지 마세요. 구독으로 받은 항목은 먼저 업데이트한 뒤 다시 선택할 수 있습니다. 항목이 남아 있는지 확인하고 테스트하세요.

Settings에서 Test Method를 확인할 때는 현재 테스트 방식이 무엇을 측정하는지 먼저 파악하세요. 방식이 다른 테스트의 결과를 직접 비교할 수는 없으며, 한 테스트의 실패가 실제 접속이 전혀 불가능하다는 뜻도 아닙니다. Diagnostics를 사용할 때는 같은 실패에서 필요한 정보를 수집하고 오류 유형과 발생 단계를 기록하세요. 기록을 다른 사람에게 전달하기 전에는 구독 링크, 비밀번호, 인증 정보와 개인 연결 기록의 민감한 내용을 가리세요.

스위치는 켜져 있지만 일부 대상만 접속 실패

먼저 Global Routing을 확인하세요. Direct 모드에서는 목록에 서버가 있어도 요청이 자동으로 프록시 경로를 사용하지 않습니다. Config 모드라면 대상에 예상과 다른 규칙이 적용되었는지 확인하세요. 잘못된 구성 파일을 선택하지 않았는지, 앞선 규칙이 먼저 일치하지 않았는지, 정책 그룹이 다른 서버를 사용하지 않는지 살펴봅니다. 일부 도메인만 문제가 있다면 DNS와 Hosts의 관련 설정을 확인하세요. 처음부터 DNS, TCP, UDP, Proxy 포트를 한꺼번에 바꾸지 마세요.

Settings의 On Demand는 자동 연결 조건을 설정합니다. Today Widget은 표시와 빠른 조작에 관련된 기능으로 서버 정보를 대신할 수 없습니다. Proxy, TCP, UDP는 서로 다른 연결 설정에 해당합니다. 처음 연결할 때 모든 항목을 바꿀 필요는 없습니다. 특정 설정이 원인이라는 근거가 있을 때만 수정하고 원래 값을 기록해 두세요. 자세한 의미와 적용 범위는 Settings 항목 참고 가이드에서 확인할 수 있습니다.

한 번에 하나의 설정만 바꾸고 같은 대상으로 다시 확인하세요. 변경해도 해결되지 않으면 원래 값으로 되돌린 뒤 다음 항목을 살펴봅니다. 이렇게 하면 문제가 기본 네트워크, 가져온 정보, 서버 연결, 규칙 선택 중 어디에서 발생했는지 구분하고 문제 해결 과정에서 다른 문제가 생기는 것을 막을 수 있습니다. 구독 업데이트, 시스템 승인, 연결 증상에 관한 자세한 내용은 자주 묻는 질문을 참고하세요. 기본 연결이 확인되었다면 규칙 문법과 일치 순서를 이어서 읽어 보세요.